• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 使用RSA密钥对(PKCS1模式)签名验签
2
3
4对应的算法规格请查看[签名验签算法规格:RSA](crypto-sign-sig-verify-overview.md#rsa)。
5
6
7**签名**
8
9
101. 调用[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),生成密钥算法为RSA、密钥长度为1024位、素数个数为2的非对称密钥对象(KeyPair),包括公钥(PubKey)和私钥(PriKey)。
11
12   如何生成RSA非对称密钥,开发者可参考下文示例,并结合[非对称密钥生成和转换规格:RSA](crypto-asym-key-generation-conversion-spec.md#rsa)和[随机生成非对称密钥对](crypto-generate-asym-key-pair-randomly.md)理解,参考文档与当前示例可能存在入参差异,请在阅读时注意区分。
13
142. 调用[cryptoFramework.createSign](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreatesign),指定字符串参数'RSA1024|PKCS1|SHA256',创建非对称密钥类型为RSA1024、填充模式为PKCS1、摘要算法为SHA256的Sign实例,用于完成签名操作。
15
163. 调用[Sign.init](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#init-3),使用私钥(PriKey)初始化Sign实例。
17
184. 调用[Sign.update](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#update-3),传入待签名的数据。
19
20   当前单次update长度没有限制,开发者可以根据数据量判断如何调用update。
21
22   - 当待签名的数据较短时,可以在init完成后直接调用sign。
23   - 当数据量较大时,可以多次调用update,即[分段签名验签](crypto-rsa-sign-sig-verify-pkcs1-by-segment.md)。
24
255. 调用[Sign.sign](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#sign-2),生成数据签名。
26
27
28**验签**
29
30
311. 调用[cryptoFramework.createVerify](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreateverify),指定字符串参数'RSA1024|PKCS1|SHA256',与签名的Sign实例保持一致。创建Verify实例,用于完成验签操作。
32
332. 调用[Verify.init](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#init-5),使用公钥(PubKey)初始化Verify实例。
34
353. 调用[Verify.update](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#update-5),传入待验证的数据。
36   当前单次update长度没有限制,开发者可以根据数据量判断如何调用update。
37
38   - 当待签名的数据较短时,可以在init完成后直接调用verify。
39   - 当数据量较大时,可以多次调用update,即[分段签名验签](crypto-rsa-sign-sig-verify-pkcs1-by-segment.md)。
40
414. 调用[Verify.verify](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#verify-2),对数据进行验签。
42
43
44```ts
45import cryptoFramework from '@ohos.security.cryptoFramework';
46import buffer from '@ohos.buffer';
47// 完整的明文被拆分为input1和input2
48let input1: cryptoFramework.DataBlob = { data: new Uint8Array(buffer.from("This is Sign test plan1", 'utf-8').buffer) };
49let input2: cryptoFramework.DataBlob = { data: new Uint8Array(buffer.from("This is Sign test plan2", 'utf-8').buffer) };
50async function signMessagePromise(priKey: cryptoFramework.PriKey) {
51  let signAlg = "RSA1024|PKCS1|SHA256";
52  let signer = cryptoFramework.createSign(signAlg);
53  await signer.init(priKey);
54  await signer.update(input1); // 如果明文较短,可以直接调用sign接口一次性传入
55  let signData = await signer.sign(input2);
56  return signData;
57}
58async function verifyMessagePromise(signMessageBlob: cryptoFramework.DataBlob, pubKey: cryptoFramework.PubKey) {
59  let verifyAlg = "RSA1024|PKCS1|SHA256";
60  let verifier = cryptoFramework.createVerify(verifyAlg);
61  await verifier.init(pubKey);
62  await verifier.update(input1); // 如果明文较短,可以直接调用verify接口一次性传入
63  let res = await verifier.verify(input2, signMessageBlob);
64  console.info("verify result is " + res);
65  return res;
66}
67async function main() {
68  let keyGenAlg = "RSA1024";
69  let generator = cryptoFramework.createAsyKeyGenerator(keyGenAlg);
70  let keyPair = await generator.generateKeyPair();
71  let signData = await signMessagePromise(keyPair.priKey);
72  let verifyResult = await verifyMessagePromise(signData, keyPair.pubKey);
73  if (verifyResult == true) {
74    console.info('verify success');
75  } else {
76    console.error('verify failed');
77  }
78}
79```
80