HMAC 생성기 (Base64)

Base64로 HMAC을 계산하는 방법

1. HMAC 모드와 SHA-256이 선택되어 있습니다. API가 SHA-1, SHA-384, SHA-512, MD5를 쓴다면 알고리즘에서 다른 것을 고르세요.
2. 비밀 키를 입력하고 키 형식을 설정하세요. 일반 시크릿 문자열이면 텍스트 (UTF-8), 키가 인코딩된 바이트로 주어졌다면 Hex나 Base64입니다.
3. 텍스트에 메시지를 입력하거나 붙여넣으세요. 또는 입력을 파일로 바꾸고 정확한 페이로드 파일을 놓으세요.
4. 서명을 Base64, Base64URL, hex로 복사하세요. 모든 알고리즘은 모든 해시로 계산한 HMAC을 한 번에 보여 주므로, 문서에 어떤 해시를 쓰는지 분명하지 않을 때 도움이 됩니다.

빈 키도 받아서 결과를 내지만, 그런 HMAC은 아무것도 보호하지 못한다는 안내가 표시됩니다.

예시 값

키 key와 메시지 The quick brown fox jumps over the lazy dog의 결과입니다.

HMAC-SHA256 값을 hex로 쓰면 f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8로, Wikipedia의 HMAC 문서에 나오는 익숙한 테스트 벡터입니다. 키 인코딩에 따라 결과가 달라집니다. 텍스트 a2V5를 키로 쓰면 5O+7AtpguFrgIRw1qXGU+m0OaTs1oV1kwRQ/hI1WAUE=가 나오지만, a2V5를 Base64로 읽으면 key의 바이트가 되어 다시 97yD9DBT…가 나옵니다.

웹훅 서명: Base64인가 hex인가

제공자들은 HMAC을 쓴다는 점에는 같지만, 출력 인코딩과 서명 대상은 다릅니다. 문서화가 잘된 몇 가지 예입니다.

이 도구의 값이 hex로는 맞는데 코드는 Base64로 비교하고 있다면, 또는 그 반대라면, 계산은 맞고 인코딩만 다른 것입니다. 무엇을 서명하는지는 제공자 문서를 확인하세요. 타임스탬프 접두사는 오래된 요청의 재전송을 막기 위해 있습니다.

코드에서 서명 검증하기

원시 바이트를 상수 시간으로 비교하고, 받은 그대로의 본문을 해시하세요.

const crypto = require("crypto");

function verifyWebhook(rawBody, secret, signatureHeader) {
  const expected = crypto.createHmac("sha256", secret).update(rawBody).digest();
  const given = Buffer.from(signatureHeader, "base64");
  return given.length === expected.length && crypto.timingSafeEqual(given, expected);
}

rawBody에 여우 문장의 Buffer를, 시크릿에 key를, 표의 Base64 값을 넣으면 true를 돌려줍니다. 원본 본문 대신 JSON.stringify(JSON.parse(body))를 넣으면, 제공자의 JSON에 직렬화기가 지워 버리는 공백이 하나라도 있는 순간 false를 돌려줍니다. Express에서는 웹훅 경로에서 express.raw()로 본문을 읽어야 한다는 뜻입니다.

Python에서는 hmac.new(key, body, hashlib.sha256).digest()로 계산하고, Base64로 인코딩한 뒤 hmac.compare_digest로 확인합니다. 명령줄에서는 openssl dgst -sha256 -hmac 'key' -binary | base64가 같은 Base64를 출력하며, 키가 hex라면 -mac HMAC -macopt hexkey:…를 쓰세요. 강력한 키는 Base64 키 생성기의 HMAC 시크릿 프리셋이 무작위 32바이트를 만들어 줍니다. 서명된 요청이 아니라 서명된 토큰이 필요하다면 JWT 인코더를 참고하세요.

자주 묻는 질문