Tạo & Xác thực Chữ ký HMAC

Tính toán và xác thực chữ ký HMAC chuẩn RFC 2104 (SHA256, SHA384, SHA512, MD5) dạng Hex, Base64 hoặc Base64URL trên trình duyệt bằng Web Crypto.

Không tải lên máy chủKhông cần đăng kýKết quả tức thì
HMAC-SHA256 · SHA512 · MD5Hex · Base64 · Base64URL100% Cục bộ • Không tải lên
Tính HMAC
Công cụ ngoại tuyến đã sẵn sàngKhông gian làm việc 100% riêng tư trên trình duyệt • Zero tải lên đám mây
Bảo mật 100% • Không tải file lên máy chủ

Tại sao nên dùng Tạo & Xác thực Chữ ký HMAC miễn phí của Utiliome?

Xây dựng cho sự riêng tư tuyệt đối, xử lý tức thì và không có rào cản. Không yêu cầu đăng ký hay trả phí.

Cấu trúc chuẩn RFC 2104 & FIPS 198-1

Triển khai đệm khóa XOR lớp trong (0x36) và lớp ngoài (0x5c) theo đúng kích thước khối tiêu chuẩn cho HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 và HMAC-MD5, được kiểm chứng với các vector thử nghiệm IETF RFC 2202 và RFC 4231.

Giải mã Khóa Bí mật UTF-8, Hex và Base64

Phân tích khóa ký dưới dạng chuỗi UTF-8, các octet thập lục phân (Hex) thô hoặc bộ đệm byte Base64 chuẩn RFC 4648 để khóa API nhị phân được giải mã chính xác từng byte trước khi tính toán HMAC.

Chế độ Xác thực Chữ ký Thời gian Hằng số

Kiểm tra header MAC từ webhook hoặc API đối chiếu với chữ ký tính toán bằng Web Crypto crypto.subtle.verify và phép so sánh XOR từng bit có độ dài cố định nhằm chống rò rỉ thời gian xử lý.

Xuất kết quả Hex, Base64 & Base64URL cho Webhook

Tạo mã băm ở định dạng Hex chữ thường/chữ hoa (GitHub, Stripe, Slack), Base64 có padding tiêu chuẩn (Shopify, AWS) và Base64URL không padding (phân đoạn JWS/JWT) hoàn toàn ngoại tuyến trong bộ nhớ trình duyệt.

Utiliome so với các giải pháp Đám mây truyền thống

So sánh công nghệ WebAssembly xử lý nội bộ của chúng tôi với các công cụ đám mây cũ.

Tính năng Utiliome (Trình duyệt nội bộ) Công cụ đám mây truyền thống
Cấu trúc chuẩn RFC 2104 & FIPS 198-1 Triển khai đệm khóa XOR lớp trong (0x36) và lớp ngoài (0x5c) theo đúng kích thước khối tiêu chuẩn cho HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 và HMAC-MD5, được kiểm chứng với các vector thử nghiệm IETF RFC 2202 và RFC 4231. Tùy chọn hạn chế, thiếu tùy chỉnh nâng cao
Giải mã Khóa Bí mật UTF-8, Hex và Base64 Phân tích khóa ký dưới dạng chuỗi UTF-8, các octet thập lục phân (Hex) thô hoặc bộ đệm byte Base64 chuẩn RFC 4648 để khóa API nhị phân được giải mã chính xác từng byte trước khi tính toán HMAC. Cần công cụ bên ngoài hoặc xử lý thủ công
Quyền riêng tư & Xử lý dữ liệu Xử lý cục bộ 100% trong trình duyệt (không tải lên máy chủ) Tải dữ liệu lên máy chủ đám mây bên thứ ba
Chi phí & Yêu cầu tài khoản Miễn phí 100% mãi mãi, không cần đăng ký Yêu cầu đăng ký tài khoản hoặc trả phí thuê bao
Cách thức hoạt động

Cách sử dụng Tạo & Xác thực Chữ ký HMAC qua 3 bước đơn giản

Không cần cài đặt phần mềm. Mọi thứ hoạt động trực tiếp trên trình duyệt web của bạn.

1

Cung cấp Payload Thông điệp Chính xác

Dán phần thân (body) HTTP request nguyên bản chưa định dạng hoặc chuỗi ký chuẩn hóa (canonical string) — giữ nguyên khoảng trắng và thứ tự khóa — hoặc kéo thả file payload đã thu thập.

2

Cấu hình Định dạng Khóa Bí mật & Thuật toán Băm

Nhập khóa bí mật chung (shared secret), chọn kiểu biểu diễn byte của khóa (văn bản thuần UTF-8, Hex hoặc Base64), sau đó chọn HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 hoặc HMAC-MD5.

3

Sao chép MAC hoặc Xác thực Chữ ký Nhận được

Sao chép chuỗi digest Hex, Base64 hoặc Base64URL vừa tạo, hoặc dán chữ ký cần đối chiếu (loại bỏ các tiền tố truyền tải như sha256= hoặc v0=) để chạy kiểm tra xác thực theo thời gian hằng số.

Tính toán và Xác thực Chữ ký HMAC cho Webhook & API: Hướng dẫn Thực tế

Trả lời nhanh: Khi ký thông điệp what do ya want for nothing? bằng khóa bí mật 4 byte Jefe (IETF RFC 4231 Test Case 2) với thuật toán HMAC-SHA256, kết quả thu được là 5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843 ở dạng Hex và W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM= ở dạng Base64, đồng nhất trên cả 3 chế độ nhập khóa UTF-8, Hex (4a656665) và Base64 (SmVmZQ==).

Mã xác thực thông điệp dựa trên hàm băm có khóa (Keyed-Hash Message Authentication Code - HMAC) chứng minh đồng thời tính toàn vẹn dữ liệu (payload không bị chỉnh sửa trên đường truyền) và tính xác thực (bên gửi nắm giữ khóa bí mật chung). Để tái tạo chính xác chữ ký của nhà cung cấp dịch vụ, bạn cần khớp đúng ba tham số: hàm băm cơ sở, chuỗi byte thô sau khi giải mã khóa bí mật, và trình tự byte chính xác của payload được ký.

Ví dụ 1: IETF RFC 2104 / RFC 2202 / RFC 4231 Test Case 2

Cho dù bạn nhập khóa bí mật 4 byte dưới dạng văn bản UTF-8 Jefe, mã thập lục phân thô 4a656665, hay Base64 SmVmZQ==, công cụ đều giải mã chúng về cùng một bộ đệm khóa [0x4a, 0x65, 0x66, 0x65]. Ký thông điệp UTF-8 dài 28 byte what do ya want for nothing? sẽ cho ra kết quả:

{
  "keyUtf8": "Jefe",
  "keyHex": "4a656665",
  "keyBase64": "SmVmZQ==",
  "message": "what do ya want for nothing?",
  "signatures": {
    "hmac_md5_hex": "750c783e6ab0b503eaa86e310a5db738",
    "hmac_sha1_hex": "effcdf6ae5eb2fa2d27416d5f184df9c259a7c79",
    "hmac_sha256_hex": "5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843",
    "hmac_sha256_base64": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM=",
    "hmac_sha256_base64url": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM",
    "hmac_sha384_hex": "af45d2e376484031617f78d2b58a6b1b9c7ef464f5a01b47e42ec3736322445e8e2240ca5e69e2c78b3239ecfab21649",
    "hmac_sha512_hex": "164b7a7bfcf819e2e395fbe73b56e0a387bd64222e831fd610270cd7ea2505549758bf75c05a994a6d034f65f8f0e6fdcaeab1a34d4a6b4b636e070a38bce737"
  }
}

Ví dụ 2: So sánh Base64 với Base64URL và Chuỗi Payload Chuẩn hóa của Webhook

Định dạng Base64 tiêu chuẩn (RFC 4648 Mục 4) xuất ra các ký tự +, / và dấu đệm = ở cuối, trong khi Base64URL an toàn cho URL (RFC 4648 Mục 5, dùng trong chữ ký JWS/JWT và signed URL) thay thế + bằng -, / bằng _ và lược bỏ dấu đệm =. Khi ký câu The quick brown fox jumps over the lazy dog bằng khóa UTF-8 key với thuật toán HMAC-SHA256, sự khác biệt giữa các kiểu mã hóa thể hiện rất rõ:

Key (UTF-8):     key
Message (UTF-8): The quick brown fox jumps over the lazy dog

HMAC-SHA256 Hex:       f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8
HMAC-SHA256 Base64:    97yD9DBThCSxMpjmqm+xQ+9NWaFJRhdZl0edvC0aPNg=
HMAC-SHA256 Base64URL: 97yD9DBThCSxMpjmqm-xQ-9NWaFJRhdZl0edvC0aPNg

Khi xác thực header webhook trong thực tế, bạn phải ghép đúng cấu trúc payload trước khi ký theo quy định của từng nền tảng rồi mới lược bỏ tiền tố trên header:

GitHub (X-Hub-Signature-256: sha256=<hex>):
  Signed input = <raw_http_body>

Stripe (Stripe-Signature: t=1730419200,v1=<hex>):
  Signed input = 1730419200.<raw_http_body>

Slack (X-Slack-Signature: v0=<hex>):
  Signed input = v0:1730419200:<raw_http_body>

Shopify (X-Shopify-Hmac-Sha256: <base64>):
  Signed input = <raw_http_body>

Cấu trúc RFC 2104, Quy tắc Chuẩn hóa Khóa và Khả năng Chống Tấn công Định thời

Trả lời nhanh: RFC 2104 định nghĩa HMAC theo công thức H((K_0 XOR opad) || H((K_0 XOR ipad) || m)), trong đó khóa bí mật được chuẩn hóa theo kích thước khối nén nội bộ B của hàm băm (64 byte với MD5/SHA-1/SHA-256; 128 byte với SHA-384/SHA-512) thay vì độ dài đầu ra digest L.

Được quy định trong IETF RFC 2104 và NIST FIPS 198-1, HMAC bao bọc bất kỳ hàm băm mật mã lặp H nào vào một cấu trúc lồng hai lượt nhằm ngăn chặn triệt để kiểu tấn công mở rộng độ dài (length-extension attack) trên cấu trúc Merkle-Damgard:

HMAC(K, m) = H( (K_0 XOR opad) || H( (K_0 XOR ipad) || m ) )

Kích thước Khối (`B`) so với Độ dài Đầu ra (`L`) và Chuẩn hóa Khóa

Một lỗi triển khai rất phổ biến khi tự viết hàm HMAC là chuẩn hóa khóa bí mật K theo độ dài byte đầu ra L của mã băm thay vì độ dài byte khối nén nội bộ B:

  • MD5 (L = 16), SHA-1 (L = 20), SHA-256 (L = 32): Kích thước khối nội bộ B = 64 byte (512 bit).
  • SHA-384 (L = 48), SHA-512 (L = 64): Kích thước khối nội bộ B = 128 byte (1024 bit).

Trước khi thực hiện phép XOR với ipad (byte 0x36 lặp lại B lần) và opad (byte 0x5c lặp lại B lần), chuỗi byte khóa thô K được chuẩn hóa thành một khối K_0 có kích thước đúng bằng B byte:

  1. Khóa ngắn (len(K) < B): Đệm thêm B - len(K) byte không (0x00) vào bên phải K.
  2. Khóa vừa khít khối (len(K) == B): Giữ nguyên K (K_0 = K).
  3. Khóa vượt kích thước khối (len(K) > B): Băm K một lần bằng H(K) để thu về chuỗi digest dài L byte, sau đó đệm thêm B - L byte không (0x00) vào bên phải cho đủ B byte.

Theo RFC 2104 Mục 3, khóa bí mật nên chứa ít nhất L byte entropy mật mã (>= 32 byte sinh từ CSPRNG cho HMAC-SHA256, >= 64 byte cho HMAC-SHA512). Sử dụng khóa ngắn hơn L sẽ làm giảm độ an toàn trước tấn công vét cạn xuống thấp hơn giới hạn ngày sinh (birthday bound) của hàm băm.

Các Lỗi Giải mã Khóa Thường gặp và Xác thực Thời gian Hằng số

  • Chuỗi Hex so với Byte Hex Thô: Nếu một API cấp khóa bí mật gồm 64 ký tự hex như 4a656665..., hãy kiểm tra xem SDK của họ xử lý chuỗi đó như 64 byte văn bản ASCII UTF-8 (0x34 0x61...) hay giải mã hex thành 32 byte nhị phân thô (0x4a 0x65...) trước khi truyền vào importKey. Việc chuyển đổi qua lại bộ chọn Định dạng Khóa giữa UTF-8, Hex và Base64 giúp bạn khoanh vùng ngay lập tức lỗi lệch chuẩn giải mã khóa khi gỡ lỗi tích hợp.
  • Xác thực Thời gian Hằng số (Constant-Time): Tuyệt đối không kiểm tra mã MAC từ nguồn không tin cậy trong code backend bằng phép so sánh chuỗi thông thường (computedHex === headerHex). Phép so sánh chuỗi tiêu chuẩn sẽ trả về false ngay tại byte sai khác đầu tiên, tạo ra kẽ hở rò rỉ thời gian ở cấp độ nano giây (timing oracle), cho phép kẻ tấn công từ xa dò từng byte của mã MAC hợp lệ (chỉ tốn khoảng 256 * L lần thử thay vì 2^(8*L)). Trình xác thực trên trình duyệt sử dụng crypto.subtle.verify('HMAC', cryptoKey, signatureBuffer, messageBuffer) (hoặc phép cộng dồn XOR từng bit có độ dài cố định trên mảng byte đã giải mã), tương đương với crypto.timingSafeEqual trong Node.js và hmac.compare_digest trong Python.

Công cụ Tạo HMAC vs Tạo Mã Băm (Hash) vs Tạo JWT: Bạn Cần Công cụ Nào?

Trả lời nhanh: Sử dụng Công cụ Tạo HMAC để ký hoặc xác thực payload thô (HTTP body, chuỗi chuẩn hóa, sự kiện webhook) bằng khóa bí mật chung. Dùng Công cụ Tạo Mã Băm (Hash) cho chuỗi hoặc file không dùng khóa, và dùng Công cụ Tạo JWT để xây dựng JSON Web Token có cấu trúc chuẩn RFC 7519 được ký bằng HS256, HS384 hoặc HS512.

Mặc dù mã băm không khóa, chữ ký HMAC thô và JSON Web Token đối xứng đều dựa trên họ thuật toán SHA-2, chúng giải quyết các tầng bảo mật giao thức hoàn toàn khác nhau:

Tính năng Tạo & Xác thực Chữ ký HMAC (Công cụ này) Công cụ Tạo Mã Băm (Hash) Công cụ Tạo Chuỗi JWT
Nguyên hàm Mật mã MAC có khóa (RFC 2104 / FIPS 198-1) Mã băm không khóa (FIPS 180-4 / RFC 1321) Cấu trúc Token JWS / JWT (RFC 7515 / RFC 7519)
Yêu cầu Khóa Bí mật Có (Khóa chung UTF-8, Hex hoặc Base64) Không Có (Khóa đối xứng hoặc cặp khóa RSA/ECDSA)
Đảm bảo Bảo mật Tính xác thực + Tính toàn vẹn dữ liệu Chỉ kiểm tra toàn vẹn dữ liệu công khai / ngẫu nhiên Các Claim có cấu trúc được xác thực (iss, sub, exp)
Thuật toán Hỗ trợ HMAC-SHA256, SHA384, SHA512, SHA1, MD5 MD5, SHA-1, SHA-256, SHA-384, SHA-512 HS256, HS384, HS512 (cùng các bộ JWS bất đối xứng)
Định dạng Đầu ra Hex, Base64, Base64URL Hex chữ thường/hoa, Base64 <header>.<payload>.<signature> (Base64URL)

Cách Chọn Đúng Công cụ

  • Cần kiểm tra mã băm file không khóa, mã hash W3C SRI, hoặc tạo ETag / cache key? Các tác vụ này không dùng khóa bí mật — hãy sử dụng Công cụ Tạo Mã Băm (Hash).
  • Cần tạo hoặc kiểm tra bearer token xác thực (HS256, HS384, HS512)? Theo chuẩn RFC 7515, phần chữ ký của JWT HS256 thực chất là kết quả xuất Base64URL không dấu đệm của phép tính HMAC-SHA256(secret, ASCII(BASE64URL(header) + "." + BASE64URL(payload))). Dù bạn có thể xác thực trực tiếp phân đoạn thứ ba tại đây bằng cách dán <base64url_header>.<base64url_payload> làm thông điệp và chọn đầu ra Base64URL, hãy dùng Công cụ Tạo Chuỗi JWT để chỉnh sửa JSON header, kiểm tra nhãn thời gian exp/nbf và ghép nối token hoàn chỉnh gồm 3 phần.
  • HMAC Đối xứng so với Chữ ký Bất đối xứng: Vì HMAC là thuật toán đối xứng, mọi dịch vụ có khả năng xác thực chữ ký đều nắm giữ chính khóa bí mật dùng để tạo mới chữ ký. Chỉ nên dùng HMAC cho các webhook điểm-nối-điểm (point-to-point) và các dịch vụ nội bộ tin cậy; khi bên thứ ba không hoàn toàn tin cậy cần xác thực token mà không được cấp quyền ký, hãy dùng cặp khóa bất đối xứng (RS256, ES256, EdDSA) trong Công cụ Tạo Chuỗi JWT.
Câu hỏi thường gặp

Câu hỏi thường gặp và Hướng dẫn kỹ thuật Tạo & Xác thực Chữ ký HMAC

Mọi thông tin cần biết khi sử dụng công cụ tạo chữ ký hmac online trực tuyến miễn phí của Utiliome.

Tại sao xác thực HMAC cho webhook của tôi vẫn thất bại dù khóa bí mật và các trường JSON trông giống hệt nhau?

Hai nguyên nhân gây ra hơn 90% lỗi lệch chữ ký HMAC ở webhook. Thứ nhất, các middleware như express.json() trong Express tự động phân tích (parse) rồi tuần tự hóa lại (re-serialize) chuỗi JSON, làm thay đổi khoảng trắng, cách thoát chuỗi Unicode hoặc thứ tự các trường so với luồng byte TCP thô mà bên gửi đã ký — hãy luôn ký trực tiếp trên bộ đệm request thô chưa qua phân tích, đồng thời ghép đầy đủ tiền tố timestamp của nhà cung cấp (như <timestamp>.<body> của Stripe hay v0:<timestamp>:<body> của Slack). Thứ hai, hãy kiểm tra xem khóa bí mật của nhà cung cấp có cần phải giải mã từ Base64 hoặc Hex sang byte nhị phân thô thay vì đọc như chuỗi văn bản UTF-8 hay không.

Tại sao cách ghép SHA256(secret + message) lại không an toàn so với chuẩn RFC 2104 HMAC-SHA256?

Các hàm băm MD5, SHA-1, SHA-256 và SHA-512 sử dụng cấu trúc Merkle-Damgard, trong đó giá trị digest cuối cùng làm lộ toàn bộ trạng thái nén nội bộ. Nếu biết kết quả SHA256(secret || message) và độ dài byte của secret, kẻ tấn công có thể tính toán được chữ ký hợp lệ cho SHA256(secret || message || padding || attacker_suffix) mà không cần biết secret là gì (tấn công mở rộng độ dài - length-extension attack). Chuẩn RFC 2104 HMAC loại bỏ hoàn toàn lỗ hổng này bằng cách đưa kết quả băm lớp trong vào một lượt băm lớp ngoài có khóa thứ hai: H((K_0 XOR opad) || inner_hash).

Điều gì xảy ra nếu khóa bí mật HMAC của tôi dài hơn 64 hoặc 128 byte?

Theo RFC 2104 Mục 2, nếu khóa bí mật vượt quá kích thước khối nội bộ B của hàm băm (len(K) > 64 byte đối với MD5, SHA-1, SHA-256; len(K) > 128 byte đối với SHA-384 và SHA-512), trước tiên khóa đó sẽ được nén bằng cách băm một lần qua hàm H(K) thành L byte, sau đó đệm thêm các byte 0x00 vào bên phải cho đủ B byte. Cả Web Crypto API (crypto.subtle.importKey) lẫn các thư viện backend tuân thủ chuẩn RFC đều tự động thực hiện bước tiền băm này.

Tôi nên chọn định dạng đầu ra nào cho GitHub, Stripe, Slack, Shopify và JWT HS256?

GitHub (X-Hub-Signature-256), Stripe (Stripe-Signature v1) và Slack (X-Slack-Signature v0) đều truyền mã băm HMAC-SHA256 ở dạng Hex chữ thường đứng sau các tiền tố tương ứng là sha256=, v1= hoặc v0=. Shopify (X-Shopify-Hmac-Sha256) và AWS Signature v1/v2 sử dụng chuẩn Base64 có dấu đệm =. Trong khi đó, JSON Web Token (HS256, HS384, HS512) bắt buộc dùng định dạng Base64URL không dấu đệm theo chuẩn RFC 7515 — xem thêm Công cụ Tạo Chuỗi JWT để ghép nối toàn bộ token.

HMAC-MD5 và HMAC-SHA1 có bị phá vỡ bởi các cuộc tấn công va chạm (collision attack) trên MD5 và SHA-1 không?

Không bị phá vỡ trực tiếp. Các cuộc tấn công tạo va chạm trên MD5 và SHA-1 không khóa dựa vào việc kẻ tấn công tự do lựa chọn các khối thông điệp xoay quanh một vector khởi tạo (IV) cố định công khai, trong khi HMAC che giấu IV nội bộ đằng sau các bước trộn khóa bí mật K_0 XOR ipad và K_0 XOR opad (được ghi nhận trong IETF RFC 6151). Tuy nhiên, khuyến nghị NIST SP 800-131A và các nền tảng webhook lớn (như việc GitHub ngừng hỗ trợ X-Hub-Signature dùng SHA-1) đều đã loại bỏ HMAC-MD5 và HMAC-SHA1 cũ trên các hệ thống mới — hãy luôn ưu tiên chọn HMAC-SHA256 hoặc HMAC-SHA512 trừ khi bắt buộc phải duy trì tương thích với giao thức cũ.