가림 처리한 설정을 올리고 VPN이 작동하지 않는다고 적으면 서로 다른 여섯 가지에 대한 여섯 개의 답이 돌아옵니다. 문제는 대개 요청 쪽에 있고 읽는 사람이 아닙니다. 도우미는 설정만으로 터널이 만들어지지 않는지, 만들어지지만 트래픽을 버리는지, 아니면 잘 동작하는데 뒤쪽 파일 서비스가 연결을 거부하는지 판단할 수 없습니다. 대신 하나의 흐름을 세 명의 담당자와 하나의 관찰된 장애와 함께 적으면 답이 곧바로 좋아집니다.

요청이 도움이 안 되는 답을 받는 이유

설정은 무엇이 구성되었는지를 설명합니다. 무엇을 시도했고, 무슨 일이 있었고, 여러 기기 중 어느 것이 어떤 역할을 맡는지는 설명하지 않습니다. 그것이 없으면 읽는 사람마다 다른 단계를 추측합니다.

예시는 출장 중인 노트북이 집 게이트웨이를 거쳐 집 서버의 파일 서비스에 닿아야 하는 경우입니다. 게이트웨이, VPN 서버, 파일 서버가 같은 기기인지 세 기기인지 밝히세요. 이 한 가지 사실이 거의 모든 답을 바꿉니다.

올리기 전에 이 기록을 채우세요


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


여덟 줄이면 대부분의 요청이 답할 수 있는 것이 됩니다. 사람들이 빠뜨리는 것이 대조 줄입니다. 만약 같은 노트북에서 탐색은 되는데 파일 공유가 안 된다면, 문제는 터널의 경로나 서비스로 좁혀지고 아무도 물을 필요가 없습니다.

가림 처리할 때 레이블을 일관되게 유지하세요. 공용 엔드포인트, 터널 주소, 집 서브넷의 차이를 남기세요. 두 범위가 겹치면 모든 네트워크를 같은 자리표시자로 바꾸지 말고 그 관계를 보이게 두세요. 겹침이 답인 경우가 많습니다.

실패한 단계를 지목하고 로그 전체를 붙이지 마세요

다섯 단계를 나눌 만합니다. 이름 확인, 연결 시도, 인증, 터널 수립, 자원 접근입니다. 어느 것이 실패했다고 보는지, 그곳에서 무엇을 보았는지 적으세요.

클라이언트가 만들 수 있는 모든 디버그 파일 대신 사건 주변의 짧은 발췌를 붙이세요. 백 줄의 핸드셰이크 잡음이 인증서 이름이 맞지 않았다는 한 줄을 가립니다.

관찰과 해석을 분리하세요. “클라이언트가 30초 후 핸드셰이크 시간 초과를 보고한다”는 관찰이고, “통신사가 UDP를 막는다고 생각한다”는 이론입니다. 둘 다 쓸모가 있지만 섞으면 도우미는 어느 쪽을 믿어야 할지 알 수 없습니다. 레이블을 붙이면 받는 답이 올바른 쪽을 향합니다.

행동할 수 있는 담당자에게 보내세요

회사가 관리하는 노트북이라면 회사의 지원 창구에서 시작하세요. 커뮤니티 포럼은 회사 정책을 바꿀 수 없습니다. 상용 VPN 서비스라면 제품과 계정은 공개가 아니라 비공개로 알리세요. 직접 관리하는 게이트웨이라면 본인이 통제하는 라우터와 서버 역할을 적으세요.

공개 커뮤니티를 쓴다면 현재 범위가 작업과 맞는 곳을 고르세요. 포럼 규칙에 관한 오래된 스레드는 지원 계약이 아니고, 쓰지도 않는 프로토콜 버전에 관한 오 년 전 답변도 마찬가지입니다.

토폴로지를 평평하게 만들지 않고 비밀을 가리세요

무언가가 기기를 떠나기 전에 개인 키, 비밀번호, 토큰, 자격 증명이 담긴 링크를 제거하세요. 진단 내보내기와 전체 설정은 파일 이름이 비슷해 보여도 다른 산출물이며, 붙인 내용에 미리 공유된 키가 들어 있을 수 있습니다.

그다음 흐름을 이해할 수 있게 하는 관계를 남기세요. RFC 6973은 불필요한 수집과 상관을 프라이버시 문제로 봅니다. 같은 원칙이 여기에도 적용됩니다. 받는 사람에게 필요한 증거를 공유하고 기기 전체를 넘기지 마세요.

관찰된 불일치에 대해 답할 수 있는 질문 하나로 마무리하세요. 예를 들어 클라이언트가 인증을 마치고 나서 왜 경로를 한 번도 받지 못하는지입니다. 구체적인 질문은 구체적인 답을 얻고, 작성한 기록이 있어야 비밀을 묻지 않고도 답을 받을 수 있습니다.

관련 글