Què incloure en un informe d’error de proxy
Conserveu les proves útils de connexió i elimineu contrasenyes del proxy, testimonis de compte, galetes i detalls privats de les peticions.
Doneu al suport el pas que ha fallat i l’error exacte, en lloc de dir només «el proxy no funciona». Un informe breu pot seguir aquesta estructura:
Client and version:
Proxy protocol and port:
Attempt time and timezone:
Connection / overall timeout settings:
Last completed stage:
Exact error or numeric status:
Same target over an allowed direct route:
Same target through another comparable endpoint:
Descriviu l’etapa com a connexió al proxy, autenticació del proxy, establiment del túnel, TLS de la destinació o resposta HTTP final. Per exemple, «proxy HTTP al port 8080; TCP connectat; CONNECT ha retornat 407; encara sense TLS de la destinació» identifica el problema sense revelar credencials. Per a un error de certificat, conserveu la categoria i el context del nom d’amfitrió esperat, ocultant noms privats quan calgui.
Reviseu el text real abans de compartir-lo. Elimineu el userinfo de l’URL del proxy, Proxy-Authorization, el Authorization de la destinació, Cookie, Set-Cookie, valors privats de consulta i cossos de petició. Una galeta de sessió o un testimoni bearer pot donar accés sense semblar una contrasenya. L’emmascarament varia segons la versió i el mode de sortida; un registre detallat i una traça completa no han d’ocultar igual.
Utilitzeu marcadors com REDACTED_PROXY_PASSWORD mantenint visibles els noms de capçalera, l’estructura de l’URL i els errors numèrics. No esborreu tot l’intercanvi al voltant de la fallada. Compartiu punts d’accés privats i detalls de xarxa només al canal de suport adequat.
Si una petició mínima a una destinació innòcua o un servei que controleu reprodueix el problema, adjunteu-la en comptes d’una traça amb dades de negoci. Si l’error només passa amb la destinació original, indiqueu-ho: canviar-la modifica què demostra la reproducció. Per a un proxy HTTP, una petició curl amb temps limitat pot servir d’exemple mínim.