!21512 X509Cert.getSerialNumber接口废弃变更为X509Cert.getCertSerialNumber

Merge pull request !21512 from zhao_zhen_zhou/master

zh-cn/application-dev/reference/apis/js-apis-cert.md

@@ -553,12 +553,16 @@ cryptoCert.createX509Cert(encodingBlob, function (error, x509Cert) {
 });
 ```
 
-### getSerialNumber
+### getSerialNumber<sup>(deprecated)</sup>
 
 getSerialNumber() : number
 
 表示获取X509证书序列号。
 
+> **说明：**
+>
+> 从API version 9开始支持，从API version 10开始废弃，建议使用[getCertSerialNumber](#getcertserialnumber10)替代。
+
 **系统能力：** SystemCapability.Security.Cert
 
 **返回值**：
@@ -589,6 +593,48 @@ cryptoCert.createX509Cert(encodingBlob, function (error, x509Cert) {
 });
 ```
 
+### getCertSerialNumber<sup>10+</sup>
+
+getCertSerialNumber() : bigint
+
+表示获取X509证书序列号。
+
+**系统能力：** SystemCapability.Security.Cert
+
+**返回值**：
+
+| 类型   | 说明               |
+| ------ | ------------------ |
+| bigint | 表示X509证书序列号 |
+
+**错误码：**
+
+| 错误码ID | 错误信息                                          |
+| -------- | ------------------------------------------------- |
+| 19020002 | runtime error.                                    |
+
+**示例：**
+
+```js
+import cryptoCert from '@ohos.security.cert';
+
+// 证书二进制数据，需业务自行赋值
+let encodingData = null;
+let encodingBlob = {
+    data: encodingData,
+    // 根据encodingData的格式进行赋值，支持FORMAT_PEM和FORMAT_DER
+    encodingFormat: cryptoCert.EncodingFormat.FORMAT_PEM
+};
+cryptoCert.createX509Cert(encodingBlob, function (error, x509Cert) {
+    if (error != null) {
+        console.log("createX509Cert failed, errCode: " + error.code + ", errMsg: " + error.message);
+    } else {
+        console.log("createX509Cert success");
+        let serialNumber = x509Cert.getCertSerialNumber();
+    }
+});
+```
+
 ### getIssuerName
 
 getIssuerName() : DataBlob

zh-cn/application-dev/security/cert-guidelines.md

@@ -34,7 +34,7 @@
 | X509Cert        | getPublicKey() : cryptoFramework.PubKey                       | 获取证书公钥                               |
 | X509Cert        | checkValidityWithDate(date: string) : void                   | 校验证书有效期                              |
 | X509Cert        | getVersion() : number                                        | 获取证书版本                                 |
-| X509Cert        | getSerialNumber() : number                                   | 获取证书序列号                               |
+| X509Cert | getCertSerialNumber() : bigint<sup>10+</sup> | 获取证书序列号 |
 | X509Cert        | getIssuerName() : DataBlob                                   | 获取证书颁发者名称                           |
 | X509Cert        | getSubjectName() : DataBlob                                  | 获取证书主体名称                             |
 | X509Cert        | getNotBeforeTime() : string                                  | 获取证书有效期起始时间                       |

zh-cn/release-notes/changelogs/OpenHarmony_4.0.10.1/changelogs-cert.md

+# 安全子系统ChangeLog
+
+##  cl.cert.1 X509Cert.getSerialNumber接口废弃变更
+
+X509Cert.getSerialNumber接口作废弃处理，变更为X509Cert.getCertSerialNumber接口。
+
+**变更影响**
+
+从API version 10开始，X509Cert.getSerialNumber接口废弃。应用需要自行适配为X509Cert.getCertSerialNumber。接口功能不变。
+
+**关键的接口/组件变更**
+
+修改前的接口原型：
+
+ ```js
+interface X509Cert {
+  ...
+  getSerialNumber(): number;
+  ...
+}
+ ```
+
+修改后的接口原型：
+
+ ```js
+interface X509Cert {
+  ...
+  getCertSerialNumber(): bigint;
+  ...
+}
+ ```
+
+**适配指导**
+
+接口使用的示例代码可参考[证书开发指导](../../../application-dev/security/cert-guidelines.md)和[API参考](../../../application-dev/reference/apis/js-apis-cert.md)。