Node.js crypto.generateKeyPair(type, options, callback)用法及代码示例

crypto.generateKeyPair(type, options, callback)

参数

• type : <string> 必须是 'rsa' , 'rsa-pss' , 'dsa' , 'ec' , 'ed25519' , 'ed448' , 'x25519' , 'x448' , 或 'dh' .
• options：<Object>
  • modulusLength : <number> key 大小(以位为单位)(RSA、DSA)。
  • publicExponent : <number> 公共 index (RSA)。 默认： 0x10001 。
  • hashAlgorithm : <string> 消息摘要的名称 (RSA-PSS)。
  • mgf1HashAlgorithm : <string> MGF1 使用的消息摘要的名称 (RSA-PSS)。
  • saltLength : <number> 以字节为单位的最小盐长度 (RSA-PSS)。
  • divisorLength : <number> q 的大小(以位 (DSA) 为单位)。
  • namedCurve : <string> 要使用的曲线的名称 (EC)。
  • prime : <Buffer> 主要参数 (DH)。
  • primeLength : <number> 以比特为单位的素数长度 (DH)。
  • generator : <number> 自定义生成器 (DH)。 默认： 2 。
  • groupName : <string> Diffie-Hellman 组名 (DH)。请参阅 crypto.getDiffieHellman() 。
  • publicKeyEncoding： <Object> 参见 keyObject.export() 。
  • privateKeyEncoding： <Object> 参见 keyObject.export() 。
• callback：<Function>
  • err： <Error>
  • publicKey : <string> | <Buffer> | <KeyObject>
  • privateKey : <string> | <Buffer> | <KeyObject>

生成给定 type 的新非对称 key 对。目前支持 RSA、RSA-PSS、DSA、EC、Ed25519、Ed448、X25519、X448 和 DH。

如果指定了 publicKeyEncoding 或 privateKeyEncoding，则此函数的行为就像在其结果上调用了 keyObject.export() 。否则， key 的相应部分将作为 KeyObject 返回。

建议将公钥编码为'spki'，将私钥编码为'pkcs8'，并对long-term 存储进行加密：

const {
  generateKeyPair
} = await import('node:crypto');

generateKeyPair('rsa', {
  modulusLength: 4096,
  publicKeyEncoding: {
    type: 'spki',
    format: 'pem'
  },
  privateKeyEncoding: {
    type: 'pkcs8',
    format: 'pem',
    cipher: 'aes-256-cbc',
    passphrase: 'top secret'
  }
}, (err, publicKey, privateKey) => {
  // Handle errors and use the generated key pair.
});const {
  generateKeyPair,
} = require('node:crypto');

generateKeyPair('rsa', {
  modulusLength: 4096,
  publicKeyEncoding: {
    type: 'spki',
    format: 'pem'
  },
  privateKeyEncoding: {
    type: 'pkcs8',
    format: 'pem',
    cipher: 'aes-256-cbc',
    passphrase: 'top secret'
  }
}, (err, publicKey, privateKey) => {
  // Handle errors and use the generated key pair.
});

完成后，将调用 callback，并将 err 设置为 undefined 和 publicKey /privateKey 表示生成的 key 对。

如果此方法作为其 util.promisify() ed 版本调用，它会为具有 publicKey 和 privateKey 属性的 Object 返回 Promise。