En Keyed-Hash Message Authentication Code (HMAC) bevisar både dataintegritet (att payloaden inte har ändrats under överföringen) och autenticitet (att avsändaren innehar den delade hemliga nyckeln). För att återskapa en tjänsteleverantörs signatur krävs att tre exakta parametrar matchar: den underliggande hashprimitiven, råbyteavkodningen av den hemliga nyckeln och den exakta bytesekvensen för den signerade payloaden.
Exempel 1: IETF RFC 2104 / RFC 2202 / RFC 4231 Testfall 2
Oavsett om du anger den 4 byte långa hemliga nyckeln som UTF-8-text Jefe, rå hexadecimal 4a656665 eller Base64 SmVmZQ==, avkodas den till den identiska nyckelbufferten [0x4a, 0x65, 0x66, 0x65]. Att signera det 28 byte långa UTF-8-meddelandet what do ya want for nothing? ger:
{
"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"
}
}
Exempel 2: Base64 kontra Base64URL och kanoniska payloads för webhooks
Standard-Base64 (RFC 4648 sektion 4) genererar +, / och avslutande =-utfyllnad, medan URL-säker Base64URL (RFC 4648 sektion 5, som används i JWS/JWT-signaturer och signerade URL:er) ersätter + med -, / med _ och tar bort =-utfyllnad. Att signera The quick brown fox jumps over the lazy dog med UTF-8-nyckeln key under HMAC-SHA256 illustrerar kodningsskillnaden direkt:
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
När du verifierar verkliga webhook-headers måste du konstruera den exakta payloaden som definieras av respektive leverantör innan du tar bort header-prefix:
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>