Elemento sharedKey (seguridad)

Artículo
06/25/2023

El elemento sharedKey (seguridad) contiene información de clave compartida. Este elemento solo es necesario si se requieren claves WEP o PSK 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

Elemento	Tipo	Descripción
keyType		Tipo de clave.
Protegido	boolean	Especifica si se cifra una clave compartida.
keyMaterial	string	Contiene la clave de red o la frase de contraseña.

keyType

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.

protected

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

keyMaterial

Contiene una clave de red o frase de contraseña. Si el elemento protegido tiene un valor true, este material de clave se cifra; de lo contrario, el material de 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 valores claveMaterial válidos para algunos pares de autenticación y cifrado.

valor de autenticación	valor de cifrado	valor keyType	Valores clavemateriales válidos
abrir o compartir	WEP	networkKey	Este elemento contiene una clave WEP de 5 o 13 caracteres ANSI, o de 10 o 26 caracteres hexadecimales.
WPAPSK o WPA2PSK	TKIP o AES	passPhrase	Este elemento contiene una frase de contraseña de 8 a 63 caracteres ASCII, es decir, de 8 a 63 caracteres ANSI en el intervalo de 32 a 126. Los valores de clave deben cumplir los requisitos especificados por 802.11i.
WPAPSK o WPA2PSK	TKIP o AES	networkKey	Este elemento contiene una clave de 64 caracteres hexadecimales.

Se pueden especificar caracteres Unicode en los que se especifican 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 de 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 almacenarse en el almacén de perfiles.

Windows XP con SP3 y LAN inalámbrica API para Windows XP con SP2: El material de 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 la API de LAN inalámbrica 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, consulta Ejemplo de perfil no de difusión, Ejemplo de perfil WPA-Personal y Ejemplo de perfil WPA2-Personal. Para ver perfiles de ejemplo que usan el elemento protegido , consulta Ejemplos de perfil inalámbrico.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Redistribuible	API de LAN inalámbrica para Windows XP con SP2

Compartir a través de