w7 APPLICATION-Konfigurationsdienstanbieter

  • Artikel

Die folgende Tabelle zeigt die Anwendbarkeit von Windows:

Edition Windows 10 Windows 11
POS1 Ja Ja
Vorteil Ja Ja
Windows SE Nein Ja
Business Ja Ja
Unternehmen Ja Ja
Bildung Ja Ja

Der APPLICATION-Konfigurationsdienstanbieter mit der APPID w7 wird zum Bootstrapping eines Geräts mit einem OMA DM-Konto verwendet. Obwohl dieser Konfigurationsdienstanbieter zum Einrichten eines OMA DM-Kontos verwendet wird, wird es über die OMA-Clientbereitstellung verwaltet.

Hinweis

Dieser Konfigurationsdienstanbieter erfordert, dass über eine Netzwerkkonfigurationsanwendung auf die ID_CAP_CSP_FOUNDATION- und ID_CAP_DEVICE_MANAGEMENT_ADMIN-Funktionen zugegriffen werden kann.

Im Folgenden wird der Konfigurationsdienstanbieter im Strukturformat dargestellt, das von der OMA-Clientbereitstellung verwendet wird.

APPLICATION
---APPADDR
------ADDR
------ADDRTYPE
------PORT
---------PORTNBR
---APPAUTH
------AAUTHDATA
------AAUTHLEVEL
------AAUTHNAME
------AAUTHSECRET
------AAUTHTYPE
---AppID
---BACKCOMPATRETRYDISABLED
---CONNRETRYFREQ
---DEFAULTENCODING
---INIT
---INITIALBACKOFTIME
---MAXBACKOFTIME
---NAME
---PROTOVER
---PROVIDER-ID
---ROLE
---TO-NAPID
---USEHWDEVID
---SSLCLIENTCERTSEARCHCRITERIA

Hinweis

Bei allen Parameternamen und Merkmalstypen wird die Groß-/Kleinschreibung beachtet, und es müssen alle Großbuchstaben verwendet werden. Sowohl APPSRV- als auch CLIENT-Anmeldeinformationen müssen in der XML-Bereitstellung bereitgestellt werden.

APPADDR Dieses Merkmal wird im w7 APPLICATION-Merkmal verwendet, um die DM-Serveradresse anzugeben.

APPADDR/ADDR Optional. Der ADDR-Parameter wird im APPADDR-Merkmal verwendet, um die Adresse des OMA DM-Servers abzurufen oder festzulegen. Dieser Parameter zeichnet einen Zeichenfolgenwert auf.

APPADDR/ADDRTYPE Optional. Der ADDRTYPE-Parameter wird im APPADDR-Merkmal verwendet, um das Format des ADDR-Parameters abzurufen oder festzulegen. Dieser Parameter zeichnet einen Zeichenfolgenwert auf.

Wenn in OMA DM XML mehrere Instanzen dieses Parameters vorhanden sind, wird der erste gültige Parameterwert verwendet.

APPADDR/PORT Dieses Merkmal wird im APPADDR-Merkmal verwendet, um Portinformationen anzugeben.

APPADDR/PORT/PORTNBR Erforderlich. Der PORTNBR-Parameter wird im PORT-Merkmal verwendet, um die Nummer des Ports abzurufen oder festzulegen, mit dem eine Verbindung hergestellt werden soll. Dieser Parameter akzeptiert einen numerischen Wert im Zeichenfolgenformat.

APPAUTH Dieses Merkmal wird im w7 APPLICATION-Merkmal verwendet, um Authentifizierungsinformationen anzugeben.

APPAUTH/AAUTHDATA Optional. Der AAUTHDATA-Parameter wird im APPAUTH-Merkmal verwendet, um mehr Daten abzurufen oder festzulegen, die bei der Authentifizierung verwendet werden. Dieser Parameter wird verwendet, um die Nonce für den Digestauthentifizierungstyp zu übermitteln. Dieser Parameter zeichnet einen Zeichenfolgenwert auf. Der Wert dieses Parameters ist base64-codiert in Form einer Bytereihe. Wenn AAUTHTYPE digest ist, wird dieser Wert als Noncewert in der MD5-Hashberechnung verwendet, und die oktale Form der Binärdaten sollte bei der Berechnung des Hashs auf server- und geräteseitiger Seite verwendet werden.

APPAUTH/AAUTHLEVEL Erforderlich. Der AAUTHLEVEL-Parameter wird im APPAUTH-Merkmal verwendet, um anzugeben, ob Anmeldeinformationen für die Serverauthentifizierung oder die Clientauthentifizierung gelten. Dieser Parameter zeichnet einen Zeichenfolgenwert auf. Sie können diesen Wert festlegen.

Gültige Werte:

  • APPSRV: Gibt an, dass sich der Client beim OMA DM-Server auf DM-Protokollebene authentifiziert.

  • CLIENT: Gibt an, dass sich der Server beim OMA DM-Client auf DM-Protokollebene authentifiziert.

APPAUTH/AAUTHNAME Optional. Der AAUTHNAME-Parameter wird im APPAUTH-Merkmal verwendet, um OMA DM-Clientnamen zu unterscheiden. Dieser Parameter zeichnet einen Zeichenfolgenwert auf. Sie können diesen Wert festlegen.

APPAUTH/AAUTHSECRET Erforderlich. Der AAUTHSECRET-Parameter wird im APPAUTH-Merkmal verwendet, um das Authentifizierungsgeheimnis abzurufen oder festzulegen, das zum Authentifizieren des Benutzers verwendet wird. Dieser Parameter zeichnet einen Zeichenfolgenwert auf.

APPAUTH/AAUTHTYPE Optional. Der AAUTHTYPE-Parameter des APPAUTH-Merkmals wird verwendet, um die Authentifizierungsmethode abzurufen oder festzulegen. Dieser Parameter zeichnet einen Zeichenfolgenwert auf.

Gültige Werte:

  • BASIC: Gibt an, dass der SyncML DM-Authentifizierungstyp "syncml:auth-basic" verwendet wird.
  • DIGEST: Gibt an, dass der SyncML-DM-Authentifizierungstyp "syncml:auth-md5" verwendet wird.
  • Wenn AAUTHLEVEL AUF CLIENT festgelegt ist, muss AAUTHTYPE digest sein. Wenn AAUTHLEVEL AUF APPSRV festgelegt ist, kann AAUTHTYPE BASIC oder DIGEST sein.

APPID Erforderlich. Der APPID-Parameter wird im APPLICATION-Merkmal verwendet, um die Typen der verfügbaren Anwendungsdienste und -protokolle zu unterscheiden. Dieser Parameter zeichnet einen Zeichenfolgenwert auf. Sie können diesen Wert abrufen oder festlegen. Der einzige gültige Wert zum Konfigurieren der OMA-Clientbereitstellungs-Bootstrap-APPID ist w7.

BACKCOMPATRETRYDISABLED Optional. Der Parameter BACKCOMPATRETRYDISABLED wird im APPLICATION-Merkmal verwendet, um anzugeben, ob ein Paket mit einer älteren Protokollversion (z. B. 1.1) im SyncHdr erneut senden soll (ohne das erste Mal).

Hinweis

Dieser Parameter enthält keinen Wert. Das Vorhandensein dieses Parameters bedeutet, dass die Wiederholung der Abwärtskompatibilität deaktiviert ist. Wenn der Parameter fehlt, bedeutet dies, dass die Wiederholung der Abwärtskompatibilität aktiviert ist.

CONNRETRYFREQ Optional. Der CONNRETRYFREQ-Parameter wird im APPLICATION-Merkmal verwendet, um anzugeben, wie viele Wiederholungen der DM-Client ausführt, wenn fehler auf Verbindungs-Manager- oder WinInet-Ebene auftreten. Dieser Parameter akzeptiert einen numerischen Wert im Zeichenfolgenformat. Der Standardwert ist "3". Sie können diesen Parameter festlegen.

DEFAULTENCODING Optional. Der DEFAULTENCODING-Parameter wird im APPLICATION-Merkmal verwendet, um anzugeben, ob der DM-Client bei der Kommunikation mit dem Server WBXML oder XML für das DM-Paket verwenden soll. Sie können diesen Parameter abrufen oder festlegen.

Die gültigen Werte sind:

  • application/vnd.syncml.dm+xml (Standard)
  • application/vnd.syncml.dm+wbxml

INIT Optional. Der INIT-Parameter wird im APPLICATION-Merkmal verwendet, um anzugeben, dass der Verwaltungsserver möchte, dass der Client sofort nach der Genehmigung der Einstellungen eine Verwaltungssitzung initiiert. Wenn das aktuelle w7 APPLICATION-Dokument im ROM abgelegt wird, darf der INIT-Parameter nicht vorhanden sein.

Hinweis

Dieser Knoten ist nur für Mobilfunkanbieter und MDM-Server vorgesehen, die versuchen, dies zu verwenden, schlägt fehl. Dieser Knoten wird im MDM-Registrierungsszenario für Unternehmen nicht unterstützt. Dieser Parameter erzwingt, dass das Gerät versucht, eine Verbindung mit dem OMA DM-Server herzustellen. Der Verbindungsversuch schlägt fehl, wenn der XML-Code während der coldinit-Phase festgelegt wird. Eine häufige Ursache für diesen Fehler ist, dass das Funkgerät unmittelbar nach abschluss von coldinit noch nicht bereit ist.

  INITIALBACKOFFTIME Optional. Der INITIALBACKOFFTIME-Parameter wird im APPLICATION-Merkmal verwendet, um die anfängliche Wartezeit in Millisekunden anzugeben, wenn der DM-Client zum ersten Mal versucht. Die Wartezeit nimmt exponentiell zu. Dieser Parameter akzeptiert einen numerischen Wert im Zeichenfolgenformat. Der Standardwert ist "16000". Sie können diesen Parameter abrufen oder festlegen.

MAXBACKOFFTIME Optional. Der PARAMETER MAXBACKOFFTIME wird im APPLICATION-Merkmal verwendet, um die maximale Anzahl von Millisekunden für den Ruhezustand nach einem Paketversandfehler anzugeben. Dieser Parameter akzeptiert einen numerischen Wert im Zeichenfolgenformat. Der Standardwert ist "86400000". Sie können diesen Parameter festlegen.

NAMEN Optional. Der NAME-Parameter wird im APPLICATION-Merkmal verwendet, um eine vom Benutzer lesbare Anwendungsidentität anzugeben. Dieser Parameter wird verwendet, um einen Teil des Registrierungspfads für die APPLICATION-Parameter zu definieren. Sie können diesen Parameter festlegen.

Der NAME-Parameter kann eine Zeichenfolge oder NULL (kein Wert) sein. Wenn kein Wert angegeben wird, wird der Registrierungsspeicherort standardmäßig unbenannt <>verwendet.

PROTOVER Optional. Der PROTOVER-Parameter wird im APPLICATION-Merkmal verwendet, um die vom Server unterstützte Version des OMA DM-Protokolls anzugeben. Es wird kein Standardwert angenommen. Die von diesem Knoten festgelegte Protokollversion stimmt mit der Protokollversion überein, die der DM-Client an den Server in SyncHdr in Paket 1 meldet. Wenn dieser Knoten beim Hinzufügen eines DM-Serverkontos nicht angegeben wird, wird die neueste DM-Protokollversion verwendet, die vom Client unterstützt wird. In Windows Phone ist diese Version 1.2. Dieser Parameter ist ein benutzerdefinierter Microsoft-Parameter. Sie können diesen Parameter festlegen.

Mögliche Werte:

  • 1.1
  • 1.2

ANBIETER-ID Optional. Der PROVIDER-ID-Parameter wird im APPLICATION-Merkmal verwendet, um OMA DM-Server zu unterscheiden. Sie gibt den Serverbezeichner für einen Verwaltungsserver an, der in der aktuellen Verwaltungssitzung verwendet wird. Dieser Parameter zeichnet einen Zeichenfolgenwert auf. Sie können diesen Parameter festlegen.

ROLLE Optional. Der ROLE-Parameter wird im APPLICATION-Merkmal verwendet, um die Sicherheitsanwendungskammer anzugeben, mit der die DM-Sitzung bei der Kommunikation mit dem DM-Server ausgeführt werden soll. Die einzigen unterstützten Rollen sind 8 (Mobilfunkanbieter) und 32 (Unternehmen). Wenn dieser Parameter nicht vorhanden ist, wird die Rolle des Mobilfunkanbieters angenommen. Die Unternehmensrolle kann nur vom Unternehmensregistrierungsclient festgelegt werden. Der Unternehmensclient kann die Rolle "Mobilfunkanbieter" nicht festlegen. Dieser Parameter ist ein benutzerdefinierter Microsoft-Parameter. Dieser Parameter akzeptiert einen numerischen Wert im Zeichenfolgenformat. Sie können diesen Parameter abrufen oder festlegen.

TO-NAPID Optional. Der TO-NAPID-Parameter wird im APPLICATION-Merkmal verwendet, um den Netzwerkzugriffspunkt anzugeben, den der Client zum Herstellen einer Verbindung mit dem OMA DM-Server verwendet. Wenn mehrere TO-NAPID-Parameter angegeben werden, wird nur der erste TO-NAPID-Wert gespeichert. Dieser Parameter zeichnet einen Zeichenfolgenwert auf. Sie können diesen Parameter festlegen.

USEHWDEVID Optional. Der USEHWDEVID-Parameter wird im APPLICATION-Merkmal verwendet, um die Verwendung der Gerätehardwareidentifikation anzugeben. Es hat keinen Wert.

  • Wenn der Parameter nicht vorhanden ist, besteht das Standardverhalten darin, anstelle der Hardwaregeräte-ID eine anwendungsspezifische GUID zu verwenden.
  • Wenn der Parameter vorhanden ist, wird die Hardwaregeräte-ID im Knoten ./DevInfo/DevID und im Quell-LocURI für das dm-Paket angegeben, das an den Server gesendet wird. International Mobile Subscriber Identity (IMEI) wird für ein GSM-Gerät zurückgegeben.

SSLCLIENTCERTSEARCHCRITERIA Optional. Der Parameter SSLCLIENTCERTSEARCHCRITERIA wird im APPLICATION-Merkmal verwendet, um die Suchkriterien für Clientzertifikate anzugeben. Dieser Parameter unterstützt die Suche nach Antragstellerattributen und Zertifikatspeichern. Wenn andere Kriterien angegeben werden, wird dies ignoriert.

Die Zeichenfolge ist eine Verkettung von Name-Wert-Paaren, wobei jedes Element des Paars durch das Zeichen "&" getrennt ist. Der Name und die Werte werden durch das Zeichen "=" getrennt. Wenn mehrere Werte vorhanden sind, wird jeder Wert durch das Unicode-Zeichen "U+F000" getrennt. Wenn der Name oder Wert Zeichen enthält, die nicht im UNRESERVED-Satz enthalten sind (wie in RFC2396 angegeben), werden diese Zeichen gemäß RFC mit URI-Escapezeichen versehen.

Die unterstützten Namen sind Betreff und Stores. Die Suche nach Einem Wildcardzertifikat wird nicht unterstützt.

Stores gibt an, welche Zertifikatspeicher der DM-Client sucht, um das SSL-Clientzertifikat zu finden. Der gültige Speicherwert ist My%5CUser. Beim Namen des Speichers wird die Groß-/Kleinschreibung nicht beachtet.   Subject gibt das zertifikat an, nach dem gesucht werden soll. Um beispielsweise anzugeben, dass Sie ein Zertifikat mit einem bestimmten Subject-Attribut ("CN=Tester,O=Microsoft") verwenden möchten, verwenden Sie Folgendes:

Hinweis

%EF%80%80 ist das UTF8-codierte Zeichen U+F000.

<parm name="SSLCLIENTCERTSEARCHCRITERIA"
   value="Subject=CN%3DTester,O%3DMicrosoft&amp;Stores=My%5CUser" />

Referenz zum Konfigurationsdienstanbieter