Fournisseur de services de configuration Wi-Fi

Le fournisseur de services de configuration Wi-Fi fournit la fonctionnalité permettant d’ajouter ou de supprimer des réseaux Wi-Fi sur un appareil Windows. Le fournisseur de services de configuration accepte l’entrée SyncML et la convertit en profil réseau installé sur l’appareil. Ce profil permet à l’appareil de se connecter au réseau Wi-Fi lorsqu’il est à portée.

Considérations relatives à la programmation :

• Si la méthode d’authentification a besoin d’un certificat (par exemple, des certificats clients pour EAP-TLS), vous devez le configurer via le fournisseur de services de configuration CertificateStore . Le fournisseur de services de configuration Wi-Fi ne fournit pas cette fonctionnalité ; au lieu de cela, le profil Wi-Fi peut spécifier les caractéristiques du certificat à utiliser pour choisir le certificat approprié pour ce réseau. Le serveur doit d’abord inscrire correctement le certificat avant de déployer la configuration réseau Wi-Fi. Par exemple, pour un profil EAP-TLS, le serveur doit configurer et inscrire correctement le certificat client requis avant de déployer le profil Wi-Fi. Le certificat auto-signé fonctionne pour EAP-TLS/PEAP-MSCHAPv2, mais il n’est pas pris en charge dans EAP-TLS.
• Pour les réseaux WEP, WPA et WPA2, incluez la clé d’accès dans la configuration réseau en texte clair. La clé d’accès est chiffrée automatiquement lorsqu’elle est stockée sur l’appareil.
• La SSID partie du nœud LocURI doit être un URI valide basé sur RFC 2396. Cette condition nécessite que tous les caractères ASCII non inclus soient placés dans une séquence d’échappement à l’aide d’un %-character, y compris en remplaçant le caractère d’espace (' ') par ' %20'. Les caractères (y compris Unicode) sans échappement nécessaire ne sont pas pris en charge.
• Pour le fournisseur de services de configuration Wi-Fi, vous ne pouvez pas utiliser la commande Remplacer, sauf si le nœud existe déjà.
• L’utilisation Proxyde ou ProxyPacUrlProxyWPAD dans les éditions clientes Windows (Famille, Professionnel, Entreprise et Éducation) peut échouer ou n’avoir aucun effet. Utilisez le fournisseur de services de configuration NetworkProxy à la place.

La liste suivante présente les nœuds du fournisseur de services de configuration Wi-Fi :

• ./Device/Vendor/MSFT/WiFi
  • Profil
    • {SSID}
      • ProfileSource
      • Proxy
      • ProxyPacUrl
      • ProxyWPAD
      • WiFiCost
      • WlanXml
• ./User/Vendor/MSFT/WiFi
  • Profil
    • {SSID}
      • ProfileSource
      • Proxy
      • ProxyPacUrl
      • ProxyWPAD
      • WiFiCost
      • WlanXml

Appareil/profil

./Device/Vendor/MSFT/WiFi/Profile

Identifie la configuration réseau Wi-Fi. Chaque configuration réseau Wi-Fi est représentée par un objet de profil. Ce profil réseau inclut toutes les informations requises pour que l’appareil se connecte à ce réseau, par exemple, le SSID, les méthodes d’authentification et de chiffrement et la phrase secrète dans le cas de réseaux WEP ou WPA2.

Propriétés de l’infrastructure de description :

Appareil/Profil/{SSID}

./Device/Vendor/MSFT/WiFi/Profile/{SSID}

Nom du profil du réseau Wi-Fi. Il est ajouté lorsque le nœud WlanXml est ajouté et supprimé lorsque WlanXml est supprimé.

Spécifie le nom de profil du réseau Wi-Fi (32 octets maximum) à créer, configurer, interroger ou supprimer. Le nom respecte la casse et peut être représenté en ASCII. Dans l’URI, il doit être %-escaped, mais la valeur non- %-escaped est utilisée à l’intérieur du système.

Le nom du profil peut être identique ou différent du SSID du réseau réel en cours de diffusion (qui se trouve sous <WLANProfile> <SSIDConfig> <SSID> <name>). Par exemple, le SSID de diffusion peut être « CC_Corp_7 », mais le nom du profil peut être « ContosoWiFi ».

Propriétés de l’infrastructure de description :

Dans l’exemple suivant, le profil « ContosoWiFi » est ajouté, ciblant le SSID « CC_Corp_7 ». Le reste du profil est omis par souci de concision. Pour obtenir des exemples complets, consultez Ajouter un réseau.

<Atomic>
  <CmdID>300</CmdID>
  <Add>
    <CmdID>301</CmdID>
    <Item>
      <Target>
        <LocURI>./Vendor/MSFT/WiFi/Profile/ContosoWiFi/WlanXml</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data><![CDATA[<?xml version="1.0"?><WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1"><name>ContosoWiFi</name><SSIDConfig><SSID><name>CC_Corp_7</name></SSID></SSIDConfig>{...}</WLANProfile>]]></Data>
    </Item>
  </Add>
</Atomic>

Appareil/Profil/{SSID}/ProfileSource

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/ProfileSource

Permet de définir l’entité administrative qui définit ce profil Wi-Fi. Il peut actuellement être défini sur 0=Enterprise ou 1=Mobile Operator.

Propriétés de l’infrastructure de description :

Valeurs autorisées:

Appareil/Profil/{SSID}/Proxy

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/Proxy

Nœud facultatif. Le format est url :port. Configuration du proxy réseau (le cas échéant).

Propriétés de l’infrastructure de description :

Appareil/Profil/{SSID}/ProxyPacUrl

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/ProxyPacUrl

Nœud facultatif. URL de l’emplacement du fichier PAC.

Propriétés de l’infrastructure de description :

Appareil/Profil/{SSID}/ProxyWPAD

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/ProxyWPAD

Nœud facultatif. La présence du champ active WPAD pour la recherche de proxy.

Propriétés de l’infrastructure de description :

Valeurs autorisées:

Appareil/Profil/{SSID}/WiFiCost

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/WiFiCost

Nœud facultatif. Si la stratégie est active, sélectionnez l’une des valeurs de la liste suivante pour définir le coût de la connexion WLAN pour le profil Wi-Fi. (1 :Sans restriction - connexion illimitée, 2 : Fixe - contraintes de capacité jusqu’à une certaine limite de données, 3 : Variable - facturée sur par octet de base) Comportement par défaut : non restreint.

Propriétés de l’infrastructure de description :

Valeurs autorisées:

Appareil/Profil/{SSID}/WlanXml

./Device/Vendor/MSFT/WiFi/Profile/{SSID}/WlanXml

XML décrivant la configuration réseau et suit le schéma windows WLAN_profile.

Lien vers le schéma : https://msdn.microsoft.com/library/windows/desktop/ms707341(v=vs.85).aspx

Le code XML du profil doit être placé dans une séquence d’échappement, comme indiqué dans les exemples suivants.

S’il existe dans l’objet blob, les éléments keyType et protégés doivent être antérieurs à keyMaterial, comme illustré dans l’exemple dans WPA2-Personal Profile Sample.

Propriétés de l’infrastructure de description :

Pour obtenir des exemples, consultez Ajouter un réseau .

Utilisateur/Profil

./User/Vendor/MSFT/WiFi/Profile

Identifie la configuration réseau Wi-Fi. Chaque configuration réseau Wi-Fi est représentée par un objet de profil. Ce profil réseau inclut toutes les informations requises pour que l’appareil se connecte à ce réseau, par exemple, le SSID, les méthodes d’authentification et de chiffrement et la phrase secrète dans le cas de réseaux WEP ou WPA2.

Propriétés de l’infrastructure de description :

Utilisateur/Profil/{SSID}

./User/Vendor/MSFT/WiFi/Profile/{SSID}

Nom du profil du réseau Wi-Fi. Il est ajouté lorsque le nœud WlanXml est ajouté et supprimé lorsque WlanXml est supprimé.

Pour plus d’informations, consultez Appareil/Profil/{SSID}.

Propriétés de l’infrastructure de description :

Utilisateur/Profil/{SSID}/ProfileSource

./User/Vendor/MSFT/WiFi/Profile/{SSID}/ProfileSource

Permet de définir l’entité administrative qui définit ce profil Wi-Fi. Il peut actuellement être défini sur 0=Enterprise ou 1=Mobile Operator.

Propriétés de l’infrastructure de description :

Valeurs autorisées:

Utilisateur/Profil/{SSID}/Proxy

./User/Vendor/MSFT/WiFi/Profile/{SSID}/Proxy

Nœud facultatif. Le format est url :port. Configuration du proxy réseau (le cas échéant).

Propriétés de l’infrastructure de description :

Utilisateur/Profil/{SSID}/ProxyPacUrl

./User/Vendor/MSFT/WiFi/Profile/{SSID}/ProxyPacUrl

Nœud facultatif. URL de l’emplacement du fichier PAC.

Propriétés de l’infrastructure de description :

Utilisateur/Profil/{SSID}/ProxyWPAD

./User/Vendor/MSFT/WiFi/Profile/{SSID}/ProxyWPAD

Nœud facultatif. La présence du champ active WPAD pour la recherche de proxy.

Propriétés de l’infrastructure de description :

Valeurs autorisées:

Utilisateur/Profil/{SSID}/WiFiCost

./User/Vendor/MSFT/WiFi/Profile/{SSID}/WiFiCost

Nœud facultatif. Si la stratégie est active, sélectionnez l’une des valeurs de la liste suivante pour définir le coût de la connexion WLAN pour le profil Wi-Fi. (1 :Sans restriction - connexion illimitée, 2 : Fixe - contraintes de capacité jusqu’à une certaine limite de données, 3 : Variable - facturée sur par octet de base) Comportement par défaut : non restreint.

Propriétés de l’infrastructure de description :

Valeurs autorisées:

Utilisateur/Profil/{SSID}/WlanXml

./User/Vendor/MSFT/WiFi/Profile/{SSID}/WlanXml

XML décrivant la configuration réseau et suit le schéma windows WLAN_profile.

Lien vers le schéma : https://msdn.microsoft.com/library/windows/desktop/ms707341(v=vs.85).aspx

Pour plus d’informations, consultez Device/Profile/{SSID}/WlanXml.

Propriétés de l’infrastructure de description :

Exemples

Ces exemples XML montrent comment effectuer diverses tâches à l’aide d’OMA DM.

Ajouter un réseau

L’exemple suivant montre comment ajouter un réseau WPA2-Enterprise avec un SSID et un nom MyNetwork de profil qui s’authentifie auprès de PEAP-MSCHAPv2. Cet exemple est basé sur l’exemple de profil wpa2-Enterprise avec PEAP-MSCHAPv2 exemple de profil.

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Atomic>
      <CmdID>301</CmdID>
      <Add>
        <CmdID>302</CmdID>
        <Item>
          <Target>
            <LocURI>./Vendor/MSFT/WiFi/Profile/MyNetwork/WlanXml</LocURI>
          </Target>
          <Meta>
            <Format xmlns="syncml:metinf">chr</Format>
          </Meta>
          <Data><![CDATA[<?xml version="1.0"?><WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1"><name>MyNetwork</name><SSIDConfig><SSID><hex>4d794e6574776f726b</hex><name>MyNetwork</name></SSID><nonBroadcast>false</nonBroadcast></SSIDConfig><connectionType>ESS</connectionType><connectionMode>manual</connectionMode><MSM><security><authEncryption><authentication>WPA2</authentication><encryption>AES</encryption><useOneX>true</useOneX></authEncryption><OneX xmlns="http://www.microsoft.com/networking/OneX/v1"><authMode>user</authMode><EAPConfig><EapHostConfig xmlns="http://www.microsoft.com/provisioning/EapHostConfig"><EapMethod><Type xmlns="http://www.microsoft.com/provisioning/EapCommon">25</Type><VendorId xmlns="http://www.microsoft.com/provisioning/EapCommon">0</VendorId><VendorType xmlns="http://www.microsoft.com/provisioning/EapCommon">0</VendorType><AuthorId xmlns="http://www.microsoft.com/provisioning/EapCommon">0</AuthorId></EapMethod><Config xmlns="http://www.microsoft.com/provisioning/EapHostConfig"><Eap xmlns="http://www.microsoft.com/provisioning/BaseEapConnectionPropertiesV1"><Type>25</Type><EapType xmlns="http://www.microsoft.com/provisioning/MsPeapConnectionPropertiesV1"><ServerValidation><DisableUserPromptForServerValidation>true</DisableUserPromptForServerValidation><ServerNames></ServerNames></ServerValidation><FastReconnect>true</FastReconnect><InnerEapOptional>false</InnerEapOptional><Eap xmlns="http://www.microsoft.com/provisioning/BaseEapConnectionPropertiesV1"><Type>26</Type><EapType xmlns="http://www.microsoft.com/provisioning/MsChapV2ConnectionPropertiesV1"><UseWinLogonCredentials>false</UseWinLogonCredentials></EapType></Eap><EnableQuarantineChecks>false</EnableQuarantineChecks><RequireCryptoBinding>false</RequireCryptoBinding><PeapExtensions><PerformServerValidation xmlns="http://www.microsoft.com/provisioning/MsPeapConnectionPropertiesV2">false</PerformServerValidation><AcceptServerName xmlns="http://www.microsoft.com/provisioning/MsPeapConnectionPropertiesV2">false</AcceptServerName></PeapExtensions></EapType></Eap></Config></EapHostConfig></EAPConfig></OneX></security></MSM></WLANProfile>]]></Data>
        </Item>
      </Add>
    </Atomic>
    <Final/>
  </SyncBody>
</SyncML>

L’exemple suivant montre comment ajouter un réseau WPA3-Enterprise avec un nom My Network de profil et un SSID MySSID qui s’authentifie auprès d’EAP-TLS. Cet exemple est basé sur l’exemple de profil wpa2-Enterprise avec l’exemple de profil TLS.

<Atomic>
  <CmdID>300</CmdID>
  <Add>
    <CmdID>301</CmdID>
    <Item>
      <Target>
        <LocURI>./Vendor/MSFT/WiFi/Profile/My%20Network/WlanXml</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data><![CDATA[<?xml version="1.0"?><WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1"><name>My Network</name><SSIDConfig><SSID><name>MySSID</name></SSID></SSIDConfig><connectionType>ESS</connectionType><connectionMode>auto</connectionMode><MSM><security><authEncryption><authentication>WPA3ENT</authentication><encryption>AES</encryption><useOneX>true</useOneX></authEncryption><PMKCacheMode>enabled</PMKCacheMode><PMKCacheTTL>720</PMKCacheTTL><PMKCacheSize>128</PMKCacheSize><preAuthMode>disabled</preAuthMode><OneX xmlns="http://www.microsoft.com/networking/OneX/v1"><authMode>machine</authMode><EAPConfig><EapHostConfig xmlns="http://www.microsoft.com/provisioning/EapHostConfig"><EapMethod><Type xmlns="http://www.microsoft.com/provisioning/EapCommon">13</Type><VendorId xmlns="http://www.microsoft.com/provisioning/EapCommon">0</VendorId><VendorType xmlns="http://www.microsoft.com/provisioning/EapCommon">0</VendorType><AuthorId xmlns="http://www.microsoft.com/provisioning/EapCommon">0</AuthorId></EapMethod><Config xmlns="http://www.microsoft.com/provisioning/EapHostConfig"><Eap xmlns="http://www.microsoft.com/provisioning/BaseEapConnectionPropertiesV1"><Type>13</Type><EapType xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV1"><CredentialsSource><CertificateStore><SimpleCertSelection>true</SimpleCertSelection></CertificateStore></CredentialsSource><ServerValidation><DisableUserPromptForServerValidation>true</DisableUserPromptForServerValidation><ServerNames></ServerNames><TrustedRootCA>00 11 22 33 44 55 66 77 88 99 aa bb cc dd ee ff 00 11 22 33</TrustedRootCA></ServerValidation><DifferentUsername>false</DifferentUsername><PerformServerValidation xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV2">true</PerformServerValidation><AcceptServerName xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV2">false</AcceptServerName><TLSExtensions xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV2"><FilteringInfo xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV3"><AllPurposeEnabled>false</AllPurposeEnabled><CAHashList Enabled="true"><IssuerHash>00112233445566778899aabbccddeeff00112233</IssuerHash></CAHashList><EKUMapping><EKUMap><EKUName>Client Authentication</EKUName><EKUOID>1.3.6.1.5.5.7.3.2</EKUOID></EKUMap></EKUMapping><ClientAuthEKUList Enabled="true"><EKUMapInList><EKUName>Client Authentication</EKUName></EKUMapInList></ClientAuthEKUList></FilteringInfo></TLSExtensions></EapType></Eap></Config></EapHostConfig></EAPConfig></OneX></security></MSM></WLANProfile>]]></Data>
    </Item>
  </Add>
</Atomic>

L’exemple suivant montre comment ajouter un réseau WPA3-Personal (mode transition) avec un nom de profil et un SSID MyNetwork qui inclut la phrase secrète TestPassword1!. Cet exemple est basé sur l’exemple de profil dans WPA3-Personal avec l’exemple de profil en mode transition.

<Atomic>
  <CmdID>300</CmdID>
  <Add>
    <CmdID>301</CmdID>
    <Item>
      <Target>
        <LocURI>./Vendor/MSFT/WiFi/Profile/MyNetwork/WlanXml</LocURI>
      </Target>
      <Meta>
        <Format xmlns="syncml:metinf">chr</Format>
      </Meta>
      <Data><![CDATA[<?xml version="1.0"?><WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1"><name>MyNetwork</name><SSIDConfig><SSID><name>MyNetwork</name></SSID></SSIDConfig><connectionType>ESS</connectionType><connectionMode>auto</connectionMode><MSM><security><authEncryption><authentication>WPA3SAE</authentication><encryption>AES</encryption><useOneX>false</useOneX><transitionMode xmlns="http://www.microsoft.com/networking/WLAN/profile/v4">true</transitionMode></authEncryption><sharedKey><keyType>passPhrase</keyType><protected>false</protected><keyMaterial>TestPassword1!</keyMaterial></sharedKey></security></MSM></WLANProfile>]]></Data>
    </Item>
  </Add>
</Atomic>

Interroger les profils réseau

L’exemple suivant montre comment interroger Wi-Fi profils installés sur un serveur MDM.

<Get>
   <CmdID>301</CmdID>
   <Item>
      <Target>
         <LocURI>./Vendor/MSFT/WiFi/Profile</LocURI>
      </Target>
   </Item>
</Get>

L’exemple suivant montre la réponse.

<Results>
   <CmdID>3</CmdID>
   <MsgRef>1</MsgRef>
   <CmdRef>301</CmdRef>
   <Item>
      <Source><LocURI>./Vendor/MSFT/WiFi/Profile</LocURI></Source>
      <Meta><Format xmlns="syncml:metinf">node</Format></Meta>
      <Data>TestWLAN1/TestWLAN2</Data>
   </Item>
</Results>

Supprimer un réseau

L’exemple suivant montre comment supprimer un réseau avec un SSID MyNetwork et aucun proxy. La suppression de tous les types d’authentification réseau est effectuée de la même manière.

<Atomic>
  <CmdID>300</CmdID>
  <Delete>
    <CmdID>301</CmdID>
    <Item>
      <Target>
        <LocURI>./Vendor/MSFT/WiFi/Profile/MyNetwork/WlanXml</LocURI>
      </Target>
    </Item>
  </Delete>
</Atomic>

Articles connexes

Informations de référence sur les fournisseurs de services de configuration