crypto.encapsulate(key[, callback])

• key <Object> | <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView> | <KeyObject> 公钥

  ¥key <Object> | <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView> | <KeyObject> Public Key

• callback <Function>

  • err <Error>

  • result <Object>

    • sharedKey <Buffer>

    • ciphertext <Buffer>

• 返回：如果未提供 callback 函数，则为 <Object>。

  ¥Returns: <Object> if the callback function is not provided.

  • sharedKey <Buffer>

  • ciphertext <Buffer>

使用公钥的 KEM 算法进行密钥封装。

¥Key encapsulation using a KEM algorithm with a public key.

支持的密钥类型及其 KEM 算法如下：

¥Supported key types and their KEM algorithms are:

• 'rsa'¹ RSA 密钥值封装

  ¥'rsa'¹ RSA Secret Value Encapsulation

• 'ec'² DHKEM(P-256, HKDF-SHA256), DHKEM(P-384, HKDF-SHA256), DHKEM(P-521, HKDF-SHA256)

• 'x25519'² DHKEM(X25519, HKDF-SHA256)

• 'x448'² DHKEM(X448, HKDF-SHA512)

• 'ml-kem-512'³ ML-KEM

• 'ml-kem-768'³ ML-KEM

• 'ml-kem-1024'³ ML-KEM

如果 key 不是 KeyObject，则此函数的行为就像将 key 传给 crypto.createPublicKey() 一样。

¥If key is not a KeyObject, this function behaves as if key had been passed to crypto.createPublicKey().

如果提供了 callback 函数，则该函数使用 libuv 的线程池。

¥If the callback function is provided this function uses libuv's threadpool.