sharedKey (セキュリティ) 要素

[アーティクル]
06/25/2023

sharedKey (security) 要素には、共有キー情報が含まれています。この要素は、認証と暗号化のペアに WEP キーまたは PSK キーが必要な場合にのみ必要です。

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

親要素

security (MSM)

子要素

要素	Type	説明
Keytype		キーの種類。
保護	boolean	共有キーを暗号化するかどうかを指定します。
keyMaterial	string	ネットワークキーまたはパスフレーズが含まれます。

keyType

共有キーがネットワークキーかパスフレーズかを示します。

暗号化要素の値が WEP の場合は、keyType を networkKey に設定する必要があります。

protected

共有キーを暗号化するかどうかを指定します。

Windows Vista と Windows Server 2008:protected は、プロファイルがプロファイルストアから取得された場合 ( たとえば、WlanGetProfile を呼び出す) 場合、常に "TRUE" の値を持ちます。

Windows XP Service Pack 3 (SP3) または Windows XP 用ワイヤレス LAN API Service Pack 2 (SP2): この要素の値は "FALSE" である必要があります。

keyMaterial

ネットワークキーまたはパスフレーズが含まれています。 保護された要素の値が TRUE の場合、このキーマテリアルは暗号化されます。それ以外の場合、キーマテリアルは暗号化されません。暗号化されたキーマテリアルは、16 進形式で表されます。

keyMaterial 要素の有効な値の範囲は、認証要素と暗号化要素で指定されているように、使用される認証と 暗号化 の種類によって異なります。また、 keyType によっても異なります。

次の表は、一部の認証と暗号化のペアで有効な keyMaterial 値を示しています。

認証値	暗号化値	keyType 値	有効な keyMaterial 値
開くまたは共有する	WEP	networkKey	この要素には、5 または 13 の ANSI 文字、または 10 または 26 の 16 進文字の WEP キーが含まれています。
WPAPSK または WPA2PSK	TKIP または AES	passPhrase	この要素には、8 から 63 の ASCII 文字のパスフレーズ (32 から 126 の範囲の 8 から 63 の ANSI 文字) が含まれています。キー値は、802.11i で指定された要件に準拠している必要があります。
WPAPSK または WPA2PSK	TKIP または AES	networkKey	この要素には、64 桁の 16 進文字のキーが含まれています。

上記で ANSI または ASCII 文字を指定した場合は、Unicode 文字を入力できます。ただし、指定された Unicode 文字を ANSI 文字または ASCII 文字にマップできない場合、指定されたキーマテリアルは拒否されます。

WlanGetProfile によって返されるキーマテリアルは常に暗号化されます。また、暗号化されていないキーマテリアルが WlanSetProfile に渡されると、キーマテリアルはプロファイルストアに格納される前に自動的に暗号化されます。

SP3 を使用した Windows XP と、SP2 を使用した Windows XP 用のワイヤレス LAN API: キーマテリアルは暗号化されません。

プロセスが LocalSystem アカウントのコンテキストで実行されている場合は、 CryptUnprotectData を呼び出してキーマテリアルを暗号化解除できます。

解説

Windows Vista および Windows Server 2008 の場合、 sharedKey 要素に関連付けられているデータは、プロファイルストアに保存される前に暗号化されます。

SP3 を使用する Windows XP と、SP2 を使用した Windows XP 用ワイヤレス LAN API の場合、データは暗号化されません。

例

sharedKey 要素とその子要素を使用するサンプルプロファイルを表示するには、「非ブロードキャストプロファイルサンプル」、「WPA-Personal プロファイルサンプル」、「WPA2-Personal プロファイルサンプル」を参照してください。 保護された要素を使用するサンプルプロファイルを表示するには、「ワイヤレスプロファイルのサンプル」を参照してください。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP3 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
再頒布可能パッケージ	Sp2 を使用した Windows XP 用ワイヤレス LAN API

次の方法で共有