elemento sharedKey (segurança)

2025-05-14

O elemento sharedKey (segurança) contém informações de chave compartilhadas. Esse elemento é opcional e só será necessário se as chaves WEP, PSK ou SAE forem necessárias para serem incluídas no perfil do par de autenticação e criptografia.

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

segurança (MSM)

Elementos filho

Elemento	Tipo	Descrição
keyType		Tipo de chave.
Protegido	booliano	Especifica se uma chave compartilhada é criptografada.
keyMaterial	corda	Contém a chave de rede ou a frase secreta.

tipoDeChave

Indica se a chave compartilhada será uma chave de rede ou uma frase de passagem.

Quando o elemento de criptografia tem um valor de WEP, keyType deve ser definido como networkKey. Quando ele tem um valor de WPA3SAE, keyType deve ser definido como passPhrase.

Protegido

Especifica se uma chave compartilhada é criptografada.

O Windows Vista e o Windows Server 2008:protected sempre têm um valor "TRUE" se o perfil foi recuperado do repositório de perfil (por exemplo, chamando WlanGetProfile).

Windows XP com Service Pack 3 (SP3) ou API lan sem fio para Windows XP com Service Pack 2 (SP2): Esse elemento deve ter um valor de "FALSE".

keyMaterial

Contém uma chave de rede ou uma frase secreta. Se o elemento protegido tiver um valor verdadeiro, esse material de chave será criptografado; caso contrário, o material da chave não será criptografado. O material de chave criptografado é expresso em forma hexadecimal.

O intervalo de valores válidos para o elemento keyMaterial varia de acordo com o tipo de autenticação e criptografia usados, conforme especificado pelos elementos de autenticação e criptografia . Ele também varia de acordo com keyType.

A tabela a seguir mostra valores keyMaterial válidos para alguns pares de autenticação e criptografia.

valor de autenticação	valor de criptografia	valor keyType	Valores de keyMaterial válidos
aberto ou compartilhado	WEP	networkKey	Esse elemento contém uma chave WEP de 5 ou 13 caracteres ANSI, ou de 10 ou 26 caracteres hexadecimal.
WPAPSK ou WPA2PSK	TKIP ou AES	frase secreta	Esse elemento contém uma frase secreta de 8 a 63 caracteres ASCII, ou seja, de 8 a 63 caracteres ANSI no intervalo de 32 a 126. Os valores de chave devem estar em conformidade com os requisitos especificados por 802,11i.
WPA3SAE	AES	frase secreta	Esse elemento contém uma frase secreta de 8 a 63 caracteres ASCII, ou seja, de 8 a 63 caracteres ANSI no intervalo de 32 a 126. Os valores de chave devem estar em conformidade com os requisitos especificados por 802,11i.
WPAPSK ou WPA2PSK	TKIP ou AES	networkKey	Esse elemento contém uma chave de 64 caracteres hexadecimal.

Caracteres Unicode podem ser inseridos em que caracteres ANSI ou ASCII são especificados acima. No entanto, se os caracteres Unicode fornecidos não puderem ser mapeados para caracteres ANSI ou ASCII, o material de chave fornecido será rejeitado.

O material de chave retornado por WlanGetProfile é sempre criptografado. Além disso, se o material de chave não criptografado for passado para WlanSetProfile, o material da chave será criptografado automaticamente antes de ser armazenado no repositório de perfil.

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: O material da chave nunca é criptografado.

Se o processo for executado no contexto da conta LocalSystem, você poderá descriptografar o material da chave chamando CryptUnprotectData.

Observações

Para o Windows Vista e o Windows Server 2008, os dados associados ao elemento sharedKey são criptografados antes de serem salvos no repositório de perfil.

Para Windows XP com SP3 e API lan sem fio para Windows XP com SP2, os dados não são criptografados.

Exemplos

Para exibir perfis de exemplo que usam o elemento sharedKey e seus elementos filho, consulte exemplo de perfil não difundido, WPA-Personal exemplo de perfil e WPA2-Personal exemplo de perfil. Para exibir perfis de exemplo que usam o elemento protegido , consulte exemplos de perfil sem fio.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Redistribuível	API de LAN sem fio para Windows XP com SP2