通过网站配置 Wi-Fi 配置文件

本主题中所述的工作流是在 Windows 10 版本 2004 中引入的。 本主题演示如何配置网站,以便用户可以在进入相应 Wi-Fi 接入点范围之前为 Passpoint 网络(或普通网络)预配配置文件。 例如,一个用户可能计划首次访问机场或参加会议,他们希望通过在家里下载和配置个人资料来提前做好准备。

作为开发人员,可以通过提供 XML 配置文件和配置网站来启用工作流。 然后,用户可以通过 Web 浏览器从您的网站下载并设置 Wi-Fi 配置文件。 在用户的设备上,使用 URI 激活和 Windows 设置来配置 Wi-Fi 配置文件。

此工作流取代了 Internet Explorer 中用于预配 Wi-Fi 配置文件的机制,这些配置文件依赖于Microsoft特定的 JavaScript API。 此新工作流应适用于所有主要浏览器。

更详细地介绍工作流

可以从超链接激活此工作流,该超链接包含预配 XML 文档的下载 URI 作为参数。

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

例如,以下 HTML 标记提供了一个链接以安装在假设文档http://contoso.com/ProvisioningDoc.xml中找到的配置文件。

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

XML 必须遵循预配架构(请参阅 帐户预配)。 XML 还必须包含一个或多个 WLANProfile 元素。 每个配置文件将显示在下文所述的“添加”对话框中。

当用户单击 HTML 链接时,在 “设置”中调用安装工作流。 设置应用程序下载您的预配 XML 文档。 下载后,将显示有关配置文件、签名和签名者的信息(前提是文档遵守架构)。

提示添加 WiFi 连接的 Windows 设置的屏幕截图

仅当预配文件已签名且受信任时,才会启用“设置”对话框中的“添加”按钮。

在网页中,确定此工作流是否受支持

JavaScript 无法确定确切的 Windows 构建版本。 但是,如果用户使用的是 Microsoft Edge Web 浏览器,则可以通过检查 HTTP 标头的值 User-agent 来确定 Edge 的版本。 如果版本大于或等于 18.nnnnn,则支持工作流。

预配 XML 配置文件的示例

这些示例演示了两个常见的 Passpoint 预配用例,使用 PEAP 或 TTLS 和用户名和密码凭据。 这些 XML 文件已使用有效的测试证书进行签名,可以安装以查看预配流端到端。

使用 PEAP/EAP-MSCHAPv2 传递点配置文件

使用 TTLS/EAP-MSCHAPv2 的传递点配置文件