通过网站预配 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 文档。 下载后， (显示有关配置文件、签名和签名者的信息，前提是文档遵循架构) 。

“设置”应用

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

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

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

预配 XML 配置文件的示例

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

使用 PEAP/EAP-MSCHAPv2 的 Passpoint 配置文件

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