You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
47 lines
1.3 KiB
47 lines
1.3 KiB
/** |
|
* An **HMAC** enables verification that a given key was used |
|
* to authenticate a payload. |
|
* |
|
* See: [[link-wiki-hmac]] |
|
* |
|
* @_subsection: api/crypto:HMAC [about-hmac] |
|
*/ |
|
import { createHmac } from "./crypto.js"; |
|
import { getBytes, hexlify } from "../utils/index.js"; |
|
let locked = false; |
|
const _computeHmac = function (algorithm, key, data) { |
|
return createHmac(algorithm, key).update(data).digest(); |
|
}; |
|
let __computeHmac = _computeHmac; |
|
/** |
|
* Return the HMAC for %%data%% using the %%key%% key with the underlying |
|
* %%algo%% used for compression. |
|
* |
|
* @example: |
|
* key = id("some-secret") |
|
* |
|
* // Compute the HMAC |
|
* computeHmac("sha256", key, "0x1337") |
|
* //_result: |
|
* |
|
* // To compute the HMAC of UTF-8 data, the data must be |
|
* // converted to UTF-8 bytes |
|
* computeHmac("sha256", key, toUtf8Bytes("Hello World")) |
|
* //_result: |
|
* |
|
*/ |
|
export function computeHmac(algorithm, _key, _data) { |
|
const key = getBytes(_key, "key"); |
|
const data = getBytes(_data, "data"); |
|
return hexlify(__computeHmac(algorithm, key, data)); |
|
} |
|
computeHmac._ = _computeHmac; |
|
computeHmac.lock = function () { locked = true; }; |
|
computeHmac.register = function (func) { |
|
if (locked) { |
|
throw new Error("computeHmac is locked"); |
|
} |
|
__computeHmac = func; |
|
}; |
|
Object.freeze(computeHmac); |
|
//# sourceMappingURL=hmac.js.map
|