웹훅 서명 키 교체에서 오래된 키를 안전하게 정리하기

웹훅 서명 키를 바꾸는 동안 보내는 쪽과 받는 쪽의 적용 시점이 다를 수 있습니다. 기존 키를 너무 빨리 폐기하면 정상 이벤트가 거부되고, 계속 남겨두면 관리 대상이 늘어납니다.

실무 적용 방법

교체 기간에는 허용할 키의 범위와 종료 시각을 정하고 수신 검증 기록에 어떤 키 버전이 사용됐는지 남깁니다. 비밀 값 자체는 로그에 기록하지 않습니다.

점검할 사항

전환 전후의 정상 서명과 오래된 키로 만든 서명을 각각 시험합니다. 종료 시각 이후 이전 키가 거부되고 실패 이벤트를 조사할 담당자가 지정돼 있는지 확인합니다.

참고: Stripe Docs — Webhook Signatures

#웹훅보안 #비밀키교체 #서명검증 #키로테이션 #SaaS보안 #네이처프랙탈 #서비스품질 #제품개발 #운영설계 #디지털전환