sharedKey (security) , element

Element sharedKey (security) zawiera informacje o kluczu udostępnionym. Ten element jest opcjonalny i jest wymagany tylko wtedy, gdy klucze WEP, PSK lub SAE muszą być uwzględnione w profilu dla pary uwierzytelniania i szyfrowania.

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

Elementy nadrzędne

• zabezpieczenia (MSM)

Elementy podrzędne

typ klucza

Wskazuje, czy klucz wspólny będzie kluczem sieciowym, czy frazą dostępu.

Jeśli element szyfrowania ma wartość WEP, parametr keyType musi być ustawiony na wartość networkKey. Jeśli ma wartość WPA3SAE, parametr keyType musi być ustawiony na wartość passPhrase.

chroniony

Określa, czy klucz współużytkowany jest szyfrowany.

Windows Vista i Windows Server 2008:protected zawsze ma wartość "TRUE", jeśli profil został pobrany z magazynu profilów (na przykład przez wywołanie WlanGetProfile).

Windows XP z dodatkiem Service Pack 3 (SP3) lub interfejsem API bezprzewodowej sieci LAN dla systemu Windows XP z dodatkiem Service Pack 2 (SP2): Ten element musi mieć wartość "FALSE".

materiał kluczowy

Zawiera klucz sieciowy lub hasło. Jeśli chroniony element ma wartość TRUE, ten materiał klucza jest szyfrowany; w przeciwnym razie materiał klucza jest niezaszyfrowany. Zaszyfrowany materiał klucza jest wyrażany w postaci szesnastkowej.

Zakres prawidłowych wartości elementu keyMaterial różni się w zależności od typu używanego uwierzytelniania i szyfrowania, jak określono w elementach uwierzytelniania i szyfrowania . Różni się również według typu keyType.

W poniższej tabeli przedstawiono prawidłowe wartości kluczaMaterialne dla niektórych par uwierzytelniania i szyfrowania.

Znaki Unicode mogą być wprowadzane, gdy znaki ANSI lub ASCII są określone powyżej. Jeśli jednak podanych znaków Unicode nie można zamapować na znaki ANSI lub ASCII, dostarczony materiał klucza zostanie odrzucony.

Materiał klucza zwracany przez plik WlanGetProfile jest zawsze szyfrowany. Ponadto w przypadku przekazania niezaszyfrowanego materiału klucza do pliku WlanSetProfile materiał klucza jest automatycznie szyfrowany przed zapisaniem go w magazynie profilów.

Windows XP z dodatkiem SP3 i interfejsem API bezprzewodowej sieci LAN dla systemu Windows XP z dodatkiem SP2: Materiał klucza nigdy nie jest zaszyfrowany.

Jeśli proces jest uruchamiany w kontekście konta LocalSystem, możesz odszyfrować materiał klucza, wywołując metodę CryptUnprotectData.

Uwagi

W przypadku systemów Windows Vista i Windows Server 2008 dane skojarzone z elementem sharedKey są szyfrowane przed zapisaniem go w magazynie profilów.

W przypadku systemu Windows XP z dodatkiem SP3 i interfejsem API bezprzewodowej sieci LAN dla systemu Windows XP z dodatkiem SP2 dane nie są szyfrowane.

Przykłady

Aby wyświetlić przykładowe profile korzystające z elementu sharedKey i jego elementów podrzędnych, zobacz przykład profilu non-Broadcast, przykład profiluWPA-Personal i przykład profiluWPA2-Personal. Aby wyświetlić przykładowe profile korzystające z chronionego elementu, zobacz Przykłady profilów bezprzewodowych.

Wymagania