รหัสยืนยันความถูกต้องของข้อความที่ใช้ฟังก์ชันแฮชร่วมกับคีย์ลับ (Keyed-Hash Message Authentication Code หรือ HMAC) ช่วยพิสูจน์ทั้ง ความสมบูรณ์ของข้อมูล (Data Integrity) (รับประกันว่า Payload ไม่ถูกแก้ไขระหว่างทาง) และ ความถูกต้องของแหล่งที่มา (Authenticity) (ยืนยันว่าผู้ส่งถือครอง Shared Secret Key จริง) การจำลองลายเซ็นของผู้ให้บริการให้ตรงกันทุกประการจำเป็นต้องกำหนดพารามิเตอร์ 3 ส่วนให้แม่นยำ ได้แก่ อัลกอริทึมแฮชพื้นฐาน การถอดรหัสไบต์ดิบของ Secret Key และลำดับไบต์ที่แท้จริงของ Payload ที่นำมาเซ็นชื่อ
ตัวอย่างที่ 1: ชุดทดสอบ IETF RFC 2104 / RFC 2202 / RFC 4231 Test Case 2
ไม่ว่าคุณจะป้อน Secret Key ขนาด 4 ไบต์ในรูปแบบข้อความ UTF-8 Jefe, เลขฐานสิบหกดิบ 4a656665 หรือ Base64 SmVmZQ== ระบบจะถอดรหัสออกมาเป็นบัฟเฟอร์คีย์ชุดเดียวกันคือ [0x4a, 0x65, 0x66, 0x65] เมื่อนำมาเซ็นชื่อข้อความ UTF-8 ขนาด 28 ไบต์ what do ya want for nothing? จะได้ผลลัพธ์ดังนี้:
{
"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"
}
}
ตัวอย่างที่ 2: ความแตกต่างระหว่าง Base64 กับ Base64URL และรูปแบบ Canonical Payload ของ Webhook
มาตรฐาน Base64 (RFC 4648 ส่วนที่ 4) จะใช้ตัวอักษร +, / และเติมเครื่องหมาย = ต่อท้าย (Padding) ในขณะที่ Base64URL ซึ่งปลอดภัยสำหรับใช้งานบน URL (RFC 4648 ส่วนที่ 5 นิยมใช้ในลายเซ็น JWS/JWT และ Signed URL) จะแทนที่ + ด้วย -, แทนที่ / ด้วย _ และตัดเครื่องหมาย = ต่อท้ายทิ้งทั้งหมด การเซ็นชื่อข้อความ The quick brown fox jumps over the lazy dog ด้วยคีย์ UTF-8 key ภายใต้ HMAC-SHA256 แสดงความแตกต่างของการเข้ารหัสแต่ละแบบได้อย่างชัดเจน:
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
เมื่อต้องการตรวจสอบ Webhook Header จากการใช้งานจริง คุณต้องประกอบโครงสร้าง Payload ก่อนการเซ็นชื่อให้ตรงตามข้อกำหนดของผู้ให้บริการแต่ละรายเสียก่อน จากนั้นจึงตัดคำนำหน้าออกจากค่าใน 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>