Utilizzare un profilo di dispositivo personalizzato per creare un profilo di Wi-Fi con una chiave già condivisa usando Intune

Importante

La gestione dell'amministratore di dispositivi Android è deprecata e non è più disponibile per i dispositivi con accesso a Google Mobile Services (GMS). Se attualmente usi la gestione DA, ti consigliamo di passare a un'altra opzione di gestione Android. La documentazione di supporto e guida rimane disponibile per alcuni dispositivi Android 15 e precedenti senza GMS. Per altre informazioni, vedere Fine del supporto per l'amministratore di dispositivi Android nei dispositivi GMS.

Le chiavi già condivise (PSK) vengono in genere usate per autenticare gli utenti nelle reti WiFi o nelle reti locali wireless (LAN). Con Intune, è possibile creare un criterio di configurazione del dispositivo WiFi usando una chiave già condivisa.

Per creare il profilo, usare la funzionalità per i profili di dispositivo personalizzati all'interno di Intune.

Questa funzionalità si applica a:

Amministratore del dispositivo Android
Dispositivi Android Enterprise di proprietà personale con profilo di lavoro
Windows
Wi-Fi basato su EAP

Aggiungere informazioni Wi-Fi e PSK in un file XML. Quindi, si aggiunge il file XML a un criterio di configurazione del dispositivo personalizzato in Intune. Quando il criterio è pronto, puoi assegnarlo ai dispositivi. Al successivo check-in del dispositivo, viene applicato il criterio e viene creato un profilo Wi-Fi nel dispositivo.

Questo articolo descrive come creare il criterio in Intune e include un esempio XML di un criterio Wi-Fi basato su EAP.

Importante

L'uso di una chiave già condivisa con Windows causa la visualizzazione di un errore di correzione in Intune. Quando si verifica questo errore, il profilo Wi-Fi viene assegnato correttamente al dispositivo e il profilo funziona come previsto.
Se si esporta un profilo Wi-Fi che include una chiave precondivisa, verificare che il file sia protetto. La chiave è in testo normale. È tua responsabilità proteggere la chiave.

Prerequisiti

Accedi all'interfaccia di amministrazione di Microsoft Intune con un account che abbia il ruolo predefinito Gestione criteri e profili. Per altre informazioni sui ruoli predefiniti, vedere Controllo di accesso in base ai ruoli per Microsoft Intune.

Prima di iniziare

Potrebbe essere più semplice copiare la sintassi XML da un computer che si connette a tale rete, come descritto in Creare il file XML da una connessione Wi-Fi esistente (in questo articolo).
È possibile aggiungere più reti e chiavi aggiungendo altre impostazioni URI OMA.
Per iOS/iPadOS, usare Apple Configurator in una stazione Mac per impostare il profilo.
PSK richiede una stringa di 64 cifre esadecimali o una passphrase tra gli 8 e i 63 caratteri ASCII stampabili. Alcuni caratteri, ad esempio l'asterisco (*), non sono supportati.

Creare un profilo personalizzato

Accedere all'Interfaccia di amministrazione di Microsoft Intune.
Selezionare Dispositivi>Gestisci dispositivi>Configurazione>Crea>Nuovo criterio.
Immettere le proprietà seguenti:
- Piattaforma:scegli la piattaforma.
- Tipo di profilo: seleziona Personalizzato. In caso contrario, selezionare Modelli>personalizzati.
Selezionare Crea.
In Informazioni di base immettere le proprietà seguenti:
- Nome: immettere un nome descrittivo per il criterio. Assegnare ai criteri nomi che possano essere identificati facilmente in un secondo momento. Ad esempio, un nome valido per i criteri è Profilo Wi-Fi personalizzato per Android.
- Descrizione: immettere una descrizione per il profilo. Questa impostazione è facoltativa ma consigliata.
Seleziona Avanti.
In Impostazioni di configurazione selezionare Aggiungi. Aggiungere una nuova impostazione OMA-URI con le proprietà seguenti:
1. Nome: immettere un nome per l'impostazione URI OMA.
2. Descrizione:immettere una descrizione per l'impostazione URI OMA. Questa impostazione è facoltativa ma consigliata.
3. URI OMA: immettere una delle opzioni seguenti:
  - Per Android: ./Vendor/MSFT/WiFi/Profile/{SSID}/Settings
  - Per Windows: ./Vendor/MSFT/WiFi/Profile/{SSID}/WlanXml
  Nota
  - Assicurarsi di includere il carattere punto all'inizio del valore OMA-URI.
  - Se l'SSID dispone di uno spazio, aggiungere uno spazio di escape %20.
  SSID (Service Set Identifier) è il nome di rete Wi-Fi per cui si sta creando il criterio. Questo valore è in genere il nome descrittivo che gli utenti vedono nell'elenco delle connessioni Internet. È possibile che questo nome descrittivo sia diverso dal valore SSID effettivo della rete Wi-Fi. Assicurarsi di immettere il nome descrittivo. Se si esporta un profilo Intune Wi-Fi esistente in XML, il nome descrittivo è elencato in <name><WLANProfile> <name>.
  
  Ad esempio, se il Wi-Fi è denominato Hotspot-1, immettere ./Vendor/MSFT/WiFi/Profile/Hotspot-1/Settings. Se il Wi-Fi è denominato Contoso WiFi, immettere ./Vendor/MSFT/WiFi/Profile/Contoso%20WiFi/Settings (con lo %20spazio di escape).
4. Tipo di dati: Selezionare Stringa.
5. Valore: incollare il codice XML. Vedi gli esempi di Wi-Fi in questo articolo o gli esempi di CSP WiFi, che si basano sugli esempi di profilo wireless. Aggiornare ogni valore in modo corrispondente alle impostazioni di rete. La sezione relativa ai commenti del codice include alcuni puntatori.
6. Selezionare Aggiungi per salvare le modifiche.
Seleziona Avanti.
In Tag ambito (facoltativo) assegnare un tag per filtrare il profilo a gruppi IT specifici, ad esempio US-NC IT Team o JohnGlenn_ITDepartment. Per altre informazioni sui tag degli ambiti, vedere Usare il controllo degli accessi in base al ruolo e i tag di ambito per l'IT distribuito.

Seleziona Avanti.
In Assegnazioni selezionare gli utenti o il gruppo utenti che riceveranno il profilo. Per altre informazioni sull'assegnazione dei profili, vai a Assegnare profili utente e dispositivo.

Nota

Questi criteri possono essere assegnati solo a gruppi di utenti.

Seleziona Avanti.
In Rivedi e crea rivedere le impostazioni. Quando si seleziona Crea, le modifiche vengono salvate e il profilo viene assegnato. Il criterio viene visualizzato anche nell'elenco dei profili.

Alla successiva verifica da parte del dispositivo, vengono applicati i criteri e viene creato un profilo Wi-Fi nel dispositivo. Il dispositivo può quindi connettersi automaticamente alla rete.

Esempio di profilo Wi-Fi Android o Windows

L'esempio seguente include il codice XML per un profilo Wi-Fi Android o Windows. L'esempio è fornito per mostrare il formato corretto e fornire altri dettagli. È solo un esempio e non è da intendersi come configurazione consigliata per l'ambiente.

Informazioni importanti

<protected>false</protected> deve essere impostato su false. Se true, potrebbe far sì che il dispositivo si aspetti una password crittografata e quindi tenti di decrittografarla; che può causare una connessione non riuscita.
<hex>53534944</hex> deve essere impostato sul valore esadecimale di <name><SSID of wifi profile></name>. I dispositivi Windows possono restituire un errore falso x87D1FDE8 Remediation failed , ma il dispositivo contiene ancora il profilo.
XML include caratteri speciali, come ( & e commerciale). L'uso di caratteri speciali può impedire il corretto funzionamento del codice XML.

XML di esempio

<!--
<hex>53534944</hex> = The hexadecimal value of <name><SSID of wifi profile></name>
<Name of wifi profile> = Name of profile shown to users. For example, enter <name>ContosoWiFi</name>.
<SSID of wifi profile> = Plain text of SSID. Does not need to be escaped. It could be <name>Your Company's Network</name>.
<nonBroadcast><true/false></nonBroadcast>
<Type of authentication> = Type of authentication used by the network, such as WPA2PSK.
<Type of encryption> = Type of encryption used by the network, such as AES.
<protected>false</protected> do not change this value, as true could cause device to expect an encrypted password and then try to decrypt it, which can result in a failed connection.
<password> = Plain text of the password to connect to the network
-->

<WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1">
  <name><Name of wifi profile></name>
  <SSIDConfig>
    <SSID>
      <hex>53534944</hex>
 <name><SSID of wifi profile></name>
    </SSID>
    <nonBroadcast>false</nonBroadcast>
  </SSIDConfig>
  <connectionType>ESS</connectionType>
  <connectionMode>auto</connectionMode>
  <autoSwitch>false</autoSwitch>
  <MSM>
    <security>
      <authEncryption>
        <authentication><Type of authentication></authentication>
        <encryption><Type of encryption></encryption>
        <useOneX>false</useOneX>
      </authEncryption>
      <sharedKey>
        <keyType>passPhrase</keyType>
        <protected>false</protected>
        <keyMaterial>password</keyMaterial>
      </sharedKey>
      <keyIndex>0</keyIndex>
    </security>
  </MSM>
</WLANProfile>

Esempio di profilo Wi-Fi basato su EAP

Nell'esempio seguente è incluso il codice XML per un profilo Wi-Fi basato su EAP. L'esempio mostra il formato corretto e fornisce altri dettagli. È solo un esempio e non è da intendersi come configurazione consigliata per l'ambiente.

    <WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1">
      <name>testcert</name>
      <SSIDConfig>
        <SSID>
          <hex>7465737463657274</hex>
          <name>testcert</name>
        </SSID>
        <nonBroadcast>true</nonBroadcast>
      </SSIDConfig>
      <connectionType>ESS</connectionType>
      <connectionMode>auto</connectionMode>
      <autoSwitch>false</autoSwitch>
      <MSM>
        <security>
          <authEncryption>
            <authentication>WPA2</authentication>
            <encryption>AES</encryption>
            <useOneX>true</useOneX>
            <FIPSMode     xmlns="http://www.microsoft.com/networking/WLAN/profile/v2">false</FIPSMode>
          </authEncryption>
          <PMKCacheMode>disabled</PMKCacheMode>
          <OneX xmlns="http://www.microsoft.com/networking/OneX/v1">
            <cacheUserData>false</cacheUserData>
            <authMode>user</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>false</DisableUserPromptForServerValidation>
                        <ServerNames></ServerNames>
                      </ServerValidation>
                      <DifferentUsername>false</DifferentUsername>
                      <PerformServerValidation xmlns="http://www.microsoft.com/provisioning/EapTlsConnectionPropertiesV2">false</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>true</AllPurposeEnabled>
                          <CAHashList Enabled="true">
                            <IssuerHash>75 f5 06 9c a4 12 0e 9b db bc a1 d9 9d d0 f0 75 fa 3b b8 78 </IssuerHash>
                          </CAHashList>
                          <EKUMapping>
                            <EKUMap>
                              <EKUName>Client Authentication</EKUName>
                              <EKUOID>1.3.6.1.5.5.7.3.2</EKUOID>
                            </EKUMap>
                          </EKUMapping>
                          <ClientAuthEKUList Enabled="true"/>
                          <AnyPurposeEKUList Enabled="false">
                            <EKUMapInList>
                              <EKUName>Client Authentication</EKUName>
                            </EKUMapInList>
                          </AnyPurposeEKUList>
                        </FilteringInfo>
                      </TLSExtensions>
                    </EapType>
                  </Eap>
                </Config>
              </EapHostConfig>
            </EAPConfig>
          </OneX>
        </security>
      </MSM>
    </WLANProfile>

Creare il file XML da una connessione Wi-Fi esistente

È possibile creare il file XML da una connessione Wi-Fi esistente. In un computer Windows, eseguire i passaggi seguenti:

Crea una cartella locale per i profili di Wi-Fi esportati, ad esempio c:\WiFi.
Aprire un prompt dei comandi come amministratore (fare clic con il pulsante destro del mouse su cmd>Esegui come amministratore).
Eseguire netsh wlan show profiles. Vengono elencati i nomi di tutti i profili.
Eseguire netsh wlan export profile name="YourProfileName" folder=c:\Wifi. Questo comando crea un file denominato Wi-Fi-YourProfileName.xml in c:\Wifi.
- Se si esporta un profilo Wi-Fi che include una chiave già condivisa, aggiungerlo key=clear al comando. Il key=clear parametro esporta la chiave in testo normale, necessario per utilizzare correttamente il profilo:
  
  netsh wlan export profile name="YourProfileName" key=clear folder=c:\Wifi
- Se l'elemento del profilo <name></name> Wi-Fi esportato include uno spazio, potrebbe restituire un ERROR CODE 0x87d101f4 ERROR DETAILS Syncml(500) errore quando viene assegnato. Quando si verifica questo problema, il profilo è elencato in \ProgramData\Microsoft\Wlansvc\Profiles\Interfaces e viene visualizzato come una rete nota. Ma non viene visualizzato correttamente come criterio gestito in "Aree gestite da..." URI.
  
  Per risolvere questo problema, rimuovere lo spazio.

Dopo aver ottenuto il file XML, copiare e incollare la sintassi XML nelle impostazioni > OMA-URI Tipo di dati. Creare un profilo personalizzato (in questo articolo) illustra la procedura.

Consiglio

\ProgramData\Microsoft\Wlansvc\Profiles\Interfaces\{guid} include anche tutti i profili in formato XML.

Procedure consigliate

Prima di distribuire un profilo Wi-Fi con una chiave precondivisa, verificare che il dispositivo possa connettersi direttamente all'endpoint.
Durante la rotazione delle chiavi (password o passphrase), prevedere un tempo di inattività e pianificare le distribuzioni. Si deve:
- Verifica che i dispositivi dispongano di una connessione alternativa a Internet.
  
  Ad esempio, l'utente può tornare al Wi-Fi guest (o a un'altra rete Wi-Fi) o avere connettività cellulare per la comunicazione con Intune. La connessione aggiuntiva consente all'utente di ricevere gli aggiornamenti dei criteri quando il profilo Wi-Fi aziendale viene aggiornato nel dispositivo.
- Eseguire il push di nuovi profili Wi-Fi durante le ore non lavorative.
- Avvisare gli utenti che la connettività potrebbe essere interessata.

Risorse

Assicurarsi di assegnare il profilo e di monitorarne lo stato.
Per ulteriori informazioni su EAP in generale, vedere EAP (Extensible Authentication Protocol) per l'accesso alla rete

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-08-19