Um pedido de suporte de VPN doméstica precisa de um fluxo, não de um despejo de configuração
Um fluxo, três responsáveis e uma falha observada superam um despejo de configuração. Use este registo, nomeie a etapa que falha e oculte os segredos sem perder a topologia.
Publica uma configuração redigida, refere que a VPN não funciona e recebe seis respostas sobre seis coisas diferentes. O problema costuma ser o pedido, não os leitores. Quem ajuda não consegue saber a partir de uma configuração se o túnel não é construído, se é construído mas descarta o tráfego, ou se funciona bem enquanto o serviço de ficheiros por trás recusa a ligação. Descreva antes um fluxo, com três responsáveis e uma falha observada, e as respostas melhoram de imediato.
Porque o pedido recebe respostas inúteis
Uma configuração descreve o que está configurado. Não descreve o que tentou, o que aconteceu nem qual de várias máquinas deve fazer que trabalho. Sem isso, cada leitor adivinha uma etapa diferente.
O caso ilustrativo é um portátil em viagem que deve chegar a um serviço de ficheiros num servidor doméstico através da gateway doméstica. Indique se a gateway, o servidor VPN e o servidor de ficheiros são a mesma máquina ou três máquinas, porque esse único facto muda quase todas as respostas.
Preencha este registo antes de publicar
Goal: the one resource or operation that should work
Path: client -> access network -> VPN endpoint -> resource
Owners: who controls the client, the gateway and the resource
Software: product, version and protocol in use
Expected: what success would look like
Observed: exact non-secret error or response
Time and change: when it started and what changed
Control: one comparable operation that still works
Oito linhas, e a maioria dos pedidos torna-se respondível. A linha de controlo é a que as pessoas omitem: se navegar a partir do mesmo portátil funciona enquanto a partilha de ficheiros não, isso restringe o problema às rotas do túnel ou ao serviço, e ninguém precisa de perguntar.
Mantenha as etiquetas coerentes quando redige. Preserve a diferença entre o ponto final público, o endereço do túnel e a sub-rede doméstica. Se dois intervalos se sobrepuserem, mantenha essa relação visível em vez de substituir cada rede pelo mesmo marcador, porque a sobreposição é muitas vezes a resposta.
Nomeie a etapa que falha, não todo o registo
Vale a pena separar cinco etapas: resolução de nomes, tentativa de ligação, autenticação, estabelecimento do túnel e acesso ao recurso. Diga qual pensa que falhou e o que viu ali.
Cole um pequeno excerto em torno do acontecimento em vez de cada ficheiro de depuração que o cliente possa produzir. Cem linhas de ruído de aperto de mão escondem a linha que diz que o nome do certificado não coincidia.
Mantenha a observação e a explicação separadas. «O cliente relata um tempo limite de aperto de mão após 30 segundos» é uma observação; «penso que o fornecedor bloqueia UDP» é uma teoria. Ambas são úteis, e misturá-las significa que quem ajuda não sabe em qual confiar. Etiquete-as, e a resposta que receber tratará da correta.
Envie-o ao responsável que pode agir
Para um portátil gerido pela entidade empregadora, comece pelo canal de suporte da entidade empregadora, porque um fórum comunitário não pode mudar a política dela. Para um serviço VPN comercial, indique o produto e a conta em privado, não em público. Para a sua própria gateway, inclua os papéis de router e de servidor que controla.
Se usar uma comunidade pública, escolha uma cujo âmbito atual se adeque à tarefa. Um tópico antigo sobre as regras do fórum não é um contrato de suporte, e uma resposta com cinco anos sobre uma versão de protocolo que não executa também não é.
Oculte os segredos sem achatar a topologia
Remova as chaves privadas, as palavras-passe, os tokens e as ligações que transportam credenciais antes de algo sair da sua máquina. Uma exportação de diagnóstico e uma configuração completa são artefactos diferentes mesmo quando os nomes dos ficheiros parecem iguais, e o que colou pode conter uma chave pré-partilhada.
Depois mantenha as relações que tornam o fluxo compreensível. O RFC 6973 trata a recolha e a correlação desnecessárias como questões de privacidade, e o mesmo princípio aplica-se aqui: partilhe as provas de que o destinatário precisa, não a máquina inteira.
Termine com uma pergunta respondível sobre a discrepância observada, como por que razão o cliente conclui a autenticação e depois nunca recebe uma rota. Uma pergunta específica obtém uma resposta específica, e o registo que construiu é o que permite a alguém dar uma sem pedir os seus segredos.