Gravando uma tag Wi-Fi no Android: o registro WSC explicado
Uma tag NFC de Wi-Fi é um único registro MIME NDEF do tipo application/vnd.wfa.wsc. Veja o que há dentro dele, como o Android o monta e quais cuidados tomar.
Introdução
Uma tag de Wi-Fi no Android é um registro NDEF com o tipo MIME application/vnd.wfa.wsc. Dentro dele ficam o nome da rede, o tipo de segurança e a senha, empacotados no formato Wi-Fi Simple Configuration (WSC). Veja o que esse registro contém, como o Android o monta e onde ele deixa de funcionar.
O que é o registro application/vnd.wfa.wsc
O registro WSC é um registro MIME NDEF, e o conteúdo (payload) dele não é texto. É uma sequência de entradas de tipo/valor e, como disse um entusiasta que montou a tag manualmente com um leitor PN532, "not a simple one (i.e. some implicit lengths)" (nada simples, com alguns tamanhos implícitos). Por isso, a maioria das pessoas deixa um app ou uma biblioteca fazer a codificação.
A especificação descreve três formas de usar o formato: Password Token, Configuration Token e Connection Handover. Uma tag que você cola na parede é um Configuration Token. Ele leva as credenciais do registrar de uma rede até um dispositivo que quer entrar nela, para que o celular se conecte diretamente.
O que há dentro da credencial
Tudo o que o celular precisa fica em um único bloco de credencial. De acordo com a documentação do ndeflib sobre o formato WSC, estes campos são obrigatórios:
| Campo | O que contém |
|---|---|
| Network Index | Obsoleto, sempre 1 por compatibilidade com versões anteriores |
| SSID | O nome da rede |
| Authentication Type | Como os dispositivos provam que podem entrar |
| Encryption Type | A cifra em uso |
| Network Key | A senha |
| MAC Address | O endereço do dispositivo que vai entrar na rede, ou um endereço de broadcast |
Um bloco de extensão de fabricante é opcional. Entradas WSC extras também.
Os campos de tipo são flags de bits, então vale conhecer os valores caso você precise ler um dump hexadecimal:
| Configuração | Valor |
|---|---|
| Aberta | 0x0001 |
| WPA2-Personal | 0x0020 |
| WPA e WPA2 misto (versão 2.0 e mais recentes) | 0x0022 |
| Criptografia: nenhuma | 0x0001 |
| Criptografia: AES | 0x0008 |
| Criptografia: TKIP e AES misto | 0x000C |
WEP e somente TKIP são marcados como obsoletos na mesma documentação. Um Configuration Token completo no exemplo do ndeflib é codificado em 139 octetos, então confira a capacidade NDEF da sua tag antes de gravar.
Como o Android monta e lê o registro
O guia básico de NFC do Android diz que os dados NDEF ficam em uma mensagem com um ou mais registros, e que cada registro precisa estar bem formado para o seu tipo. Desde o Android 4.1 (API level 16), existe o método NdefRecord.createMime(), para que você não precise montar registros MIME manualmente. O Google recomenda usar esse auxiliar sempre que possível, para evitar erros.
O tipo MIME é o que torna a tag útil. O sistema de despacho de tags do Android mapeia o tipo de um registro TNF_MIME_MEDIA para uma intent ACTION_NDEF_DISCOVERED, que é a intent de maior prioridade. Para uma tag de Wi-Fi, esse tipo é application/vnd.wfa.wsc. A documentação também diz que o registro que você quer que seja processado deve ser o primeiro da mensagem gravada, então mantenha o registro de Wi-Fi em primeiro lugar e não o esconda atrás de uma URL.
A documentação do Android não traz um exemplo de Wi-Fi, então trate o layout dos bytes como tarefa do codificador que você usa. Se escrever o seu próprio, teste-o com uma tag gravada por um app comprovadamente confiável.
Antes de gravar uma tag
O Configuration Token guarda credenciais sem criptografia. Qualquer pessoa que encoste o celular na tag, ou a leia com qualquer app leitor de NFC, consegue ver a senha. Use a tag em uma rede de convidados, nunca na rede principal, e troque a senha se uma tag sumir. Essa também é a configuração mais sensata para uma tag de boas-vindas com Wi-Fi em um imóvel de aluguel.
Grave tags apenas para redes que você possui ou administra. Simples assim.
O que acontece quando um iPhone lê a tag
O iPhone se comporta de outra forma. A documentação de leitura de tags em segundo plano da Apple diz que o sistema inspeciona a mensagem NDEF em busca de um registro URI, um tipo well-known U. Em seguida, lista os esquemas de URL compatíveis, como links da web, e-mail, telefone e SMS. Registros de credenciais de Wi-Fi não aparecem na página.
O entusiasta mencionado acima testou a tag dele e relatou que ela "does not work on an iPhone" (não funciona em um iPhone). Explicamos os detalhes em por que o iPhone não entra sozinho no Wi-Fi com a mesma tag. Se seus convidados usam os dois tipos de celular, coloque um QR code de Wi-Fi ao lado da tag, como explicado em NFC vs QR code.
Conclusão
Uma tag de Wi-Fi é um único registro MIME com um bloco de credencial compacto e sem criptografia. O despacho de tags do Android o encaminha pelo tipo MIME, e os iPhones não agem sobre ele. Para testar, grave uma tag com o NFCore no iPhone ou no Android e depois leia-a de volta para ver o tipo do registro e o payload.
Perguntas frequentes
Que tipo MIME uma tag NFC de Wi-Fi usa?
Ela usa application/vnd.wfa.wsc, um registro MIME NDEF que carrega dados do Wi-Fi Simple Configuration.
A senha do Wi-Fi na tag é criptografada?
Não. Um Configuration Token carrega credenciais sem criptografia, então qualquer pessoa que consiga ler a tag consegue ler a senha. Use uma rede de convidados.
Posso gravar o registro WSC manualmente?
Pode, mas o payload é um conjunto de entradas tipo-tamanho-valor com tamanhos implícitos. Use uma biblioteca ou um app que o monte para você.
A tag funciona em um iPhone?
Não como conexão ao Wi-Fi. A leitura de tags em segundo plano procura um registro URI, e uma tag com registro WSC foi relatada como não funcionando em um iPhone.