서명이 맞는 웹훅이 두 번 도착하면
웹훅 서명은 요청 본문의 진위를 검증하는 데 쓰이고, 같은 요청이 반복돼도 업무 처리가 한 번만 실행되게 하려면 별도의 통제가 필요합니다.
같은 배포가 두 번 실행됐습니다
가상의 업무 예시입니다. 개발팀이 코드 저장소에서 이벤트를 받으면 사내 배포 작업을 시작하도록 연동했습니다. 장애 복구 중 담당자가 이전 이벤트를 다시 전송하자 같은 배포가 두 번 실행됐습니다. 수신 서버에는 두 요청 모두 서명 검증에 성공한 것으로 표시됩니다.
요청의 진위와 중복 실행을 따로 확인합니다
웹훅은 한 시스템의 이벤트를 다른 시스템에 HTTP 요청으로 알리는 방식입니다. GitHub 웹훅은 공유 비밀값과 요청 본문을 이용해 서명을 검증할 수 있습니다. 유효한 요청의 재전송에도 서명이 유효할 수 있으므로, 수신 서버는 이전에 처리한 요청인지 따로 확인해야 합니다. GitHub는 X-GitHub-Delivery를 중복 식별에 활용하도록 안내하며, 기존 전달을 재전송하면 같은 식별자가 사용됩니다.
실무에서 확인할 사항
서명은 파싱하거나 재구성하기 전의 요청 본문으로 검증합니다. 검증이 끝난 뒤에도 허용된 저장소·이벤트·작업 대상인지 확인합니다.
전달 식별자와 업무 처리 키를 구분합니다. 같은 전달의 반복은 전달 식별자로 확인하고, 서로 다른 전달이 같은 배포를 요청하는 경우는 배포 대상과 버전 등 업무 키로 통제합니다.
요청 두 건이 동시에 도착하거나 업무 처리는 성공했지만 응답이 끊기는 상황을 시험합니다. 중복 확인과 실행 사이에 경쟁이 생기지 않는지, 처리 실패와 완료를 구분해 재시도할 수 있는지 확인합니다.
수신·검증·중복 판단·실행 결과를 연결할 식별자를 남깁니다. 공유 비밀값과 불필요한 요청 본문은 로그에서 제외합니다.
같은 요청의 반복은 정상 재전송에서도 발생합니다. 공격 여부는 재전송 기록과 업무 처리 기록을 함께 검토해야 합니다. 전달 식별자의 제공 방식과 서명 대상은 서비스별로 다르므로 실제 연동 사양을 확인합니다.
