Freigeben über


Bereitstellen eines Wi-Fi Profils über eine Website

Der in diesem Thema beschriebene Workflow wurde in Windows 10, Version 2004, eingeführt. In diesem Thema wird gezeigt, wie Sie eine Website so konfigurieren, dass ein Benutzer ein Profil für ein Passpoint-Netzwerk (oder für ein normales Netzwerk) bereitstellen kann, bevor er in den Bereich der entsprechenden Wi-Fi Zugriffspunkte wechselt. Ein Beispielszenario ist das eines Benutzers, der zum ersten Mal einen Flughafen oder eine Konferenz besuchen möchte und sich vorab vorbereiten möchte, indem er ein Profil zu Hause herunter- und bereitstellen kann.

Als Entwickler aktivieren Sie den Workflow, indem Sie ein XML-Profil bereitstellen und eine Website konfigurieren. Ihre Benutzer können dann ein Wi-Fi Profil bereitstellen, indem Sie es über einen Webbrowser von Ihrer Website herunterladen. Auf dem Gerät des Benutzers wird das Wi-Fi Profil dann mithilfe der URI-Aktivierung und der Windows-Einstellungen bereitgestellt.

Dieser Workflow ersetzt den Mechanismus in Internet Explorer für die Bereitstellung von Wi-Fi Profilen, die auf microsoftspezifischen JavaScript-APIs basieren. Dieser neue Workflow soll mit allen wichtigen Browsern funktionieren.

Der Workflow ausführlicher

Sie können diesen Workflow über einen Link aktivieren, der als Argument den Download-URI des XML-Bereitstellungsdokuments enthält.

ms-settings:wifi-provisioning?uri={download_uri}

Das folgende HTML-Markup gibt z. B. einen Link zum Installieren der Profile, die in einem hypothetischen Dokument http://contoso.com/ProvisioningDoc.xmlgefunden werden.

<a href="ms-settings:wifi-provisioning?uri=http://contoso.com/ProvisioningDoc.xml">Install</a>

Ihr XML muss dem Bereitstellungsschema entsprechen (siehe Kontobereitstellung). Ihr XML muss auch ein oder mehrere WLANProfile-Elemente enthalten. Jedes Profil wird im dialogfeld "Hinzufügen " angezeigt, das als nächstes beschrieben wird.

Wenn der Benutzer auf Ihren HTML-Link klickt, wird der Installationsworkflow in den Einstellungen aufgerufen. Ihr XML-Bereitstellungsdokument wird von Den Einstellungen heruntergeladen. Nach dem Herunterladen werden Informationen zu den Profilen, der Signatur und dem Signierer angezeigt (sofern das Dokument dem Schema entspricht).

Ein Screenshot der Windows-Einstellungen, die dazu auffordern, eine WLAN-Verbindung hinzuzufügen

Die Schaltfläche "Hinzufügen " im Dialogfeld in " Einstellungen " ist nur aktiviert, wenn die Bereitstellungsdatei signiert und vertrauenswürdig ist.

Ermitteln Sie auf Ihrer Webseite, ob dieser Workflow unterstützt wird.

In JavaScript gibt es keine Möglichkeit, die genaue Buildversion von Windows zu ermitteln. Wenn Ihr Benutzer jedoch den Microsoft Edge-Webbrowser verwendet, können Sie die Version von Edge ermitteln, indem Sie den Wert des User-agent HTTP-Headers prüfen. Wenn die Version größer oder gleich 18.nnnnnist, wird der Workflow unterstützt.

Beispiele für die Bereitstellung von XML-Profilen

Diese veranschaulichen zwei gängige Passpoint-Bereitstellungsanwendungsfälle, die PEAP oder TTLS mit Benutzernamen und Kennwortanmeldeinformationen verwenden. Diese XML-Dateien wurden mit einem gültigen Testzertifikat signiert und können installiert werden, um den Bereitstellungsfluss end-to-End anzuzeigen.

Passpointprofil mit PEAP/EAP-MSCHAPv2

Passpoint-Profil mit TTLS/EAP-MSCHAPv2