인증·보안
HMAC이란? 웹훅이 바뀌지 않았는지 확인하는 서명
Hash-based Message Authentication Code · HMAC-SHA256
HMAC은 공유한 비밀 키로 메시지의 확인 값을 만드는 방식이에요. 받은 웹훅의 내용을 같은 규칙으로 계산해 요청이 위조되거나 바뀌지 않았는지 확인해요.
내용을 숨기는 암호화는 아니에요
서명이 붙어 있어도 본문은 읽을 수 있어요. 전송 중 내용을 보호하는 HTTPS와 요청의 무결성을 확인하는 서명은 역할이 달라요.
서명만으로 재전송까지 막지는 못해요
정상 요청을 복사해서 다시 보낼 수 있어요. 제공되는 이벤트의 시각과 ID를 확인하고 오래됐거나 중복된 요청을 처리할 기준도 준비해요.
한국AI통신(ClawOps)의 계산 규칙을 그대로 따라요
X-Signature와 별도의 Signing Key를 사용해요. URL과 파라미터를 조합하는 공식 가이드 또는 SDK로 검증해요. 다른 서비스의 raw body 서명 예시를 그대로 적용하지 않아요.