SymmetricKeyBuilder

用于创建和导入对称密钥的构建器类。该类提供了配置密钥属性以及生成或导入对称密钥的方法。

扩展

• BaseCryptoClass

访问器

algorithm

设置签名

set algorithm(algorithm): void

设置此密钥将使用的算法。默认为AES-256。

抛出

如果不支持该算法，则抛出InvalidArgumentError。

参数

algorithm

SymmetricAlgorithm

要使用的对称算法。

返回值

void

---

bits

设置签名

set bits(bits): void

设置密钥位数。默认为AES设置256位。

参数

bits

number

密钥位数。

返回值

void

---

exportable

设置签名

set exportable(exportable): void

设置密钥是否可导出。

备注

除非明确设置，否则密钥不可导出。

参数

exportable

boolean

表示密钥是否可导出的布尔值。

返回值

void

---

purposes

设置签名

set purposes(purposes): void

设置密钥的用途。

抛出

如果参数非有效用途，则抛出InvalidArgumentError。

参数

purposes

KeyPurpose[]

密钥用途数组。

返回值

void

方法

buildFromRaw()

buildFromRaw(rawKey): Promise<SymmetricKey>

使用原始字节生成对称密钥。

参数

rawKey

ArrayBuffer

用作对称密钥的实际字节。

返回值

Promise<SymmetricKey>

解析为构建对称密钥的Promise。

备注

创建的密钥将继承此构建器上设置的属性（algorithm、purposes、exportability）。

---

buildGenerated()

buildGenerated(): Promise<SymmetricKey>

根据配置的属性构建新的对称私钥。

返回值

Promise<SymmetricKey>

解析为生成对称密钥的Promise。

抛出

如果所选密钥大小无效，则抛出InvalidArgumentError。

---

Last updated: 2025年10月2日