• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 证书扩展信息对象的创建、解析和校验
2
3<!--Kit: Device Certificate Kit-->
4<!--Subsystem: Security-->
5<!--Owner: @zxz--3-->
6<!--Designer: @lanming-->
7<!--Tester: @PAFT-->
8<!--Adviser: @zengyawen-->
9
10以获取证书指定OID域段，并判断是否为CA证书为例，完成证书扩展信息对象的创建、解析和校验。
11
12## 开发步骤
13
141. 导入[证书算法库框架模块](../../reference/apis-device-certificate-kit/js-apis-cert.md)。
15   ```ts
16   import { cert } from '@kit.DeviceCertificateKit';
17   ```
18
192. 解析证书扩展域段数据，调用[cert.createCertExtension](../../reference/apis-device-certificate-kit/js-apis-cert.md#certcreatecertextension10)创建证书扩展域段对象。
20
213. 调用[CertExtension.getEntry](../../reference/apis-device-certificate-kit/js-apis-cert.md#getentry10)获取指定OID证书扩展域段信息。比如，证书扩展域段对象标识符列表，根据对象标识符获取具体数据等。
22
234. 调用[CertExtension.checkCA](../../reference/apis-device-certificate-kit/js-apis-cert.md#checkca10)判断证书是否为CA证书。
24
25```ts
26import { cert } from '@kit.DeviceCertificateKit';
27import { BusinessError } from '@kit.BasicServicesKit';
28import { util } from '@kit.ArkTS';
29
30// 证书扩展数据，以下只是一个示例。需要根据具体业务来赋值。
31let extData = new Uint8Array([
32  0x30, 0x40, 0x30, 0x0F, 0x06, 0x03, 0x55, 0x1D,
33  0x13, 0x01, 0x01, 0xFF, 0x04, 0x05, 0x30, 0x03,
34  0x01, 0x01, 0xFF, 0x30, 0x0E, 0x06, 0x03, 0x55,
35  0x1D, 0x0F, 0x01, 0x01, 0xFF, 0x04, 0x04, 0x03,
36  0x02, 0x01, 0xC6, 0x30, 0x1D, 0x06, 0x03, 0x55,
37  0x1D, 0x0E, 0x04, 0x16, 0x04, 0x14, 0xE0, 0x8C,
38  0x9B, 0xDB, 0x25, 0x49, 0xB3, 0xF1, 0x7C, 0x86,
39  0xD6, 0xB2, 0x42, 0x87, 0x0B, 0xD0, 0x6B, 0xA0,
40  0xD9, 0xE4
41]);
42
43// 证书扩展示例
44function certExtensionSample(): void {
45  let textEncoder = new util.TextEncoder();
46  let encodingBlob: cert.EncodingBlob = {
47    data: extData,
48    // 证书扩展格式，目前仅支持DER格式。
49    encodingFormat: cert.EncodingFormat.FORMAT_DER
50  };
51
52  // 创建一个证书扩展实例。
53  cert.createCertExtension(encodingBlob, (err, certExtension) => {
54    if (err != null) {
55      // 证书扩展实例创建失败。
56      console.error(`createCertExtension failed, errCode:${err.code}, errMsg:${err.message} `);
57      return;
58    }
59    // 证书扩展实例创建成功。
60    console.log('createCertExtension success');
61
62    try {
63      // 根据OID获取证书扩展信息。
64      let oidData = '2.5.29.14';
65      let oid: cert.DataBlob = {
66        data: textEncoder.encodeInto(oidData),
67      }
68      let entry = certExtension.getEntry(cert.ExtensionEntryType.EXTENSION_ENTRY_TYPE_ENTRY, oid);
69
70      // 检查证书是否为CA证书。
71      let pathLen = certExtension.checkCA();
72      console.log('test cert extension success');
73    } catch (err) {
74      let e: BusinessError = err as BusinessError;
75      console.error(`operation failed, message:${e.message} ,code:${e.code} `);
76    }
77  });
78}
79```
80