Aprovisionamiento de un perfil de Wi-Fi a través de un sitio web

  • Artículo

El flujo de trabajo descrito en este tema se introdujo en Windows 10, versión 2004. En este tema se muestra cómo configurar un sitio web para que un usuario pueda aprovisionar un perfil para una red de punto de acceso (o para una red normal) antes de pasar al intervalo de los puntos de acceso Wi-Fi correspondientes. Un escenario de ejemplo es el de un usuario que podría estar planeando visitar un aeropuerto o una conferencia por primera vez, y quiere prepararse de antemano descargando y aprovisionando un perfil en casa.

Como desarrollador, se habilita el flujo de trabajo proporcionando un perfil XML y configurando un sitio web. A continuación, los usuarios pueden aprovisionar un perfil de Wi-Fi descargólo desde su sitio web a través de un explorador web. En el dispositivo del usuario, el perfil de Wi-Fi se aprovisiona mediante la activación de URI y la aplicación Configuración de Windows.

Este flujo de trabajo reemplaza el mecanismo de Internet Explorer para el aprovisionamiento de perfiles de Wi-Fi, que se basa en las API de JavaScript específicas de Microsoft. Se espera que este nuevo flujo de trabajo funcione con todos los exploradores principales.

Flujo de trabajo con más detalle

Puede activar este flujo de trabajo desde un hipervínculo que incluya como argumento el URI de descarga del documento XML de aprovisionamiento.

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

Por ejemplo, el siguiente marcado HTML proporciona un vínculo para instalar los perfiles que se encuentran en un documento http://contoso.com/ProvisioningDoc.xmlhipotético.

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

El XML debe cumplir el esquema de aprovisionamiento (consulte Aprovisionamiento de cuentas). El XML también debe incluir uno o varios elementos WLANProfile . Cada perfil se mostrará en el cuadro de diálogo Agregar que se describe a continuación.

Cuando el usuario hace clic en el vínculo HTML, se invoca el flujo de trabajo de instalación en la aplicación Configuración . La aplicación Configuración descarga el documento XML de aprovisionamiento. Una vez descargado, se muestra información sobre los perfiles, la firma y el firmante (siempre que el documento se ajuste al esquema).

La aplicación Configuración

El botón Agregar del cuadro de diálogo de la aplicación Configuración solo está habilitado si el archivo de aprovisionamiento está firmado y de confianza.

En la página web, determine si se admite este flujo de trabajo.

No hay ninguna manera en JavaScript para determinar la versión de compilación exacta de Windows. Pero si el usuario usa el explorador web de Microsoft Edge, puede determinar la versión de Edge inspeccionando el valor del User-agent encabezado HTTP. Si la versión es mayor o igual que 18.nnnnn, se admite el flujo de trabajo.

Ejemplos de perfiles XML de aprovisionamiento

Estos ejemplifican dos casos de uso comunes de aprovisionamiento de punto de paso, mediante PEAP o TTLS con credenciales de nombre de usuario y contraseña. Estos archivos XML se han firmado con un certificado de prueba válido y se pueden instalar para ver el flujo de aprovisionamiento de un extremo a otro.

Perfil de punto de acceso mediante PEAP/EAP-MSCHAPv2

Perfil de punto de acceso mediante TTLS/EAP-MSCHAPv2