• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 证书对象的创建、解析和校验
2
3以校验证书有效性为例，完成证书对象的创建、解析和校验。
4
5## 开发步骤
6
71. 导入[证书算法库框架模块](../../reference/apis-device-certificate-kit/js-apis-cert.md)。
8   ```ts
9   import { cert } from '@kit.DeviceCertificateKit';
10   ```
11
122. 基于已有的X509证书数据，调用[cert.createX509Cert](../../reference/apis-device-certificate-kit/js-apis-cert.md#certcreatex509cert)创建证书对象。
13
143. 解析证书的字段信息。
15   此处以获取证书版本、证书序列号为例，更多字段信息获取接口请查看[API参考文档](../../reference/apis-device-certificate-kit/js-apis-cert.md#x509cert)。
16
174. 调用[X509Cert.getPublicKey](../../reference/apis-device-certificate-kit/js-apis-cert.md#getpublickey)获取证书中的公钥，并调用[X509Cert.verify](../../reference/apis-device-certificate-kit/js-apis-cert.md#verify)校验签名。示例为自验签场景，因此获取的是本证书中的公钥。应用须结合自身场景获取用于验签的公钥。
18
195. 调用[X509Cert.checkValidityWithDate](../../reference/apis-device-certificate-kit/js-apis-cert.md#checkvaliditywithdate)校验证书有效期。入参date用于确认此日期是否在X509证书有效期内。
20
21```ts
22import { cert } from '@kit.DeviceCertificateKit';
23import { BusinessError } from '@kit.BasicServicesKit';
24import { util } from '@kit.ArkTS';
25
26// 此处仅为示例的证书二进制数据，需根据业务的不同对证书数据进行赋值。
27let certData = '-----BEGIN CERTIFICATE-----\n' +
28  'MIIBLzCB1QIUO/QDVJwZLIpeJyPjyTvE43xvE5cwCgYIKoZIzj0EAwIwGjEYMBYG\n' +
29  'A1UEAwwPRXhhbXBsZSBSb290IENBMB4XDTIzMDkwNDExMjAxOVoXDTI2MDUzMDEx\n' +
30  'MjAxOVowGjEYMBYGA1UEAwwPRXhhbXBsZSBSb290IENBMFkwEwYHKoZIzj0CAQYI\n' +
31  'KoZIzj0DAQcDQgAEHjG74yMIueO7z3T+dyuEIrhxTg2fqgeNB3SGfsIXlsiUfLTa\n' +
32  'tUsU0i/sePnrKglj2H8Abbx9PK0tsW/VgqwDIDAKBggqhkjOPQQDAgNJADBGAiEA\n' +
33  '0ce/fvA4tckNZeB865aOApKXKlBjiRlaiuq5mEEqvNACIQDPD9WyC21MXqPBuRUf\n' +
34  'BetUokslUfjT6+s/X4ByaxycAA==\n' +
35  '-----END CERTIFICATE-----\n';
36
37// 证书示例
38function certSample(): void {
39  let textEncoder = new util.TextEncoder();
40  let encodingBlob: cert.EncodingBlob = {
41    // 将证书数据从string类型转换成Unit8Array。
42    data: textEncoder.encodeInto(certData),
43    // 证书格式，仅支持PEM和DER。在此示例中，证书为PEM格式。
44    encodingFormat: cert.EncodingFormat.FORMAT_PEM
45  };
46
47  // 创建X509Cert实例。
48  cert.createX509Cert(encodingBlob, (err, x509Cert) => {
49    if (err != null) {
50      // 创建X509Cert实例失败。
51      console.error(`createX509Cert failed, errCode:${err.code}, errMsg:${err.message}`);
52      return;
53    }
54    // X509Cert实例创建成功。
55    console.log('createX509Cert success');
56
57    // 获取证书版本。
58    let version = x509Cert.getVersion();
59    let serial = x509Cert.getCertSerialNumber();
60    console.log(`X509 version: ${version} , X509 serial:${serial}`);
61
62    // 使用上级证书对象的getPublicKey()方法或本（自签名）证书对象获取公钥对象。
63    try {
64      let pubKey = x509Cert.getPublicKey();
65      // 验证证书签名。
66      x509Cert.verify(pubKey, (err, data) => {
67        if (err == null) {
68          // 签名验证成功。
69          console.log('verify success');
70        } else {
71          // 签名验证失败。
72          console.error(`verify failed, errCode: ${err.code} , errMsg:${err.message}`);
73        }
74      });
75    } catch (error) {
76      let e: BusinessError = error as BusinessError;
77      console.error(`getPublicKey failed, errCode: ${e.code} , errMsg:${e.message}`);
78    }
79
80    // 用一个字符串代表时间。
81    let date = '20230930000001Z';
82
83    // 验证证书的有效期。
84    try {
85      x509Cert.checkValidityWithDate(date);
86    } catch (error) {
87      let e: BusinessError = error as BusinessError;
88      console.error(`checkValidityWithDate failed, errCode: ${e.code}, errMsg:${e.message}`);
89    }
90  });
91}
92```
93