HmacImportParams

{{ APIRef("Web Crypto API") }} 

The HmacImportParams dictionary of the Web Crypto API represents the object that should be passed when importing, unwrapping, or deriving a key for the HMAC algorithm, as:

• The algorithm parameter to {{domxref("SubtleCrypto.importKey()")}} 
• The unwrappedKeyAlgorithm parameter to {{domxref("SubtleCrypto.unwrapKey()")}} 
• The derivedKeyType parameter to {{domxref("SubtleCrypto.deriveKey()")}} .

Instance properties

• name

  • : A string. This should be set to HMAC.

• hash

  • : A string or an object containing a single property called name with a string value. It is an identifier for the digest algorithm to use. This should be one of the following:

    • SHA-256: selects the SHA-256 algorithm.
    • SHA-384: selects the SHA-384 algorithm.
    • SHA-512: selects the SHA-512 algorithm.

    [!WARNING] SHA-1 is also supported here but the SHA-1 algorithm is considered vulnerable and should no longer be used.

• length {{optional_inline}} 

  • : A Number representing the length in bits of the key. If this is omitted the length of the key is equal to the length of the digest generated by the digest function you have chosen. Unless you have a good reason to use a different length, omit this property and use the default.

Examples

See the examples for {{domxref("SubtleCrypto.importKey()")}} , {{domxref("SubtleCrypto.unwrapKey()")}} , or {{domxref("SubtleCrypto.deriveKey()")}} .

Specifications

{{Specifications}} 

Browser compatibility

Browsers that support the “HMAC” algorithm for the {{domxref("SubtleCrypto.importKey()")}} , {{domxref("SubtleCrypto.unwrapKey()")}} , or {{domxref("SubtleCrypto.deriveKey()")}}  methods will support this type.

See also

• {{domxref("SubtleCrypto.importKey()")}} .
• {{domxref("SubtleCrypto.unwrapKey()")}} .
• {{domxref("SubtleCrypto.deriveKey()")}} .