웹훅 서명 검증하기
X-CalcLib-Signature 헤더로 t.body 문자열을 만들고, 시크릿으로 HMAC-SHA256을 계산해 비교하세요. 검증이 끝난 뒤에만 전송된 내용을 처리해야 합니다.
웹훅에서 추가한 웹훅 엔드포인트는 누군가 내 임베드에서 계산기를 실행할 때마다 서명된 POST 요청을 받습니다. 모든 전송에는 t=<unix time>,v1=<signature> 형식의 X-CalcLib-Signature 헤더가 포함됩니다.
파싱하기 전에 검증하세요
- 원본 요청 본문을 읽으세요. JSON을 파싱한 뒤 다시 직렬화하면 바이트가 달라져 서명이 절대 일치하지 않습니다.
- 헤더에서
t를 가져와t.body문자열을 만드세요. 타임스탬프, 점, 원본 본문을 차례로 이어 붙인 문자열입니다. - 이 문자열에 엔드포인트 시크릿으로 HMAC-SHA256을 계산해 16진수(hex)로 구하세요.
- 이 값을 각
v1값과 상수 시간 방식으로 비교하세요. 시크릿을 교체하는 동안에는 헤더에v1값이 두 개 들어 있을 수 있으며, 둘 중 하나만 일치하면 됩니다. t가 현재 시각과 5분 넘게 차이 나면 해당 전송을 거부하세요.
전송에 실패하면
1분, 5분, 30분, 2시간, 8시간 후에 다시 시도합니다. 엔드포인트가 연속 20번 실패하면 비활성화되며, 알림의 제품 이메일 설정에 따라 이메일로 알려 드립니다.