CryptoKey
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Web Crypto API 的 CryptoKey
接口表示从特定 SubtleCrypto
方法(generateKey()
、deriveKey()
、importKey()
或 unwrapKey()
)导出的密钥。
出于安全考虑,CryptoKey
接口仅在安全上下文中可用。
实例属性
CryptoKey.type
-
返回一个表示密钥类型的字符串,可使用以下值:
"secret"
:为密钥(secret key),用于对称加密算法。"private"
:为非对称加密算法的CryptoKeyPair
的密钥(private key)部分。"public"
:为非对称加密算法的CryptoKeyPair
的公钥(public key)部分。
CryptoKey.extractable
-
一个布尔值,表示原始信息是否能使用
SubtleCrypto.exportKey()
或SubtleCrypto.wrapKey()
导出。true
:密钥可以导出。false
:密钥不能导出。使用exportKey()
或wrapKey()
方法来导出此密钥将会抛出异常。
CryptoKey.algorithm
-
一个描述可使用此密钥的算法及任何关联的额外参数的对象。
AesKeyGenParams
如果算法是任意高级加密标准(AES)的变体。RsaHashedKeyGenParams
如果算法是任意 RSA 的变体。EcKeyGenParams
如果算法是任意椭圆曲线加密算法(EC)的变体。HmacKeyGenParams
如果算法是任意密钥散列消息认证码(HMAC)的变体。
CryptoKey.usages
-
一个字符串的数组,指明密钥的用途。数组元素可能的值有:
示例
规范
Specification |
---|
Web Cryptography API # cryptokey-interface |
浏览器兼容性
BCD tables only load in the browser