sharedKey(보안) 요소
sharedKey(보안) 요소에는 공유 키 정보가 포함됩니다. 이 요소는 인증 및 암호화 쌍에 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>
부모 요소
자식 요소
요소 | Type | Description |
---|---|---|
keyType | 키 유형입니다. | |
보호 | boolean | 공유 키를 암호화할지 여부를 지정합니다. |
keyMaterial | string | 네트워크 키 또는 암호를 포함합니다. |
keyType
공유 키가 네트워크 키인지 아니면 통과 구인지를 나타냅니다.
암호화 요소의 값이 WEP이면 keyType을 networkKey로 설정해야 합니다.
protected
공유 키를 암호화할지 여부를 지정합니다.
프로필 저장소에서 프로필을 검색한 경우(예: WlanGetProfile 호출) Windows Vista 및 Windows Server 2008:protected의 값은 항상 "TRUE"입니다.
Windows XP SP3(서비스 팩 3) 또는 WINDOWS XP용 무선 LAN API(서비스 팩 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 문자를 지정한 경우 유니코드 문자를 입력할 수 있습니다. 그러나 제공된 유니코드 문자를 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 |