Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
699afa7b
D
Docs
项目概览
OpenHarmony
/
Docs
11 个月 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
699afa7b
编写于
11月 23, 2022
作者:
X
xwb
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
完善算法库中对称加解密和mac、md、rand的描述,补充错误码
Signed-off-by:
N
xwb
<
xuwanbing1@huawei.com
>
上级
1a4f4a76
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
766 addition
and
471 deletion
+766
-471
zh-cn/application-dev/reference/apis/js-apis-cryptoFramework.md
...application-dev/reference/apis/js-apis-cryptoFramework.md
+751
-460
zh-cn/application-dev/security/cryptoFramework-guidelines.md
zh-cn/application-dev/security/cryptoFramework-guidelines.md
+5
-5
zh-cn/application-dev/security/cryptoFramework-overview.md
zh-cn/application-dev/security/cryptoFramework-overview.md
+10
-6
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-cryptoFramework.md
浏览文件 @
699afa7b
...
...
@@ -3,7 +3,7 @@
为屏蔽底层硬件和算法库,向上提供统一的密码算法库加解密和证书相关接口。
> **说明:**
>
>
> 本模块首批接口从API version 9开始支持。
## 导入模块
...
...
@@ -18,33 +18,37 @@ import cryptoFramework from "@ohos.security.cryptoFramework"
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 默认值 | 描述
|
| -------------------------------------
-| -------- | ------------------------------
|
| INVALID_PARAMS | 401 | 非法入参。
|
| NOT_SUPPORT | 801 | 操作不支持。
|
| ERR_OUT_OF_MEMORY | 17620001 | 内存错误。
|
| ERR_RUNTIME_ERROR | 17620002 | 运行时外部错误。
|
| ERR_CRYPTO_OPERATION | 17630001 | 调用三方算法库API出错。
|
| ERR_CERT_SIGNATURE_FAILURE | 17630002 | 证书签名验证错误。
|
| ERR_CERT_NOT_YET_VALID | 17630003 | 证书尚未生效。
|
| ERR_CERT_HAS_EXPIRED | 17630004 | 证书过期。
|
| ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY | 17630005 | 无法获取证书的颁发者。
|
| ERR_KEYUSAGE_NO_CERTSIGN | 17630006 | 证书的秘钥用途不含证书签名。
|
| ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE | 17630007 |
证书的秘钥用途不含数字签名。 |
| 名称 | 默认值 | 描述 |
| -------------------------------------
| -------- | ----------------------------
|
| INVALID_PARAMS | 401 | 非法入参。 |
| NOT_SUPPORT | 801 | 操作不支持。 |
| ERR_OUT_OF_MEMORY | 17620001 | 内存错误。 |
| ERR_RUNTIME_ERROR | 17620002 | 运行时外部错误。 |
| ERR_CRYPTO_OPERATION | 17630001 | 调用三方算法库API出错。 |
| ERR_CERT_SIGNATURE_FAILURE | 17630002 | 证书签名验证错误。 |
| ERR_CERT_NOT_YET_VALID | 17630003 | 证书尚未生效。 |
| ERR_CERT_HAS_EXPIRED | 17630004 | 证书过期。 |
| ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY | 17630005 | 无法获取证书的颁发者。 |
| ERR_KEYUSAGE_NO_CERTSIGN | 17630006 | 证书的秘钥用途不含证书签名。 |
| ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE | 17630007 | 证书的秘钥用途不含数字签名。 |
## DataBlob
buffer数组。
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| -------------- | -------------- | ---- | ---- | ----------------|
| data | Uint8Array | 是 | 是 | 数据。 |
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ---- | ---------- | ---- | ---- | ------ |
| data | Uint8Array | 是 | 是 | 数据。 |
## DataArray
buffer数组的列表。
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| -------------- | -------------- | ---- | ---- | ----------------|
| data | Uint8Array | 是 | 是 | 数据列表。 |
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ---- | ---------- | ---- | ---- | ---------- |
| data | Uint8Array | 是 | 是 | 数据列表。 |
## EncodingFormat
...
...
@@ -52,24 +56,24 @@ buffer数组的列表。
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称
| 默认值 | 描述
|
| ----------
--| ---------| -----------
|
| FORMAT_DER
| 0 | DER格式。
|
| FORMAT_PEM
| 1 | PEM格式。
|
| 名称
| 默认值 | 描述
|
| ----------
| ------ | ---------
|
| FORMAT_DER
| 0 | DER格式。
|
| FORMAT_PEM
| 1 | PEM格式。
|
## EncodingBlob
带编码格式的证书二进制数组
。
证书链数据,在证书链校验时,作为入参传入
。
### 属性
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型
| 可读 | 可写 | 描述
|
| -------------- | --------------
| ---- | ---- | ----------------------------------
|
| data | Uint8Array
| 是 | 是 | 传入的数据中,包含的证书数量。
|
| encodingFormat |
[
EncodingFormat
](
#encodingformat
)
| 是 | 是 | 指明证书编码格式。 |
| 名称 | 类型
| 可读 | 可写 | 描述
|
| -------------- | --------------
------------------- | ---- | ---- | ------------------------------
|
| data | Uint8Array
| 是 | 是 | 传入的数据中,包含的证书数量。
|
| encodingFormat |
[
EncodingFormat
](
#encodingformat
)
| 是 | 是 | 指明证书编码格式。
|
## CertChainData
...
...
@@ -80,11 +84,11 @@ buffer数组的列表。
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| -------------- | -------------- | ---- | ---- | ------------------------------------------------------------ |
| data | Uint8Array
| 是 | 是 | 证书数据,按照长度(2字节)-数据的形式传入,如:08ABCDEFGH07ABCDEFG,第一本证书,前2个字节表示证书的长度为8字节,后面附加8字节的证书数据;第2本证书前2个字节表示证书的长度为7字节,后面附加7字节的证书数据。
|
| count | number
| 是 | 是 | 传入的数据中,包含的证书数量。
|
| encodingFormat |
[
EncodingFormat
](
#encodingformat
)
| 是 | 是 | 指明证书编码格式。 |
| 名称 | 类型
| 可读 | 可写 | 描述 |
| -------------- | --------------
-------------------
| ---- | ---- | ------------------------------------------------------------ |
| data | Uint8Array
| 是 | 是 | 证书数据,按照长度(2字节)-数据的形式传入,如:08ABCDEFGH07ABCDEFG,第一本证书,前2个字节表示证书的长度为8字节,后面附加8字节的证书数据;第2本证书前2个字节表示证书的长度为7字节,后面附加7字节的证书数据。
|
| count | number
| 是 | 是 | 传入的数据中,包含的证书数量。
|
| encodingFormat |
[
EncodingFormat
](
#encodingformat
)
| 是 | 是 | 指明证书编码格式。
|
## cryptoFramework.createMac
...
...
@@ -107,6 +111,12 @@ createMac(algName : string) : Mac
| ---- | --------------------------------------- |
| Mac | 返回由输入算法指定生成的
[
Mac
](
#mac
)
对象 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 17620001 | memory error |
**示例:**
```
javascript
...
...
@@ -114,6 +124,7 @@ import cryptoFramework from "@ohos.security.cryptoFramework"
var
mac
;
try
{
// 参数选择请参考上述算法支持范围
mac
=
cryptoFramework
.
createMac
(
"
SHA256
"
);
}
catch
(
error
)
{
console
.
error
(
"
[Promise]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
);
...
...
@@ -124,9 +135,9 @@ try {
Mac类,调用Mac方法可以进行MAC(Message Authentication Code)加密计算。调用前,需要通过
[
createMac
](
#cryptoframeworkcreatemac
)
构造Mac实例。
###
**属性**
###
属性
**系统能力:**
SystemCapability.Security.CryptoFramework
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------- | ------ | ---- | ---- | -------------------- |
...
...
@@ -142,10 +153,16 @@ init(key : SymKey, callback : AsyncCallback\<void>) : void;
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ------------------ |
| key | SymKey | 是 | 共享对称密钥 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------ |
| key | SymKey | 是 | 共享对称密钥 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17630001 | crypto operation error |
**示例:**
...
...
@@ -172,8 +189,6 @@ symKeyGenerator.convertKey(KeyBlob, (err, symKey) => {
});
```
### init
init(key : SymKey) : Promise
\<
void>;
...
...
@@ -190,10 +205,16 @@ init(key : SymKey) : Promise\<void>;
**返回值:**
| 类型
| 说明
|
| --------------
- | -
----------- |
| 类型
| 说明
|
| --------------
|
----------- |
| Promise
\<
void> | Promise对象 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17630001 | crypto operation error |
**示例:**
```
javascript
...
...
@@ -203,9 +224,7 @@ var mac;
try
{
mac
=
cryptoFramework
.
createMac
(
"
SHA256
"
);
}
catch
(
error
)
{
AlertDialog
.
show
({
message
:
"
[Promise]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
});
console
.
error
(
"
[Promise]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
);
}
console
.
error
(
"
Mac algName is:
"
+
mac
.
algName
);
...
...
@@ -229,10 +248,18 @@ update(input : DataBlob, callback : AsyncCallback\<void>) : void;
**系统能力:**
SystemCapability.Security.CryptoFramework
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ---------- |
| input | DataBlob | 是 | 传入的消息 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ---------- |
| input | DataBlob | 是 | 传入的消息 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17630001 | crypto operation error |
**示例:**
...
...
@@ -244,7 +271,6 @@ var mac;
try
{
mac
=
cryptoFramework
.
createMac
(
"
SHA256
"
);
}
catch
(
error
)
{
AlertDialog
.
show
({
message
:
"
[Callback]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
});
console
.
error
(
"
[Callback]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
);
}
var
symKeyGenerator
=
cryptoFramework
.
createSymKeyGenerator
(
"
AES128
"
);
...
...
@@ -274,16 +300,26 @@ update(input : DataBlob) : Promise\<void>;
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------- | ---- | ---------- |
| input | DataBlob | 是 | 传入的消息 |
**返回值:**
| 类型
| 说明
|
| --------------
-
| ----------- |
| 类型
| 说明
|
| -------------- | ----------- |
| Promise
\<
void> | Promise对象 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17630001 | crypto operation error |
**示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -291,14 +327,11 @@ var mac;
try
{
mac
=
cryptoFramework
.
createMac
(
"
SHA256
"
);
}
catch
(
error
)
{
AlertDialog
.
show
({
message
:
"
[Promise]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
});
console
.
error
(
"
[Promise]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
);
}
console
.
error
(
"
Mac algName is:
"
+
mac
.
algName
);
AlertDialog
.
show
({
message
:
"
Mac algName is:
"
+
mac
.
algName
});
var
KeyBlob
;
var
symKeyGenerator
=
cryptoFramework
.
createSymKeyGenerator
(
"
AES128
"
);
var
promiseConvertKey
=
symKeyGenerator
.
convertKey
(
KeyBlob
);
promiseConvertKey
.
then
(
symKey
=>
{
...
...
@@ -314,8 +347,6 @@ promiseConvertKey.then(symKey => {
```
### doFinal
doFinal(callback : AsyncCallback
\<
DataBlob>) : void;
...
...
@@ -324,10 +355,19 @@ doFinal(callback : AsyncCallback\<DataBlob>) : void;
**系统能力:**
SystemCapability.Security.CryptoFramework
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | -------- |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------ | ---- | -------- |
| callback | AsyncCallback
\<
DataBlob> | 是 | 回调函数 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17620001 | memory error |
| 17630001 | crypto operation error |
**示例:**
```
javascript
...
...
@@ -338,7 +378,6 @@ var mac;
try
{
mac
=
cryptoFramework
.
createMac
(
"
SHA256
"
);
}
catch
(
error
)
{
AlertDialog
.
show
({
message
:
"
[Callback]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
});
console
.
error
(
"
[Callback]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
);
}
var
symKeyGenerator
=
cryptoFramework
.
createSymKeyGenerator
(
"
AES128
"
);
...
...
@@ -377,10 +416,17 @@ doFinal() : Promise\<DataBlob>
**返回值:**
| 类型 | 说明 |
| ------------------
-
| ----------- |
| 类型
| 说明 |
| ------------------ | ----------- |
| Promise
\<
DataBlob> | Promise对象 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17620001 | memory error |
| 17630001 | crypto operation error |
**示例:**
```
javascript
...
...
@@ -393,7 +439,6 @@ try {
console
.
error
(
"
[Promise]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
);
}
console
.
error
(
"
Mac algName is:
"
+
mac
.
algName
);
AlertDialog
.
show
({
message
:
"
Mac algName is:
"
+
mac
.
algName
});
var
KeyBlob
;
var
symKeyGenerator
=
cryptoFramework
.
createSymKeyGenerator
(
"
AES128
"
);
...
...
@@ -429,6 +474,12 @@ getMacLength() : number
| ------ | ------------------------- |
| number | 返回mac计算结果的字节长度 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17630001 | crypto operation error |
**示例:**
```
javascript
...
...
@@ -441,7 +492,6 @@ try {
console
.
error
(
"
[Promise]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
);
}
console
.
error
(
"
Mac algName is:
"
+
mac
.
algName
);
AlertDialog
.
show
({
message
:
"
Mac algName is:
"
+
mac
.
algName
});
var
KeyBlob
;
var
symKeyGenerator
=
cryptoFramework
.
createSymKeyGenerator
(
"
AES128
"
);
...
...
@@ -459,7 +509,7 @@ promiseConvertKey.then(symKey => {
}).
then
(
macOutput
=>
{
console
.
error
(
"
[Promise]: HMAC result:
"
+
macOutput
.
data
);
let
macLen
=
mac
.
getMacLength
();
AlertDialog
.
show
({
message
:
"
MAC len:
"
+
macLen
}
);
console
.
error
(
"
MAC len:
"
+
macLen
);
}).
catch
(
error
=>
{
console
.
error
(
"
[Promise]: error:
"
+
error
.
message
);
});
...
...
@@ -485,6 +535,12 @@ createMd(algName : string) : Md
| ---- | ------------------------------------- |
| Md | 返回由输入算法指定生成的
[
Md
](
#md
)
对象 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 17620001 | memory error |
**示例:**
```
javascript
...
...
@@ -492,6 +548,7 @@ import cryptoFramework from "@ohos.security.cryptoFramework"
var
md
;
try
{
// 参数选择请参考上述算法支持范围
md
=
cryptoFramework
.
createMd
(
"
SHA256
"
);
}
catch
(
error
)
{
console
.
error
(
"
[Promise]: error code:
"
+
error
.
code
+
"
, message is:
"
+
error
.
message
);
...
...
@@ -502,9 +559,9 @@ try {
Md类,调用Md方法可以进行MD(Message Digest)摘要计算。调用前,需要通过
[
createMd
](
#cryptoframeworkcreatemd
)
构造Md实例。
###
**属性**
###
属性
**系统能力:**
SystemCapability.Security.CryptoFramework
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------- | ------ | ---- | ---- | -------------------- |
...
...
@@ -518,16 +575,18 @@ update(input : DataBlob, callback : AsyncCallback\<void>) : void;
**系统能力:**
SystemCapability.Security.CryptoFramework
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ------------ |
| input | DataBlob | 是 | 传入的消息 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ---------- |
| input | DataBlob | 是 | 传入的消息 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
**
返回值
:**
**
错误码
:**
|
类型 | 说明
|
| --------
------- |
------------ |
|
Promise
\<
void> | Promise对象
|
|
错误码ID | 错误信息
|
| --------
| ----------
------------ |
|
17630001 | crypto operation error
|
**示例:**
...
...
@@ -564,10 +623,16 @@ update(input : DataBlob) : Promise\<void>;
**返回值:**
| 类型
| 说明
|
| --------------
- | -
----------- |
| 类型
| 说明
|
| --------------
|
----------- |
| Promise
\<
void> | Promise对象 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17630001 | crypto operation error |
**示例:**
```
javascript
...
...
@@ -598,10 +663,17 @@ digest(callback : AsyncCallback\<DataBlob>) : void
**系统能力:**
SystemCapability.Security.CryptoFramework
| 参数名 | 类型
| 必填 | 说明
|
| -------- | ------------------------
- | ---- | ------------
-------- |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | ------------------------
| ---- |
-------- |
| callback | AsyncCallback
\<
DataBlob> | 是 | 回调函数 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17620001 | memory error |
| 17630001 | crypto operation error |
**示例:**
```
javascript
...
...
@@ -640,10 +712,17 @@ digest() : Promise\<DataBlob>
**返回值:**
| 类型 | 说明 |
| ------------------
-
| ----------- |
| 类型
| 说明 |
| ------------------ | ----------- |
| Promise
\<
DataBlob> | Promise对象 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17620001 | memory error |
| 17630001 | crypto operation error |
**示例:**
```
javascript
...
...
@@ -683,6 +762,12 @@ getMdLength() : number
| ------ | ------------------------ |
| number | 返回md计算结果的字节长度 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17630001 | crypto operation error |
**示例:**
```
javascript
...
...
@@ -704,7 +789,7 @@ promiseMdUpdate.then(() => {
}).
then
(
mdOutput
=>
{
console
.
error
(
"
[Promise]: MD result:
"
+
mdOutput
.
data
);
let
mdLen
=
md
.
getMdLength
();
AlertDialog
.
show
({
message
:
"
MD len:
"
+
mdLen
}
);
console
.
error
(
"
MD len:
"
+
mdLen
);
}).
catch
(
error
=>
{
console
.
error
(
"
[Promise]: error:
"
+
error
.
message
);
});
...
...
@@ -724,6 +809,12 @@ createRandom() : Random
| ------ | --------------------------------------------- |
| Random | 返回由输入算法指定生成的
[
Random
](
#random
)
对象 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------ |
| 17620001 | memory error |
**示例:**
```
javascript
...
...
@@ -748,10 +839,19 @@ generateRandom(len : number, callback: AsyncCallback\<DataBlob>) : void;
**系统能力:**
SystemCapability.Security.CryptoFramework
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | -------------------- |
| len | number | 是 | 表示生成随机数的长度 |
| callback | AsyncCallback
\<
DataBlob> | 是 | 回调函数 |
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------ | ---- | -------------------- |
| len | number | 是 | 表示生成随机数的长度 |
| callback | AsyncCallback
\<
DataBlob> | 是 | 回调函数 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17620001 | memory error |
| 17630001 | crypto operation error |
**示例:**
...
...
@@ -781,16 +881,25 @@ generateRandom(len : number) : Promise\<DataBlob>;
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | -------------------- |
| len | number | 是 | 表示生成随机数的长度 |
**返回值:**
| 类型 | 说明 |
| ------------------
-
| ----------- |
| 类型
| 说明 |
| ------------------ | ----------- |
| Promise
\<
DataBlob> | Promise对象 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ---------------------- |
| 17620001 | memory error |
| 17630001 | crypto operation error |
**示例:**
```
javascript
...
...
@@ -819,10 +928,16 @@ setSeed(seed : DataBlob, callback : AsyncCallback\<void>) : void;
**系统能力:**
SystemCapability.Security.CryptoFramework
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------- | ---- | ------------ |
| seed | DataBlob | 是 | 设置的种子 |
| callback | AsyncCallback
\<
void
\>
| 是 | 回调函数 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------- | ---- | ---------- |
| seed | DataBlob | 是 | 设置的种子 |
| callback | AsyncCallback
\<
void
\>
| 是 | 回调函数 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 17620001 | memory error |
**示例:**
...
...
@@ -860,10 +975,20 @@ setSeed(seed : DataBlob) : Promise\<void>;
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------- | ---- | ---------- |
| seed | DataBlob | 是 | 设置的种子 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------ |
| 17620001 | memory error |
**示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -888,47 +1013,59 @@ promiseGenerateRand.then(randData => {
## ParamsSpec
加解密参数,在进行对称加解密时需要构造其子类对象,并将子类对象传入
[
init()
](
#init-2
)
方法。
适用于需要iv等参数的对称加解密模式(对于无iv等参数的模式如ECB模式,不需要构造其子类对象
)。
加解密参数,在进行对称加解密时需要构造其子类对象,并将子类对象传入
[
init()
](
#init-2
)
方法。
<br/>
适用于需要iv等参数的对称加解密模式(对于无iv等参数的模式如ECB模式,无需构造,在
[
init()
](
#init-2
)
中传入null即可
)。
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称
| 类型 | 可读 | 可写 | 描述
|
| -------
| ------ | ---- | ---- |
---------------------- |
| 名称
| 类型 | 可读 | 可写 | 描述
|
| -------
- | ------ | ---- | ---- | -
---------------------- |
| algoName | string | 是 | 是 | 指明对称加解密参数的算法模式。可选值如下:
<br/>
- "IvParamsSpec": 适用于CBC
\|
CTR
\|
OFB
\|
CFB模式
<br/>
- "GcmParamsSpec": 适用于GCM模式
<br/>
- "CcmParamsSpec": 适用于CCM模式 |
> **说明:**
> 由于[init()](#init-2)的params参数是ParamsSpec类型(父类),而实际需要传入具体的子类对象(如IvParamsSpec),因此在构造子类对象时应设置其父类ParamsSpec的algoName参数,使算法库在init()时知道传入的是哪种子类对象。
## IvParamsSpec
适用于CBC、CTR、OFB、CFB模式,仅使用iv的加解密参数,在对称加解密时构造并传入
[
init()
](
#init-2
)
方法作为参数
。
加解密参数
[
ParamsSpec
](
#paramsspec
)
的子类,用于在对称加解密时作为
[
init()
](
#init-2
)
方法的参数。
<br/>
适用于CBC、CTR、OFB、CFB这些仅使用iv作为参数的加解密模式
。
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ------- | ------ | ---- | ---- | ---------------------- |
| iv |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数iv。常见取值如下:
<br/>
- AES的CBC
\|
CTR
\|
OFB
\|
CFB模式:iv长度为16字节
<br/>
- 3DES的CBC
\|
OFB
\|
CFB模式:iv长度为8字节|
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ---- | --------------------- | ---- | ---- | ------------------------------------------------------------ |
| iv |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数iv。常见取值如下:
<br/>
- AES的CBC
\|
CTR
\|
OFB
\|
CFB模式:iv长度为16字节
<br/>
- 3DES的CBC
\|
OFB
\|
CFB模式:iv长度为8字节 |
> **说明:**
> 传入[init()](#init-2)方法前需要指定其algoName属性(来源于父类[ParamsSpec](#paramsspec))。
## GcmParamsSpec
适用于GCM模式的加解密参数,在对称加解密时构造并传入
[
init()
](
#init-2
)
方法作为参数
。
加解密参数
[
ParamsSpec
](
#paramsspec
)
的子类,用于在对称加解密时作为
[
init()
](
#init-2
)
方法的参数。
<br/>
适用于GCM模式
。
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ------- | ------ | ---- | ---- | ---------------------- |
| iv |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数iv,长度为12字节|
| aad |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数aad,长度为8字节|
| authTag |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数authTag,长度为16字节。
<br/>
采用GCM模式加密时,需要获取
[
doFinal()
](
#dofinal-2
)
输出的
[
DataBlob
](
#datablob
)
,将其末尾16字节作为解密时
[
GcmParamsSpec
](
#gcmparamsspec
)
中的authTag |
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ------- | --------------------- | ---- | ---- | ------------------------------------------------------------ |
| iv |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数iv,长度为12字节 |
| aad |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数aad,长度为8字节 |
| authTag |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数authTag,长度为16字节。
<br/>
采用GCM模式加密时,需要获取
[
doFinal()
](
#dofinal-2
)
输出的
[
DataBlob
](
#datablob
)
,取出其末尾16字节作为解密时
[
init()
](
#init-2
)
方法的入参
[
GcmParamsSpec
](
#gcmparamsspec
)
中的的authTag |
> **说明:**
> 传入[init()](#init-2)方法前需要指定其algoName属性(来源于父类[ParamsSpec](#paramsspec))。
## CcmParamsSpec
适用于CCM模式的加解密参数,在对称加解密时构造并传入
[
init()
](
#init-2
)
方法作为参数
。
加解密参数
[
ParamsSpec
](
#paramsspec
)
的子类,用于在对称加解密时作为
[
init()
](
#init-2
)
方法的参数。
<br/>
适用于CCM模式
。
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ------- | --------
| ---- | ---- | -------------------------------
|
| 名称 | 类型
| 可读 | 可写 | 描述 |
| ------- | --------
------------- | ---- | ---- | ------------------------------------------------------------
|
| iv |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数iv,长度为7字节 |
| aad |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数aad,长度为8字节 |
| authTag |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数authTag,长度为12字节。
<br/>
采用CCM模式加密时,需要获取
[
doFinal()
](
#dofinal-2
)
输出的
[
DataBlob
](
#datablob
)
,将其末尾12字节作为解密时
[
CcmParamsSpec
](
#ccmparamsspec
)
中的authTag |
| authTag |
[
DataBlob
](
#datablob
)
| 是 | 是 | 指明加解密参数authTag,长度为12字节。
<br/>
采用CCM模式加密时,需要获取
[
doFinal()
](
#dofinal-2
)
输出的
[
DataBlob
](
#datablob
)
,取出其末尾12字节作为解密时
[
init()
](
#init-2
)
方法的入参
[
CcmParamsSpec
](
#ccmparamsspec
)
中的authTag |
> **说明:**
> 传入[init()](#init-2)方法前需要指定其algoName属性(来源于父类[ParamsSpec](#paramsspec))。
## CryptoMode
...
...
@@ -936,23 +1073,23 @@ promiseGenerateRand.then(randData => {
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 值
| 描述
|
| ------------ | ----
---- | ----------------
---------------- |
| ENCRYPT_MODE | 0
| 表示进行加密操作
|
| DECRYPT_MODE | 1
| 表示进行解密操作
|
| 名称 | 值
| 描述
|
| ------------ | ----
|
---------------- |
| ENCRYPT_MODE | 0
| 表示进行加密操作
|
| DECRYPT_MODE | 1
| 表示进行解密操作
|
## Key
密钥(父类),在运行密码算法(如加解密)时需要提前生成其子类对象,并传入
[
Cipher
](
#cipher
)
实例的
[
init()
](
#init-2
)
方法。密钥可以通过密钥生成器来生成。
密钥(父类),在运行密码算法(如加解密)时需要提前生成其子类对象,并传入
[
Cipher
](
#cipher
)
实例的
[
init()
](
#init-2
)
方法。
<br/>
密钥可以通过密钥生成器来生成。
### 属性
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ------- | ------ | ---- | ---- | ---------------------- |
| format
| string | 是 | 否 | 密钥的格式。
|
| algName | string | 是 | 否 | 密钥对应的算法名(含长度)。|
| 名称 | 类型 | 可读 | 可写 | 描述
|
| ------- | ------ | ---- | ---- | ----------------------
------
|
| format
| string | 是 | 否 | 密钥的格式。
|
| algName | string | 是 | 否 | 密钥对应的算法名(含长度)。
|
### getEncoded
...
...
@@ -964,13 +1101,14 @@ getEncoded() : DataBlob
**返回值:**
| 类型
|描述
|
| -------
|
----------- |
|
[
DataBlob
](
#datablob
)
| 用于查看密钥的具体内容。|
| 类型
| 描述
|
| -------
-------------- | -------------
----------- |
|
[
DataBlob
](
#datablob
)
| 用于查看密钥的具体内容。
|
**示例:**
```
js
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
function
uint8ArrayToShowStr
(
uint8Array
)
{
return
Array
.
prototype
.
map
.
call
(
uint8Array
,
(
x
)
=>
(
'
00
'
+
x
.
toString
(
16
)).
slice
(
-
2
))
...
...
@@ -984,19 +1122,20 @@ console.info("key hex:" + uint8ArrayToShowStr(encodedKey.data));
## SymKey
对称密钥,是
[
Key
](
#key
)
的子类,在对称加解密时需要将其对象传入
[
Cipher
](
#cipher
)
实例的
[
init()
](
#init-2
)
方法使用。对称密钥可以通过对称密钥生成器
[
SymKeyGenerator
](
#symkeygenerator
)
来生成。
对称密钥,是
[
Key
](
#key
)
的子类,在对称加解密时需要将其对象传入
[
Cipher
](
#cipher
)
实例的
[
init()
](
#init-2
)
方法使用。
<br/>
对称密钥可以通过对称密钥生成器
[
SymKeyGenerator
](
#symkeygenerator
)
来生成。
### clearMem
clearMem() : void
以同步方法,将系统底层内存中的的密钥内容清零。
以同步方法,将系统底层内存中的的密钥内容清零。
建议在不再使用对称密钥实例时,调用本函数,避免内存中密钥数据存留过久。
**系统能力:**
SystemCapability.Security.CryptoFramework
**示例:**
```
js
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
function
uint8ArrayToShowStr
(
uint8Array
)
{
return
Array
.
prototype
.
map
.
call
(
uint8Array
,
(
x
)
=>
(
'
00
'
+
x
.
toString
(
16
)).
slice
(
-
2
))
...
...
@@ -1013,16 +1152,16 @@ console.info("key hex:" + uint8ArrayToShowStr(encodedKey.data)); // 输出全
## PubKey
公钥,是Key的子类,在非对称加解密、验签、密钥协商时需要将其对象作为输入使用。公钥可以通过非对称密钥生成器AsyKeyGenerator来生成。
公钥,是Key的子类,在非对称加解密、验签、密钥协商时需要将其对象作为输入使用。
<br/>
公钥可以通过非对称密钥生成器AsyKeyGenerator来生成。
### 属性
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ------- | ------ | ---- | ---- | ---------------------- |
| format
| string | 是 | 否 | 密钥的格式。
|
| algName | string | 是 | 否 | 密钥对应的算法名(含长度)。|
| 名称 | 类型 | 可读 | 可写 | 描述
|
| ------- | ------ | ---- | ---- | ----------------------
------
|
| format
| string | 是 | 否 | 密钥的格式。
|
| algName | string | 是 | 否 | 密钥对应的算法名(含长度)。
|
### getEncoded
...
...
@@ -1035,9 +1174,9 @@ getEncoded() : DataBlob
**返回值:**
| 类型
|描述
|
| -------
|
----------- |
|
[
DataBlob
](
#datablob
)
| 用于查看密钥的具体内容。|
| 类型
| 描述
|
| -------
-------------- | -------------
----------- |
|
[
DataBlob
](
#datablob
)
| 用于查看密钥的具体内容。
|
**示例:**
...
...
@@ -1050,16 +1189,16 @@ console.info("key encoded:" + Uint8ArrayToShowStr(encodedKey.data));
## PriKey
私钥,是Key的子类,在非对称加解密、签名、密钥协商时需要将其作为输入使用。私钥可以通过非对称密钥生成器AsyKeyGenerator来生成。
私钥,是Key的子类,在非对称加解密、签名、密钥协商时需要将其作为输入使用。
<br/>
私钥可以通过非对称密钥生成器AsyKeyGenerator来生成。
### 属性
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ------- | ------ | ---- | ---- | ---------------------- |
| format
| string | 是 | 否 | 密钥的格式。
|
| algName | string | 是 | 否 | 密钥对应的算法名(含长度)。|
| 名称 | 类型 | 可读 | 可写 | 描述
|
| ------- | ------ | ---- | ---- | ----------------------
------
|
| format
| string | 是 | 否 | 密钥的格式。
|
| algName | string | 是 | 否 | 密钥对应的算法名(含长度)。
|
### getEncoded
...
...
@@ -1071,9 +1210,9 @@ getEncoded() : DataBlob
**返回值:**
| 类型
|描述
|
| -------
|
----------- |
|
[
DataBlob
](
#datablob
)
| 用于查看密钥的具体内容。|
| 类型
| 描述
|
| -------
-------------- | -------------
----------- |
|
[
DataBlob
](
#datablob
)
| 用于查看密钥的具体内容。
|
**示例:**
...
...
@@ -1102,19 +1241,19 @@ key.clearMem();
createSymKeyGenerator(algName : string) : SymKeyGenerator
通过指定算法名称的字符串,获取相应的对称密钥生成器实例。
支持的对称密钥参数详见框架概述“
[
密钥生成规格
](
../../security/cryptoFramework-overview.md#密钥生成规格
)
”一节中“生成密钥的字符串”
。
通过指定算法名称的字符串,获取相应的对称密钥生成器实例。
<br/>
支持的规格详见框架概述“
[
密钥生成规格
](
../../security/cryptoFramework-overview.md#密钥生成规格
)
”一节
。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ----------------------------- |
| algName | string | 是 | 待生成对称密钥生成器的算法名称。 |
| 参数名 | 类型 | 必填 | 说明
|
| ------- | ------ | ---- | -----------------------------
-------------------------------
|
| algName | string | 是 | 待生成对称密钥生成器的算法名称。
<br/>
具体取值详见框架概述“
[
密钥生成规格
](
../../security/cryptoFramework-overview.md#密钥生成规格
)
”一节中的“字符串参数”。
|
**返回值:**
| 类型 | 说明 |
| 类型
| 说明 |
| ----------------------------------- | -------------------------- |
|
[
SymKeyGenerator
](
#symkeygenerator
)
| 返回对称密钥生成器的对象。 |
...
...
@@ -1127,29 +1266,35 @@ let symKeyGenerator = cryptoFramework.createSymKeyGenerator('3DES192');
## SymKeyGenerator
对称密钥生成器。在使用该类的方法前,需要先使用
[
createSymKeyGenerator
](
#cryptoframeworkcreatesymkeygenerator
)
方法构建一个symKeyGenerator实例。
对称密钥生成器。
<br/>
在使用该类的方法前,需要先使用
[
createSymKeyGenerator
](
#cryptoframeworkcreatesymkeygenerator
)
方法构建一个symKeyGenerator实例。
### 属性
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ------- | ------ | ---- | ---- | ---------------------------- |
| 名称 | 类型 | 可读 | 可写 | 描述
|
| ------- | ------ | ---- | ---- | ----------------------------
--
|
| algName | string | 是 | 否 | 对称密钥生成器指定的算法名称。 |
### generateSymKey
generateSymKey(callback : AsyncCallback
\<
SymKey>) : void
异步获取对称密钥生成器随机生成的密钥,通过注册回调函数获取结果。
异步获取对称密钥生成器随机生成的密钥,通过注册回调函数获取结果。
<br/>
必须在使用
[
createSymKeyGenerator
](
#cryptoframeworkcreatesymkeygenerator
)
创建对称密钥生成器后,才能使用本函数。
<br/>
目前支持使用OpenSSL的RAND_priv_bytes()作为底层能力生成随机密钥。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| -------- | ----------------- | ---- | ------------------- |
| callback | AsyncCallback
\<
[
SymKey
](
#symkey
)
> | 是 | 回调函数,用于获取对称密钥。 |
| 名称 | 类型 | 必填 | 说明 |
| -------- | --------------------------------- | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback
\<
[
SymKey
](
#symkey
)
> | 是 | 回调函数。当生成对称密钥成功,err为undefined,data为获取到的SymKey;否则为错误对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------- |
| 17620001 | memory error. |
**示例:**
...
...
@@ -1158,11 +1303,11 @@ import cryptoFramework from '@ohos.security.cryptoFramework';
let
symAlgoName
=
'
3DES192
'
;
let
symKeyGenerator
=
cryptoFramework
.
createSymKeyGenerator
(
symAlgoName
);
symKeyGenerator
.
generateSymKey
((
err
,
symKey
)
=>
{
if
(
err
)
{
console
.
error
(
'
Failed to generate symKey
'
);
return
;
}
console
.
log
(
'
Generate symKey success, algName:
'
+
symKey
.
algName
);
if
(
err
)
{
console
.
error
(
`Generate symKey failed,
${
err
.
code
}
,
${
err
.
message
}
`
);
}
else
{
console
.
info
(
`Generate symKey success, algName:
${
symKey
.
algName
}
`
);
}
})
```
...
...
@@ -1170,15 +1315,21 @@ symKeyGenerator.generateSymKey((err, symKey) => {
generateSymKey() : Promise
\<
SymKey>
异步获取该对称密钥生成器随机生成的密钥,通过Promise获取结果。
异步获取该对称密钥生成器随机生成的密钥,通过Promise获取结果。
<br/>
必须在使用
[
createSymKeyGenerator
](
#cryptoframeworkcreatesymkeygenerator
)
创建对称密钥生成器后,才能使用本函数。
<br/>
目前支持使用OpenSSL的RAND_priv_bytes()作为底层能力生成随机密钥。
**系统能力:**
SystemCapability.Security.CryptoFramework
**返回值:**
| 类型 | 说明 |
| --------------------- | ------------------------------- |
| Promise
\<
[
SymKey
](
#symkey
)
> | 使用Promise的方式获取对称密钥。 |
| 类型 | 说明 |
| --------------------------- | --------------------------------- |
| Promise
\<
[
SymKey
](
#symkey
)
> | Promise对象,返回对称密钥SymKey。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------- |
| 17620001 | memory error. |
**示例:**
...
...
@@ -1186,8 +1337,11 @@ generateSymKey() : Promise\<SymKey>
import
cryptoFramework
from
'
@ohos.security.cryptoFramework
'
;
let
symAlgoName
=
'
AES128
'
;
let
symKeyGenerator
=
cryptoFramework
.
createSymKeyGenerator
(
symAlgoName
);
symKeyGenerator
.
generateSymKey
().
then
((
symKey
)
=>
{
console
.
log
(
'
Generate symKey success, algName:
'
+
symKey
.
algName
);
symKeyGenerator
.
generateSymKey
()
.
then
(
symKey
=>
{
console
.
info
(
`Generate symKey success, algName:
${
symKey
.
algName
}
`
);
},
error
=>
{
console
.
error
(
`Generate symKey failed,
${
error
.
code
}
,
${
error
.
message
}
`
);
})
```
...
...
@@ -1195,16 +1349,22 @@ symKeyGenerator.generateSymKey().then((symKey) => {
convertKey(key : DataBlob, callback : AsyncCallback
\<
SymKey>) : void
异步
获取指定数据生成对称密钥,通过注册回调函数获取结果
。
异步
根据指定数据生成对称密钥,通过注册回调函数获取结果。
<br/>
必须在使用
[
createSymKeyGenerator
](
#cryptoframeworkcreatesymkeygenerator
)
创建对称密钥生成器后,才能使用本函数
。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| -------- | ----------------- | ---- | ---------------------- |
| key |
[
DataBlob
](
#datablob
)
| 是 | 指定的对称密钥材料。 |
| callback | AsyncCallback
\<
[
SymKey
](
#symkey
)
> | 是 | 回调函数,用于获取对称密钥。 |
| 名称 | 类型 | 必填 | 说明 |
| -------- | --------------------------------- | ---- | ------------------------------------------------------------ |
| key |
[
DataBlob
](
#datablob
)
| 是 | 指定的对称密钥材料。 |
| callback | AsyncCallback
\<
[
SymKey
](
#symkey
)
> | 是 | 回调函数。当生成对称密钥成功,err为undefined,data为获取到的SymKey;否则为错误对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | --------------------------------------------------- |
| 17620001 | memory error. |
**示例:**
...
...
@@ -1223,12 +1383,12 @@ function genKeyMaterialBlob() {
let
symAlgoName
=
'
3DES192
'
;
let
symKeyGenerator
=
cryptoFramework
.
createSymKeyGenerator
(
symAlgoName
);
let
keyMaterialBlob
=
genKeyMaterialBlob
();
symKeyGenerator
.
convertKey
(
keyMaterial
,
(
err
,
symKey
)
=>
{
if
(
err
)
{
console
.
error
(
'
Failed to convert symKey
'
);
return
;
}
console
.
log
(
'
Convert symKey success, algName:
'
+
symKey
.
algName
);
symKeyGenerator
.
convertKey
(
keyMaterial
Blob
,
(
err
,
symKey
)
=>
{
if
(
err
)
{
console
.
error
(
`Convert symKey failed,
${
err
.
code
}
,
${
err
.
message
}
`
);
}
else
{
console
.
info
(
`Convert symKey success, algName:
${
symKey
.
algName
}
`
);
}
})
```
...
...
@@ -1236,21 +1396,27 @@ symKeyGenerator.convertKey(keyMaterial, (err, symKey) => {
convertKey(key : DataBlob) : Promise
\<
SymKey>
异步
获取指定数据生成对称密钥,通过Promise获取结果
。
异步
根据指定数据生成对称密钥,通过Promise获取结果。
<br/>
必须在使用
[
createSymKeyGenerator
](
#cryptoframeworkcreatesymkeygenerator
)
创建对称密钥生成器后,才能使用本函数
。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| ---- | -------- | ---- | -------------------- |
| 名称 | 类型
| 必填 | 说明 |
| ---- | --------
-------------
| ---- | -------------------- |
| key |
[
DataBlob
](
#datablob
)
| 是 | 指定的密钥材料数据。 |
**返回值:**
| 类型 | 说明 |
| --------------------- | ------------------------------- |
| Promise
\<
[
SymKey
](
#symkey
)
> | 使用Promise的方式获取对称密钥。 |
| 类型 | 说明 |
| --------------------------- | --------------------------------- |
| Promise
\<
[
SymKey
](
#symkey
)
> | Promise对象,返回对称密钥SymKey。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | --------------------------------------------- |
| 17620001 | memory error. |
**示例:**
...
...
@@ -1269,8 +1435,11 @@ function genKeyMaterialBlob() {
let
symAlgoName
=
'
3DES192
'
;
let
symKeyGenerator
=
cryptoFramework
.
createSymKeyGenerator
(
symAlgoName
);
let
keyMaterialBlob
=
genKeyMaterialBlob
();
symKeyGenerator
.
convertKey
(
keyMaterial
).
then
((
symKey
)
=>
{
console
.
log
(
'
Convert symKey success, algName:
'
+
symKey
.
algName
);
symKeyGenerator
.
convertKey
(
keyMaterialBlob
)
.
then
(
symKey
=>
{
console
.
info
(
`Convert symKey success, algName:
${
symKey
.
algName
}
`
);
},
error
=>
{
console
.
error
(
`Convert symKey failed,
${
error
.
code
}
,
${
error
.
message
}
`
);
})
```
...
...
@@ -1289,8 +1458,8 @@ createAsyKeyGenerator(algName : string) : AsyKeyGenerator
**返回值:**
| 类型 | 说明 |
| --------------- | -------------------------- |
| 类型 | 说明
|
| --------------- | --------------------------
--
|
| asyKeyGenerator | 返回非对称密钥生成器的对象。 |
**示例:**
...
...
@@ -1309,23 +1478,22 @@ let asyKeyGenerator = cryptoFramework.createAsyKeyGenerator("ECC256");
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读 | 可写 | 描述 |
| -------------- | -------------- | ---- | ---- | ----------------------------------|
| algName | string | 是 | 否 | 非对称密钥生成器指定的算法名称。 |
| 名称 | 类型 | 可读 | 可写 | 描述 |
| ------- | ------ | ---- | ---- | -------------------------------- |
| algName | string | 是 | 否 | 非对称密钥生成器指定的算法名称。 |
### generateKeyPair
generateKeyPair(callback : AsyncCallback
\<
KeyPair>) : void;
异步获取非对称密钥生成器随机生成的密钥,通过注册回调函数获取结果。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型
| 必填 | 说明
|
| -------- | -----------------------
--- | ---- |
---------------------------- |
| 名称 | 类型
| 必填 | 说明
|
| -------- | -----------------------
| ---- | --
---------------------------- |
| callback | AsyncCallback
\<
KeyPair> | 是 | 回调函数,用于获取非对称密钥。 |
**示例:**
...
...
@@ -1347,14 +1515,15 @@ asyKeyGenerator.generateKeyPair((err, keyPair) => {
### generateKeyPair
generateKeyPair() : Promise
\<
KeyPair>
异步获取该非对称密钥生成器随机生成的密钥,通过Promise获取结果。
**系统能力:**
SystemCapability.Security.CryptoFramework
**返回值:**
| 类型
| 说明
|
| -----------------
---- |
------------------------------- |
| 类型
| 说明
|
| -----------------
| --
------------------------------- |
| Promise
\<
KeyPair> | 使用Promise的方式获取非对称密钥。 |
**示例:**
...
...
@@ -1374,16 +1543,17 @@ keyGenPromise.then( keyPair => {
### convertKey
convertKey(pubKey : DataBlob, priKey : DataBlob, callback : AsyncCallback
\<
KeyPair
\>
) : void
异步获取指定数据生成非对称密钥,通过注册回调函数获取结果。详情请看下方
**密钥转换说明**
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型
| 必填 | 说明
|
| -------- | -----------------------
--- | ---- |
---------------------------- |
| pubKey
| DataBlob | 否 | 指定的公钥材料。
|
| priKey
| DataBlob | 否 | 指定的私钥材料。
|
| 名称 | 类型
| 必填 | 说明
|
| -------- | -----------------------
| ---- | --
---------------------------- |
| pubKey
| DataBlob | 否 | 指定的公钥材料。
|
| priKey
| DataBlob | 否 | 指定的私钥材料。
|
| callback | AsyncCallback
\<
KeyPair> | 是 | 回调函数,用于获取非对称密钥。 |
**示例:**
...
...
@@ -1404,21 +1574,22 @@ asyKeyGenerator.convertKey(pubKey, priKey, (err, keyPair) => {
### convertKey
convertKey(pubKey : DataBlob, priKey : DataBlob) : Promise
\<
KeyPair>
异步获取指定数据生成非对称密钥,通过Promise获取结果。详情请看下方
**密钥转换说明**
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称
| 类型 | 必填 | 说明
|
| ----
| -------- | ---- | ----
---------------- |
| pubKey
| DataBlob | 否 | 指定的公钥材料。
|
| priKey
| DataBlob | 否 | 指定的私钥材料。
|
| 名称
| 类型 | 必填 | 说明
|
| ----
-- | -------- | ---- |
---------------- |
| pubKey
| DataBlob | 否 | 指定的公钥材料。
|
| priKey
| DataBlob | 否 | 指定的私钥材料。
|
**返回值:**
| 类型
| 说明
|
| -----------------
---- |
------------------------------- |
| 类型
| 说明
|
| -----------------
| --
------------------------------- |
| Promise
\<
KeyPair> | 使用Promise的方式获取非对称密钥。 |
**示例:**
...
...
@@ -1444,20 +1615,25 @@ keyGenPromise.then( keyPair => {
## cryptoFramework.createCipher
createCipher(transformation : string) : Cipher
通过指定算法名称,获取相应的
[
Cipher
](
#cipher
)
实例。支持的算法名参数详见框架概述“
[
加解密规格
](
../../security/cryptoFramework-overview.md#加解密规格
)
”一节中的“指定算法名称字符串”。
通过指定算法名称,获取相应的
[
Cipher
](
#cipher
)
实例。
<br/>
支持的规格详见框架概述“
[
加解密规格
](
../../security/cryptoFramework-overview.md#加解密规格
)
”一节。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ------ | -------- | ------------------------------------------------------------ |
| transformation | string | 是 | 待生成Cipher的算法名称、加密模式以及填充方法的组合。输入可以为"RSA1024
\|
PKCS1", "RSA1024
\|
PKCS1_OAEP
\|
SHA256
\|
SHA256"等 |
| 参数名 | 类型 | 必填 | 说明 |
| -------------- | ------ | ---- | ------------------------------------------------------------ |
| transformation | string | 是 | 待生成Cipher的算法名称(含密钥长度)、加密模式以及填充方法的组合。
<br/>
具体取值详见框架概述“
[
加解密规格
](
../../security/cryptoFramework-overview.md#加解密规格
)
”一节中的“字符串参数”。 |
> **说明:**
> 1. 目前对称加解密中,PKCS5和PKCS7的实现相同,其padding长度和分组长度保持一致(即PKCS5和PKCS7在3DES中均按照8字节填充,在AES中均按照16字节填充),另有NoPadding表示不填充。<br/>开发者需要自行了解密码学不同分组模式的差异,以便选择合适的参数规格。例如选择ECB和CBC模式时,建议启用填充,否则必须确保明文长度是分组大小的整数倍;选择其他模式时,可以不启用填充,此时密文长度和明文长度一致(即可能不是分组大小的整数倍)。
> 2. 使用RSA进行非对称加解密时,必须创建两个Cipher对象分别进行加密和解密操作,而不能对同一个Cipher对象进行加解密。对称加解密没有此要求(即只要算法规格一样,可以对同一个Cipher对象进行加解密操作)。
**返回值:**
| 类型 | 说明 |
| ------ | ------------------------ |
| 类型
| 说明 |
| ------
-----------
| ------------------------ |
|
[
Cipher
](
#cipher
)
| 返回加解密生成器的对象。 |
**示例:**
...
...
@@ -1472,39 +1648,51 @@ try {
console
.
info
(
`cipher algName:
${
cipher
.
algName
}
`
);
}
catch
(
error
)
{
console
.
error
(
`createCipher failed,
${
error
.
code
}
,
${
error
.
message
}
`
);
return
;
}
```
## Cipher
提供加解密的算法操作功能,按序调用本类中的
[
init()
](
#init-2
)
、
[
update()
](
#update-4
)
、
[
doFinal()
](
#dofinal-2
)
方法,可以实现对称加密/对称解密/非对称加密/非对称解密。完整的加解密流程示例可参考开发指导中的“
[
使用加解密操作
](
../../security/cryptoFramework-guidelines.md#使用加解密操作
)
”一节。
提供加解密的算法操作功能,按序调用本类中的
[
init()
](
#init-2
)
、
[
update()
](
#update-4
)
、
[
doFinal()
](
#dofinal-2
)
方法,可以实现对称加密/对称解密/非对称加密/非对称解密。
<br/>
完整的加解密流程示例可参考开发指导中的“
[
使用加解密操作
](
../../security/cryptoFramework-guidelines.md#使用加解密操作
)
”一节。
一次完整的加/解密流程在对称加密和非对称加密中略有不同:
-
对称加解密:init为必选,update为可选(且允许多次update加/解密大数据),doFinal为必选;doFinal结束后可以重新init开始新一轮加/解密流程。
-
RSA非对称加解密:init为必选,不支持update操作,doFinal为必选(允许连续多次doFinal加/解密大数据);doFinal后不支持重新init。
### 属性
**系统能力:**
SystemCapability.Security.CryptoFramework
| 名称 | 类型 | 可读
| 可写
| 描述 |
| ------- | ------ | ----
---- | -------
---- | ---------------------------- |
| 名称 | 类型 | 可读
| 可写
| 描述 |
| ------- | ------ | ----
|
---- | ---------------------------- |
| algName | string | 是 | 否 | 加解密生成器指定的算法名称。 |
### init
init(opMode : CryptoMode, key : Key, params : ParamsSpec, callback : AsyncCallback
\<
void>) : void
初始化加解密的
[
cipher
](
#cipher
)
对象,通过注册回调函数获取结果。
初始化加解密的
[
cipher
](
#cipher
)
对象,通过注册回调函数获取结果。
<br/>
必须在使用
[
createCipher
](
#cryptoframeworkcreatecipher
)
创建
[
Cipher
](
#cipher
)
实例后,才能使用本函数。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| -------- | ------------------------ | ------- | ------------------------ |
| opMode |
[
CryptoMode
](
#cryptomode
)
| 是 | 加密或者解密模式。 |
| key |
[
Key
](
#key
)
| 是 | 指定加密或解密的密钥。 |
| params |
[
ParamsSpec
](
#paramsspec
)
| 是 | 指定加密或解密的参数。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数。 |
| 名称 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------------------------------------------------------ |
| opMode |
[
CryptoMode
](
#cryptomode
)
| 是 | 加密或者解密模式。 |
| key |
[
Key
](
#key
)
| 是 | 指定加密或解密的密钥。 |
| params |
[
ParamsSpec
](
#paramsspec
)
| 是 | 指定加密或解密的参数,对于ECB等没有参数的算法模式,可以传入null。 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数。当初始化成功,err为undefined,否则为错误对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | --------------------------------------------------------- |
| 17620001 | memory error. |
| 17620002 | runtime error. |
| 17630001 | crypto operation error.|
**示例:**
...
...
@@ -1512,13 +1700,14 @@ init(opMode : CryptoMode, key : Key, params : ParamsSpec, callback : AsyncCallba
import
cryptoFramework
from
'
@ohos.security.cryptoFramework
'
;
let
symKey
;
// 此处省略生成对称密钥的过程
let
cipher
;
// 此处省略生成cipher实例的过程
cipher
.
init
(
cryptoFramework
.
CryptoMode
.
ENCRYPT_MODE
,
symKey
,
null
,
(
err
,
)
=>
{
if
(
err
)
{
console
.
error
(
'
Failed to init cipher
'
);
return
;
console
.
error
(
`Failed to init cipher,
${
err
.
code
}
,
${
err
.
message
}
`
);
}
else
{
console
.
info
(
`Init cipher success`
);
// 此处进行update等后续操作
}
console
.
log
(
'
Init cipher success
'
);
// 此处进行update等后续操作
})
```
...
...
@@ -1526,23 +1715,31 @@ cipher.init(cryptoFramework.CryptoMode.ENCRYPT_MODE, symKey, null, (err, ) => {
init(opMode : CryptoMode, key : Key, params : ParamsSpec) : Promise
\<
void>
初始化加解密的cipher对象,通过Promise获取结果。
初始化加解密的cipher对象,通过Promise获取结果。
<br/>
必须在使用
[
createCipher
](
#cryptoframeworkcreatecipher
)
创建
[
Cipher
](
#cipher
)
实例后,才能使用本函数。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型
| 必填 | 说明
|
| ------ | ----------
| ---- |
---------------------- |
| opMode |
[
CryptoMode
](
#cryptomode
)
| 是 | 加密或者解密模式。
|
| key |
[
Key
](
#key
)
| 是 | 指定加密或解密的密钥。
|
| 名称 | 类型
| 必填 | 说明
|
| ------ | ----------
--------------- | ---- | --------------------------------------
---------------------- |
| opMode |
[
CryptoMode
](
#cryptomode
)
| 是 | 加密或者解密模式。
|
| key |
[
Key
](
#key
)
| 是 | 指定加密或解密的密钥。
|
| params |
[
ParamsSpec
](
#paramsspec
)
| 是 | 指定加密或解密的参数,对于ECB等没有参数的算法模式,可以传入null。 |
**返回值:**
| 类型 | 说明 |
| ------------------- | --------------------------- |
| Promise
\<
void> | 使用Promise的方式获取结果。 |
| 类型 | 说明 |
| -------------- | -------------------------------------- |
| Promise
\<
void> | Promise对象。无返回结果的Promise对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------------- |
| 17620001 | memory error. |
| 17620002 | runtime error. |
| 17630001 | crypto operation error.|
**示例:**
...
...
@@ -1550,9 +1747,12 @@ init(opMode : CryptoMode, key : Key, params : ParamsSpec) : Promise\<void>
import
cryptoFramework
from
'
@ohos.security.cryptoFramework
'
;
let
symKey
;
// 此处省略生成对称密钥的过程
let
cipher
;
// 此处省略生成cipher实例的过程
cipher
.
init
(
cryptoFramework
.
CryptoMode
.
ENCRYPT_MODE
,
symKey
,
null
).
then
(()
=>
{
console
.
log
(
'
Init cipher success
'
);
cipher
.
init
(
cryptoFramework
.
CryptoMode
.
ENCRYPT_MODE
,
symKey
,
null
)
.
then
(()
=>
{
console
.
info
(
`Init cipher success`
);
// 此处进行update等后续操作
},
error
=>
{
console
.
error
(
`Failed to init cipher,
${
error
.
code
}
,
${
error
.
message
}
`
);
})
```
...
...
@@ -1560,16 +1760,29 @@ cipher.init(cryptoFramework.CryptoMode.ENCRYPT_MODE, symKey, null).then(() => {
update(data : DataBlob, callback : AsyncCallback
\<
DataBlob>) : void
分段更新加密或者解密数据操作,通过注册回调函数获取加密或者解密数据。(根据数据量,可不调用update或调用多次update)
分段更新加密或者解密数据操作,通过注册回调函数获取加/解密数据。
<br/>
必须在对
[
Cipher
](
#cipher
)
实例使用
[
init()
](
init-2
)
初始化后,才能使用本函数。
> **说明:**
> 1. 在进行对称加解密操作的时候,如果开发者对各个分组模式不够熟悉,建议对每次update和doFinal的结果都判断是否为null,并在结果不为null时取出其中的数据进行拼接,形成完整的密文/明文。这是因为选择的分组模式等各项规格都可能对update和[doFinal](#dofinal-2)结果产生影响。<br/>(例如对于ECB和CBC模式,不论update传入的数据是否为分组长度的整数倍,都会以分组作为基本单位进行加/解密,并输出本次update新产生的加/解密分组结果。<br/>可以理解为,update只要凑满一个新的分组就会有输出,如果没有凑满则此次update输出为null,把当前还没被加/解密的数据留着,等下一次update/doFinal传入数据的时候,拼接起来继续凑分组。<br/>最后doFinal的时候,会把剩下的还没加/解密的数据,根据[createCipher](#cryptoframeworkcreatecipher)时设置的padding模式进行填充,补齐到分组的整数倍长度,再输出剩余加解密结果。<br/>而对于可以将分组密码转化为流模式实现的模式,还可能出现密文长度和明文长度相同的情况等。)
> 2. 根据数据量,可以不调用update(即[init](#init-2)完成后直接调用[doFinal](#dofinal-2))或多次调用update。<br/>算法库目前没有对update(单次或累计)的数据量设置大小限制,建议对于大数据量的对称加解密,采用多次update的方式传入数据。
> 3. RSA非对称加解密不支持update操作。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| -------- | ---------------------------- | ---- | ------------------------------------------ |
| data |
[
DataBlob
](
#datablob
)
| 是 | 加密或者解密的数据。 |
| callback | AsyncCallback
\<
[
DataBlob
](
#datablob
)
> | 是 | 回调函数,用于获取加密或者解密的数据结果。 |
| 名称 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------- | ---- | ------------------------------------------------------------ |
| data |
[
DataBlob
](
#datablob
)
| 是 | 加密或者解密的数据。data不能为null,也不允许传入{data : Uint8Array(空) } |
| callback | AsyncCallback
\<
[
DataBlob
](
#datablob
)
> | 是 | 回调函数。当更新加/解密数据成功,err为undefined,data为此次更新的加/解密结果DataBlob;否则为错误对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ------------------------------------------- |
| 17620001 | memory error. |
| 17620002 | runtime error. |
| 17630001 | crypto operation error. |
**示例:**
...
...
@@ -1589,11 +1802,14 @@ let cipher; // 此处省略生成cipher实例的过程
let
plainText
=
{
data
:
stringToUint8Array
(
'
this is test!
'
)};
cipher
.
update
(
plainText
,
(
err
,
output
)
=>
{
// 加密过程举例
if
(
err
)
{
console
.
error
(
'
Failed to update cipher
'
);
return
;
console
.
error
(
`Failed to update cipher`
);
}
else
{
console
.
info
(
`Update cipher success`
);
if
(
output
!=
null
)
{
// 拼接output.data到密文
}
// 此处进行doFinal等后续操作
}
console
.
log
(
'
Update cipher success
'
);
// 此处进行doFinal等后续操作
})
```
...
...
@@ -1601,21 +1817,34 @@ cipher.update(plainText, (err, output) => { // 加密过程举例
update(data : DataBlob) : Promise
\<
DataBlob>
分段更新加密或者解密数据操作,通过Promise获取结果。(根据数据量,可不调用update或调用多次update)
分段更新加密或者解密数据操作,通过通过Promise获取加/解密数据。
<br/>
必须在对
[
Cipher
](
#cipher
)
实例使用
[
init()
](
init-2
)
初始化后,才能使用本函数。
> **说明:**
> 1. 在进行对称加解密操作的时候,如果开发者对各个分组模式不够熟悉,建议对每次update和doFinal的结果都判断是否为null,并在结果不为null时取出其中的数据进行拼接,形成完整的密文/明文。这是因为选择的分组模式等各项规格都可能对update和[doFinal](#dofinal-2)结果产生影响。<br/>(例如对于ECB和CBC模式,不论update传入的数据是否为分组长度的整数倍,都会以分组作为基本单位进行加/解密,并输出本次update新产生的加/解密分组结果。<br/>可以理解为,update只要凑满一个新的分组就会有输出,如果没有凑满则此次update输出为null,把当前还没被加/解密的数据留着,等下一次update/doFinal传入数据的时候,拼接起来继续凑分组。<br/>最后doFinal的时候,会把剩下的还没加/解密的数据,根据[createCipher](#cryptoframeworkcreatecipher)时设置的padding模式进行填充,补齐到分组的整数倍长度,再输出剩余加解密结果。<br/>而对于可以将分组密码转化为流模式实现的模式,还可能出现密文长度和明文长度相同的情况等。)
> 2. 根据数据量,可以不调用update(即[init](#init-2)完成后直接调用[doFinal](#dofinal-2))或多次调用update。<br/>算法库目前没有对update(单次或累计)的数据量设置大小限制,建议对于大数据量的对称加解密,可以采用多次update的方式传入数据。
> 3. RSA非对称加解密不支持update操作。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| ---- | -------- | ---- | -------------------- |
| data |
[
DataBlob
](
#datablob
)
| 是 | 加密或者解密的数据。
|
| 名称 | 类型
| 必填 | 说明 |
| ---- | --------
-------------
| ---- | -------------------- |
| data |
[
DataBlob
](
#datablob
)
| 是 | 加密或者解密的数据。data不能为null,也不允许传入{data : Uint8Array(空) }
|
**返回值:**
| 类型 | 说明 |
| ----------------------- | --------------------------- |
| Promise
\<
[
DataBlob
](
#datablob
)
> | 使用Promise的方式获取结果。 |
| 类型 | 说明 |
| ------------------------------- | ------------------------------------------------ |
| Promise
\<
[
DataBlob
](
#datablob
)
> | Promise对象,返回此次更新的加/解密结果DataBlob。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 17620001 | memory error. |
| 17620002 | runtime error. |
| 17630001 | crypto operation error. |
**示例:**
...
...
@@ -1633,9 +1862,15 @@ function stringToUint8Array(str) {
let
cipher
;
// 此处省略生成cipher实例的过程
// 此处省略init()过程
let
plainText
=
{
data
:
stringToUint8Array
(
'
this is test!
'
)};
cipher
.
update
(
data
).
then
((
output
)
=>
{
console
.
log
(
'
Update cipher success
'
);
cipher
.
update
(
plainText
)
.
then
((
output
)
=>
{
console
.
info
(
`Update cipher success.`
);
if
(
output
!=
null
)
{
// 拼接output.data到密文
}
// 此处进行doFinal等后续操作
},
error
=>
{
console
.
info
(
`Update cipher failed.`
);
})
```
...
...
@@ -1643,16 +1878,33 @@ cipher.update(data).then((output) => {
doFinal(data : DataBlob, callback : AsyncCallback
\<
DataBlob>) : void
最后结束加密或者解密数据操作,通过注册回调函数获取加密或者解密数据。如果在本次加解密过程中已经使用
[
update
](
#update-4
)
传入过数据,可以在doFinal的data参数处传入null。
<br/>
根据对称加解密的模式不同,doFinal的输出可能不同:
<br/>
对于GCM和CCM模式的对称加密,doFinal的结果是剩余密文和authTag的拼接,即末尾的16字节(GCM模式)或12字节(CCM模式)是authTag(因此如果doFinal的data参数传入null,则doFinal的结果就是authTag)。在doFinal完成后需要将authTag暂存,填入解密时的
[
GcmParamsSpec
](
#gcmparamsspec
)
或
[
CcmParamsSpec
](
#ccmparamsspec
)
。
<br/>
对于其他模式的对称加解密,根据不同的模式特点,存在两种情况(1)update输出一部分加解密结果,doFinal输出剩余加解密结果;(2)加解密结果全部由update输出,doFinal输出空。
(1)在对称加解密中,doFinal加/解密(分组模式产生的)剩余数据和本次传入的数据,最后结束加密或者解密数据操作,通过注册回调函数获取加密或者解密数据。
<br/>
如果数据量较小,可以在doFinal中一次性传入数据,而不使用update;如果在本次加解密流程中,已经使用
[
update
](
#update-4
)
传入过数据,可以在doFinal的data参数处传入null。
<br/>
根据对称加解密的模式不同,doFinal的输出有如下区别:
-
对于GCM和CCM模式的对称加密:一次加密流程中,如果将每一次update和doFinal的结果拼接起来,会得到“密文+authTag”,即末尾的16字节(GCM模式)或12字节(CCM模式)是authTag,而其余部分均为密文。(也就是说,如果doFinal的data参数传入null,则doFinal的结果就是authTag)
<br/>
authTag需要填入解密时的
[
GcmParamsSpec
](
#gcmparamsspec
)
或
[
CcmParamsSpec
](
#ccmparamsspec
)
;密文则作为解密时的入参data。
-
对于其他模式的对称加解密、GCM和CCM模式的对称解密:一次加/解密流程中,每一次update和doFinal的结果拼接起来,得到完整的明文/密文。
(2)在RSA非对称加解密中,doFinal加/解密本次传入的数据,通过注册回调函数获取加密或者解密数据。如果数据量较大,可以多次调用doFinal,拼接结果得到完整的明文/密文。
> **说明:**
> 1. 对称加解密中,调用doFinal标志着一次加解密流程已经完成,即[Cipher](#cipher)实例的状态被清除,因此当后续开启新一轮加解密流程时,需要重新调用[init()](init-2)并传入完整的参数列表进行初始化<br/>(比如即使是对同一个Cipher实例,采用同样的对称密钥,进行加密然后解密,则解密中调用init的时候仍需填写params参数,而不能直接省略为null)。
> 2. 如果遇到解密失败,需检查加解密数据和[init](#init-2)时的参数是否匹配,包括GCM模式下加密得到的authTag是否填入解密时的GcmParamsSpec等。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| -------- | ---------------------------- | ---- | ------------------------------------------ |
| data |
[
DataBlob
](
#datablob
)
| 是 | 加密或者解密的数据。 |
| callback | AsyncCallback
\<
[
DataBlob
](
#datablob
)
> | 是 | 回调函数,用于获取加密或者解密的数据结果。 |
| 名称 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------- | ---- | ------------------------------------------------------------ |
| data |
[
DataBlob
](
#datablob
)
| 是 | 加密或者解密的数据。在对称加解密中允许为null,但不允许传入{data : Uint8Array(空) }。 |
| callback | AsyncCallback
\<
[
DataBlob
](
#datablob
)
> | 是 | 回调函数。当最终加/解密数据成功,err为undefined,data为剩余数据的加/解密结果DataBlob;否则为错误对象。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | ----------------------- |
| 17620001 | memory error. |
| 17620002 | runtime error. |
| 17630001 | crypto operation error. |
**示例:**
...
...
@@ -1664,10 +1916,13 @@ let data; // 此处省略准备待加密/解密数据的过程
// 此处省略init()和update()过程
cipher
.
doFinal
(
data
,
(
err
,
output
)
=>
{
if
(
err
)
{
console
.
error
(
'
Failed to final cipher
'
);
return
;
console
.
error
(
`Failed to finalize cipher,
${
err
.
code
}
,
${
err
.
message
}
`
);
}
else
{
console
.
info
(
`Finalize cipher success`
);
if
(
output
!=
null
)
{
// 拼接output.data得到完整的明文/密文(及authTag)
}
}
console
.
log
(
'
Final cipher success
'
);
})
```
...
...
@@ -1675,21 +1930,38 @@ cipher.doFinal(data, (err, output) => {
doFinal(data : DataBlob) : Promise
\<
DataBlob>
最后结束加密或者解密数据操作,通过Promise获取结果。如果在本次加解密过程中已经使用
[
update
](
#update-4
)
传入过数据,可以在doFinal的data参数处传入null。
<br/>
根据对称加解密的模式不同,doFinal的输出可能不同:
<br/>
对于GCM和CCM模式的对称加密,doFinal的结果是剩余密文和authTag的拼接,即末尾的16字节(GCM模式)或12字节(CCM模式)是authTag(因此如果doFinal的data参数传入null,则doFinal的结果就是authTag)。在doFinal完成后需要将authTag暂存,填入解密时的
[
GcmParamsSpec
](
#gcmparamsspec
)
或
[
CcmParamsSpec
](
#ccmparamsspec
)
。
<br/>
对于其他模式的对称加解密,根据不同的模式特点,存在两种情况(1)update输出一部分加解密结果,doFinal输出剩余加解密结果;(2)加解密结果全部由update输出,doFinal输出空。
(1)在对称加解密中,doFinal加/解密(分组模式产生的)剩余数据和本次传入的数据,最后结束加密或者解密数据操作,通过Promise获取加密或者解密数据。
<br/>
如果数据量较小,可以在doFinal中一次性传入数据,而不使用update;如果在本次加解密流程中,已经使用
[
update
](
#update-4
)
传入过数据,可以在doFinal的data参数处传入null。
<br/>
根据对称加解密的模式不同,doFinal的输出有如下区别:
-
对于GCM和CCM模式的对称加密:一次加密流程中,如果将每一次update和doFinal的结果拼接起来,会得到“密文+authTag”,即末尾的16字节(GCM模式)或12字节(CCM模式)是authTag,而其余部分均为密文。(也就是说,如果doFinal的data参数传入null,则doFinal的结果就是authTag)
<br/>
authTag需要填入解密时的
[
GcmParamsSpec
](
#gcmparamsspec
)
或
[
CcmParamsSpec
](
#ccmparamsspec
)
;密文则作为解密时的入参data。
-
对于其他模式的对称加解密、GCM和CCM模式的对称解密:一次加/解密流程中,每一次update和doFinal的结果拼接起来,得到完整的明文/密文。
(2)在RSA非对称加解密中,doFinal加/解密本次传入的数据,通过Promise获取加密或者解密数据。如果数据量较大,可以多次调用doFinal,拼接结果得到完整的明文/密文。
> **说明:**
> 1. 对称加解密中,调用doFinal标志着一次加解密流程已经完成,即[Cipher](#cipher)实例的状态被清除,因此当后续开启新一轮加解密流程时,需要重新调用[init()](init-2)并传入完整的参数列表进行初始化<br/>(比如即使是对同一个Cipher实例,采用同样的对称密钥,进行加密然后解密,则解密中调用init的时候仍需填写params参数,而不能直接省略为null)。
> 2. 如果遇到解密失败,需检查加解密数据和[init](#init-2)时的参数是否匹配,包括GCM模式下加密得到的authTag是否填入解密时的GcmParamsSpec等。
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| ---- | -------- | ---- | -------------------- |
| data |
[
DataBlob
](
#datablob
)
| 是 | 加密或者解密的数据。 |
| 名称 | 类型
| 必填 | 说明 |
| ---- | --------
-------------
| ---- | -------------------- |
| data |
[
DataBlob
](
#datablob
)
| 是 | 加密或者解密的数据。
data参数允许为null,但不允许传入{data : Uint8Array(空) }
|
**返回值:**
| 类型 | 说明 |
| ----------------------- | --------------------------- |
| Promise
\<
[
DataBlob
](
#datablob
)
> | 使用Promise的方式获取结果。 |
| 类型 | 说明 |
| ------------------------------- | ------------------------------------------------ |
| Promise
\<
[
DataBlob
](
#datablob
)
> | Promise对象,返回剩余数据的加/解密结果DataBlob。 |
**错误码:**
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 17620001 | memory error. |
| 17620002 | runtime error. |
| 17630001 | crypto operation error. |
**示例:**
...
...
@@ -1699,12 +1971,18 @@ import cryptoFramework from '@ohos.security.cryptoFramework';
let
cipher
;
// 此处省略生成cipher实例的过程
let
data
;
// 此处省略准备待加密/解密数据的过程
// 此处省略init()和update()过程
cipher
.
doFinal
(
data
).
then
((
output
)
=>
{
console
.
log
(
'
Final cipher success
'
);
cipher
.
doFinal
(
data
)
.
then
(
output
=>
{
console
.
info
(
`Finalize cipher success`
);
if
(
output
!=
null
)
{
// 拼接output.data得到完整的明文/密文(及authTag)
}
},
error
=>
{
console
.
error
(
`Failed to finalize cipher,
${
error
.
code
}
,
${
error
.
message
}
`
);
})
```
**
callback
示例:**
**
使用RSA加密的callback完整
示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -1722,7 +2000,7 @@ rsaGenerator.generateKeyPair(function (err, keyPair) {
});
```
**
promise
示例:**
**
使用RSA加密的promise完整
示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -1741,6 +2019,8 @@ keyGenPromise.then(rsaKeyPair => {
});
```
> **说明:**
> 更多加解密流程的完整示例可参考开发指导中的“[使用加解密操作](../../security/cryptoFramework-guidelines.md#使用加解密操作)”一节。
## cryptoFramework.createSign
...
...
@@ -1758,9 +2038,9 @@ Sign实例生成
**返回值**
:
| 类型 | 说明 |
| ---- | ------------------------------ |
| Sign
| 返回由输入算法指定生成的Sign对象 |
| 类型 | 说明
|
| ---- | ------------------------------
--
|
| Sign | 返回由输入算法指定生成的Sign对象 |
**示例:**
...
...
@@ -1786,10 +2066,10 @@ init(priKey : PriKey, callback : AsyncCallback\<void>) : void
**参数:**
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
- | ---- | --
---------------- |
| priKey | Key
|是
| 用于Sign的初始化 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数的 |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
| ---- |
---------------- |
| priKey | Key
| 是
| 用于Sign的初始化 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数的
|
### init
...
...
@@ -1801,14 +2081,14 @@ init(opMode : CryptoMode, key : Key, params : ParamsSpec) : Promise\<void>
**参数:**
| 参数名
| 类型 | 必填 | 说明
|
| ------
-- | --------------------- | ---- | --
---------------- |
| priKey
| Key |是
| 用于Sign的初始化 |
| 参数名
| 类型 | 必填 | 说明
|
| ------
| ---- | ---- |
---------------- |
| priKey
| Key | 是
| 用于Sign的初始化 |
**返回值:**
| 类型 | 说明 |
| ------------- | ----------- |
| 类型
| 说明 |
| -------------
-
| ----------- |
| Promise
\<
void> | Promise对象 |
### update
...
...
@@ -1821,10 +2101,10 @@ update(data : DataBlob, callback : AsyncCallback\<void>) : void
**参数:**
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
- | ---- | --------
---------- |
| data
| DataBlob | 是 | 传入的消息
|
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
| ---- |
---------- |
| data
| DataBlob | 是 | 传入的消息
|
| callback | AsyncCallback
\<
void> | 是 | 回调函数
|
### update
...
...
@@ -1838,12 +2118,12 @@ update(data : DataBlob) : Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------- | ---- | ---------- |
| data | DataBlob | 是 | 传入的消息 |
| data
| DataBlob | 是 | 传入的消息 |
**返回值:**
| 类型 | 说明 |
| ------------- | ----------- |
| 类型
| 说明 |
| -------------
-
| ----------- |
| Promise
\<
void> | Promise对象 |
### sign
...
...
@@ -1856,10 +2136,10 @@ sign(data : DataBlob, callback : AsyncCallback\<DataBlob>) : void
**参数:**
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
- | ---- | --------
---------- |
| data
| DataBlob | 是 | 传入的消息
|
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
| ---- |
---------- |
| data
| DataBlob | 是 | 传入的消息
|
| callback | AsyncCallback
\<
void> | 是 | 回调函数
|
### sign
...
...
@@ -1873,15 +2153,16 @@ sign(data : DataBlob) : Promise\<DataBlob>
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------- | ---- | ---------- |
| data | DataBlob | 是 | 传入的消息 |
| data
| DataBlob | 是 | 传入的消息 |
**返回值:**
| 类型 | 说明 |
| ------------- | ----------- |
| 类型
| 说明 |
| -------------
-
| ----------- |
| Promise
\<
void> | Promise对象 |
**callback示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -1902,6 +2183,7 @@ rsaGenerator.generateKeyPair(function (err, keyPair) {
```
**promise示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -1938,9 +2220,9 @@ Verify实例生成
**返回值**
:
| 类型
| 说明
|
| ----
|
------------------------------ |
| Verify
| 返回由输入算法指定生成的Verify对象 |
| 类型
| 说明
|
| ----
-- | ----
------------------------------ |
| Verify | 返回由输入算法指定生成的Verify对象 |
**示例:**
...
...
@@ -1951,6 +2233,7 @@ let verifyer1 = cryptoFramework.createVerify("RSA1024|PKCS1|SHA256");
let
verifyer2
=
cryptoFramework
.
createVerify
(
"
RSA1024|PKCS1_OAEP|SHA256|MGF1_SHA256
"
)
```
## Verify
Verify类,使用Verify方法之前需要创建该类的实例进行操作,通过createVerify(algName : string) : Verify方法构造此实例。
...
...
@@ -1959,34 +2242,35 @@ Verify类,使用Verify方法之前需要创建该类的实例进行操作,
init(pubKey : PubKey, callback : AsyncCallback
\<
void>) : void
传入
私
钥初始化Verify对象,Callback形式
传入
公
钥初始化Verify对象,Callback形式
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
- | ---- |
------------------ |
| pubKey | Key
|是
| 公钥对象,用于Verify的初始化 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
| ---- | ----------
------------------ |
| pubKey | Key
| 是
| 公钥对象,用于Verify的初始化 |
| callback | AsyncCallback
\<
void> | 是 | 回调函数
|
### init
init(pubKey : PubKey) : Promise
\<
void>
传入
私
钥初始化Verify对象,Promise形式
传入
公
钥初始化Verify对象,Promise形式
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 参数名
| 类型 | 必填 | 说明
|
| ------
-- | --------------------- | ---- |
------------------ |
| pubKey
| Key |是|
公钥对象,用于Verify的初始化 |
| 参数名
| 类型 | 必填 | 说明
|
| ------
| ---- | ---- | ----------
------------------ |
| pubKey
| Key | 是 |
公钥对象,用于Verify的初始化 |
**返回值:**
| 类型
| 说明
|
| --------------
- | -
----------- |
| 类型
| 说明
|
| --------------
|
----------- |
| Promise
\<
void> | Promise对象 |
### update
...
...
@@ -1999,10 +2283,10 @@ update(data : DataBlob, callback : AsyncCallback\<void>) : void
**参数:**
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
- | ---- | --------
---------- |
| data
| DataBlob | 是 | 传入的消息
|
| callback | AsyncCallback
\<
void> | 是 | 回调函数 |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | --------------------
| ---- |
---------- |
| data
| DataBlob | 是 | 传入的消息
|
| callback | AsyncCallback
\<
void> | 是 | 回调函数
|
### update
...
...
@@ -2016,52 +2300,53 @@ update(data : DataBlob) : Promise\<void>;
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------- | ---- | ---------- |
| data | DataBlob | 是 | 传入的消息 |
| data
| DataBlob | 是 | 传入的消息 |
**返回值:**
| 类型 | 说明 |
| ------------- | ----------- |
| 类型
| 说明 |
| -------------
-
| ----------- |
| Promise
\<
void> | Promise对象 |
### verify
verify(data : DataBlob, signatureData : DataBlob, callback : AsyncCallback
\<
boolean>) : void
对数据进行
签名,返回签名
结果,callback方式
对数据进行
验签,返回验签
结果,callback方式
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 参数名
| 类型 | 必填 | 说明
|
| --------
| --------------------- | ---- | --------
---------- |
| data
| DataBlob | 是 | 传入的消息
|
| signatureData
| DataBlob | 是 | 签名数据
|
| callback
| AsyncCallback
\<
void> | 是 | 回调函数
|
| 参数名
| 类型 | 必填 | 说明
|
| --------
----- | -------------------- | ---- |
---------- |
| data
| DataBlob | 是 | 传入的消息
|
| signatureData
| DataBlob | 是 | 签名数据
|
| callback
| AsyncCallback
\<
void> | 是 | 回调函数
|
### verify
verify(data : DataBlob, signatureData : DataBlob) : Promise
\<
boolean>
对数据进行
签名,返回签名
结果,promise方式
对数据进行
验签,返回验签
结果,promise方式
**系统能力:**
SystemCapability.Security.CryptoFramework
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | -------- | ---- | ---------- |
| data | DataBlob | 是 | 传入的消息 |
| signatureData
| DataBlob| 是 | 签名数据
|
| 参数名
| 类型 | 必填 | 说明 |
| ------
-------
| -------- | ---- | ---------- |
| data
| DataBlob | 是 | 传入的消息 |
| signatureData
| DataBlob | 是 | 签名数据
|
**返回值:**
| 类型
| 说明
|
| ---------------
|
------------ |
| Promise
\<
boolean> | 异步返回值,代表验签是否通过|
| 类型
| 说明
|
| ---------------
-- | ----------------
------------ |
| Promise
\<
boolean> | 异步返回值,代表验签是否通过
|
**callback示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -2076,6 +2361,7 @@ verifyer.init(globalKeyPair.pubKey, function (err, data) {
```
**promise示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -2089,6 +2375,7 @@ verifyInitPromise.then(() => {
console
.
log
(
"
Verify result is
"
+
res
);
});
```
## cryptoFramework.createKeyAgreement
createKeyAgreement(algName : string) : KeyAgreement
...
...
@@ -2099,15 +2386,15 @@ KeyAgreement实例生成
**参数:**
| 参数名 | 类型 | 必填 | 说明
|
| ------- | ------ | ---- | -------------------------------
-----------------------------
|
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ------------------------------- |
| algName | string | 是 | 指定密钥协商算法:目前仅支持ECC |
**返回值**
:
| 类型
| 说明
|
| ----
|
------------------------------ |
| KeyAgreement
| 返回由输入算法指定生成的KeyAgreement对象 |
| 类型
| 说明
|
| ----
-------- | ----------
------------------------------ |
| KeyAgreement | 返回由输入算法指定生成的KeyAgreement对象 |
**示例:**
...
...
@@ -2132,13 +2419,14 @@ generateSecret(priKey : PriKey, pubKey : PubKey, callback : AsyncCallback\<DataB
**参数:**
| 参数名 | 类型
| 必填 | 说明
|
| -------- | ---------------------
| ---- |
------------------ |
| priKey | PriKey
|是
| 设置密钥协商的私钥输入 |
| pubKey | PubKey
|是
| 设置密钥协商的公钥输入 |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | ---------------------
--- | ---- | ----
------------------ |
| priKey | PriKey
| 是
| 设置密钥协商的私钥输入 |
| pubKey | PubKey
| 是
| 设置密钥协商的公钥输入 |
| callback | AsyncCallback
\<
DataBlob> | 是 | 异步接受共享秘密的回调 |
### generateSecret
generateSecret(priKey : PriKey, pubKey : PubKey) : Promise
\<
DataBlob>
基于传入的私钥与公钥进行密钥协商,返回共享秘密,Promise形式
...
...
@@ -2147,18 +2435,19 @@ generateSecret(priKey : PriKey, pubKey : PubKey) : Promise\<DataBlob>
**参数:**
| 参数名
| 类型 | 必填 | 说明
|
| ------
-- | --------------------- | ---- |
------------------ |
| priKey
| PriKey |是
| 设置密钥协商的私钥输入 |
| pubKey
| PubKey |是
| 设置密钥协商的公钥输入 |
| 参数名
| 类型 | 必填 | 说明
|
| ------
| ------ | ---- | ----
------------------ |
| priKey
| PriKey | 是
| 设置密钥协商的私钥输入 |
| pubKey
| PubKey | 是
| 设置密钥协商的公钥输入 |
**返回值:**
| 类型
| 说明
|
| ---------------
| ----
-------- |
| 类型
| 说明
|
| ---------------
--- |
-------- |
| Promise
\<
DataBlob> | 共享秘密 |
**callback示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -2173,6 +2462,7 @@ keyAgreement.generateSecret(globalKeyPair.priKey, globalKeyPair.pubKey, function
```
**promise示例:**
```
javascript
import
cryptoFramework
from
"
@ohos.security.cryptoFramework
"
...
...
@@ -2184,6 +2474,7 @@ keyAgreementPromise.then((secret) => {
console
.
error
(
"
keyAgreement error.
"
);
});
```
## cryptoFramework.createX509Cert
createX509Cert(inStream : EncodingBlob, callback : AsyncCallback
\<
X509Cert>) : void
...
...
@@ -2194,10 +2485,10 @@ createX509Cert(inStream : EncodingBlob, callback : AsyncCallback\<X509Cert>) : v
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
------------------ |
| inStream |
[
EncodingBlob
](
#encodingblob
)
| 是 | X509证书序列化数据
|
| callback | AsyncCallback
\<
X509Cert>
| 否 | 回调函数。表示X509证书对象
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
---------------- | ---- | --------
------------------ |
| inStream |
[
EncodingBlob
](
#encodingblob
)
| 是 | X509证书序列化数据
|
| callback | AsyncCallback
\<
X509Cert>
| 否 | 回调函数。表示X509证书对象
|
**示例**
:
...
...
@@ -2231,8 +2522,8 @@ createX509Cert(inStream : EncodingBlob) : Promise\<X509Cert>
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------ | ---- | ------------------ |
| 参数名 | 类型
| 必填 | 说明 |
| -------- | ------------
-----------------
| ---- | ------------------ |
| inStream |
[
EncodingBlob
](
#encodingblob
)
| 是 | X509证书序列化数据 |
**返回值**
:
...
...
@@ -2274,10 +2565,10 @@ verify(key : PubKey, callback : AsyncCallback\<void>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
------------------ |
| key |
[
PubKey
](
#pubkey
)
| 是 | 用于验签的公钥对象
|
| callback | AsyncCallback
\<
void>) | 否 | 回调函数。使用AsyncCallback的第一个error参数判断是否验签成功,error为null表示成功,不为null表示失败
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
-------- | ---- | ------------------------------------------
------------------ |
| key |
[
PubKey
](
#pubkey
)
| 是 | 用于验签的公钥对象
|
| callback | AsyncCallback
\<
void>) | 否 | 回调函数。使用AsyncCallback的第一个error参数判断是否验签成功,error为null表示成功,不为null表示失败 |
**示例**
:
...
...
@@ -2320,14 +2611,14 @@ verify(key : PubKey) : Promise\<void>
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------ |
| 参数名 | 类型
| 必填 | 说明 |
| ------ | ------
-----------
| ---- | ------------------ |
| key |
[
PubKey
](
#pubkey
)
| 是 | 用于验签的公钥对象 |
**返回值**
:
| 类型
| 说明
|
| ----
| -------------------------------------------------
----------- |
| 类型
| 说明
|
| ----
---------- |
----------- |
| Promise
\<
void> | Promise对象 |
**示例**
:
...
...
@@ -2366,8 +2657,8 @@ getEncoded(callback : AsyncCallback\<EncodingBlob>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------- |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
-------------------------------- | ---- | ------------------------
-------- |
| callback | AsyncCallback
\<
[
EncodingBlob
](
#encodingblob
)
> | 否 | 回调函数。表示X509证书序列化数据 |
...
...
@@ -2409,8 +2700,8 @@ getEncoded() : Promise\<EncodingBlob>
**返回值**
:
| 类型 | 说明 |
| ------------ | ---------------------- |
| 类型
| 说明 |
| ------------
---------------------------
| ---------------------- |
| Promise
\<
[
EncodingBlob
](
#encodingblob
)
> | 表示X509证书序列化数据 |
**示例**
:
...
...
@@ -2447,8 +2738,8 @@ getPublicKey(callback : AsyncCallback\<PubKey>) : void
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------- | ---- | -------- |
| 参数名 | 类型 | 必填 | 说明
|
| -------- | ------------- | ---- | --------
------------------
|
| callback | AsyncCallback | 否 | 回调函数,X509证书公钥对象 |
...
...
@@ -2528,9 +2819,9 @@ checkValidityWithDate(date: string, callback : AsyncCallback\<void>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------- |
| date | string
| 是 | 日期
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
------- | ---- | ----------------------------------------------------
-------- |
| date | string
| 是 | 日期
|
| callback | AsyncCallback
\<
void> | 否 | 回调函数。使用AsyncCallback的第一个error参数判断是否检查成功,error为null表示成功,不为null表示失败 |
...
...
@@ -2690,8 +2981,8 @@ getIssuerName() : DataBlob
**返回值**
:
| 类型 | 说明 |
| -------- | ---------------------- |
| 类型
| 说明 |
| --------
-------------
| ---------------------- |
|
[
DataBlob
](
#datablob
)
| 表示X509证书颁发者名称 |
**示例**
:
...
...
@@ -2726,8 +3017,8 @@ getSubjectName() : DataBlob
**返回值**
:
| 类型 | 说明 |
| -------- | -------------------- |
| 类型
| 说明 |
| --------
-------------
| -------------------- |
|
[
DataBlob
](
#datablob
)
| 表示X509证书主体名称 |
**示例**
:
...
...
@@ -2834,8 +3125,8 @@ getSignature() : DataBlob
**返回值**
:
| 类型 | 说明 |
| -------- | -------------------- |
| 类型
| 说明 |
| --------
-------------
| -------------------- |
|
[
DataBlob
](
#datablob
)
| 表示X509证书签名数据 |
**示例**
:
...
...
@@ -2942,8 +3233,8 @@ getSignatureAlgParams() : DataBlob
**返回值**
:
| 类型 | 说明 |
| -------- | ------------------------ |
| 类型
| 说明 |
| --------
-------------
| ------------------------ |
|
[
DataBlob
](
#datablob
)
| 表示X509证书签名算法参数 |
**示例**
:
...
...
@@ -2978,8 +3269,8 @@ getKeyUsage() : DataBlob
**返回值**
:
| 类型 | 说明 |
| -------- | -------------------- |
| 类型
| 说明 |
| --------
-------------
| -------------------- |
|
[
DataBlob
](
#datablob
)
| 表示X509证书秘钥用途 |
**示例**
:
...
...
@@ -3014,8 +3305,8 @@ getExtKeyUsage() : DataArray
**返回值**
:
| 类型 | 说明 |
| --------- | ------------------------ |
| 类型
| 说明 |
| ---------
--------------
| ------------------------ |
|
[
DataArray
](
#dataarray
)
| 表示X509证书扩展秘钥用途 |
**示例**
:
...
...
@@ -3086,8 +3377,8 @@ getSubjectAltNames() : DataArray
**返回值**
:
| 类型 | 说明 |
| --------- | ------------------------ |
| 类型
| 说明 |
| ---------
--------------
| ------------------------ |
|
[
DataArray
](
#dataarray
)
| 表示X509证书主体可选名称 |
**示例**
:
...
...
@@ -3122,8 +3413,8 @@ getIssuerAltNames() : DataArray
**返回值**
:
| 类型 | 说明 |
| --------- | -------------------------- |
| 类型
| 说明 |
| ---------
--------------
| -------------------------- |
|
[
DataArray
](
#dataarray
)
| 表示X509证书颁发者可选名称 |
**示例**
:
...
...
@@ -3158,10 +3449,10 @@ createX509Crl(inStream : EncodingBlob, callback : AsyncCallback\<X509Crl>) : voi
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------------------------- |
| inStream |
[
EncodingBlob
](
#encodingblob
)
| 是 | 表示证书吊销列表序列化数据
|
| callback | AsyncCallback
\<
X509Crl>
| 否 | 回调函数。表示证书吊销列表对象
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
---------------- | ---- | ----
-------------------------- |
| inStream |
[
EncodingBlob
](
#encodingblob
)
| 是 | 表示证书吊销列表序列化数据
|
| callback | AsyncCallback
\<
X509Crl>
| 否 | 回调函数。表示证书吊销列表对象
|
**示例**
:
...
...
@@ -3195,14 +3486,14 @@ createX509Crl(inStream : EncodingBlob) : Promise\<X509Crl>
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------ | ---- | -------------------------- |
| 参数名 | 类型
| 必填 | 说明 |
| -------- | ------------
-----------------
| ---- | -------------------------- |
| inStream |
[
EncodingBlob
](
#encodingblob
)
| 是 | 表示证书吊销列表序列化数据 |
**返回值**
:
| 类型 | 说明 |
| ------- | -------------------- |
| 类型
| 说明 |
| -------
----------
| -------------------- |
| Promise
\<
X509Crl> | 表示证书吊销列表对象 |
**示例**
:
...
...
@@ -3238,10 +3529,10 @@ isRevoked(cert : X509Cert, callback : AsyncCallback\<boolean>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------------------- |
| cert |
[
X509Cert
](
#x509cert
)
| 是 | 表示被检查的证书对象
|
| callback | AsyncCallback
\<
boolean> | 否 | 回调函数。表示证书吊销状态,true表示已吊销,false表示未吊销
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
---------- | ---- | ---------------------------------------
-------------------- |
| cert |
[
X509Cert
](
#x509cert
)
| 是 | 表示被检查的证书对象
|
| callback | AsyncCallback
\<
boolean> | 否 | 回调函数。表示证书吊销状态,true表示已吊销,false表示未吊销 |
**示例**
:
...
...
@@ -3290,8 +3581,8 @@ isRevoked(cert : X509Cert) : Promise\<boolean>
**返回值**
:
| 类型 | 说明 |
| ------- | ------------------------------------------------- |
| 类型
| 说明 |
| -------
----------
| ------------------------------------------------- |
| Promise
\<
boolean> | 表示证书吊销状态,true表示已吊销,false表示未吊销 |
**示例**
:
...
...
@@ -3366,9 +3657,9 @@ getEncoded(callback : AsyncCallback\<EncodingBlob>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------- |
| callback |
AsyncCallback
\<
EncodingBlob> | 否 | 回调函数,表示X509证书吊销列表的序列化数据 |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
--------------- | ---- | ----------------------------------
-------- |
| callback | AsyncCallback
\<
EncodingBlob> | 否 | 回调函数,表示X509证书吊销列表的序列化数据 |
**示例**
:
...
...
@@ -3409,8 +3700,8 @@ getEncoded() : Promise\<EncodingBlob>
**返回值**
:
| 类型 | 说明 |
| ------------ | -------------------------------- |
| 类型
| 说明 |
| ------------
----------
| -------------------------------- |
| Promise
\<
EncodingBlob> | 表示X509证书吊销列表的序列化数据 |
**示例**
:
...
...
@@ -3447,10 +3738,10 @@ verify(key : PubKey, callback : AsyncCallback\<void>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
---------------------- |
| key | PubKey
| 是 | 表示用于验签的公钥对象
|
| callback | AsyncCallback
\<
void> | 否 | 回调函数,使用AsyncCallback的第一个error参数判断是否验签成功,error为null表示成功,error不为null表示失败。
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
------- | ---- | --------------------------------------
---------------------- |
| key | PubKey
| 是 | 表示用于验签的公钥对象
|
| callback | AsyncCallback
\<
void> | 否 | 回调函数,使用AsyncCallback的第一个error参数判断是否验签成功,error为null表示成功,error不为null表示失败。 |
**示例**
:
...
...
@@ -3493,14 +3784,14 @@ verify(key : PubKey) : Promise\<void>
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------------- |
| 参数名 | 类型
| 必填 | 说明 |
| ------ | ------
-----------
| ---- | ---------------------- |
| key |
[
PubKey
](
#pubkey
)
| 是 | 表示用于验签的公钥对象 |
**返回值**
:
| 类型 | 说明 |
| ---- | ------------------------------------------------------------ |
| 类型
| 说明 |
| ----
----------
| ------------------------------------------------------------ |
| Promise
\<
void> | 使用AsyncCallback的第一个error参数判断是否验签成功,error为null表示成功,error不为null表示失败 |
**示例**
:
...
...
@@ -3575,8 +3866,8 @@ getIssuerName() : DataBlob
**返回值**
:
| 类型 | 说明 |
| -------- | ------------------------------ |
| 类型
| 说明 |
| --------
-------------
| ------------------------------ |
|
[
DataBlob
](
#datablob
)
| 表示X509证书吊销列表颁发者名称 |
**示例**
:
...
...
@@ -3683,10 +3974,10 @@ getRevokedCert(serialNumber : number, callback : AsyncCallback\<X509CrlEntry>) :
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| ------------ | -------------
| ---- |
-------------- |
| serialNumber | number
| 是 | 表示证书序列号
|
| callback | AsyncCallback
\<
X509CrlEntry> | 否 | 回调函数。表示被吊销X509证书对象
|
| 参数名 | 类型
| 必填 | 说明
|
| ------------ | -------------
--------------- | ---- | ------------------
-------------- |
| serialNumber | number
| 是 | 表示证书序列号
|
| callback | AsyncCallback
\<
X509CrlEntry> | 否 | 回调函数。表示被吊销X509证书对象 |
**示例**
:
...
...
@@ -3735,8 +4026,8 @@ getRevokedCert(serialNumber : number) : Promise\<X509CrlEntry>
**返回值**
:
| 类型 | 说明 |
| ------------ | ---------------------- |
| 类型
| 说明 |
| ------------
----------
| ---------------------- |
| Promise
\<
X509CrlEntry> | 表示被吊销X509证书对象 |
**示例**
:
...
...
@@ -3775,10 +4066,10 @@ getRevokedCertWithCert(cert : X509Cert, callback : AsyncCallback\<X509CrlEntry>)
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
------------ |
| cert | X509Cert
| 是 | 表示证书对象
|
| callback | AsyncCallback
\<
X509CrlEntry> | 否 | 回调函数,表示被吊销X509证书对象
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
--------------- | ---- | -------------------
------------ |
| cert | X509Cert
| 是 | 表示证书对象
|
| callback | AsyncCallback
\<
X509CrlEntry> | 否 | 回调函数,表示被吊销X509证书对象 |
**示例**
:
...
...
@@ -3827,8 +4118,8 @@ getRevokedCertWithCert(cert : X509Cert) : Promise\<X509CrlEntry>
**返回值**
:
| 类型 | 说明 |
| ------------ | ---------------------- |
| 类型
| 说明 |
| ------------
----------
| ---------------------- |
| Promise
\<
X509CrlEntry> | 表示被吊销X509证书对象 |
**示例**
:
...
...
@@ -3867,8 +4158,8 @@ getRevokedCerts(callback : AsyncCallback<Array\<X509CrlEntry>>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------- |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
---------------------- | ---- | ------------------------
-------- |
| callback | AsyncCallback
<Array
\<
X509CrlEntry
>
> | 否 | 回调函数。表示被吊销X509证书列表 |
...
...
@@ -3910,9 +4201,9 @@ getRevokedCerts() : Promise<Array\<X509CrlEntry>>
**返回值**
:
| 类型 | 说明 |
| ------------------- | ---------------------- |
|Promise
<Array
\<
X509CrlEntry
>
> | 表示被吊销X509证书列表 |
| 类型
| 说明 |
| -------------------
----------
| ---------------------- |
|
Promise
<Array
\<
X509CrlEntry
>
> | 表示被吊销X509证书列表 |
**示例**
:
...
...
@@ -3948,8 +4239,8 @@ getTbsInfo(callback : AsyncCallback\<DataBlob>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------- |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
------------------------ | ---- | -----------------------------------
-------- |
| callback | AsyncCallback
\<
[
DataBlob
](
#datablob
)
> | 否 | 回调函数。表示证书吊销列表的tbsCertList信息 |
...
...
@@ -3991,8 +4282,8 @@ getTbsInfo() : Promise\<DataBlob>
**返回值**
:
| 类型 | 说明 |
| -------- | --------------------------------- |
| 类型
| 说明 |
| --------
-----------------------
| --------------------------------- |
| Promise
\<
[
DataBlob
](
#datablob
)
> | 表示证书吊销列表的tbsCertList信息 |
**示例**
:
...
...
@@ -4029,8 +4320,8 @@ getSignature() : DataBlob
**返回值**
:
| 类型 | 说明 |
| -------- | ------------------------------ |
| 类型
| 说明 |
| --------
-------------
| ------------------------------ |
|
[
DataBlob
](
#datablob
)
| 表示X509证书吊销列表的签名数据 |
**示例**
:
...
...
@@ -4137,8 +4428,8 @@ getSignatureAlgParams() : DataBlob
**返回值**
:
| 类型 | 说明 |
| -------- | ---------------------------------- |
| 类型
| 说明 |
| --------
-------------
| ---------------------------------- |
|
[
DataBlob
](
#datablob
)
| 表示X509证书吊销列表签名的算法参数 |
**示例**
:
...
...
@@ -4206,10 +4497,10 @@ validate(certChain : CertChainData, callback : AsyncCallback\<void>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| --------- | -------------
| ---- |
------------------------ |
| certChain |
[
CertChainData
](
#certchaindata
)
| 是 | 表示X509证书链序列化数据 |
| callback | AsyncCallback
\<
void>
| 否 | 回调函数。使用AsyncCallback的第一个error参数判断是否校验成功,error为null表示成功,error不为null表示失败
|
| 参数名 | 类型
| 必填 | 说明
|
| --------- | -------------
------------------ | ---- | ------------------------------------
------------------------ |
| certChain |
[
CertChainData
](
#certchaindata
)
| 是 | 表示X509证书链序列化数据
|
| callback | AsyncCallback
\<
void>
| 否 | 回调函数。使用AsyncCallback的第一个error参数判断是否校验成功,error为null表示成功,error不为null表示失败
|
**示例**
:
...
...
@@ -4248,14 +4539,14 @@ validate(certChain : CertChainData) : Promise\<void>
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| --------- | -------------
| ---- |
------------------------ |
| 参数名 | 类型
| 必填 | 说明
|
| --------- | -------------
------------------ | ---- | --
------------------------ |
| certChain |
[
CertChainData
](
#certchaindata
)
| 是 | 表示X509证书链序列化数据。 |
**返回值**
:
| 类型
| 说明
|
| ----
| -------------------------------------------------
----------- |
| 类型
| 说明
|
| ----
---------- |
----------- |
| Promise
\<
void> | Promise对象 |
**示例**
:
...
...
@@ -4318,8 +4609,8 @@ getEncoded(callback : AsyncCallback\<EncodingBlob>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------- |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
-------------------------------- | ---- | ----------------------------
-------- |
| callback | AsyncCallback
\<
[
EncodingBlob
](
#encodingblob
)
> | 否 | 回调函数。表示被吊销证书的序列化数据 |
...
...
@@ -4349,8 +4640,8 @@ getEncoded() : Promise\<EncodingBlob>
**返回值**
:
| 类型 | 说明 |
| ------------ | -------------------------- |
| 类型
| 说明 |
| ------------
---------------------------
| -------------------------- |
| Promise
\<
[
EncodingBlob
](
#encodingblob
)
> | 表示被吊销证书的序列化数据 |
**示例**
:
...
...
@@ -4401,8 +4692,8 @@ getCertIssuer(callback : AsyncCallback\<DataBlob>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------- |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
------------------------ | ---- | ----------------------------
-------- |
| callback | AsyncCallback
\<
[
DataBlob
](
#datablob
)
> | 否 | 回调函数。表示被吊销证书的颁发者信息 |
...
...
@@ -4432,8 +4723,8 @@ getCertIssuer() : Promise\<DataBlob>
**返回值**
:
| 类型 | 说明 |
| -------- | -------------------------- |
| 类型
| 说明 |
| --------
-----------------------
| -------------------------- |
| Promise
\<
[
DataBlob
](
#datablob
)
> | 表示被吊销证书的颁发者信息 |
**示例**
:
...
...
@@ -4460,8 +4751,8 @@ getRevocationDate(callback : AsyncCallback\<string>) : void
**参数**
:
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
| ---- |
-------- |
| 参数名 | 类型
| 必填 | 说明
|
| -------- | -------------
--------- | ---- | ----------------------
-------- |
| callback | AsyncCallback
\<
string> | 否 | 回调函数。表示证书被吊销的日期 |
...
...
@@ -4491,8 +4782,8 @@ getRevocationDate() : Promise\<string>
**返回值**
:
| 类型 | 说明 |
| ------ | -------------------- |
| 类型
| 说明 |
| ------
----------
| -------------------- |
| Promise
\<
string> | 表示证书被吊销的日期 |
**示例**
:
...
...
zh-cn/application-dev/security/cryptoFramework-guidelines.md
浏览文件 @
699afa7b
...
...
@@ -262,14 +262,14 @@ function stringToUint8Array(str) {
return
new
Uint8Array
(
arr
);
}
// 字节流
转成可理解的字符串
// 字节流
以16进制输出
function
uint8ArrayToShowStr
(
uint8Array
)
{
return
Array
.
prototype
.
map
.
call
(
uint8Array
,
(
x
)
=>
(
'
00
'
+
x
.
toString
(
16
)).
slice
(
-
2
))
.
join
(
''
);
}
// 字节流
以16进制输出
// 字节流
转成可理解的字符串
function
uint8ArrayToString
(
array
)
{
let
arrayString
=
''
;
for
(
let
i
=
0
;
i
<
array
.
length
;
i
++
)
{
...
...
@@ -381,14 +381,14 @@ function stringToUint8Array(str) {
return
new
Uint8Array
(
arr
);
}
// 字节流
转成可理解的字符串
// 字节流
以16进制输出
function
uint8ArrayToShowStr
(
uint8Array
)
{
return
Array
.
prototype
.
map
.
call
(
uint8Array
,
(
x
)
=>
(
'
00
'
+
x
.
toString
(
16
)).
slice
(
-
2
))
.
join
(
''
);
}
// 字节流
以16进制输出
// 字节流
转成可理解的字符串
function
uint8ArrayToString
(
array
)
{
let
arrayString
=
''
;
for
(
let
i
=
0
;
i
<
array
.
length
;
i
++
)
{
...
...
@@ -922,7 +922,7 @@ Mac(message authentication code)可以对消息进行完整性校验,通过使
| 实例名 | 接口名 | 描述 |
| --------------- | ------------------------------------------------------------ | --------------------------------------------------- |
| cryptoFramework | function createM
d(algName : string) : Md;
| 指定摘要算法,生成消息认证码实例Mac |
| cryptoFramework | function createM
ac(algName : string) : Mac;
| 指定摘要算法,生成消息认证码实例Mac |
| Mac | init(key : SymKey, callback : AsyncCallback
\<
void
\>
) : void; | 接收输入对称密钥,通过Callback的方式,异步初始化MAC |
| Mac | init(key : SymKey) : Promise
\<
void
\>
; | 接收输入对称密钥,通过Promise的方式,异步初始化MAC |
| Mac | update(input : DataBlob, callback : AsyncCallback
\<
void
\>
) : void; | 接受输入数据,通过Callback的方式,异步更新MAC |
...
...
zh-cn/application-dev/security/cryptoFramework-overview.md
浏览文件 @
699afa7b
...
...
@@ -36,7 +36,7 @@
-
PKCS5:填充字符由一个字节序列组成,每个字节填充该填充字节序列的长度,规定是8字节填充;
-
PKCS7:填充字符和PKCS5填充方法一致,但是可以在1-255字节之间任意填充;
> **说明:** ECB、CBC加密模式,明文长度不是128位整数倍,必须使用填充方法补足
;
> **说明:** ECB、CBC加密模式,明文长度不是128位整数倍,必须使用填充方法补足
。<br/>由于需要填充至分组大小,所以实际算法库中的PKCS5和PKCS7都是以分组大小作为填充长度的,即AES加密填充至16字节。
-
**对称3DES加解密**
该算法的加解密过程分别是对明文/密文数据进行三次DES加密或解密,得到相应的密文或明文。
...
...
@@ -46,7 +46,7 @@
-
PKCS5:填充字符由一个字节序列组成,每个字节填充该填充字节序列的长度,规定是8字节填充;
-
PKCS7:填充字符和PKCS5填充方法一致,但是可以在1-255字节之间任意填充;
> **说明:** ECB、CBC加密模式,明文长度不是64位整数倍,必须使用填充方法补足
> **说明:** ECB、CBC加密模式,明文长度不是64位整数倍,必须使用填充方法补足
。<br/>由于需要填充至分组大小,所以实际算法库中的PKCS5和PKCS7都是以分组大小作为填充长度的,即3DES加密填充至8字节。
-
**非对称RSA加解密**
...
...
@@ -116,19 +116,21 @@ HMAC(Hash-based Message Authentication Code)是一种基于密钥的消息
支持的对称密钥生成参数:
|对称密钥算法|密钥长度
|生成密钥的
字符串参数|
|对称密钥算法|密钥长度
(bit)|
字符串参数|
|---|---|---|
|3DES|192|3DES192|
|AES|128|AES128|
|AES|192|AES192|
|AES|256|AES256|
> **说明**:“字符串参数”是“对称密钥算法”和“密钥长度”拼接而成,用于在创建对称密钥生成器时,指定密钥规格。
**非对称密钥生成规格**
-
**RSA密钥生成**
支持的非对称密钥生成参数:
|非对称密钥算法|密钥长度
|素数个数|生成密钥的
字符串参数|
|非对称密钥算法|密钥长度
(bit)|素数个数|
字符串参数|
|---|---|---|---|
|RSA|512|2|RSA512
\|
PRIMES_2|
|RSA|768|2|RSA768
\|
PRIMES_2|
...
...
@@ -165,7 +167,7 @@ HMAC(Hash-based Message Authentication Code)是一种基于密钥的消息
支持的对称加密算法:
|对称加解密算法|分组模式|
指定算法名称字符串
|
|对称加解密算法|分组模式|
字符串参数
|
|---|---|---|
|3DES|ECB|3DES192
\|
ECB
\|
[NoPadding
\|
PKCS5
\|
PKCS7]|
|3DES|CBC|3DES192
\|
CBC
\|
[NoPadding
\|
PKCS5
\|
PKCS7]|
...
...
@@ -179,7 +181,9 @@ HMAC(Hash-based Message Authentication Code)是一种基于密钥的消息
|AES|GCM|AES[128
\|
192
\|
256]
\|
GCM
\|
[NoPadding
\|
PKCS5
\|
PKCS7]|
|AES|CCM|AES[128
\|
192
\|
256]
\|
CCM
\|
[NoPadding
\|
PKCS5
\|
PKCS7]|
> **说明:** []中只能任选一项
> **说明:**
> 1. []中只能任选一项。
> 2. “字符串参数”是“对称加解密算法(含密钥长度)”、“分组模式”、“填充模式”拼接而成,用于在创建对称加解密实例时,指定对称加解密算法规格。
**非对称RSA加解密**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录