HotspotProfile 스키마

아티클
08/31/2023

HotspotProfile 스키마는 WISPr(무선 인터넷 서비스 공급자 로밍) 프로토콜을 사용하는 Wi-Fi 핫스팟에 대한 로그인 자격 증명을 설명하는 데 사용되는 요소를 정의합니다. 모든 요소는 네임스페이스에 http://www.microsoft.com/networking/WLAN/HotspotProfile/v1있습니다. 일부 요소는 선택 사항이므로 모든 요소가 모든 프로필에 있는 것은 아닙니다.

전체 HotspotProfile 스키마는 다음과 같습니다.

<?xml version="1.0" encoding="UTF-8"?>  
<xs:schema targetNamespace="http://www.microsoft.com/networking/WLAN/HotspotProfile/v1"  
    elementFormDefault="qualified"  
    xmlns="http://www.microsoft.com/networking/WLAN/HotspotProfile/v1"  
    xmlns:xs="http://www.w3.org/2001/XMLSchema">  
  
  <xs:element name="BasicAuth">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="UserName" type="xs:token"/>  
        <xs:element name="Password" type="xs:token"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="ExtAuth">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="ExtensionId" type="xs:token"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="TrustedDomains">  
    <xs:annotation>  
      <xs:documentation xml:lang="en">  
        The element contains a set of host names that are trusted for providing credentials over HTTPS.  
        A domain name is either a fully qualified name such as hotspot.contoso.com  
        or a wildcard such as .contoso.com to refer to all hosts under the given domain name.  
      </xs:documentation>  
    </xs:annotation>  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="TrustedDomain" maxOccurs="unbounded" type="xs:token"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="SSIDConfig">  
    <xs:annotation>  
      <xs:documentation xml:lang="en">  
        The element contains a set of additional SSID's that are handled by this profile  
        to reduce the number of SSID's in the WLAN profile store.  
        Windows will not auto-connect to these SSID's until a user manually connects  
        and sets the auto-connect flag for a specific SSID.  
      </xs:documentation>  
    </xs:annotation>  
    <xs:complexType>  
      <xs:sequence>  
        <xs:element name="SSID" maxOccurs="250">  
          <xs:complexType>  
            <xs:choice>  
              <xs:element name="hex">  
                <xs:simpleType>  
                  <xs:restriction base="xs:hexBinary">  
                    <xs:minLength value="1" />  
                    <xs:maxLength value="32" />  
                  </xs:restriction>  
                </xs:simpleType>  
              </xs:element>  
              <xs:element name="hexPrefix">  
                <xs:simpleType>  
                  <xs:restriction base="xs:hexBinary">  
                    <xs:minLength value="4" />  
                    <xs:maxLength value="32" />  
                  </xs:restriction>  
                </xs:simpleType>  
              </xs:element>  
              <xs:element name="name">  
                <xs:simpleType>  
                  <xs:restriction base="xs:string">  
                    <xs:minLength value="1" />  
                    <xs:maxLength value="32" />  
                  </xs:restriction>  
                </xs:simpleType>  
              </xs:element>  
              <xs:element name="namePrefix">  
                <xs:simpleType>  
                  <xs:restriction base="xs:string">  
                    <xs:minLength value="4" />  
                    <xs:maxLength value="32" />  
                  </xs:restriction>  
                </xs:simpleType>  
              </xs:element>  
            </xs:choice>  
          </xs:complexType>  
        </xs:element>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
  
  <xs:element name="HotspotProfile">  
    <xs:complexType>  
      <xs:sequence>  
        <xs:choice>  
          <xs:sequence>  
            <xs:element ref="BasicAuth"/>  
            <xs:element ref="TrustedDomains"/>  
          </xs:sequence>  
          <xs:sequence>  
            <xs:element ref="ExtAuth"/>  
            <xs:element ref="TrustedDomains" minOccurs="0"/>  
          </xs:sequence>  
        </xs:choice>  
        <xs:element name="UserAgent" minOccurs="0" type="xs:token"/>  
        <xs:element ref="SSIDConfig" minOccurs="0"/>  
  
        <!-- extension point -->  
        <xs:any processContents="lax" namespace="##other" minOccurs="0" maxOccurs="unbounded"/>  
      </xs:sequence>  
    </xs:complexType>  
  </xs:element>  
</xs:schema>

다음 표에서는 이 스키마의 모든 요소를 이름별로 사전순으로 정렬하여 나열합니다.

요소	Description
BasicAuth	WISPr 인증에 필요한 사용자 이름 및 암호를 포함합니다. BasicAuth를 사용하면 정적 자격 증명 집합을 사용할 수 있습니다. ExtAuth를 사용하여 앱이 WISPr 인증에 대한 자격 증명을 생성하도록 합니다.
ExtAuth	BasicAuth를 통해 정적 사용자 이름 및 암호를 지정하는 대신 앱을 통해 WISPr 인증을 처리하기 위한 매개 변수를 포함합니다.
ExtensionId	WISPr 인증을 처리하기 위해 호출될 앱의 패키지 패밀리 이름입니다.
HotspotProfile	Wi-Fi 핫스팟에 대한 속성 및 로그인 자격 증명을 정의합니다. HotspotProfile 은 WISPr(무선 인터넷 서비스 공급자 로밍) 프로토콜을 사용하는 Wi-Fi 핫스팟 프로필의 고유한 루트 요소입니다.
암호	WISPr 인증에 사용할 암호입니다.
SSID	이 프로필에서 처리하는 추가 SSID입니다.
SSIDConfig	WLAN 프로필 저장소의 SSID 수를 줄이기 위해 이 프로필에서 처리하는 추가 SSID 집합을 포함합니다. Windows 사용자가 수동으로 한 번 연결할 때까지 이러한 SSID에 연결되지 않습니다. 새로 만든 프로필은 이 프로필에서 HotspotAuth 설정을 상속합니다.
TrustedDomain	HTTPS를 통해 자격 증명을 제공하기 위해 신뢰할 수 있는 호스트 이름입니다. 정규화된 이름(예: hotspot.contoso.com) 또는 지정된 도메인 이름(예: .contoso.com)의 모든 호스트를 참조하는 와일드카드일 수 있습니다.
TrustedDomains	HTTPS를 통해 자격 증명을 제공하기 위해 신뢰할 수 있는 하나 이상의 호스트 이름 집합을 포함합니다. 정규화된 이름(예: hotspot.contoso.com) 또는 지정된 도메인 이름(예: .contoso.com)의 모든 호스트를 참조하는 와일드카드일 수 있습니다.
UserAgent	운영자별 사용자 에이전트 필터링을 지원하도록 사용자 지정된 HTTP 사용자 에이전트 문자열입니다. 이 요소는 선택적입니다.
UserName	WISPr 인증에 사용할 사용자 이름입니다.
hex	무선 LAN의 SSID를 16진수 형식으로 정의합니다.
hexPrefix	SSID가 제공된 바이트로 시작하는 무선 LAN 클래스를 정의합니다.
name	무선 LAN의 SSID를 영숫자 형식으로 정의합니다.
namePrefix	SSID가 제공된 문자로 시작하는 무선 LAN 클래스를 정의합니다.

다음을 통해 공유

HotspotProfile 스키마

피드백

추가 리소스