1# cert子系统ChangeLog
2
3##  cl.cert.1 X509Crl接口变更
4
5**访问级别**
6
7公开接口
8
9**变更原因**
10
111.为满足规范规定的证书吊销列表（CRL）描述，需要将原有X509Crl相关的接口，重新定义为X509CRL。
12
132.getRevokedCert接口，规范规定的证书序列号范围较大，需要将serialNumber参数类型从number变更为bigint。
14
15**变更影响**
16
17该变更为非兼容性变更。从API11开始，X509Crl接口不再提供支持，应用需要自行适配为X509CRL接口函数。函数功能不变。
18
19**变更发生版本**
20
21从OpenHarmony SDK 4.1.3.5 开始。
22
23**变更的接口/组件**
24
25修改前的接口原型：
26
27 ```js
28interface X509Crl {
29    ...
30    getRevokedCert(serialNumber: number): X509CrlEntry;
31    getRevokedCertWithCert(cert: X509Cert): X509CrlEntry;
32    getRevokedCerts(callback: AsyncCallback<Array<X509CrlEntry>>): void;
33    getRevokedCerts(): Promise<Array<X509CrlEntry>>;
34    getTbsInfo(): DataBlob;
35    ...
36};
37function createX509Crl(inStream: EncodingBlob, callback: AsyncCallback<X509Crl>): void;
38function createX509Crl(inStream: EncodingBlob): Promise<X509Crl>;
39 ```
40
41修改后的接口原型：
42
43 ```js
44interface X509CRL {
45    ...
46    getRevokedCert(serialNumber: bigint): X509CRLEntry;
47    getRevokedCertWithCert(cert: X509Cert): X509CRLEntry;
48    getRevokedCerts(callback: AsyncCallback<Array<X509CRLEntry>>): void;
49    getRevokedCerts(): Promise<Array<X509CRLEntry>>;
50    getTBSInfo(): DataBlob;
51    ...
52};
53function createX509CRL(inStream: EncodingBlob, callback: AsyncCallback<X509CRL>): void;
54function createX509CRL(inStream: EncodingBlob): Promise<X509CRL>;
55 ```
56
57**适配指导**
58
59接口使用的示例代码可参考[证书开发指导](../../../application-dev/security/cert-guidelines.md)和[API参考](../../../application-dev/reference/apis/js-apis-cert.md)。
60
61##  cl.cert.2 X509CrlEntry接口变更
62
63**访问级别**
64
65公开接口
66
67**变更原因**
68
691.为满足规范规定的证书吊销列表（CRL）描述，需要将原有X509CrlEntry相关的接口，重新定义为X509CRLEntry。
70
712.获取序列号的接口getSerialNumber，由于规范规定的证书序列号范围较大，返回值类型需要从number变更为bigint。
72
73**变更影响**
74
75该变更为非兼容性变更。从API11开始，X509CrlEntry接口不再提供支持，应用需要自行适配为X509CRLEntry。
76
77**变更发生版本**
78
79从OpenHarmony SDK 4.1.3.5 开始。
80
81**变更的接口/组件**
82
83修改前的接口原型：
84
85 ```js
86interface X509CrlEntry {
87  ...
88  getSerialNumber(): number;
89  ...
90}
91 ```
92
93修改后的接口原型：
94
95 ```js
96interface X509CRLEntry {
97  ...
98  getSerialNumber(): bigint;
99  ...
100}
101 ```
102
103**适配指导**
104
105接口使用的示例代码可参考[证书开发指导](../../../application-dev/security/cert-guidelines.md)和[API参考](../../../application-dev/reference/apis/js-apis-cert.md)。
106