Condividi tramite


Schema HotspotProfile

Lo schema HotspotProfile definisce gli elementi usati per descrivere le credenziali di accesso per Wi-Fi hotspot che usano il protocollo WISPr (Wireless Internet Service Provider roaming). Tutti gli elementi sono nello spazio dei nomi http://www.microsoft.com/networking/WLAN/HotspotProfile/v1. Non tutti gli elementi sono presenti in ogni profilo, poiché alcuni elementi sono facoltativi.

Di seguito è riportato lo schema completo di 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>

Nella tabella seguente sono elencati tutti gli elementi di questo schema, ordinati alfabeticamente in base al nome.

Elemento Descrizione
BasicAuth

Contiene il nome utente e la password necessari per l'autenticazione WISPr. L'uso di BasicAuth consente l'uso di un set statico di credenziali. usare ExtAuth per fare in modo che un'app generi credenziali per l'autenticazione WISPr.

ExtAuth

Contiene i parametri per la gestione dell'autenticazione WISPr tramite un'app ( anziché specificare un nome utente e una password statici tramite BasicAuth ).

ExtensionId

Nome della famiglia di pacchetti dell'app che verrà richiamata per gestire l'autenticazione WISPr.

HotspotProfile

Definisce le proprietà e le credenziali di accesso per un'area Wi-Fi hotspot. HotspotProfile è l'elemento radice univoco di un profilo Wi-Fi hotspot che usa il protocollo WISPr (Wireless Internet Service Provider roaming).

Password

Password da usare per l'autenticazione WISPr.

SSID

SSID aggiuntivo gestito da questo profilo.

SSIDConfig

Contiene un set di SSID aggiuntivi gestiti da questo profilo per ridurre il numero di SSID nell'archivio profili WLAN. Windows non si connetterà a questi SSID finché un utente non si connette manualmente una volta. Il profilo appena creato erediterà le impostazioni hotspotAuth da questo profilo.

TrustedDomain

Nome host attendibile per fornire le credenziali tramite HTTPS. Può essere un nome completo (ad esempio hotspot.contoso.com) o un carattere jolly per fare riferimento a tutti gli host con il nome di dominio specificato,ad esempio .contoso.com.

TrustedDomains

Contiene un set di uno o più nomi host attendibili per fornire credenziali tramite HTTPS. Può essere un nome completo (ad esempio hotspot.contoso.com) o un carattere jolly per fare riferimento a tutti gli host con il nome di dominio specificato,ad esempio .contoso.com.

UserAgent

Stringa personalizzata dell'agente utente HTTP per supportare il filtro dell'agente utente specifico dell'operatore. Questo elemento è facoltativo.

UserName

Nome utente da usare per l'autenticazione WISPr.

hex

Definisce l'SSID di una lan wireless in formato esadecimale.

hexPrefix

Definisce una classe di reti LAN wireless i cui SSID iniziano con i byte forniti.

nome

Definisce l'SSID di una rete LAN wireless in formato alfanumerico.

namePrefix

Definisce una classe di reti LAN wireless i cui SSID iniziano con i caratteri specificati.