Gerador de QR Code de Wi-Fi
Gere um QR code que permite a qualquer telemóvel ligar-se a uma rede Wi-Fi com uma só leitura — sem digitar a palavra-passe. Reconhecido nativamente pelas câmaras do iOS e do Android. Funciona inteiramente no seu navegador.
213 visualizações
O Formato do QR Code de Wi-Fi
Um QR code de Wi-Fi funciona porque, em vez de codificar uma simples ligação, codifica uma pequena cadeia de texto estruturada: WIFI:T:WPA;S:MinhaRede;P:MinhaPassword;H:false;;. Cada campo tem uma chave de uma letra — T para o tipo de segurança (WPA, WEP ou nopass para uma rede aberta), S para o nome da rede (SSID), P para a palavra-passe e H para indicar se a rede está oculta — separados por ponto e vírgula e fechados com um ponto e vírgula duplo. A aplicação de câmara do telemóvel analisa essa cadeia, reconhece o prefixo WIFI: e oferece a opção de ligar-se diretamente à rede, em vez de abrir o conteúdo como uma ligação ou texto simples.
Este formato não tem por trás nenhuma especificação oficial do IEEE ou da Wi-Fi Alliance. Foi popularizado pela ZXing (Zebra Crossing), a biblioteca de leitura de códigos de barras de código aberto sobre a qual muitos dos primeiros leitores de QR para Android foram construídos, e tornou-se um padrão de facto da indústria simplesmente porque todos os outros copiaram a mesma sintaxe. A Apple deu-lhe suporte oficial de primeira classe a partir do iOS 11, em 2017, quando a aplicação Câmara nativa passou a reconhecer um QR code de Wi-Fi e a oferecer um aviso de "Aderir à Rede" com um único toque; a câmara nativa do Android e o Google Lens também suportam nativamente o mesmo formato. Como o formato nunca ficou preso a uma especificação formal, existem pequenas diferenças de implementação entre leitores — alguns assumem, de forma tolerante, que a rede é visível quando o campo H: é simplesmente omitido — mas os campos T:, S: e P: são lidos de forma idêntica por praticamente todos os leitores em uso atualmente, o que torna o formato fiável na prática apesar de não haver nenhum organismo oficial a regê-lo.
Por Que os Caracteres Especiais Têm de Ser Escapados
Como o ponto e vírgula e a vírgula são os próprios separadores de campos e valores do formato, um nome de rede ou palavra-passe que contenha um deles — uma rede de convidados chamada Escritorio,Piso 2, por exemplo — quebraria silenciosamente o analisador se fosse deixado tal como está: a vírgula não escapada seria interpretada como o limite entre dois campos completamente diferentes, corrompendo tudo o que vem a seguir. A especificação resolve isto exigindo que cinco caracteres sejam escapados com uma barra invertida sempre que aparecem dentro de um valor: a própria barra invertida (\ → \\), o ponto e vírgula (; → \;), a vírgula (, → \,), os dois pontos (: → \:) e as aspas duplas (" → \"). Esta ferramenta aplica esse escape automaticamente tanto ao nome da rede como à palavra-passe antes de codificar, para que possa usar com segurança qualquer carácter aceite pelo seu router.
Tenha em conta que se trata de um código estático: incorpora a palavra-passe atual diretamente na imagem, por isso, se a palavra-passe do Wi-Fi mudar, este código exato deixa de funcionar e terá de gerar um novo. Vale também a pena notar que, embora o WPA3 já seja comum em routers mais recentes, esta ferramenta — como a maioria dos geradores de QR de Wi-Fi — continua a codificar redes WPA3 com T:WPA, uma vez que o formato é anterior ao WPA3 e todos os leitores já interpretam esse valor como "usar o processo padrão de negociação de palavra-passe", o que funciona corretamente independentemente de o router estar de facto a usar WPA2 ou WPA3. Tudo acontece localmente no seu navegador — o nome da rede e a palavra-passe nunca são transmitidos para lado nenhum, o que é relevante já que está a codificar uma credencial real e não apenas uma ligação pública.
Perguntas Frequentes
O formato do QR code de Wi-Fi é um padrão oficial?
Não. Não existe nenhuma especificação do IEEE ou da Wi-Fi Alliance para ele. O formato WIFI: foi popularizado pela ZXing (Zebra Crossing), uma biblioteca de código de barras de código aberto, e tornou-se um padrão de facto simplesmente porque todas as grandes aplicações de câmara e geradores de QR adotaram a mesma sintaxe. Funciona em todo o lado apesar de nunca ter sido formalmente normalizado.
Que telemóveis conseguem ler um QR code de Wi-Fi?
Qualquer iPhone com iOS 11 ou posterior (lançado em 2017) reconhece-o diretamente na aplicação Câmara nativa, com um aviso de "Aderir à Rede" com um único toque. Os telemóveis Android suportam o mesmo formato através da câmara nativa ou do Google Lens, embora a interface exata de leitura varie um pouco consoante o fabricante e a versão do Android.
Por que motivo os caracteres especiais no nome da rede precisam de ser escapados?
O ponto e vírgula, a vírgula e os dois pontos são os próprios caracteres estruturais do formato — marcam onde um campo termina e o seguinte começa. Se o seu SSID ou palavra-passe contiver um destes caracteres sem escape, o leitor de QR interpreta-o incorretamente como um separador de campo e ou liga-se com um valor corrompido ou falha por completo. O escape com barra invertida, que esta ferramenta aplica automaticamente, indica ao analisador para tratar o carácter como texto literal.
O que acontece se eu mudar a palavra-passe do Wi-Fi depois de gerar o código?
O código deixa de funcionar. É um QR code estático — a palavra-passe existente no momento em que o gerou fica gravada diretamente na imagem, sem qualquer ligação ao seu router que pudesse captar uma alteração automaticamente. Gere e imprima um novo código sempre que a palavra-passe mudar.
É seguro escrever a palavra-passe do meu Wi-Fi nesta ferramenta?
Sim — todo o processo, desde o preenchimento do formulário até à criação da imagem QR, corre localmente no seu navegador com JavaScript. Nada do que escreve é enviado para nenhum servidor. Ainda assim, trate o próprio QR code impresso ou partilhado com o mesmo cuidado que teria com a palavra-passe: quem o ler pode entrar na sua rede.
Ferramentas Semelhantes
Reportar um Problema
Gerador de QR Code de Wi-Fi
Comentários
Ainda não há comentários — seja o primeiro a escrever um!