QR Code de Wi-Fi

Também chamado de: QR Code WiFi, URI WIFI:, QR Code de rede, Wi-Fi QR code

Definição

O QR Code de Wi-Fi guarda o nome da rede, a senha e o tipo de segurança para que o celular entre na rede por leitura, sem digitar nada. O texto tem esta aparência: WIFI:T:WPA;S:MyNetwork;P:secret;;.

O formato WIFI:

O QR Code de Wi-Fi guarda uma linha de texto que começa com WIFI: e lista campos separados por ponto e vírgula, terminando com dois pontos e vírgulas. Para uma rede doméstica ou de escritório típica, fica assim: WIFI:T:WPA;S:MyNetwork;P:secret;; em que T é o tipo de segurança, S o nome da rede (SSID) e P a senha.

O formato nasceu em projetos de leitores de código de barras de código aberto e virou uma convenção de fato. Edições recentes da especificação WPA3 da Wi-Fi Alliance descrevem um formato de URI muito próximo, que acrescenta campos opcionais para recursos de segurança mais novos.

  • T: tipo de segurança, normalmente WPA, WEP ou nopass para uma rede aberta
  • S: o nome da rede (SSID), exatamente como aparece, com diferença entre maiúsculas e minúsculas
  • P: a senha; omita-a numa rede aberta
  • H:true marca uma rede oculta, que não divulga o nome

Tipos de segurança e caracteres especiais

O valor WPA é usado para WPA, WPA2 e, na prática, para a maioria das redes pessoais WPA3, porque os celulares negociam o protocolo exato ao se conectar. O WEP está obsoleto e é inseguro, e nopass serve para redes abertas, sem senha. As redes corporativas, que exigem usuário e certificado, não são bem atendidas por esse formato simples.

Se o nome da rede ou a senha tiver barra invertida, ponto e vírgula, vírgula, dois-pontos ou aspas duplas, esse caractere precisa ser escapado com uma barra invertida. Uma senha escrita como pass;word, por exemplo, é codificada como pass\;word. Errar nisso é um dos motivos mais comuns de um código de Wi-Fi ser lido, mas não conectar.

Suporte nos celulares e boas práticas

Os apps de câmera nativos do iPhone (a partir do iOS 11, mais ou menos) e do Android (a partir do Android 10, mais ou menos) reconhecem códigos de Wi-Fi e oferecem entrar na rede. Celulares mais antigos podem precisar de um aplicativo leitor à parte.

A senha fica guardada em texto simples dentro do código, então quem conseguir escaneá-lo consegue lê-la. Redes de visitantes são uma boa opção, e o código precisa ser gerado de novo sempre que a senha mudar, já que o texto fica fixo na imagem impressa.

Perguntas frequentes

Como faço um QR Code para o meu Wi-Fi?

Codifique o texto WIFI:T:WPA;S:NomeDaSuaRede;P:SuaSenha;; num QR Code, trocando o nome e a senha. A maioria dos celulares oferecerá entrar na rede ao escaneá-lo.

O QR Code de Wi-Fi funciona com WPA3?

Na maioria dos casos, sim. Usar T:WPA costuma funcionar para redes pessoais WPA2 e WPA3, porque o celular negocia o protocolo ao se conectar.

Por que meu QR Code de Wi-Fi é lido, mas não conecta?

As causas comuns são um nome de rede digitado errado (há diferença entre maiúsculas e minúsculas), uma senha que mudou ou caracteres especiais, como ; , : ou \, que não foram escapados com uma barra invertida.

É seguro publicar um QR Code de Wi-Fi?

Quem o escanear consegue ler a senha, então publique códigos só de redes que você aceita compartilhar, como uma rede de visitantes separada.

Todos os termos