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>