elemento sharedKey (security)

Articolo
06/25/2023

L'elemento sharedKey (security) contiene informazioni sulla chiave condivisa. Questo elemento è obbligatorio solo se sono necessarie chiavi WEP o PSK per l'autenticazione e la coppia di crittografia.

<xs:element name="sharedKey"
    minOccurs="0"
 >
    <xs:complexType>
        <xs:sequence>
            <xs:element name="keyType">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="networkKey">
                        <xs:enumeration value="passPhrase">
                    </xs:restriction>
                </xs:simpleType>
            </xs:element>
            <xs:element name="protected"
                type="boolean"
             />
            <xs:element name="keyMaterial"
                type="string"
             />
            <xs:any
                processContents="lax"
                minOccurs="0"
                maxOccurs="unbounded"
                namespace="##other"
             />
        </xs:sequence>
    </xs:complexType>
</xs:element>

Elementi padre

sicurezza (MSM)

Elementi figlio

Elemento	Tipo	Descrizione
Keytype		Tipo di chiave.
protetto	boolean	Specifica se una chiave condivisa è crittografata.
keyMaterial	string	Contiene la chiave di rete o la passphrase.

keyType

Indica se la chiave condivisa sarà una chiave di rete o una frase pass.

Quando l'elemento di crittografia ha un valore WEP, keyType deve essere impostato su networkKey.

protetto

Specifica se una chiave condivisa è crittografata.

Windows Vista e Windows Server 2008:protected ha sempre un valore "TRUE" se il profilo è stato recuperato dall'archivio profili, ad esempio chiamando WlanGetProfile.

Windows XP con Service Pack 3 (SP3) o API LAN wireless per Windows XP con Service Pack 2 (SP2): Questo elemento deve avere un valore "FALSE".

keyMaterial

Contiene una chiave di rete o una passphrase. Se l'elemento protetto ha un valore TRUE, questo materiale della chiave viene crittografato; in caso contrario, il materiale della chiave non è crittografato. Il materiale chiave crittografato è espresso in forma esadecimale.

L'intervallo di valori validi per l'elemento keyMaterial varia in base al tipo di autenticazione e crittografia usato, come specificato dagli elementi di autenticazione e crittografia . Varia anche in base al keyType.

La tabella seguente mostra i valori keyMaterial validi per alcune coppie di autenticazione e crittografia.

valore di autenticazione	valore di crittografia	valore keyType	Valori keyMaterial validi
aprire o condividere	WEP	networkKey	Questo elemento contiene una chiave WEP di 5 o 13 caratteri ANSI o di 10 o 26 caratteri esadecimali.
WPAPSK o WPA2PSK	TKIP o AES	passPhrase	Questo elemento contiene una passphrase di 8 a 63 caratteri ASCII, ovvero da 8 a 63 caratteri ANSI nell'intervallo compreso tra 32 e 126. I valori chiave devono essere conformi ai requisiti specificati da 802.11i.
WPAPSK o WPA2PSK	TKIP o AES	networkKey	Questo elemento contiene una chiave di 64 caratteri esadecimali.

I caratteri Unicode possono essere immessi in cui sono specificati caratteri ANSI o ASCII in precedenza. Tuttavia, se i caratteri Unicode specificati non possono essere mappati a caratteri ANSI o ASCII, il materiale della chiave fornito viene rifiutato.

Il materiale chiave restituito da WlanGetProfile è sempre crittografato. Inoltre, se il materiale chiave non crittografato viene passato a WlanSetProfile, il materiale della chiave viene crittografato automaticamente prima che venga archiviato nell'archivio profili.

Windows XP con SP3 e API LAN wireless per Windows XP con SP2: Il materiale della chiave non viene mai crittografato.

Se il processo viene eseguito nel contesto dell'account LocalSystem, è possibile annullare la crittografia del materiale della chiave chiamando CryptUnprotectData.

Commenti

Per Windows Vista e Windows Server 2008, i dati associati all'elemento sharedKey vengono crittografati prima che vengano salvati nell'archivio profili.

Per Windows XP con l'API LAN wireless sp3 per Windows XP con SP2, i dati non vengono crittografati.

Esempio

Per visualizzare profili di esempio che usano l'elemento sharedKey e i relativi elementi figlio, vedere Esempio di profilo non broadcast, esempio di profilo WPA-Personale e esempio di profilo WPA2-Personal. Per visualizzare i profili di esempio che usano l'elemento protetto , vedere Esempi di profilo wireless.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Componente ridistribuibile	API LAN wireless per Windows XP con SP2

Condividi tramite