Bereitstellen eines WLAN-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 ein Benutzer, der zum ersten Mal einen Flughafen oder eine Konferenz besuchen möchte und sich vorab vorbereiten möchte, indem er ein Profil zu Hause herunterlädt und bereitgestellt.

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 App bereitgestellt.

Dieser Workflow ersetzt den Mechanismus in Internet Explorer für die Bereitstellung Wi-Fi Profile, der auf Microsoft-spezifischen JavaScript-APIs basiert. Es wird erwartet, dass dieser neue Workflow mit allen gängigen Browsern funktioniert.

Ausführlichere Informationen zum Workflow

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 enthält beispielsweise einen Link zum Installieren der Profile, die sich in einem hypothetischen Dokument http://contoso.com/ProvisioningDoc.xml befinden.

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

Ihr XML-Code muss dem Bereitstellungsschema entsprechen (siehe Kontobereitstellung). Ihr XML-Code 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 der Einstellungen-App aufgerufen. Das XML-Bereitstellungsdokument wird von der Einstellungen-App heruntergeladen. Nach dem Herunterladen werden Informationen zu profiles, signature und signer angezeigt (vorausgesetzt, dass das Dokument dem Schema entspricht).

Die Einstellungen-App

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

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

Es gibt keine Möglichkeit in JavaScript, die genaue Buildversion von Windows zu bestimmen. 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 überprüfen. Wenn die Version größer oder gleich 18.nnnnn ist, wird der Workflow unterstützt.