사용 방법
- 알고리즘(HMAC-SHA256, SHA384, SHA512)을 고릅니다. 특별한 지정이 없으면 SHA256이 가장 흔합니다.
- 비밀 키를 입력합니다. 키가 16진수나 Base64로 주어졌다면 키 형식을 맞춰 바꿔야 같은 값이 나옵니다. 텍스트는 UTF-8 바이트로 변환됩니다.
- 메시지를 입력하면 바로 결과가 hex(소문자·대문자), Base64, Base64URL로 표시됩니다. 페이지를 열면 RFC 4231 예시(키
Jefe)가 채워져 있습니다. - 웹훅이나 API 응답으로 받은 서명이 있으면 서명 확인 칸에 붙여넣습니다. 일치 여부를 바로 알려 줍니다.
HMAC이 하는 일
HMAC은 비밀 키를 아는 사람만 만들 수 있는 “메시지의 확인 도장”입니다. 메시지와 함께 값이 도착하면, 받는 쪽이 같은 키로 다시 계산해 보고 일치하면 메시지가 중간에 바뀌지 않았고 키를 가진 쪽이 보냈다고 판단합니다. 해시 단독과 달리 키 없이는 값을 위조할 수 없습니다. 값 자체로는 내용을 숨기지 않습니다. 내용을 숨기려면 AES 암호화·복호화를 쓰세요.
| 알고리즘 | 출력 길이 | hex 글자 수 | Base64 글자 수 |
|---|---|---|---|
| HMAC-SHA256 | 32바이트 | 64 | 44 (패딩 = 포함) |
| HMAC-SHA384 | 48바이트 | 96 | 64 |
| HMAC-SHA512 | 64바이트 | 128 | 88 (패딩 포함) |
검증용 값: 키 Jefe, 메시지 what do ya want for nothing? 의 HMAC-SHA256은 5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843 입니다(RFC 4231 테스트 케이스 2). 이 도구는 RFC 4231의 벡터와 Node.js crypto 결과로 계산이 맞는지 확인했습니다.
서비스별 서명 형식
| 서비스 | 서명 대상 | 표기 |
|---|---|---|
GitHub 웹훅 (X-Hub-Signature-256) |
받은 본문 그대로 | sha256= + hex |
Shopify 웹훅 (X-Shopify-Hmac-Sha256) |
받은 본문 그대로 | Base64 |
Stripe (Stripe-Signature) |
타임스탬프.본문 |
헤더 안의 v1= hex |
Slack (X-Slack-Signature) |
v0:타임스탬프:본문 |
v0= + hex |
서비스마다 서명 대상 문자열을 만드는 방식이 다르므로, 위 표를 보고 메시지 칸에 같은 문자열을 만들어 넣으세요. sha256= 같은 머리말은 서명 확인 칸이 알아서 떼고 비교합니다. 최신 규격은 각 서비스 문서를 확인하세요.
주의할 점
- 웹훅 본문은 JSON으로 파싱했다가 다시 문자열로 만들면 공백과 키 순서가 달라져 서명이 맞지 않습니다. 받은 원문 그대로 계산하세요.
- 서버 코드에서 서명을 비교할 때는
==대신 시간이 일정한 비교 함수(Node의crypto.timingSafeEqual등)를 쓰세요. - 키는 길고 무작위여야 합니다. 비밀번호 생성기로 32자 이상 만드는 것이 좋습니다. 실제 운영 키를 외부 사이트에 입력하는 것은 피하고, 테스트용 키로 확인하세요.
- 키가 블록 크기(SHA256은 64바이트, SHA512는 128바이트)보다 길면 먼저 해시되어 짧아집니다. 결과는 같은 규칙으로 계산됩니다.
자주 묻는 질문
HMAC과 그냥 해시는 무엇이 다른가요?
해시는 누구나 같은 값을 계산할 수 있어 위조를 막지 못합니다. HMAC은 비밀 키가 섞여 있어 키를 모르면 올바른 값을 만들 수 없습니다. 파일 무결성만 볼 때는 해시 생성기로 충분합니다.
웹훅 서명이 계속 일치하지 않으면 무엇을 확인하나요?
가장 흔한 원인은 본문 변형(JSON 재직렬화, 끝의 줄바꿈 제거), 키 인코딩 혼동(텍스트 대 hex), 알고리즘 불일치(SHA256 대 SHA512), 그리고 hex와 Base64 표기를 바꿔 비교하는 것입니다. 하나씩 바꿔 가며 확인하세요.
SHA1 HMAC은 없나요?
HMAC-SHA1은 아직 깨지지는 않았지만 신규 설계에서는 SHA-256 이상을 권장하므로 이 도구는 SHA256, SHA384, SHA512만 제공합니다.
JWT의 HS256은 이것과 같은가요?
네. JWT HS256 서명은 헤더.페이로드 문자열에 대한 HMAC-SHA256을 Base64URL로 적은 것입니다. 토큰 내용은 JWT 디코더로 확인할 수 있습니다.
입력한 키가 서버로 전송되나요?
아니요. 이 페이지 안에서만 계산하며 키와 메시지는 전송·저장되지 않습니다.
관련 도구
- 일반 해시 계산은 해시 생성기, 암호화는 AES 암호화·복호화를 쓰세요.
- Base64 값을 풀어 보려면 Base64 인코더·디코더가 있습니다.
입력한 키와 메시지는 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.