ECDH类
- ecdh.generateKeys([encoding[, format]])
- ecdh.getPrivateKey([encoding])
- ecdh.computeSecret(other_public_key[, input_encoding][, output_encoding])
ECDH
类的实例可以使用 函数来创建。
生成私有的和公共的 EC Diffie-Hellman 键值,并返回指定 format
和 encoding
的公钥。这个密钥应该转移到另一方。
format
参数指定点编码,可以是 'compressed'
、'uncompressed'
或 'hybrid'
。如果没有指定 format
,这个点会以 'uncompressed'
格式返回。
encoding
参数可以是 'binary'
、'hex'
或 'base64'
。如果提供了 encoding
,会返回一个字符串;否则返回一个 Buffer。
ecdh.setPrivateKey(private_key[, encoding])
返回指定了 encoding
的 EC Diffie-Hellman 私钥,它可以是 、'hex'
或 'base64'
。如果提供了 encoding
,会返回一个字符串;否则返回一个 Buffer。
ecdh.setPublicKey(public_key[, encoding])
设置一个 EC Diffie-Hellman 公钥。密钥的编码可以是 'binary'
、'hex'
或 'base64'
。如果提供了 public_key
则期望是个字符串;否则,期望是一个 Buffer。
请注意,通常没有理由调用此方法,因为 ECDH
只需要私钥和对方的公钥来计算共享密钥。通常会调用 或 ecdh.setPrivateKey()。 方法尝试生成与正被设置的私钥相关联的公共点/密钥。
const crypto = require('crypto');
const alice = crypto.createECDH('secp256k1');
const bob = crypto.createECDH('secp256k1');
// Note: This is a shortcut way to specify one of Alice's previous private
// keys. It would be unwise to use such a predictable private key in a real
// application.
crypto.createHash('sha256').update('alice', 'utf8').digest()
);
// Bob uses a newly generated cryptographically strong
// pseudorandom key pair bob.generateKeys();
const alice_secret = alice.computeSecret(bob.getPublicKey(), null, 'hex');
const bob_secret = bob.computeSecret(alice.getPublicKey(), null, 'hex');
console.log(alice_secret === bob_secret);
返回指定了 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。