The HkdfParams
dictionary of the Web Crypto API represents the object that should be passed as the algorithm
parameter into SubtleCrypto.deriveKey()
, when using the HKDF algorithm.
The HkdfParams
dictionary of the Web Crypto API represents the object that should be passed as the algorithm
parameter into SubtleCrypto.deriveKey()
, when using the HKDF algorithm.
name
A string. This should be set to HKDF
.
hash
A string representing the digest algorithm to use. This may be one of:
SHA-1
SHA-256
SHA-384
SHA-512
salt
An ArrayBuffer
, a TypedArray
, or a DataView
. The HKDF specification states that adding salt "adds significantly to the strength of HKDF". Ideally, the salt is a random or pseudo-random value with the same length as the output of the digest function. Unlike the input key material passed into deriveKey()
, salt does not need to be kept secret.
info
An ArrayBuffer
, a TypedArray
, or a DataView
representing application-specific contextual information. This is used to bind the derived key to an application or context, and enables you to derive different keys for different contexts while using the same input key material. It's important that this should be independent of the input key material itself. This property is required but may be an empty buffer.
See the examples for SubtleCrypto.deriveKey()
.
Specification |
---|
Web Cryptography API # dfn-HkdfParams |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HkdfParams