hmac_sha256
Generates an HMAC-SHA256 hash of a message using a secret key. Commonly used for webhook signature verification, API authentication, and secure token generation.
{% assign signature = "message body" | hmac_sha256: "secret_key" %}
{% log signature %}Syntax
{{ message | hmac_sha256: key }}
{{ message | hmac_sha256: key, encoding }}Parameter
Description
message
The string to hash
key
The secret key used for hashing
encoding
Output encoding: "hex" (default), "base64", or "utf8"
Return Value
Returns the HMAC-SHA256 hash as a string in the specified encoding.
Examples
Generate a hex-encoded signature (default):
{% assign signature = request.body | hmac_sha256: "my_secret" %}
{% log signature %}Output:
a1b2c3d4e5f6...Generate a base64-encoded signature:
Verify a Shopify webhook signature:
Sign an API request:
Notes
Default encoding is
hexSupported encodings:
hex,base64,utf8The secret key should be stored in global variables, not hardcoded in scripts
See also:
sha1,base64_encode
Last updated