1. 계산기 찾기
  2. 숫자와 단위 입력하기
  3. 결과 읽기와 신뢰하기
  4. 저장, 공유, 삽입
  5. API로 개발하기
  6. 계정 및 요금제
  7. 개인정보 및 내 데이터
  8. 문제 해결

웹훅 서명 검증하기

X-CalcLib-Signature 헤더로 t.body 문자열을 만들고, 시크릿으로 HMAC-SHA256을 계산해 비교하세요. 검증이 끝난 뒤에만 전송된 내용을 처리해야 합니다.

API 토큰, 사용량, AI 에이전트용 MCP 서버, 웹훅.

웹훅에서 추가한 웹훅 엔드포인트는 누군가 내 임베드에서 계산기를 실행할 때마다 서명된 POST 요청을 받습니다. 모든 전송에는 t=<unix time>,v1=<signature> 형식의 X-CalcLib-Signature 헤더가 포함됩니다.

파싱하기 전에 검증하세요

  1. 원본 요청 본문을 읽으세요. JSON을 파싱한 뒤 다시 직렬화하면 바이트가 달라져 서명이 절대 일치하지 않습니다.
  2. 헤더에서 t를 가져와 t.body 문자열을 만드세요. 타임스탬프, 점, 원본 본문을 차례로 이어 붙인 문자열입니다.
  3. 이 문자열에 엔드포인트 시크릿으로 HMAC-SHA256을 계산해 16진수(hex)로 구하세요.
  4. 이 값을 각 v1 값과 상수 시간 방식으로 비교하세요. 시크릿을 교체하는 동안에는 헤더에 v1 값이 두 개 들어 있을 수 있으며, 둘 중 하나만 일치하면 됩니다.
  5. t가 현재 시각과 5분 넘게 차이 나면 해당 전송을 거부하세요.

전송에 실패하면

1분, 5분, 30분, 2시간, 8시간 후에 다시 시도합니다. 엔드포인트가 연속 20번 실패하면 비활성화되며, 알림의 제품 이메일 설정에 따라 이메일로 알려 드립니다.

이 글이 도움이 되었나요?

아직 해결되지 않았나요? 고객지원 문의 · 도움말 센터