Provisionar um perfil de Wi-Fi por meio de um site

  • Artigo

O fluxo de trabalho descrito neste tópico foi introduzido no Windows 10, versão 2004. Este tópico mostra como configurar um site para que um usuário possa provisionar um perfil para uma rede passpoint (ou para uma rede normal) antes de passar para o intervalo dos pontos de acesso Wi-Fi correspondentes. Um cenário de exemplo é o de um usuário que pode estar planejando visitar um aeroporto ou uma conferência pela primeira vez e que deseja se preparar com antecedência baixando e provisionando um perfil em casa.

Como desenvolvedor, você habilita o fluxo de trabalho fornecendo um perfil XML e configurando um site. Em seguida, os usuários podem provisionar um perfil de Wi-Fi baixando-o do seu site por meio de um navegador da Web. No dispositivo do usuário, o perfil de Wi-Fi é provisionado usando a ativação de URI e o aplicativo Configurações do Windows.

Esse fluxo de trabalho substitui o mecanismo no Internet Explorer para provisionar perfis de Wi-Fi, que se baseia em APIs JavaScript específicas da Microsoft. Espera-se que esse novo fluxo de trabalho funcione com todos os principais navegadores.

O fluxo de trabalho com mais detalhes

Você pode ativar esse fluxo de trabalho de um hiperlink que inclui como argumento o URI de download do documento XML de provisionamento.

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

Por exemplo, a marcação HTML a seguir fornece um link para instalar os perfis encontrados em um documento http://contoso.com/ProvisioningDoc.xmlhipotético .

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

Seu XML deve aderir ao esquema de provisionamento (consulte Provisionamento de conta). Seu XML também deve incluir um ou mais elementos WLANProfile . Cada perfil será exibido na caixa de diálogo Adicionar descrita a seguir.

Quando o usuário clica no link HTML, o fluxo de trabalho de instalação é invocado no aplicativo Configurações . Seu documento XML de provisionamento é baixado pelo aplicativo Configurações . Depois de baixado, as informações sobre os perfis, a assinatura e o signatário são exibidas (desde que o documento adere ao esquema).

O aplicativo Configurações

O botão Adicionar na caixa de diálogo no aplicativo Configurações será habilitado somente se o arquivo de provisionamento estiver assinado e confiável.

Em sua página da Web, determine se esse fluxo de trabalho tem suporte

Não há nenhuma maneira no JavaScript de determinar a versão exata de build do Windows. Mas se o usuário estiver usando o navegador da Web Microsoft Edge, você poderá determinar a versão do Edge inspecionando o valor do User-agent cabeçalho HTTP. Se a versão for maior ou igual a 18.nnnnn, o fluxo de trabalho terá suporte.

Exemplos de provisionamento de perfis XML

Esses exemplificam dois casos comuns de uso de provisionamento do Passpoint , usando PEAP ou TTLS com credenciais de nome de usuário e senha. Esses arquivos XML foram assinados com um certificado de teste válido e podem ser instalados para ver o fluxo de provisionamento de ponta a ponta.

Perfil de ponto de passagem usando PEAP/EAP-MSCHAPv2

Perfil de ponto de passagem usando TTLS/EAP-MSCHAPv2