O Safari abre, uma página carrega e nada mais acontece. Isso surpreende as pessoas porque o código foi entregue como uma configuração de VPN, mas o telefone o tratou como um link. Ambos os comportamentos vêm do mesmo lugar: um código QR carrega bytes, e algo no telefone tem de reconhecer esses bytes como um formato que entende. Quando nada os reconhece, o recurso sensato é mostrar texto ou oferecer abrir um URL.

Primeiro passo: decodifique o conteúdo antes de culpar

Leia o código com um leitor comum e observe os primeiros caracteres. Um http ou https inicial indica um endereço de transferência, uma declaração XML indica texto de carga, e um bloco curto que começa com o nome de um produto costuma pertencer ao formato de importação privado de um cliente. Essa única olhada diz qual das verificações seguintes se aplica. Também encerra uma discussão sobre o telefone que na verdade é uma discussão sobre o conteúdo. Registe o achado no ticket, porque o próximo leitor vai perguntar o que o código realmente continha.

Renomear um ficheiro transferido não muda o que ele é. São os bytes que decidem qual aplicação o pode consumir.

Segundo passo: combine o leitor com a carga

A câmara não tem importador de VPN, por isso oferece as leituras genéricas: abrir a ligação, copiar o texto, adicionar o endereço aos contactos. Um cliente que traz o seu próprio leitor pode reconhecer um formato que a câmara nunca reconhecerá. Nenhum dos dois resultados diz nada sobre outro cliente noutro telefone. Quando num mesmo local se usam dois clientes, é justamente esse desalinhamento que explica um código que funciona para uma pessoa e falha para a seguinte.

Pergunte ao operador para que cliente o código foi gerado. Essa pergunta resolve mais casos do que qualquer definição do leitor.

Terceiro passo: transferir não é instalar

Um perfil de configuração da Apple obtido por URL ainda tem de ser instalado. O ficheiro chega à secção de perfis das Definições, e alguém tem de o rever e confirmar aí a instalação. Abrir a ligação e instalar o perfil são acontecimentos distintos, e nenhum deles liga o túnel. Acompanhe as três fases em separado, ou a última será culpada pelas duas primeiras.

Um dispositivo gerido pode recusar a instalação de imediato, e um código QR não tem autoridade para anular essa decisão.

Quarto passo: classifique a imagem como os dados que contém

Se a carga incorporar uma chave ou uma credencial, a imagem é uma cópia desse segredo. As capturas de ecrã viajam por aplicações de conversação, anexos e rolos de câmara, e nenhuma delas foi concebida para guardar segredos. Decida onde pode viver uma fotografia do código com as mesmas regras que aplica à própria chave.

Se a carga apontar para uma transferência, a ligação e as regras do servidor decidem quem pode obter o material. Um código impresso num cartaz não é um canal privado.

Quinto passo: verifique o túnel como fase própria

Após uma importação bem-sucedida, verifique a configuração como assunto separado: está selecionada, liga-se, e um recurso privado responde. Cada um destes pontos tem uma correção e um responsável diferentes. Uma configuração que se liga enquanto o recurso privado fica em silêncio já lhe disse que o túnel funciona e que a rota ou o resolver não.

Anote que fase falhou. Quatro fases com uma falha é um ticket de suporte; quatro fases esmagadas numa queixa é um mistério para todos. Depois passe o material com a fase escrita ao lado: o que o código carrega, que cliente o consome e se a instalação ou a ligação foi a última coisa que funcionou.

Artigos relacionados