Fournisseur de services de configuration w7 APPLICATION
Le tableau ci-dessous montre l’applicabilité de Windows :
Édition | Windows 10 | Windows 11 |
---|---|---|
Accueil | Oui | Oui |
Pro | Oui | Oui |
Windows SE | Non | Oui |
Entreprise | Oui | Oui |
Enterprise | Oui | Oui |
Éducation | Oui | Oui |
Le fournisseur de services de configuration d’APPLICATION qui a un APPID de w7 est utilisé pour démarrer un appareil avec un compte OMA DM. Bien que ce fournisseur de services de configuration soit utilisé pour configurer un compte OMA DM, il est géré via l’approvisionnement du client OMA.
Remarque
Ce fournisseur de services de configuration nécessite l’accès aux fonctionnalités ID_CAP_CSP_FOUNDATION et ID_CAP_DEVICE_MANAGEMENT_ADMIN à partir d’une application de configuration réseau.
L’exemple suivant montre le fournisseur de services de configuration au format d’arborescence utilisé par l’approvisionnement du client OMA.
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
Remarque
Tous les noms de paramètres et types caractéristiques respectent la casse et doivent utiliser tous les majuscules. Les informations d’identification APPSRV et CLIENT doivent être fournies dans le code XML d’approvisionnement.
APPADDR Cette caractéristique est utilisée dans la caractéristique application w7 pour spécifier l’adresse du serveur DM.
APPADDR/ADDR Optionnel. Le paramètre ADDR est utilisé dans la caractéristique APPADDR pour obtenir ou définir l’adresse du serveur DM OMA. Ce paramètre utilise une valeur de chaîne.
APPADDR/ADDRTYPE Optionnel. Le paramètre ADDRTYPE est utilisé dans la caractéristique APPADDR pour obtenir ou définir le format du paramètre ADDR. Ce paramètre utilise une valeur de chaîne.
Dans OMA DM XML, s’il existe plusieurs instances de ce paramètre, la première valeur de paramètre valide est utilisée.
APPADDR/PORT Cette caractéristique est utilisée dans la caractéristique APPADDR pour spécifier les informations de port.
APPADDR/PORT/PORTNBR Obligatoire. Le paramètre PORTNBR est utilisé dans la caractéristique PORT pour obtenir ou définir le numéro du port auquel se connecter. Ce paramètre prend une valeur numérique au format chaîne.
APPAUTH Cette caractéristique est utilisée dans la caractéristique w7 APPLICATION pour spécifier les informations d’authentification.
APPAUTH/AAUTHDATA Optionnel. Le paramètre AAUTHDATA est utilisé dans la caractéristique APPAUTH pour obtenir ou définir davantage de données utilisées dans l’authentification. Ce paramètre est utilisé pour transmettre le nonce pour le type d’authentification Digest. Ce paramètre utilise une valeur de chaîne. La valeur de ce paramètre est codée en base64 sous la forme d’une série d’octets. Si AAUTHTYPE est DIGEST, cette valeur est utilisée comme valeur nonce dans le calcul de hachage MD5, et la forme octale des données binaires doit être utilisée lors du calcul du hachage côté serveur et côté appareil.
APPAUTH/AAUTHLEVEL Obligatoire. Le paramètre AAUTHLEVEL est utilisé dans la caractéristique APPAUTH pour indiquer si les informations d’identification sont destinées à l’authentification du serveur ou au client. Ce paramètre utilise une valeur de chaîne. Vous pouvez définir cette valeur.
Valeurs valides :
APPSRV : spécifie que le client s’authentifie auprès du serveur DM OMA au niveau du protocole DM.
CLIENT : spécifie que le serveur s’authentifie auprès du client OMA DM au niveau du protocole DM.
APPAUTH/AAUTHNAME Optionnel. Le paramètre AAUTHNAME est utilisé dans la caractéristique APPAUTH pour différencier les noms de clients OMA DM. Ce paramètre utilise une valeur de chaîne. Vous pouvez définir cette valeur.
APPAUTH/AAUTHSECRET Obligatoire. Le paramètre AAUTHSECRET est utilisé dans la caractéristique APPAUTH pour obtenir ou définir le secret d’authentification utilisé pour authentifier l’utilisateur. Ce paramètre utilise une valeur de chaîne.
APPAUTH/AAUTHTYPE Optionnel. Le paramètre AAUTHTYPE de la caractéristique APPAUTH est utilisé pour obtenir ou définir la méthode d’authentification. Ce paramètre utilise une valeur de chaîne.
Valeurs valides :
- BASIC : spécifie le type d’authentification SyncML DM « syncml :auth-basic ».
- DIGEST : spécifie le type d’authentification SyncML DM « syncml :auth-md5 ».
- Quand AAUTHLEVEL a la valeur CLIENT, AAUTHTYPE doit être DIGEST. Quand AAUTHLEVEL a la valeur APPSRV, AAUTHTYPE peut être de base ou DIGEST.
APPID Obligatoire. Le paramètre APPID est utilisé dans la caractéristique APPLICATION pour différencier les types de services et de protocoles d’application disponibles. Ce paramètre utilise une valeur de chaîne. Vous pouvez obtenir ou définir cette valeur. La seule valeur valide pour configurer l’APPID d’amorçage du client OMA est w7.
BACKCOMPATRETRYDISABLED Optionnel. Le paramètre BACKCOMPATRETRYDISABLED est utilisé dans la caractéristique APPLICATION pour spécifier s’il faut réessayer de renvoyer un package avec une version de protocole antérieure (par exemple, 1.1) dans syncHdr (sans inclure la première fois).
Remarque
Ce paramètre ne contient pas de valeur. L’existence de ce paramètre signifie que la nouvelle tentative de compatibilité descendante est désactivée. Si le paramètre est manquant, cela signifie que la nouvelle tentative de compatibilité descendante est activée.
CONNRETRYFREQ Optionnel. Le paramètre CONNRETRYFREQ est utilisé dans la caractéristique APPLICATION pour spécifier le nombre de nouvelles tentatives effectuées par le client DM en cas d’erreurs de niveau Gestionnaire des connexions ou de niveau WinInet. Ce paramètre prend une valeur numérique au format chaîne. La valeur par défaut est « 3 ». Vous pouvez définir ce paramètre.
DEFAULTENCODING Optionnel. Le paramètre DEFAULTENCODING est utilisé dans la caractéristique APPLICATION pour spécifier si le client DM doit utiliser WBXML ou XML pour le package DM lors de la communication avec le serveur. Vous pouvez obtenir ou définir ce paramètre.
Les valeurs valides sont les suivantes :
- application/vnd.syncml.dm+xml (par défaut)
- application/vnd.syncml.dm+wbxml
INIT Optionnel. Le paramètre INIT est utilisé dans la caractéristique APPLICATION pour indiquer que le serveur d’administration souhaite que le client lance une session de gestion immédiatement après l’approbation des paramètres. Si le document w7 APPLICATION actuel est placé dans rom, le paramètre INIT ne doit pas être présent.
Remarque
Ce nœud est uniquement destiné aux opérateurs mobiles et aux serveurs GPM qui essaient d’utiliser ce nœud échoue. Ce nœud n’est pas pris en charge dans le scénario d’inscription mdm d’entreprise. Ce paramètre force l’appareil à tenter de se connecter au serveur DM OMA. La tentative de connexion échoue si le code XML est défini pendant la phase coldinit. Une cause courante de cet échec est que immédiatement après coldinit est terminé, la radio n’est pas encore prête.
INITIALBACKOFFTIME Optionnel. Le paramètre INITIALBACKOFFTIME est utilisé dans la caractéristique APPLICATION pour spécifier le temps d’attente initial en millisecondes lorsque le client DM effectue une nouvelle tentative pour la première fois. Le temps d’attente augmente de façon exponentielle. Ce paramètre prend une valeur numérique au format chaîne. La valeur par défaut est « 16000 ». Vous pouvez obtenir ou définir ce paramètre.
MAXBACKOFFTIME Optionnel. Le paramètre MAXBACKOFFTIME est utilisé dans la caractéristique APPLICATION pour spécifier le nombre maximal de millisecondes à mettre en veille après l’échec de l’envoi du package. Ce paramètre prend une valeur numérique au format chaîne. La valeur par défaut est « 86400000 ». Vous pouvez définir ce paramètre.
NOM Optionnel. Le paramètre NAME est utilisé dans la caractéristique APPLICATION pour spécifier une identité d’application lisible par l’utilisateur. Ce paramètre est utilisé pour définir une partie du chemin d’accès du Registre pour les paramètres APPLICATION. Vous pouvez définir ce paramètre.
Le paramètre NAME peut être une chaîne ou null (aucune valeur). Si aucune valeur n’est spécifiée, l’emplacement du Registre est par défaut <sans nom>.
PROTOVER Optionnel. Le paramètre PROTOVER est utilisé dans la caractéristique APPLICATION pour spécifier la version du protocole OMA DM prise en charge par le serveur. Aucune valeur par défaut n’est supposée. La version de protocole définie par ce nœud correspond à la version de protocole que le client DM signale au serveur dans SyncHdr dans le package 1. Si ce nœud n’est pas spécifié lors de l’ajout d’un compte de serveur DM, la dernière version du protocole DM prise en charge par le client est utilisée. Dans Windows Phone, cette version est 1.2. Ce paramètre est un paramètre personnalisé Microsoft. Vous pouvez définir ce paramètre.
Valeurs possibles :
- 1.1
- 1.2
PROVIDER-ID Optionnel. Le paramètre PROVIDER-ID est utilisé dans la caractéristique APPLICATION pour différencier les serveurs DM OMA. Il spécifie l’identificateur du serveur d’administration utilisé dans la session de gestion actuelle. Ce paramètre utilise une valeur de chaîne. Vous pouvez définir ce paramètre.
RÔLE Optionnel. Le paramètre ROLE est utilisé dans la caractéristique APPLICATION pour spécifier la chambre d’application de sécurité avec laquelle la session DM doit s’exécuter lors de la communication avec le serveur DM. Les seuls rôles pris en charge sont 8 (opérateur mobile) et 32 (entreprise). Si ce paramètre n’est pas présent, le rôle d’opérateur mobile est supposé. Le rôle d’entreprise ne peut être défini que par le client d’inscription d’entreprise. Le client d’entreprise ne peut pas définir le rôle d’opérateur mobile. Ce paramètre est un paramètre personnalisé Microsoft. Ce paramètre prend une valeur numérique au format chaîne. Vous pouvez obtenir ou définir ce paramètre.
TO-NAPID Optionnel. Le paramètre TO-NAPID est utilisé dans la caractéristique APPLICATION pour spécifier le point d’accès réseau que le client utilisera pour se connecter au serveur DM OMA. Si plusieurs paramètres TO-NAPID sont spécifiés, seule la première valeur TO-NAPID est stockée. Ce paramètre utilise une valeur de chaîne. Vous pouvez définir ce paramètre.
USEHWDEVID Optionnel. Le paramètre USEHWDEVID est utilisé dans la caractéristique APPLICATION pour spécifier l’utilisation de l’identification matérielle de l’appareil. Il n’a pas de valeur.
- Si le paramètre n’est pas présent, le comportement par défaut consiste à utiliser un GUID spécifique à l’application utilisé plutôt que l’ID de périphérique matériel.
- Si le paramètre est présent, l’ID de périphérique matériel est fourni au niveau du nœud ./DevInfo/DevID et dans le LocURI source pour le package DM envoyé au serveur. L’identité IMEI (International Mobile Subscriber Identity) est retournée pour un appareil GSM.
SSLCLIENTCERTSEARCHCRITERIA Optionnel. Le paramètre SSLCLIENTCERTSEARCHCRITERIA est utilisé dans la caractéristique APPLICATION pour spécifier les critères de recherche de certificat client. Ce paramètre prend en charge la recherche par attribut d’objet et magasins de certificats. Si d’autres critères sont fournis, ils sont ignorés.
La chaîne est une concaténation de paires nom/valeur, chaque membre de la paire délimité par le caractère « & ». Le nom et les valeurs sont délimités par le caractère « = ». S’il existe plusieurs valeurs, chaque valeur est délimitée par le caractère Unicode « U+F000 ». Si le nom ou la valeur contient des caractères qui ne figurent pas dans le jeu UNRESERVED (comme spécifié dans RFC2396), ces caractères sont placés dans une séquence d’échappement d’URI conformément à la RFC.
Les noms pris en charge sont Subject et Stores ; La recherche de certificat générique n’est pas prise en charge.
Stores spécifie le certificat qui stocke le client DM pour rechercher le certificat client SSL. La valeur de magasin valide est My%5CUser. Le nom du magasin ne respecte pas la casse. Subject spécifie le certificat à rechercher. Par exemple, pour spécifier que vous souhaitez un certificat avec un attribut Subject particulier (« CN=Tester,O=Microsoft »), utilisez ce qui suit :
Remarque
%EF%80%80
est le caractère encodé en UTF8 U+F000.
<parm name="SSLCLIENTCERTSEARCHCRITERIA"
value="Subject=CN%3DTester,O%3DMicrosoft&Stores=My%5CUser" />
Rubriques connexes
Informations de référence sur les fournisseurs de services de configuration