Elemento sharedKey (seguridad)

El elemento sharedKey (seguridad) contiene información de clave compartida. Este elemento es opcional y solo es necesario si es necesario incluir claves WEP, PSK o SAE en el perfil para el par de autenticación y cifrado.

<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>

Elementos primarios

• seguridad (MSM)

Elementos secundarios

tipo de clave

Indica si la clave compartida será una clave de red o una frase de contraseña.

Cuando el elemento de cifrado tiene un valor de WEP, keyType debe establecerse en networkKey. Cuando tiene un valor de WPA3SAE, keyType debe establecerse en passPhrase.

protegido

Especifica si se cifra una clave compartida.

Windows Vista y Windows Server 2008:protected siempre tienen un valor de "TRUE" si el perfil se recuperó del almacén de perfiles (por ejemplo, llamando a WlanGetProfile).

Windows XP con Service Pack 3 (SP3) o LAN inalámbrica API para Windows XP con Service Pack 2 (SP2): Este elemento debe tener un valor de "FALSE".

material clave

Contiene una clave de red o una frase de contraseña. Si el elemento protegido tiene un valor true, este material de clave se cifra; De lo contrario, el material clave no se cifra. El material de clave cifrada se expresa en forma hexadecimal.

El intervalo de valores válidos para el elemento keyMaterial varía según el tipo de autenticación y cifrado utilizado, según lo especificado por los elementos de autenticación y cifrado . También varía según keyType.

En la tabla siguiente se muestran los valores claveMaterial válidos para algunos pares de autenticación y cifrado.

Los caracteres Unicode se pueden especificar donde se especifican los caracteres ANSI o ASCII anteriores. Sin embargo, si los caracteres Unicode proporcionados no se pueden asignar a caracteres ANSI o ASCII, se rechaza el material de clave proporcionado.

El material clave devuelto por WlanGetProfile siempre está cifrado. Además, si el material de clave sin cifrar se pasa a WlanSetProfile, el material de clave se cifra automáticamente antes de almacenarlo en el almacén de perfiles.

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: El material clave nunca se cifra.

Si el proceso se ejecuta en el contexto de la cuenta localSystem, puede descifrar el material de clave llamando a CryptUnprotectData.

Observaciones

Para Windows Vista y Windows Server 2008, los datos asociados al elemento sharedKey se cifran antes de guardarlos en el almacén de perfiles.

Para Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2, los datos no se cifran.

Ejemplos

Para ver perfiles de ejemplo que usan el elemento sharedKey y sus elementos secundarios, vea Ejemplo de perfil sin difusión, ejemplo de perfil deWPA-Personal y ejemplo de perfil deWPA2-Personal. Para ver perfiles de ejemplo que usan el elemento protegido , consulte Ejemplos de perfiles inalámbricos.

Requisitos