• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 使用DH进行密钥协商
2
3对应的算法规格请查看[密钥协商算法规格：DH](crypto-key-agreement-overview.md#dh)。
4
5## 开发步骤
6
71. 调用[cryptoFramework.createAsyKeyGenerator](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreateasykeygenerator)、[AsyKeyGenerator.generateKeyPair](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#generatekeypair-1)生成密钥算法为DH、采用知名安全素数群modp1536的非对称密钥（KeyPair）。
8   如何生成DH非对称密钥，开发者可参考下文示例，并结合[非对称密钥生成和转换规格：DH](crypto-asym-key-generation-conversion-spec.md#dh)和[随机生成非对称密钥对](crypto-generate-asym-key-pair-randomly.md)理解，参考文档与当前示例可能存在入参差异，请在阅读时注意区分。
9
102. 调用[cryptoFramework.createKeyAgreement](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreatekeyagreement)，指定字符串参数'DH_modp1536'，创建密钥算法为DH、采用知名安全素数群modp1536的密钥协议生成器（KeyAgreement）。
11
123. 调用[KeyAgreement.generateSecret](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#generatesecret-1)，基于传入的私钥（KeyPair.priKey）与公钥（KeyPair.pubKey）进行密钥协商，返回共享秘密。
13
14- 异步方法示例：
15
16  ```ts
17  import { cryptoFramework } from '@kit.CryptoArchitectureKit';
18
19  async function dhAwait() {
20    let keyGen = cryptoFramework.createAsyKeyGenerator('DH_modp1536');
21    // 随机生成公私钥对A。
22    let keyPairA = await keyGen.generateKeyPair();
23    // 随机生成规格一致的公私钥对B。
24    let keyPairB = await keyGen.generateKeyPair();
25    let keyAgreement = cryptoFramework.createKeyAgreement('DH_modp1536');
26    // 使用A的公钥和B的私钥进行密钥协商。
27    let secret1 = await keyAgreement.generateSecret(keyPairB.priKey, keyPairA.pubKey);
28    // 使用A的私钥和B的公钥进行密钥协商。
29    let secret2 = await keyAgreement.generateSecret(keyPairA.priKey, keyPairB.pubKey);
30    // 两种协商的结果应当一致。
31    if (secret1.data.toString() === secret2.data.toString()) {
32      console.info('DH success');
33      console.info('DH output is ' + secret1.data);
34    } else {
35      console.error('DH result is not equal');
36    }
37  }
38  ```
39
40- 同步方法示例：
41
42  ```ts
43  import { cryptoFramework } from '@kit.CryptoArchitectureKit';
44
45  function dhAgreementSync() {
46    let keyGen = cryptoFramework.createAsyKeyGenerator('DH_modp1536');
47    // 随机生成公私钥对A。
48    let keyPairA = keyGen.generateKeyPairSync();
49    // 随机生成规格一致的公私钥对B。
50    let keyPairB = keyGen.generateKeyPairSync();
51    let keyAgreement = cryptoFramework.createKeyAgreement('DH_modp1536');
52    // 使用A的公钥和B的私钥进行密钥协商。
53    let secret1 = keyAgreement.generateSecretSync(keyPairB.priKey, keyPairA.pubKey);
54    // 使用A的私钥和B的公钥进行密钥协商。
55    let secret2 = keyAgreement.generateSecretSync(keyPairA.priKey, keyPairB.pubKey);
56    // 两种协商的结果应当一致。
57    if (secret1.data.toString() === secret2.data.toString()) {
58      console.info('DH success');
59      console.info('DH output is ' + secret1.data);
60    } else {
61      console.error('DH result is not equal');
62    }
63  }
64  ```
65