ECDH类

ECDH 类是用来创建 Elliptic Curve Diffie-Hellman（ECDH）密钥交换的工具类。

ECDH 类的实例可以使用 crypto.createECDH() 函数来创建。

  1. const crypto = require('crypto');
  2. const assert = require('assert');
  4. // Generate Alice's keys...
  5. const alice = crypto.createECDH('secp521r1');
  6. const alice_key = alice.generateKeys();
  8. // Generate Bob's keys...
  9. const bob = crypto.createECDH('secp521r1');
  10. const bob_key = bob.generateKeys();
  12. // Exchange and generate the secret...
  13. const alice_secret = alice.computeSecret(bob_key);
  14. const bob_secret = bob.computeSecret(alice_key);
  16. assert(alice_secret, bob_secret);
  17. // OK

ecdh.generateKeys([encoding[, format]])

生成私有的和公共的 EC Diffie-Hellman 键值，并返回指定 format 和 encoding 的公钥。这个密钥应该转移到另一方。

format 参数指定点编码，可以是 'compressed'、'uncompressed' 或 'hybrid'。如果没有指定 format，这个点会以 'uncompressed' 格式返回。

encoding 参数可以是 'binary'、'hex' 或 'base64'。如果提供了 encoding，会返回一个字符串；否则返回一个 Buffer。

ecdh.setPrivateKey(private_key[, encoding])

设置一个 EC Diffie-Hellman 私钥。encoding 可以是 'binary'、'hex' 或 'base64'。如果提供了 encoding，private_key 则期望是个字符串；否则，private_key 期望是一个 Buffer。当 ECDH 对象被创建时，如果 private_key 指定的曲线无效，将抛出错误。在设置私钥时，还在 ECDH 对象中生成和设置了相关联的公共点（密钥）。

ecdh.getPrivateKey([encoding])

返回指定了 encoding 的 EC Diffie-Hellman 私钥，它可以是 'binary'、'hex' 或 'base64'。如果提供了 encoding，会返回一个字符串；否则返回一个 Buffer。

ecdh.setPublicKey(public_key[, encoding])

稳定度：0 - 已废弃

设置一个 EC Diffie-Hellman 公钥。密钥的编码可以是 'binary'、'hex' 或 'base64'。如果提供了 public_key 则期望是个字符串；否则，期望是一个 Buffer。

请注意，通常没有理由调用此方法，因为 ECDH 只需要私钥和对方的公钥来计算共享密钥。通常会调用 ecdh.generateKeys() 或 ecdh.setPrivateKey()。ecdh.setPrivateKey() 方法尝试生成与正被设置的私钥相关联的公共点/密钥。

示例（获取共享密钥）：

  1. const crypto = require('crypto');
  2. const alice = crypto.createECDH('secp256k1');
  3. const bob = crypto.createECDH('secp256k1');
  5. // Note: This is a shortcut way to specify one of Alice's previous private
  6. // keys. It would be unwise to use such a predictable private key in a real
  7. // application.
  8. alice.setPrivateKey(
  9.     crypto.createHash('sha256').update('alice', 'utf8').digest()
  10. );
  12. // Bob uses a newly generated cryptographically strong
  13. // pseudorandom key pair bob.generateKeys();
  15. const alice_secret = alice.computeSecret(bob.getPublicKey(), null, 'hex');
  16. const bob_secret = bob.computeSecret(alice.getPublicKey(), null, 'hex');
  18. // alice_secret and bob_secret should be the same shared secret value
  19. console.log(alice_secret === bob_secret);

ecdh.getPublicKey([encoding[, format]])

返回指定了 encoding 和 format 的 EC Diffie-Hellman 公钥。

format 参数指定点编码，可以是 'compressed'、'uncompressed' 或 'hybrid'。如果没有指定 format，这个点会以 'uncompressed' 格式返回。

encoding 参数可以是 'binary'、'hex' 或 'base64'。如果提供了 encoding，会返回一个字符串；否则返回一个 Buffer。

ecdh.computeSecret(other_public_key[, input_encoding][, output_encoding])

使用作为对方的公钥的 other_public_key 计算共享密钥，并返回计算后的共享密钥。使用指定的 input_encoding 解释提供的密钥，并返回使用指定 output_encoding 编码的密钥。编码可以是 'binary'、'hex' 或 'base64'。如果没有提供 input_encoding，other_public_key 期望是一个 Buffer。

如果给出了 output_encoding，将返回一个字符串；否则，返回一个 Buffer。