элемент sharedKey (security)

2025-05-14

Элемент sharedKey (security) содержит общие сведения о ключе. Этот элемент является необязательным и необходим, только если ключи WEP, PSK или SAE должны быть включены в профиль для пары проверки подлинности и шифрования.

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

Родительские элементы

безопасность (MSM)

Дочерние элементы

Элемент	Тип	Описание
keyType		Тип ключа.
защищенный	булевое значение	Указывает, зашифрован ли общий ключ.
keyMaterial	струна	Содержит сетевой ключ или парольную фразу.

тип ключа

Указывает, будет ли общий ключ сетевым ключом или парольной фразой.

Если элемент шифрования имеет значение WEP, keyType должен иметь значение networkKey. Если значение имеет значение WPA3SAE, параметр keyType должен иметь значение passPhrase.

защищенный

Указывает, зашифрован ли общий ключ.

Windows Vista и Windows Server 2008:protected всегда имеет значение TRUE, если профиль был извлечен из хранилища профилей (например, путем вызова WlanGetProfile).

Windows XP с пакетом обновления 3 (SP3) или API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Этот элемент должен иметь значение FALSE.

keyMaterial

Содержит сетевой ключ или парольную фразу. Если защищенный элемент имеет значение TRUE, то этот ключевой материал шифруется; в противном случае материал ключа незашифрован. Зашифрованный материал ключа выражается в шестнадцатеричной форме.

Диапазон допустимых значений для элемента keyMaterial зависит от типа проверки подлинности и шифрования, используемого в соответствии с элементами проверки подлинности и шифрования. Он также зависит от keyType.

В следующей таблице показаны допустимые значения keySource для некоторых пар проверки подлинности и шифрования.

значение проверки подлинности	значение шифрования	значение keyType	Допустимые значения keySource
открытие или общий доступ	WEP	networkKey	Этот элемент содержит ключ WEP из 5 или 13 символов ANSI, а также 10 или 26 шестнадцатеричных символов.
WPAPSK или WPA2PSK	TKIP или AES	парольная фраза	Этот элемент содержит парольную фразу от 8 до 63 символов ASCII, то есть от 8 до 63 символов ANSI в диапазоне от 32 до 126. Значения ключей должны соответствовать требованиям, указанным в 802.11i.
WPA3SAE	AES	парольная фраза	Этот элемент содержит парольную фразу от 8 до 63 символов ASCII, то есть от 8 до 63 символов ANSI в диапазоне от 32 до 126. Значения ключей должны соответствовать требованиям, указанным в 802.11i.
WPAPSK или WPA2PSK	TKIP или AES	networkKey	Этот элемент содержит ключ из 64 шестнадцатеричных символов.

Символы Юникода могут вводиться, где указаны символы ANSI или ASCII выше. Однако если указанные символы Юникода не могут быть сопоставлены с символами ANSI или ASCII, то предоставленный материал ключа отклоняется.

Материал ключа, возвращаемый WlanGetProfile , всегда шифруется. Кроме того, если в WlanSetProfile передается незашифрованный материал ключа, материал ключа автоматически шифруется, прежде чем он хранится в хранилище профилей.

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Материал ключа никогда не шифруется.

Если процесс выполняется в контексте учетной записи LocalSystem, можно отменить шифрование материала ключа, вызвав CryptUnprotectData.

Замечания

Для Windows Vista и Windows Server 2008 данные, связанные с элементом sharedKey , шифруются перед сохранением в хранилище профилей.

Для Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2) данные не шифруются.

Примеры

Чтобы просмотреть примеры профилей, использующих элемент sharedKey и его дочерние элементы, см. пример профиля non-Broadcast, пример профиля WPA-Personal и пример профиля WPA2-Personal. Чтобы просмотреть примеры профилей, использующих защищенный элемент, см. примеры профилей беспроводной сети.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows Vista, Windows XP с пакетом обновления 3 (SP3) [только классические приложения]
Минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
Компоненты для повторного распространения	API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2)