1# 使用X25519进行密钥协商(ArkTS) 2 3<!--Kit: Crypto Architecture Kit--> 4<!--Subsystem: Security--> 5<!--Owner: @zxz--3--> 6<!--Designer: @lanming--> 7<!--Tester: @PAFT--> 8<!--Adviser: @zengyawen--> 9 10对应的算法规格请查看[密钥协商算法规格：X25519](crypto-key-agreement-overview.md#x25519)。 11 12## 开发步骤 13 141. 调用[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)、[AsyKeyGenerator.convertKey](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#convertkey-3)生成密钥算法为X25519的非对称密钥（KeyPair）。 15 如何生成X25519非对称密钥，开发者可参考下文示例，并结合[非对称密钥生成和转换规格：X25519](crypto-asym-key-generation-conversion-spec.md#x25519)和[随机生成非对称密钥对](crypto-generate-asym-key-pair-randomly.md)理解，参考文档与当前示例可能存在入参差异，请在阅读时注意区分。 16 172. 调用[cryptoFramework.createKeyAgreement](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreatekeyagreement)，指定字符串参数'X25519'，创建密钥算法为X25519的密钥协议生成器（KeyAgreement）。 18 193. 调用[KeyAgreement.generateSecret](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#generatesecret-1)，基于传入的私钥（KeyPair.priKey）与公钥（KeyPair.pubKey）进行密钥协商，返回共享秘钥。 20 21- 异步方法示例： 22 23 ```ts 24 import { cryptoFramework } from '@kit.CryptoArchitectureKit'; 25 26 async function x25519Await() { 27 // 假设此公私钥对数据为外部传入。 28 let pubKeyArray = new Uint8Array([48, 42, 48, 5, 6, 3, 43, 101, 110, 3, 33, 0, 36, 98, 216, 106, 74, 99, 179, 203, 81, 145, 147, 101, 139, 57, 74, 225, 119, 196, 207, 0, 50, 232, 93, 147, 188, 21, 225, 228, 54, 251, 230, 52]); 29 let priKeyArray = new Uint8Array([48, 46, 2, 1, 0, 48, 5, 6, 3, 43, 101, 110, 4, 34, 4, 32, 112, 65, 156, 73, 65, 89, 183, 39, 119, 229, 110, 12, 192, 237, 186, 153, 21, 122, 28, 176, 248, 108, 22, 242, 239, 179, 106, 175, 85, 65, 214, 90]); 30 let keyGen = cryptoFramework.createAsyKeyGenerator('X25519'); 31 // 外部传入的公私钥对A。 32 let keyPairA = await keyGen.convertKey({ data: pubKeyArray }, { data: priKeyArray }); 33 // 内部生成的公私钥对B。 34 let keyPairB = await keyGen.generateKeyPair(); 35 let keyAgreement = cryptoFramework.createKeyAgreement('X25519'); 36 // 使用A的公钥和B的私钥进行密钥协商。 37 let secret1 = await keyAgreement.generateSecret(keyPairB.priKey, keyPairA.pubKey); 38 // 使用A的私钥和B的公钥进行密钥协商。 39 let secret2 = await keyAgreement.generateSecret(keyPairA.priKey, keyPairB.pubKey); 40 // 两种协商的结果应当一致。 41 if (secret1.data.toString() === secret2.data.toString()) { 42 console.info('x25519 success'); 43 console.info('x25519 output is ' + secret1.data); 44 } else { 45 console.error('x25519 result is not equal'); 46 } 47 } 48 ``` 49 50- 同步方法示例： 51 52 ```ts 53 import { cryptoFramework } from '@kit.CryptoArchitectureKit'; 54 55 function x25519AgreementSync() { 56 // 假设此公私钥对数据为外部传入。 57 let pubKeyArray = new Uint8Array([48, 42, 48, 5, 6, 3, 43, 101, 110, 3, 33, 0, 36, 98, 216, 106, 74, 99, 179, 203, 81, 145, 147, 101, 139, 57, 74, 225, 119, 196, 207, 0, 50, 232, 93, 147, 188, 21, 225, 228, 54, 251, 230, 52]); 58 let priKeyArray = new Uint8Array([48, 46, 2, 1, 0, 48, 5, 6, 3, 43, 101, 110, 4, 34, 4, 32, 112, 65, 156, 73, 65, 89, 183, 39, 119, 229, 110, 12, 192, 237, 186, 153, 21, 122, 28, 176, 248, 108, 22, 242, 239, 179, 106, 175, 85, 65, 214, 90]); 59 let keyGen = cryptoFramework.createAsyKeyGenerator('X25519'); 60 // 外部传入的公私钥对A。 61 let keyPairA = keyGen.convertKeySync({ data: pubKeyArray }, { data: priKeyArray }); 62 // 内部生成的公私钥对B。 63 let keyPairB = keyGen.generateKeyPairSync(); 64 let keyAgreement = cryptoFramework.createKeyAgreement('X25519'); 65 // 使用A的公钥和B的私钥进行密钥协商。 66 let secret1 = keyAgreement.generateSecretSync(keyPairB.priKey, keyPairA.pubKey); 67 // 使用A的私钥和B的公钥进行密钥协商。 68 let secret2 = keyAgreement.generateSecretSync(keyPairA.priKey, keyPairB.pubKey); 69 // 两种协商的结果应当一致。 70 if (secret1.data.toString() === secret2.data.toString()) { 71 console.info('x25519 success'); 72 console.info('x25519 output is ' + secret1.data); 73 } else { 74 console.error('x25519 result is not equal'); 75 } 76 } 77 ``` 78