elemento sharedKey (segurança)

O elemento sharedKey (segurança) contém informações de chave compartilhadas. Esse elemento é opcional e só é necessário se as chaves WEP, PSK ou SAE precisarem ser incluídas no perfil para o 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 principais

• segurança (MSM)

Elementos filhos

tipoDeChave

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

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

protegido

Especifica se uma chave compartilhada é criptografada.

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

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

chaveMaterial

Contém uma chave de rede ou frase secreta. Se o elemento protegido tiver um valor TRUE, esse material de chave será criptografado; caso contrário, o material da chave não será criptografado. O material da chave criptografada é 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 . Também varia de acordo com keyType.

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

Caracteres Unicode podem ser inseridos onde os 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 da chave não criptografada for passado para WlanSetProfile, o material da chave será automaticamente criptografado antes de ser armazenado no repositório de perfis.

Windows XP com SP3 e API de LAN sem fio para Windows XP com SP2: O material da chave nunca é encriptado.

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

Observações

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

Para Windows XP com SP3 e API de 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, Exemplo de perfilWPA-Personal e Exemplo de perfilWPA2-Personal. Para exibir perfis de exemplo que usam o elemento protegido, consulte Exemplos de perfil sem fio.

Requerimentos