QR Code Wi-Fi

Como funciona?

O conteúdo do QR segue o formato WIFI:T:<tipo>;S:<nome>;P:<senha>;H:<oculta>;;, que iOS e Android já reconhecem desde versões antigas.

Ao apontar a câmera nativa para ele, o celular sugere "Conectar à rede". Útil para passar o Wi-Fi a quem chega de visita.

E a senha não sai do lugar, já que o QR é só uma representação visual da string. Tudo é gerado no seu navegador.

Por que usar QR Code de Wi-Fi em vez de ditar a senha

Compartilhar a senha do Wi-Fi era ditar uma sequência de letras misturadas com símbolos enquanto a visita olhava perplexa para um ímã de geladeira, errava e no fim usava 4G. O QR Code de Wi-Fi remove essa fricção. Você gera um quadradinho, imprime uma vez, cola na parede, e qualquer visitante entra na rede em três segundos: abre a câmera, aponta, toca, pronto.

O mecanismo é simples. O QR não guarda token criptografado nem sessão. É só uma string curta num formato que os apps de câmera de iOS e Android reconhecem como uma intenção de conexão Wi-Fi. O celular decodifica e mostra um banner Conectar à rede "MinhaRede"?; tocar é idêntico a escolher a rede na lista de configurações e colar a senha. O aparelho ainda faz o handshake normal de WPA2 ou WPA3.

Para uma casa, o QR é um adesivo de "visitas bem-vindas" — dá para manter uma senha aleatória feia de 40 caracteres e nunca mais lê-la em voz alta. Para um café ou coworking o ganho é maior: a equipe para de repetir a senha o dia todo, e a rede pode rotacionar periodicamente sem ninguém precisar decorar. Para eventos, hotéis e Airbnbs o QR no cartão de boas-vindas é hoje um detalhe esperado.

O formato técnico: WIFI:T:<tipo>;S:<ssid>;P:<senha>;H:<oculta>;;

O formato é um padrão de fato introduzido pela biblioteca open source ZXing de leitura de códigos de barras por volta de 2010 e adotado por todos os scanners e câmeras relevantes desde então. É uma linha única de texto ASCII começando pelo prefixo literal WIFI: seguido de pares chave/valor separados por ponto-e-vírgula e terminada por um ponto-e-vírgula duplo.

WIFI:T:WPA;S:CafeVisitas;P:montanha-azul42;;

Os campos são:

• T: tipo de autenticação. Valores aceitos: WPA (cobre WPA, WPA2 e WPA3), WEP (legado), nopass (rede aberta) e WPA2-EAP (corporativo).
• S: o SSID (nome da rede). Obrigatório.
• P: a senha. Ignorado quando T é nopass.
• H: booleano opcional (true/false) marcando o SSID como oculto, para que o telefone não recuse a conexão por não enxergar a rede num scan passivo.

A ordem dos campos não é rígida, mas o ponto-e-vírgula duplo final é, porque o segundo ponto-e-vírgula marca o fim do registro. Uma rede aberta com SSID oculto fica assim:

WIFI:T:nopass;S:EventoAberto;H:true;;

Tipos de segurança: WEP, WPA, WPA2, WPA3 e redes abertas

O campo T: diz ao dispositivo qual handshake de autenticação negociar. Entender as quatro famílias importa porque nem todas são seguras de usar hoje.

WEP (obsoleto, 1997)

Wired Equivalent Privacy usa RC4 e é quebrável em minutos. Depreciado há mais de uma década. Se você ainda vê WEP numa rede, troque o roteador ou atualize o firmware.

WPA (depreciado, 2004)

Padrão de transição sobre TKIP para corrigir os defeitos do WEP enquanto o hardware AES era distribuído. Substituído pelo WPA2 no mesmo ano. Como o WEP, trate-o como histórico.

WPA2 (dominante, 2004 em diante)

WPA2 usa AES com CCMP e segue sendo o protocolo dominante em redes domésticas. Pontos fracos principais: ataque de dicionário offline contra Pre-Shared Keys fracas e a falha KRACK de reinstalação de chave, ambos mitigados por firmware corrigido e senhas aleatórias longas. Para um QR de Wi-Fi, selecionar WPA cobre WPA2 corretamente.

WPA3 (padrão atual, 2018 em diante)

WPA3 substitui o handshake de quatro vias pelo SAE (Simultaneous Authentication of Equals), tornando força bruta offline impraticável, e exige Protected Management Frames. O formato do QR não tem token WPA3 separado porque o campo descreve a credencial, não a cifra: telefone e ponto de acesso negociam o protocolo mais forte suportado na conexão.

Redes abertas (nopass)

Redes abertas não têm senha, só SSID. O QR Code ainda pode ser útil como ponto de entrada para um portal cativo ou para divulgar o SSID correto quando há várias redes próximas. Use T:nopass e omita o campo P: por completo.

Suporte por sistema operacional

O suporte nativo hoje é universal em smartphones:

• iOS 11+ (2017): app Câmera mostra um banner "Entrar na Rede". Nenhum app extra. iPadOS idêntico.
• Android 10+ (2019): Câmera, Google Lens e configurações de Wi-Fi reconhecem o formato. Android 11+ tem scanner em Configurações Rápidas.
• Android antigo: scanners de terceiros como Google Lens cobrem o formato.
• Windows 11: suporte nativo limitado; Phone Link consegue ler do celular.
• macOS: sem leitor nativo na Câmera; Continuity Camera e iPhone resolvem.

Caracteres especiais e escape

Como o formato usa : como separador de chave e ; como terminador de campo, qualquer senha ou SSID que contenha esses caracteres precisa escapá-los com uma barra invertida. A lista completa de caracteres que devem ser escapados é \, ;, ,, " e :.

SSID bruto    : foo;bar\baz
SSID codificado: WIFI:S:foo\;bar\\baz;T:WPA;P:senha;;

Se o SSID for só dígitos hexadecimais, a especificação recomenda envolvê-lo em aspas duplas escapadas. O gerador desta página cuida do escape automaticamente; as regras importam se você montar a string à mão.

Privacidade: a senha vai em texto claro dentro do QR

Um QR Code não é criptografia. É um código de barras 2D que qualquer scanner lê, e a senha do Wi-Fi fica gravada literalmente. Qualquer pessoa com câmera de celular extrai em menos de um segundo. Consequências:

• Não publique o QR da rede doméstica em redes sociais, mesmo cortado — super-resolução lê QRs em resoluções surpreendentemente baixas.
• Se imprime o QR para uma cafeteria, aceite que qualquer foto da parede é vazamento de credencial (a alternativa de gritar a senha não é melhor).
• Para redes de maior valor use VLAN de visitantes com acesso limitado e rotacione em cronograma, ou WPA2-Enterprise com credenciais por usuário e dispense o QR.
• Nunca reutilize uma senha de Wi-Fi em outro lugar; se o QR vazar, o dano fica contido.

Aplicações típicas

• Rede de visitas em casa: cartão plastificado na geladeira.
• Cafés e restaurantes: impresso no cardápio ou emoldurado no balcão.
• Eventos e conferências: no verso do crachá ou no slide de boas-vindas.
• Hotéis e temporada: cartão de boas-vindas ao lado da TV.
• Escritórios e coworkings: adesivo na porta de cada sala de reunião.
• Escolas e bibliotecas: um QR na recepção substitui a lista impressa.

Perguntas frequentes

Funciona offline?

Sim. O QR contém SSID e senha em texto puro; o celular não precisa de internet para decodificar. A internet começa depois de entrar na rede.

Preciso de QR diferente para WPA2 e WPA3?

Não. Use T:WPA para os dois. A cifra é negociada na conexão.

Pode carregar IP ou DNS?

Não. Só SSID, senha, tipo e a flag de oculto. IP, DNS, proxy e certificados exigem configuração manual ou perfil MDM.

SSID com emoji funciona?

QR Codes suportam UTF-8, então SSIDs com emoji codificam certo. Se roteador e telefone renderizam depende do suporte Unicode. ASCII é mais seguro para redes de visitantes.

Quão pequeno posso imprimir?

A string de Wi-Fi é curta; o QR lê bem em quadrados de 2-3 cm a 20-30 cm de distância. Menor que isso, aumente o nível de correção de erro e teste com um telefone real antes de plastificar.