HkdfParams

HkdfParams 字典是 Web Crypto API 的一部分,当使用 HKDF 算法时,它代表了应该作为 SubtleCrypto.deriveKey()algorithm 参数传递的对象。

实例属性

name

一个字符串。此项应设置为 HKDF

哈希

一个字符串或一个包含单个属性 name(值为字符串)的对象。这是要使用的 摘要算法 的标识符。应为以下之一:

  • SHA-256:选择 SHA-256 算法。
  • SHA-384:选择 SHA-384 算法。
  • SHA-512:选择 SHA-512 算法。

警告: 此处也支持 SHA-1,但 SHA-1 算法被认为不安全,不应再使用。

salt

一个 ArrayBuffer、一个 TypedArray 或一个 DataViewHKDF 规范指出,添加 salt“极大地增强了 HKDF 的强度”。理想情况下,salt 是一个随机或伪随机值,其长度与摘要函数的输出长度相同。与传递给 deriveKey() 的输入密钥材料不同,salt 不需要保密。

info

一个 ArrayBuffer、一个 TypedArray 或一个 DataView,代表特定于应用程序的上下文信息。这用于将派生的密钥绑定到应用程序或上下文,并允许您在不使用相同的输入密钥材料的情况下,为不同上下文派生不同的密钥。重要的是,此项应独立于输入密钥材料本身。此属性是必需的,但可以是一个空缓冲区。

示例

请参阅 SubtleCrypto.deriveKey() 的示例。

规范

规范
Web 加密级别 2
# dfn-HkdfParams

浏览器兼容性

支持 SubtleCrypto.deriveKey() 方法的“HKDF”算法的浏览器将支持此类型。

另见