证书算法库框架概述
=========

证书算法库框架是一个屏蔽了第三方算法库实现差异的证书算法框架，向应用提供证书、证书扩展域段、证书吊销列表的创建、解析及校验能力，此外还提供了证书链的校验能力。

开发者通过调用证书算法库框架接口，忽略底层不同三方算法库的差异，实现快速开发。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/39/v3/AOXR08q8QEmZGhPGzlAP9A/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073407Z&HW-CC-Expire=86400&HW-CC-Sign=4AC002E197FA438D1A4208D17B5BD88BEFCBF4342C605CE83A82EA31EFB33DC1)

本框架具备处理已有证书及证书吊销列表数据后处理的能力，并不具备生成或签发证书及证书吊销列表的能力，签发证书及证书吊销列表的能力由证书颁发机构（CA）来完成，不由单个应用签发。

#### 基本概念

证书算法库框架提供X.509证书的解析、序列化、X.509证书签名验证、X.509证书吊销列表、证书链校验器等相关的功能。

在开发具体的功能前，开发者需要先了解证书领域的一些基本概念。包括但不限于：

数字证书、数字证书标准X.509（本指导中的“X509”均代指X.509）、证书链、TBS（To Be Signed，待签名部分：指X.509证书中被签名的数据结构，通常包含版本号、序列号、签名算法标识、颁发者、有效期、主体、主体公钥信息和扩展等字段）、CRL（Certificate Revocation List，证书吊销列表）。

#### 证书规格

证书相关规格说明如下所示。

#### \[h2\]证书链校验不包含对时间有效性的校验

由于端侧系统时间不可信，证书链校验不包含对证书有效时间的校验。如果需要检查证书的时间有效性，可使用X.509证书的[checkValidityWithDate()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-cert#checkvaliditywithdate)方法进行检查。

#### \[h2\]证书格式

目前仅支持DER与PEM格式的证书。

#### \[h2\]X.509证书的基本结构

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7c/v3/KDM2rDrMS62XExto5HQoxA/zh-cn_image_0000002594828530.png?HW-CC-KV=V1&HW-CC-Date=20260612T073407Z&HW-CC-Expire=86400&HW-CC-Sign=484D9F409F8A009CD817C4CB53486630A8A77D89A665319EDAA9F119B4EBD3E7)

样例证书文件：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dd/v3/xChkn0l_QlWcxsCxqF72Tg/zh-cn_image_0000002625187977.png?HW-CC-KV=V1&HW-CC-Date=20260612T073407Z&HW-CC-Expire=86400&HW-CC-Sign=B438A0E38F1D62C2673C205A94ABC8D09EA5953CEBED902CA68389AC98792538)

#### \[h2\]X.509证书吊销列表（CRL）基本结构

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e2/v3/1voDslDqRvSZFJokjWC4xQ/zh-cn_image_0000002625108121.png?HW-CC-KV=V1&HW-CC-Date=20260612T073407Z&HW-CC-Expire=86400&HW-CC-Sign=B21C0B182F698C9728AA38DEBB2E377490450B16E8C6B4625E4D9098B67F4088)

样例CRL文件：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7c/v3/yojymjiVSFWQY3fYYD8byw/zh-cn_image_0000002594668604.png?HW-CC-KV=V1&HW-CC-Date=20260612T073407Z&HW-CC-Expire=86400&HW-CC-Sign=38D84CA7D45B2A4221BA0AD355DA575E5859790366C840919A755C1FEA1C619E)

#### 约束与限制

依赖加解密算法库框架的基础算法能力的部分，算法库框架不支持多线程并发操作，详情请参考[加解密算法框架](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/crypto-architecture-kit-intro#约束与限制)。

#### 开发总览

证书算法库框架为开发者提供了以下相关功能的开发指导，请开发者参照开发。在开发前，请先查阅[证书规格](#证书规格)。

*   [证书对象的创建、解析和校验](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-parse-verify-cert-object)
*   [证书扩展信息对象的创建、解析和校验](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-parse-verify-certextension-object)
*   [证书吊销列表对象的创建、解析和校验](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-parse-verify-crl-object)
*   [证书链校验器对象的创建和校验](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-verify-cerchainvalidator-object)
*   [证书集合及证书吊销列表集合对象的创建和获取](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-get-cert-crl-object)
*   [证书链对象的创建和校验](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-verify-certchain-object)
*   [证书链校验时从p12文件构造TrustAnchor对象数组](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-trustanchor-from-p12)
*   [使用系统预置CA证书校验证书链](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/verify-certchain-by-systemca)
*   [证书CMS签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-cms-sign-object)
*   [证书CMS封装](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-cms-enveloped-object)
*   [证书CMS验签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-cms-verify-object)
*   [证书CMS解封装](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-cms-decapsulation-object)
*   [证书PKCS #12的创建和解析](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-parse-pkcs12)
*   [证书链在线校验证书吊销状态](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/create-verify-cerchainvalidator-revocation-object)
*   [证书链校验时下载缺失的中间CA证书](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/allow-download-intermediate-cert)
*   [构建并校验证书链](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/build-and-verify-cert-chain)

证书算法库框架主要提供了以下类，开发者可以查阅对应API参考，了解以下接口：

| 名称 | 类 | 功能 |
| :-- | :-- | :-- |
| X.509证书 | [X509Cert](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-cert#x509cert) | 提供X.509证书的解析、序列化、X.509证书签名验证、证书相关的信息查询等功能。 |
| 证书扩展域段 | [CertExtension](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-cert#certextension10) | 提供X.509证书中扩展域段的获取，如是否CA，CRL分发点等字段。 |
| X.509证书吊销列表 | [X509CRL](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-cert#x509crl11) | 提供X.509证书吊销列表的解析、序列化、信息查询等功能。 |
| 证书链校验器 | [CertChainValidator](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-cert#certchainvalidator) | 提供证书链校验（不包括证书有效期的校验）、证书链算法名称查询的功能。 |
| 证书和证书吊销列表集合 | [CertCRLCollection](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-cert#certcrlcollection11) | 提供证书和证书吊销列表集合的查询功能。 |
| X.509证书链 | [X509CertChain](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-cert#x509certchain11) | 提供证书链校验、证书列表获取的功能。 |