1. 홈
  2. 개발자
  3. HMAC 생성기

HMAC 생성기

HMAC-SHA256·384·512를 hex·Base64로 계산하고 받은 서명과 비교합니다.

내 브라우저에서 처리 · 업로드 없음
서버와 공유하는 비밀 값입니다. 입력한 키는 이 페이지 밖으로 나가지 않습니다.
웹훅은 받은 본문(body)을 한 글자도 바꾸지 않고 그대로 넣어야 합니다. 줄바꿈과 공백도 결과를 바꿉니다.

HMAC 결과 | HMAC-SHA256, 32바이트 = 256비트

16진수 (소문자)
5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843
Base64
W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM=
Base64URL (패딩 없음)
W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM
16진수 (대문자)
5BDCC146BF60754E6A042426089575C75A003F089D2739839DEC58B964EC3843

서명 확인

sha256= 같은 머리말, 대소문자, 콜론, hex·Base64 어느 쪽이든 비교합니다.

HMAC은 이 기기에서만 계산되며 키와 메시지는 어디에도 전송·저장되지 않습니다.

사용 방법

  1. 알고리즘(HMAC-SHA256, SHA384, SHA512)을 고릅니다. 특별한 지정이 없으면 SHA256이 가장 흔합니다.
  2. 비밀 키를 입력합니다. 키가 16진수나 Base64로 주어졌다면 키 형식을 맞춰 바꿔야 같은 값이 나옵니다. 텍스트는 UTF-8 바이트로 변환됩니다.
  3. 메시지를 입력하면 바로 결과가 hex(소문자·대문자), Base64, Base64URL로 표시됩니다. 페이지를 열면 RFC 4231 예시(키 Jefe)가 채워져 있습니다.
  4. 웹훅이나 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 디코더로 확인할 수 있습니다.

입력한 키가 서버로 전송되나요?

아니요. 이 페이지 안에서만 계산하며 키와 메시지는 전송·저장되지 않습니다.

관련 도구

입력한 키와 메시지는 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

필요한 도구가 없나요?

어떤 작업을 하고 싶은지 적어 주세요. 요청이 많은 도구부터 만듭니다.