Elemen sharedKey (keamanan)

Artikel
06/25/2023

Elemen sharedKey (keamanan) berisi informasi kunci bersama. Elemen ini hanya diperlukan jika kunci WEP atau PSK diperlukan untuk pasangan autentikasi dan enkripsi.

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

Elemen induk

keamanan (MSM)

Elemen anak

Elemen	Jenis	Deskripsi
keyType		Jenis kunci.
terlindungi	boolean	Menentukan apakah kunci bersama dienkripsi.
keyMaterial	string	Berisi kunci jaringan atau frase sandi.

keyType

Menunjukkan apakah kunci bersama akan menjadi kunci jaringan atau frasa sandi.

Ketika elemen enkripsi memiliki nilai WEP, keyType harus diatur ke networkKey.

terlindungi

Menentukan apakah kunci bersama dienkripsi.

Windows Vista dan Windows Server 2008:protected selalu memiliki nilai "TRUE" jika profil diambil dari penyimpanan profil (misalnya, dengan memanggil WlanGetProfile).

Windows XP dengan Paket Layanan 3 (SP3) atau API LAN Nirkabel untuk Windows XP dengan Paket Layanan 2 (SP2): Elemen ini harus memiliki nilai "FALSE".

keyMaterial

Berisi kunci jaringan atau frase sandi. Jika elemen yang dilindungi memiliki nilai TRUE, maka materi kunci ini dienkripsi; jika tidak, materi kunci tidak terenkripsi. Materi kunci terenkripsi dinyatakan dalam bentuk heksadesimal.

Rentang nilai yang valid untuk elemen keyMaterial bervariasi menurut jenis autentikasi dan enkripsi yang digunakan, seperti yang ditentukan oleh elemen autentikasi dan enkripsi . Ini juga bervariasi menurut keyType.

Tabel berikut ini memperlihatkan nilai keyMaterial yang valid untuk beberapa pasangan autentikasi dan enkripsi.

nilai autentikasi	nilai enkripsi	nilai keyType	Nilai keyMaterial yang valid
buka atau bagikan	WEP	networkKey	Elemen ini berisi kunci WEP 5 atau 13 karakter ANSI, atau 10 atau 26 karakter heksadesimal.
WPAPSK atau WPA2PSK	TKIP atau AES	passPhrase	Elemen ini berisi frasa sandi 8 hingga 63 karakter ASCII, yaitu 8 hingga 63 karakter ANSI dalam rentang 32 hingga 126. Nilai kunci harus mematuhi persyaratan yang ditentukan oleh 802.11i.
WPAPSK atau WPA2PSK	TKIP atau AES	networkKey	Elemen ini berisi kunci 64 karakter heksadesimal.

Karakter Unicode dapat dimasukkan di mana karakter ANSI atau ASCII ditentukan di atas. Namun, jika karakter Unicode yang disediakan tidak dapat dipetakan ke karakter ANSI atau ASCII, materi kunci yang disediakan akan ditolak.

Materi kunci yang dikembalikan oleh WlanGetProfile selalu dienkripsi. Selain itu, jika materi kunci yang tidak terenkripsi diteruskan ke WlanSetProfile, materi kunci secara otomatis dienkripsi sebelum disimpan di penyimpanan profil.

Windows XP dengan SP3 dan Wireless LAN API untuk Windows XP dengan SP2: Materi kunci tidak pernah dienkripsi.

Jika proses Anda berjalan dalam konteks akun LocalSystem, maka Anda dapat membatalkan enkripsi materi kunci dengan memanggil CryptUnprotectData.

Keterangan

Untuk Windows Vista dan Windows Server 2008, data yang terkait dengan elemen sharedKey dienkripsi sebelum disimpan di penyimpanan profil.

Untuk Windows XP dengan SP3 dan Wireless LAN API untuk Windows XP dengan SP2, data tidak dienkripsi.

Contoh

Untuk melihat contoh profil yang menggunakan elemen sharedKey dan elemen turunannya, lihat Sampel profil Non-Siaran, sampel profil WPA-Personal, dan sampel profil WPA2-Personal. Untuk melihat contoh profil yang menggunakan elemen yang dilindungi , lihat Sampel profil nirkabel.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Redistribusi	API LAN Nirkabel untuk Windows XP dengan SP2

Bagikan melalui