Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/k6/next/javascript-api/k6-crypto/hmac.md, or by sending Accept: text/markdown to https://grafana.com/docs/k6/next/javascript-api/k6-crypto/hmac/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.
hmac( algorithm, secret, data, outputEncoding )
Note
A module with a better and standard API exists.
The crypto module partially implements the WebCrypto API, supporting more features than k6/crypto.
Use HMAC to sign a piece of data using a shared secret.
| Parameter | Type | Description |
|---|---|---|
| algorithm | string | The hashing algorithm to use. One of md4, md5, sha1, sha256, sha384, sha512, sha512_224, sha512_256 or ripemd160. |
| secret | string / ArrayBuffer | A shared secret used to sign the data. |
| data | string / ArrayBuffer | The data to sign. |
| outputEncoding | string | Describes the type of encoding to use for the hash value. Can be “base64”, “base64url”, “base64rawurl”, “hex” or “binary”. |
Returns
| Type | Description |
|---|---|
| string / Array | The hash digest as string (for “base64”, “base64url”, “base64rawurl”, “hex” outputEncoding) or raw array of integers (for “binary” outputEncoding). |
Example
import crypto from 'k6/crypto';
export default function () {
let hash = crypto.hmac('sha256', 'mysecret', 'hello world!', 'hex');
console.log(hash);
const binArray = [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33];
hash = crypto.hmac('sha256', 'mysecret', new Uint8Array(binArray).buffer, 'hex');
console.log(hash);
}The above script should result in the following being printed during execution:
INFO[0000] 893a72d8cab129e5ba85aea4599fd53f59bfe652cff4098a3780313228d8c20f
INFO[0000] 893a72d8cab129e5ba85aea4599fd53f59bfe652cff4098a3780313228d8c20fWas this page helpful?
Related resources from Grafana Labs

