Compartilhar via

elemento sharedKey (segurança)

  • Artigo

O elemento sharedKey (segurança) contém informações de chave compartilhadas. Esse elemento só será necessário se chaves WEP ou PSK forem necessárias 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 pai

Elementos filho

Elemento Type Descrição
Keytype Tipo de chave.
protegidos booleano Especifica se uma chave compartilhada é criptografada.
keyMaterial cadeia de caracteres Contém a chave de rede ou a frase secreta.

keyType

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

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

protegidos

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 frase secreta. Se o elemento protegido tiver um valor TRUE, esse material de chave será criptografado; caso contrário, o material de chave será descriptografado. 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 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 Senha Esse elemento contém uma frase secreta de 8 a 63 caracteres ASCII, ou seja, 8 a 63 caracteres ANSI no intervalo de 32 a 126. Os valores de chave devem estar em conformidade com os requisitos especificados pelo 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 de chave chamando CryptUnprotectData.

Comentários

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 o Windows XP com SP3 e a 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, exemplo de perfil WPA-Personal e exemplo de perfil WPA2-Personal. Para exibir perfis de exemplo que usam o elemento protegido , confira 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