Voltar aos guias

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.

Publicado

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:

CampoO que contém
Network IndexObsoleto, sempre 1 por compatibilidade com versões anteriores
SSIDO nome da rede
Authentication TypeComo os dispositivos provam que podem entrar
Encryption TypeA cifra em uso
Network KeyA senha
MAC AddressO 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çãoValor
Aberta0x0001
WPA2-Personal0x0020
WPA e WPA2 misto (versão 2.0 e mais recentes)0x0022
Criptografia: nenhuma0x0001
Criptografia: AES0x0008
Criptografia: TKIP e AES misto0x000C

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.