다음을 통해 공유


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이면 keyTypenetworkKey로 설정해야 합니다.

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