加解密算法庫框架

導(dǎo)入模塊

import cryptoFramework from "@ohos.security.cryptoFramework"

Result

表示執(zhí)行結(jié)果的枚舉。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

DataBlob

buffer數(shù)組。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

cryptoFramework.createMac

createMac(algName : string) : Mac

生成Mac實(shí)例，用于進(jìn)行消息認(rèn)證碼的計(jì)算與操作。

支持的規(guī)格詳見框架概述“HMAC消息認(rèn)證碼算法規(guī)格”一節(jié)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var mac;
try {
    // 參數(shù)選擇請參考上述算法支持范圍
    mac = cryptoFramework.createMac("SHA256");
} catch (error) {
    console.error("[Promise]: error code: " + error.code + ", message is: " + error.message);
}

Mac

Mac類，調(diào)用Mac方法可以進(jìn)行MAC（Message Authentication Code）加密計(jì)算。調(diào)用前，需要通過createMac構(gòu)造Mac實(shí)例。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

init

init(key : SymKey, callback : AsyncCallback<void>) : void;

使用對稱密鑰初始化Mac計(jì)算

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

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);
}
var KeyBlob;
var symKeyGenerator = cryptoFramework.createSymKeyGenerator("AES128");
symKeyGenerator.convertKey(KeyBlob, (err, symKey) => {
    if (err) {
        console.error("[Callback] err: " + err.code);
    }
    mac.init(symKey, (err1, ) => {
        if (err1) {
            console.error("[Callback] err: " + err1.code);
        }
    });
});

init

init(key : SymKey) : Promise<void>;

使用對稱密鑰初始化Mac計(jì)算

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

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);
}
console.error("Mac algName is: " + mac.algName);

var KeyBlob;
var symKeyGenerator = cryptoFramework.createSymKeyGenerator("AES128");
var promiseConvertKey = symKeyGenerator.convertKey(KeyBlob);
promiseConvertKey.then(symKey => {
    var promiseMacInit = mac.init(symKey);
    return promiseMacInit;
}).catch(error => {
    console.error("[Promise]: error: " + error.message);
});

update

update(input : DataBlob, callback : AsyncCallback<void>) : void;

傳入消息進(jìn)行Mac更新計(jì)算

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var KeyBlob;
var mac;
try {
    mac = cryptoFramework.createMac("SHA256");
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);
}
var symKeyGenerator = cryptoFramework.createSymKeyGenerator("AES128");
symKeyGenerator.convertKey(KeyBlob, (err, symKey) => {
    if (err) {
        console.error("[Callback] err: " + err.code);
    }
    mac.init(symKey, (err1, ) => {
        if (err1) {
            console.error("[Callback] err: " + err1.code);
        }
        let blob;
          mac.update(blob, (err2, data) => {
            if (err2) {
            console.error("[Callback] err: " + err2.code);
            }
          });
    });
});

update

update(input : DataBlob) : Promise<void>;

傳入消息進(jìn)行Mac更新計(jì)算

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

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);
}
console.error("Mac algName is: " + mac.algName);

var KeyBlob;
var symKeyGenerator = cryptoFramework.createSymKeyGenerator("AES128");
var promiseConvertKey = symKeyGenerator.convertKey(KeyBlob);
promiseConvertKey.then(symKey => {
    var promiseMacInit = mac.init(symKey);
    return promiseMacInit;
}).then(() => {
    let blob;
    var promiseMacUpdate = mac.update(blob);
    return promiseMacUpdate;
}).catch(error => {
    console.error("[Promise]: error: " + error.message);
});

doFinal

doFinal(callback : AsyncCallback<DataBlob>) : void;

返回Mac的計(jì)算結(jié)果

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var KeyBlob;
var mac;
try {
    mac = cryptoFramework.createMac("SHA256");
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);  
}
var symKeyGenerator = cryptoFramework.createSymKeyGenerator("AES128");
symKeyGenerator.convertKey(KeyBlob, (err, symKey) => {
    if (err) {
        console.error("[Callback] err: " + err.code);
    }
    mac.init(symKey, (err1, ) => {
        if (err1) {
            console.error("[Callback] err: " + err1.code);
        }
        let blob;
        mac.update(blob, (err2, ) => {
            if (err2) {
                console.error("[Callback] err: " + err2.code);
            }
            mac.doFinal((err3, macOutput) => {
                if (err3) {
                    console.error("[Callback] err: " + err3.code);
                } else {
                    console.error("[Promise]: HMAC result: " + macOutput);
                }
            });
        });
    });
});

doFinal

doFinal() : Promise<DataBlob>

返回Mac的計(jì)算結(jié)果

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

錯(cuò)誤碼：

示例：

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);  
}
console.error("Mac algName is: " + mac.algName);

var KeyBlob;
var symKeyGenerator = cryptoFramework.createSymKeyGenerator("AES128");
var promiseConvertKey = symKeyGenerator.convertKey(KeyBlob);
promiseConvertKey.then(symKey => {
    var promiseMacInit = mac.init(symKey);
    return promiseMacInit;
}).then(() => {
    let blob;
    var promiseMacUpdate = mac.update(blob);
    return promiseMacUpdate;
}).then(() => {
    var PromiseMacDoFinal = mac.doFinal();
    return PromiseMacDoFinal;
}).then(macOutput => {
    console.error("[Promise]: HMAC result: " + macOutput.data);
}).catch(error => {
    console.error("[Promise]: error: " + error.message);
});

getMacLength

getMacLength() : number

獲取Mac消息認(rèn)證碼的長度（字節(jié)數(shù)）

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

錯(cuò)誤碼：

示例：

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);
}
console.error("Mac algName is: " + mac.algName);

var KeyBlob;
var symKeyGenerator = cryptoFramework.createSymKeyGenerator("AES128");
var promiseConvertKey = symKeyGenerator.convertKey(KeyBlob);
promiseConvertKey.then(symKey => {
    var promiseMacInit = mac.init(symKey);
    return promiseMacInit;
}).then(() => {
    let blob;
    var promiseMacUpdate = mac.update(blob);
    return promiseMacUpdate;
}).then(() => {
    var PromiseMacDoFinal = mac.doFinal();
    return PromiseMacDoFinal;
}).then(macOutput => {
    console.error("[Promise]: HMAC result: " + macOutput.data);
    let macLen = mac.getMacLength();
    console.error("MAC len: " + macLen);
}).catch(error => {
    console.error("[Promise]: error: " + error.message);
});

cryptoFramework.createMd

createMd(algName : string) : Md

生成Md實(shí)例，用于進(jìn)行消息摘要的計(jì)算與操作。

支持的規(guī)格詳見框架概述“MD消息摘要算法規(guī)格”一節(jié)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var md;
try {
    // 參數(shù)選擇請參考上述算法支持范圍
    md = cryptoFramework.createMd("SHA256");
} catch (error) {
    console.error("[Promise]: error code: " + error.code + ", message is: " + error.message);
}

Md

Md類，調(diào)用Md方法可以進(jìn)行MD（Message Digest）摘要計(jì)算。調(diào)用前，需要通過createMd構(gòu)造Md實(shí)例。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

update

update(input : DataBlob, callback : AsyncCallback<void>) : void;

傳入消息進(jìn)行Md更新計(jì)算

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var md;
try {
    md = cryptoFramework.createMd("SHA256");
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);
}
console.error("Md algName is: " + md.algName);

let blob;
md.update(blob, (err,) => {
    if (err) {
        console.error("[Callback] err: " + err.code);
    }
});

update

update(input : DataBlob) : Promise<void>;

傳入消息進(jìn)行Md更新計(jì)算

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var md;
try {
    md = cryptoFramework.createMd("SHA256");
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);
}
console.error("Md algName is: " + md.algName);

let blob;
var promiseMdUpdate = md.update(blob);
promiseMdUpdate.then(() => {
    // do something
}).catch(error => {
    console.error("[Promise]: error: " + error.message);
});

digest

digest(callback : AsyncCallback<DataBlob>) : void

返回Md的計(jì)算結(jié)果

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var md;
try {
    md = cryptoFramework.createMd("SHA256");
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);
}
console.error("Md algName is: " + md.algName);

let blob;
md.update(blob, (err,) => {
    if (err) {
        console.error("[Callback] err: " + err.code);
    }
    md.digest((err1, mdOutput) => {
        if (err1) {
            console.error("[Callback] err: " + err1.code);
        } else {
            console.error("[Callback]: MD result: " + mdOutput);
        }
    });
});

digest

digest() : Promise<DataBlob>

返回Md的計(jì)算結(jié)果

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var md;
try {
    md = cryptoFramework.createMd("SHA256");
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);
}
console.error("Md algName is: " + md.algName);

let blob;
var promiseMdUpdate = md.update(blob);
promiseMdUpdate.then(() => {
    var PromiseMdDigest = md.digest();
    return PromiseMdDigest;
}).then(mdOutput => {
    console.error("[Promise]: MD result: " + mdOutput.data);
}).catch(error => {
    console.error("[Promise]: error: " + error.message);
});

getMdLength

getMdLength() : number

獲取Md消息摘要長度（字節(jié)數(shù)）

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var md;
try {
    md = cryptoFramework.createMd("SHA256");
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);
}
console.error("Md algName is: " + md.algName);

let blob;
var promiseMdUpdate = md.update(blob);
promiseMdUpdate.then(() => {
    var PromiseMdDigest = md.digest();
    return PromiseMdDigest;
}).then(mdOutput => {
    console.error("[Promise]: MD result: " + mdOutput.data);
    let mdLen = md.getMdLength();
    console.error("MD len: " + mdLen);
}).catch(error => {
    console.error("[Promise]: error: " + error.message);
});

cryptoFramework.createRandom

createRandom() : Random

生成Random實(shí)例，用于進(jìn)行隨機(jī)數(shù)的計(jì)算與設(shè)置種子。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

try {
    var rand = cryptoFramework.createRandom();
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message); 
}

Random

Random類，調(diào)用Random方法可以進(jìn)行隨機(jī)數(shù)計(jì)算。調(diào)用前，需要通過createRandom構(gòu)造Random實(shí)例。

generateRandom

generateRandom(len : number, callback: AsyncCallback<DataBlob>) : void;

生成指定長度的隨機(jī)數(shù)

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var rand;
try {
    rand = cryptoFramework.createRandom();
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);    
}
rand.generateRandom(12, (err, randData) => {
    if (err) {
        console.error("[Callback] err: " + err.code);
    } else {
        console.error("[Callback]: generate random result: " + randData.data);
    }
});

generateRandom

generateRandom(len : number) : Promise<DataBlob>;

生成指定長度的隨機(jī)數(shù)

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var rand;
try {
    rand = cryptoFramework.createRandom();
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);
}

var promiseGenerateRand = rand.generateRandom(12);
promiseGenerateRand.then(randData => {
    console.error("[Promise]: rand result: " + randData.data);
}).catch(error => {
    console.error("[Promise]: error: " + error.message);
});

setSeed

setSeed(seed : DataBlob) : void;

設(shè)置指定的種子

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

var rand;
try {
    rand = cryptoFramework.createRandom();
} catch (error) {
    console.error("[Callback]: error code: " + error.code + ", message is: " + error.message);
}

rand.generateRandom(12, (err, randData) => {
    if (err) {
        console.error("[Callback] err: " + err.code);
    } else {
        console.error("[Callback]: generate random result: " + randData.data);
        try {
            rand.setSeed(randData);
        } catch (error) {
            console.log("setSeed failed, errCode: " + error.code + ", errMsg: " + error.message);
        }
    }
});

ParamsSpec

加解密參數(shù)，在進(jìn)行對稱加解密時(shí)需要構(gòu)造其子類對象，并將子類對象傳入init()方法。

適用于需要iv等參數(shù)的對稱加解密模式（對于無iv等參數(shù)的模式如ECB模式，無需構(gòu)造，在init()中傳入null即可）。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

IvParamsSpec

加解密參數(shù)ParamsSpec的子類，用于在對稱加解密時(shí)作為init()方法的參數(shù)。

適用于CBC、CTR、OFB、CFB這些僅使用iv作為參數(shù)的加解密模式。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

GcmParamsSpec

加解密參數(shù)ParamsSpec的子類，用于在對稱加解密時(shí)作為init()方法的參數(shù)。

適用于GCM模式。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

CcmParamsSpec

加解密參數(shù)ParamsSpec的子類，用于在對稱加解密時(shí)作為init()方法的參數(shù)。

適用于CCM模式。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

CryptoMode

表示加解密操作的枚舉。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

Key

密鑰（父類），在運(yùn)行密碼算法（如加解密）時(shí)需要提前生成其子類對象，并傳入Cipher實(shí)例的init()方法。

密鑰可以通過密鑰生成器來生成。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

getEncoded

getEncoded() : DataBlob

以同步方法，獲取16進(jìn)制形式的密鑰內(nèi)容。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"
function uint8ArrayToShowStr(uint8Array) {
  return Array.prototype.map
    .call(uint8Array, (x) => ('00' + x.toString(16)).slice(-2))
    .join('');
}

let key;    // key為使用對稱密鑰生成器 生成的密鑰，此處省略生成過程
let encodedKey = key.getEncoded();
console.info("key hex:" + uint8ArrayToShowStr(encodedKey.data));

SymKey

對稱密鑰，是Key的子類，在對稱加解密時(shí)需要將其對象傳入Cipher實(shí)例的init()方法使用。

對稱密鑰可以通過對稱密鑰生成器SymKeyGenerator來生成。

clearMem

clearMem() : void

以同步方法，將系統(tǒng)底層內(nèi)存中的的密鑰內(nèi)容清零。建議在不再使用對稱密鑰實(shí)例時(shí)，調(diào)用本函數(shù)，避免內(nèi)存中密鑰數(shù)據(jù)存留過久。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"
function uint8ArrayToShowStr(uint8Array) {
  return Array.prototype.map
    .call(uint8Array, (x) => ('00' + x.toString(16)).slice(-2))
    .join('');
}

let key;    // key為使用對稱密鑰生成器 生成的密鑰，此處省略生成過程
let encodedKey = key.getEncoded();
console.info("key hex:" + uint8ArrayToShowStr(encodedKey.data));    // 輸出密鑰內(nèi)容
key.clearMem();
encodedKey = key.getEncoded();
console.info("key hex:" + uint8ArrayToShowStr(encodedKey.data));    // 輸出全零

PubKey

公鑰，是Key的子類，在非對稱加解密、驗(yàn)簽、密鑰協(xié)商時(shí)需要將其對象作為輸入使用。

公鑰可以通過非對稱密鑰生成器AsyKeyGenerator來生成。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

getEncoded

getEncoded() : DataBlob

以同步方法，獲取二進(jìn)制形式的密鑰內(nèi)容。公鑰格式滿足ASN.1語法、X.509規(guī)范、DER編碼格式。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

示例：

function uint8ArrayToShowStr(uint8Array) {
  return Array.prototype.map
    .call(uint8Array, (x) => ('00' + x.toString(16)).slice(-2))
    .join('');
}

let key; // key為使用非對稱密鑰生成器生成的非對稱密鑰的公鑰對象，此處省略生成過程
console.info("key format:" + key.format);
console.info("key algName:" + key.algName);
var encodedKey = key.getEncoded();
console.info("key encoded:" + uint8ArrayToShowStr(encodedKey.data));

PriKey

私鑰，是Key的子類，在非對稱加解密、簽名、密鑰協(xié)商時(shí)需要將其作為輸入使用。

私鑰可以通過非對稱密鑰生成器AsyKeyGenerator來生成。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

getEncoded

getEncoded() : DataBlob

以同步方法，獲取二進(jìn)制形式的密鑰內(nèi)容。私鑰格式滿足ASN.1語法，PKCS#8規(guī)范、DER編碼方式。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

示例：

function uint8ArrayToShowStr(uint8Array) {
  return Array.prototype.map
    .call(uint8Array, (x) => ('00' + x.toString(16)).slice(-2))
    .join('');
}

let key; // key為使用非對稱密鑰生成器生成的非對稱密鑰的私鑰對象，此處省略生成過程
console.info("key format:" + key.format);
console.info("key algName:" + key.algName);
var encodedKey = key.getEncoded();
console.info("key encoded:" + uint8ArrayToShowStr(encodedKey.data));

clearMem

clearMem() : void

以同步方法，將系統(tǒng)底層內(nèi)存中的的密鑰內(nèi)容清零。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

示例：

let key; // key為使用非對稱密鑰生成器生成的非對稱密鑰的私鑰對象，此處省略生成過程
key.clearMem();

KeyPair

非對稱密鑰對，包含：公鑰與私鑰。

可以通過非對稱密鑰生成器AsyKeyGenerator來生成。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

cryptoFramework.createSymKeyGenerator

createSymKeyGenerator(algName : string) : SymKeyGenerator

通過指定算法名稱的字符串，獲取相應(yīng)的對稱密鑰生成器實(shí)例。

支持的規(guī)格詳見框架概述“密鑰生成規(guī)格”一節(jié)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';
let symKeyGenerator = cryptoFramework.createSymKeyGenerator('3DES192');

SymKeyGenerator

對稱密鑰生成器。

在使用該類的方法前，需要先使用createSymKeyGenerator方法構(gòu)建一個(gè)symKeyGenerator實(shí)例。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

generateSymKey

generateSymKey(callback : AsyncCallback<SymKey>) : void

異步獲取對稱密鑰生成器隨機(jī)生成的密鑰，通過注冊回調(diào)函數(shù)獲取結(jié)果。

必須在使用createSymKeyGenerator創(chuàng)建對稱密鑰生成器后，才能使用本函數(shù)。

目前支持使用OpenSSL的RAND_priv_bytes()作為底層能力生成隨機(jī)密鑰。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';
let symAlgName = '3DES192';
let symKeyGenerator = cryptoFramework.createSymKeyGenerator(symAlgName);
symKeyGenerator.generateSymKey((err, symKey) => {
  if (err) {
    console.error(`Generate symKey failed, ${err.code}, ${err.message}`);
  } else {
    console.info(`Generate symKey success, algName: ${symKey.algName}`);
  }
})

generateSymKey

generateSymKey() : Promise<SymKey>

異步獲取該對稱密鑰生成器隨機(jī)生成的密鑰，通過Promise獲取結(jié)果。

必須在使用createSymKeyGenerator創(chuàng)建對稱密鑰生成器后，才能使用本函數(shù)。

目前支持使用OpenSSL的RAND_priv_bytes()作為底層能力生成隨機(jī)密鑰。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';
let symAlgName = 'AES128';
let symKeyGenerator = cryptoFramework.createSymKeyGenerator(symAlgName);
symKeyGenerator.generateSymKey()
.then(symKey => {
  console.info(`Generate symKey success, algName: ${symKey.algName}`);
}, error => {
  console.error(`Generate symKey failed, ${error.code}, ${error.message}`);
})

convertKey

convertKey(key : DataBlob, callback : AsyncCallback<SymKey>) : void

異步根據(jù)指定數(shù)據(jù)生成對稱密鑰，通過注冊回調(diào)函數(shù)獲取結(jié)果。

必須在使用createSymKeyGenerator創(chuàng)建對稱密鑰生成器后，才能使用本函數(shù)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';

function genKeyMaterialBlob() {
  let arr = [
    0xba, 0x3d, 0xc2, 0x71, 0x21, 0x1e, 0x30, 0x56,
    0xad, 0x47, 0xfc, 0x5a, 0x46, 0x39, 0xee, 0x7c,
    0xba, 0x3b, 0xc2, 0x71, 0xab, 0xa0, 0x30, 0x72];    // keyLen = 192 (24 bytes)
  let keyMaterial = new Uint8Array(arr);
  return {data : keyMaterial};
}

let symAlgName = '3DES192';
let symKeyGenerator = cryptoFramework.createSymKeyGenerator(symAlgName);
let keyMaterialBlob = genKeyMaterialBlob();
symKeyGenerator.convertKey(keyMaterialBlob, (err, symKey) => {
  if (err) {
    console.error(`Convert symKey failed, ${err.code}, ${err.message}`);
  } else {
    console.info(`Convert symKey success, algName: ${symKey.algName}`);
  }
})

convertKey

convertKey(key : DataBlob) : Promise<SymKey>

異步根據(jù)指定數(shù)據(jù)生成對稱密鑰，通過Promise獲取結(jié)果。

必須在使用createSymKeyGenerator創(chuàng)建對稱密鑰生成器后，才能使用本函數(shù)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';

function genKeyMaterialBlob() {
  let arr = [
    0xba, 0x3d, 0xc2, 0x71, 0x21, 0x1e, 0x30, 0x56,
    0xad, 0x47, 0xfc, 0x5a, 0x46, 0x39, 0xee, 0x7c,
    0xba, 0x3b, 0xc2, 0x71, 0xab, 0xa0, 0x30, 0x72];    // keyLen = 192 (24 bytes)
  let keyMaterial = new Uint8Array(arr);
  return {data : keyMaterial};
}

let symAlgName = '3DES192';
let symKeyGenerator = cryptoFramework.createSymKeyGenerator(symAlgName);
let keyMaterialBlob = genKeyMaterialBlob();
symKeyGenerator.convertKey(keyMaterialBlob)
.then(symKey => {
  console.info(`Convert symKey success, algName: ${symKey.algName}`);
}, error => {
  console.error(`Convert symKey failed, ${error.code}, ${error.message}`);
})

cryptoFramework.createAsyKeyGenerator

createAsyKeyGenerator(algName : string) : AsyKeyGenerator

通過指定算法名稱的字符串，獲取相應(yīng)的非對稱密鑰生成器實(shí)例。

支持的規(guī)格詳見框架概述“密鑰生成規(guī)格”一節(jié)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

let asyKeyGenerator = cryptoFramework.createAsyKeyGenerator("ECC256");

AsyKeyGenerator

非對稱密鑰生成器。在使用該類的方法前，需要先使用createAsyKeyGenerator()方法構(gòu)建一個(gè)AsyKeyGenerator實(shí)例。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

generateKeyPair

generateKeyPair(callback : AsyncCallback<KeyPair>) : void;

異步獲取非對稱密鑰生成器隨機(jī)生成的密鑰，通過注冊回調(diào)函數(shù)獲取結(jié)果。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

let asyKeyGenerator = cryptoFramework.createAsyKeyGenerator("ECC256");
asyKeyGenerator.generateKeyPair((err, keyPair) => {
  if (err) {
    console.error("generateKeyPair: error.");
    return;
  }
  console.info("generateKeyPair: success.");
})

generateKeyPair

generateKeyPair() : Promise<KeyPair>

異步獲取該非對稱密鑰生成器隨機(jī)生成的密鑰，通過Promise獲取結(jié)果。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

let asyKeyGenerator = cryptoFramework.createAsyKeyGenerator("ECC256");
let keyGenPromise = asyKeyGenerator.generateKeyPair();
keyGenPromise.then( keyPair => {
  console.info("generateKeyPair success.");
}).catch(error => {
  console.error("generateKeyPair error.");
});

convertKey

convertKey(pubKey : DataBlob, priKey : DataBlob, callback : AsyncCallback<KeyPair>) : void

異步獲取指定數(shù)據(jù)生成非對稱密鑰，通過注冊回調(diào)函數(shù)獲取結(jié)果。詳情請看下方密鑰轉(zhuǎn)換說明

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"
let pubKey; // X.509規(guī)范、DER格式的公鑰數(shù)據(jù)，此處省略數(shù)據(jù)。
let priKey; // PKCS#8規(guī)范、DER格式的私鑰數(shù)據(jù)，此處省略數(shù)據(jù)。
let asyKeyGenerator = cryptoFramework.createAsyKeyGenerator("ECC256");
asyKeyGenerator.convertKey(pubKey, priKey, (err, keyPair) => {
  if (err) {
    console.error("convertKey: error.");
    return;
  }
  console.info("convertKey: success.");
})

convertKey

convertKey(pubKey : DataBlob, priKey : DataBlob) : Promise<KeyPair>

異步獲取指定數(shù)據(jù)生成非對稱密鑰，通過Promise獲取結(jié)果。詳情請看下方密鑰轉(zhuǎn)換說明

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

let asyKeyGenerator = cryptoFramework.createAsyKeyGenerator("ECC256");
let pubKey; // pubKey為使用非對稱密鑰生成器生成的非對稱密鑰的公鑰對象，此處省略生成過程
let priKey; // priKey為使用非對稱密鑰生成器生成的非對稱密鑰的私鑰對象，此處省略生成過程
let keyGenPromise = asyKeyGenerator.convertKey(pubKey, priKey);
keyGenPromise.then( keyPair => {
  console.info("convertKey success.");
}).catch(error => {
  console.error("convertKey error.");
});

密鑰轉(zhuǎn)換說明

1. 非對稱密鑰（RSA、ECC）的公鑰和私鑰調(diào)用getEncoded()方法后，分別返回X.509格式和PKCS#8格式的二進(jìn)制數(shù)據(jù)，此數(shù)據(jù)可用于跨應(yīng)用傳輸或持久化存儲。
2. 當(dāng)調(diào)用convertKey方法將外來二進(jìn)制數(shù)據(jù)轉(zhuǎn)換為算法庫非對稱密鑰對象時(shí)，公鑰應(yīng)滿足ASN.1語法、X.509規(guī)范、DER編碼格式，私鑰應(yīng)滿足ASN.1語法、PKCS#8規(guī)范、DER編碼格式。
3. convertKey方法中，公鑰和密鑰二進(jìn)制數(shù)據(jù)非必選項(xiàng)，可單獨(dú)傳入公鑰或私鑰的數(shù)據(jù)，生成對應(yīng)只包含公鑰或私鑰的KeyPair對象。

cryptoFramework.createCipher

createCipher(transformation : string) : Cipher

通過指定算法名稱，獲取相應(yīng)的Cipher實(shí)例。

支持的規(guī)格詳見框架概述“加解密規(guī)格”一節(jié)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

let cipherAlgName = '3DES192|ECB|PKCS7';
var cipher;
try {
  cipher = cryptoFramework.createCipher(cipherAlgName);
  console.info(`cipher algName: ${cipher.algName}`);
} catch (error) {
  console.error(`createCipher failed, ${error.code}, ${error.message}`);
}

Cipher

提供加解密的算法操作功能，按序調(diào)用本類中的init()、update()、doFinal()方法，可以實(shí)現(xiàn)對稱加密/對稱解密/非對稱加密/非對稱解密。

完整的加解密流程示例可參考開發(fā)指導(dǎo)中的“使用加解密操作”一節(jié)。

一次完整的加/解密流程在對稱加密和非對稱加密中略有不同：

• 對稱加解密：init為必選，update為可選（且允許多次update加/解密大數(shù)據(jù)），doFinal為必選；doFinal結(jié)束后可以重新init開始新一輪加/解密流程。
• RSA非對稱加解密：init為必選，不支持update操作，doFinal為必選（允許連續(xù)多次doFinal加/解密大數(shù)據(jù)）；RSA不支持重復(fù)init，切換加解密模式或填充方式時(shí)，需要重新創(chuàng)建Cipher對象。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

init

init(opMode : CryptoMode, key : Key, params : ParamsSpec, callback : AsyncCallback<void>) : void

初始化加解密的cipher對象，通過注冊回調(diào)函數(shù)獲取結(jié)果。

必須在使用createCipher創(chuàng)建Cipher實(shí)例后，才能使用本函數(shù)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';
let symKey;     // 此處省略生成對稱密鑰的過程
let cipher;         // 此處省略生成cipher實(shí)例的過程

cipher.init(cryptoFramework.CryptoMode.ENCRYPT_MODE, symKey, null, (err, ) => {
  if (err) {
    console.error(`Failed to init cipher, ${err.code}, ${err.message}`);
  } else {
    console.info(`Init cipher success`);
    // 此處進(jìn)行update等后續(xù)操作
  }
})

init

init(opMode : CryptoMode, key : Key, params : ParamsSpec) : Promise<void>

初始化加解密的cipher對象，通過Promise獲取結(jié)果。

必須在使用createCipher創(chuàng)建Cipher實(shí)例后，才能使用本函數(shù)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';
let symKey;     // 此處省略生成對稱密鑰的過程
let cipher;         // 此處省略生成cipher實(shí)例的過程
cipher.init(cryptoFramework.CryptoMode.ENCRYPT_MODE, symKey, null)
.then(() => {
  console.info(`Init cipher success`);
  // 此處進(jìn)行update等后續(xù)操作
}, error => {
  console.error(`Failed to init cipher, ${error.code}, ${error.message}`);
})

update

update(data : DataBlob, callback : AsyncCallback<DataBlob>) : void

分段更新加密或者解密數(shù)據(jù)操作，通過注冊回調(diào)函數(shù)獲取加/解密數(shù)據(jù)。

必須在對Cipher實(shí)例使用init()初始化后，才能使用本函數(shù)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';

function stringToUint8Array(str) {
  let arr = [];
  for (let i = 0, j = str.length; i < j; ++i) {
    arr.push(str.charCodeAt(i));
  }
  return new Uint8Array(arr);
}

let cipher;         // 此處省略生成cipher實(shí)例的過程
// 此處省略init()過程
let plainText = {data : stringToUint8Array('this is test!')};
cipher.update(plainText, (err, output) => {       // 加密過程舉例
  if (err) {
    console.error(`Failed to update cipher`);
  } else {
    console.info(`Update cipher success`);
    if (output != null) {
      // 拼接output.data到密文
    }
    // 此處進(jìn)行doFinal等后續(xù)操作
  }
})

update

update(data : DataBlob) : Promise<DataBlob>

分段更新加密或者解密數(shù)據(jù)操作，通過Promise獲取加/解密數(shù)據(jù)。

必須在對Cipher實(shí)例使用init()初始化后，才能使用本函數(shù)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';

function stringToUint8Array(str) {
  let arr = [];
  for (let i = 0, j = str.length; i < j; ++i) {
    arr.push(str.charCodeAt(i));
  }
  return new Uint8Array(arr);
}

let cipher;         // 此處省略生成cipher實(shí)例的過程
// 此處省略init()過程
let plainText = {data : stringToUint8Array('this is test!')};
cipher.update(plainText)
.then((output) => {
  console.info(`Update cipher success.`);
  if (output != null) {
    // 拼接output.data到密文
  }
  // 此處進(jìn)行doFinal等后續(xù)操作
}, error => {
  console.info(`Update cipher failed.`);
})

doFinal

doFinal(data : DataBlob, callback : AsyncCallback<DataBlob>) : void

（1）在對稱加解密中，doFinal加/解密（分組模式產(chǎn)生的）剩余數(shù)據(jù)和本次傳入的數(shù)據(jù)，最后結(jié)束加密或者解密數(shù)據(jù)操作，通過注冊回調(diào)函數(shù)獲取加密或者解密數(shù)據(jù)。

如果數(shù)據(jù)量較小，可以在doFinal中一次性傳入數(shù)據(jù)，而不使用update；如果在本次加解密流程中，已經(jīng)使用update傳入過數(shù)據(jù)，可以在doFinal的data參數(shù)處傳入null。

根據(jù)對稱加解密的模式不同，doFinal的輸出有如下區(qū)別：

• 對于GCM和CCM模式的對稱加密：一次加密流程中，如果將每一次update和doFinal的結(jié)果拼接起來，會得到“密文+authTag”，即末尾的16字節(jié)（GCM模式）或12字節(jié)（CCM模式）是authTag，而其余部分均為密文。（也就是說，如果doFinal的data參數(shù)傳入null，則doFinal的結(jié)果就是authTag）

  authTag需要填入解密時(shí)的GcmParamsSpec或CcmParamsSpec；密文則作為解密時(shí)的入?yún)ata。

• 對于其他模式的對稱加解密、GCM和CCM模式的對稱解密：一次加/解密流程中，每一次update和doFinal的結(jié)果拼接起來，得到完整的明文/密文。

（2）在RSA非對稱加解密中，doFinal加/解密本次傳入的數(shù)據(jù)，通過注冊回調(diào)函數(shù)獲取加密或者解密數(shù)據(jù)。如果數(shù)據(jù)量較大，可以多次調(diào)用doFinal，拼接結(jié)果得到完整的明文/密文。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';

let cipher;         // 此處省略生成cipher實(shí)例的過程
let data;           // 此處省略準(zhǔn)備待加密/解密數(shù)據(jù)的過程
// 此處省略init()和update()過程
cipher.doFinal(data, (err, output) => {
  if (err) {
    console.error(`Failed to finalize cipher, ${err.code}, ${err.message}`);
  } else {
    console.info(`Finalize cipher success`);
    if (output != null) {
      // 拼接output.data得到完整的明文/密文(及authTag)
    }
  }
})

doFinal

doFinal(data : DataBlob) : Promise<DataBlob>

（1）在對稱加解密中，doFinal加/解密（分組模式產(chǎn)生的）剩余數(shù)據(jù)和本次傳入的數(shù)據(jù)，最后結(jié)束加密或者解密數(shù)據(jù)操作，通過Promise獲取加密或者解密數(shù)據(jù)。

如果數(shù)據(jù)量較小，可以在doFinal中一次性傳入數(shù)據(jù)，而不使用update；如果在本次加解密流程中，已經(jīng)使用update傳入過數(shù)據(jù)，可以在doFinal的data參數(shù)處傳入null。

根據(jù)對稱加解密的模式不同，doFinal的輸出有如下區(qū)別：

• 對于GCM和CCM模式的對稱加密：一次加密流程中，如果將每一次update和doFinal的結(jié)果拼接起來，會得到“密文+authTag”，即末尾的16字節(jié)（GCM模式）或12字節(jié)（CCM模式）是authTag，而其余部分均為密文。（也就是說，如果doFinal的data參數(shù)傳入null，則doFinal的結(jié)果就是authTag）

  authTag需要填入解密時(shí)的GcmParamsSpec或CcmParamsSpec；密文則作為解密時(shí)的入?yún)ata。

• 對于其他模式的對稱加解密、GCM和CCM模式的對稱解密：一次加/解密流程中，每一次update和doFinal的結(jié)果拼接起來，得到完整的明文/密文。

（2）在RSA非對稱加解密中，doFinal加/解密本次傳入的數(shù)據(jù)，通過Promise獲取加密或者解密數(shù)據(jù)。如果數(shù)據(jù)量較大，可以多次調(diào)用doFinal，拼接結(jié)果得到完整的明文/密文。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

示例：

import cryptoFramework from '@ohos.security.cryptoFramework';

let cipher;         // 此處省略生成cipher實(shí)例的過程
let data;           // 此處省略準(zhǔn)備待加密/解密數(shù)據(jù)的過程
// 此處省略init()和update()過程
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}`);
})

使用RSA加密的callback完整示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

function stringToUint8Array(str) {
  let arr = [];
  for (let i = 0, j = str.length; i < j; ++i) {
    arr.push(str.charCodeAt(i));
  }
  return new Uint8Array(arr);
}

let rsaGenerator = cryptoFramework.createAsyKeyGenerator("RSA1024|PRIMES_2");
let cipher = cryptoFramework.createCipher("RSA1024|PKCS1");
rsaGenerator.generateKeyPair(function (err, keyPair) {
  let pubKey = keyPair.pubKey;
  cipher.init(cryptoFramework.CryptoMode.ENCRYPT_MODE, pubKey, null, function (err, data) {
    let plainText = "this is cipher text";
    let input = {data : stringToUint8Array(plainText) };
    cipher.doFinal(input, function (err, data) {
      AlertDialog.show({ message : "EncryptOutPut is " + data.data} );
    });
  });
});

使用RSA加密的promise完整示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

function stringToUint8Array(str) {
  let arr = [];
  for (let i = 0, j = str.length; i < j; ++i) {
    arr.push(str.charCodeAt(i));
  }
  return new Uint8Array(arr);
}

let rsaGenerator = cryptoFramework.createAsyKeyGenerator("RSA1024|PRIMES_2");
let cipher = cryptoFramework.createCipher("RSA1024|PKCS1");
let keyGenPromise = rsaGenerator.generateKeyPair();
keyGenPromise.then(rsaKeyPair => {
  let pubKey = rsaKeyPair.pubKey;
  return cipher.init(cryptoFramework.CryptoMode.ENCRYPT_MODE, pubKey, null); // 傳入私鑰和DECRYPT_MODE可初始化解密模式
}).then(() => {
  let plainText = "this is cipher text";
  let input = { data : stringToUint8Array(plainText) };
  return cipher.doFinal(input);
}).then(dataBlob => {
  console.info("EncryptOutPut is " + dataBlob.data);
});

cryptoFramework.createSign

createSign(algName : string) : Sign

Sign實(shí)例生成。

支持的規(guī)格詳見框架概述“簽名驗(yàn)簽規(guī)格”一節(jié)。

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

示例：

import cryptoFramework from "@ohos.security.cryptoFramework"

let signer1 = cryptoFramework.createSign("RSA1024|PKCS1|SHA256");

let singer2 = cryptoFramework.createSign("RSA1024|PSS|SHA256|MGF1_SHA256")

Sign

Sign類，使用Sign方法之前需要?jiǎng)?chuàng)建該類的實(shí)例進(jìn)行操作，通過createSign(algName : string) : Sign方法構(gòu)造此實(shí)例。Sign類不支持重復(fù)初始化，當(dāng)業(yè)務(wù)方需要使用新密鑰簽名時(shí)，需要重新創(chuàng)建新Sign對象并調(diào)用init初始化。

業(yè)務(wù)方使用時(shí)，在createSign時(shí)確定簽名的模式，調(diào)用init接口設(shè)置密鑰。

當(dāng)待簽名數(shù)據(jù)較短時(shí)，可在init初始化后直接調(diào)用sign接口傳入原文數(shù)據(jù)進(jìn)行簽名。

當(dāng)待簽名數(shù)據(jù)較長時(shí)，可通過update接口分段傳入切分后的原文數(shù)據(jù)，最后調(diào)用sign接口對整體原文數(shù)據(jù)進(jìn)行簽名。

當(dāng)使用update分段傳入原文時(shí)，sign接口支持傳null，業(yè)務(wù)方可在循環(huán)中調(diào)用update接口，循環(huán)結(jié)束后調(diào)用sign進(jìn)行簽名。

屬性

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

init

init(priKey : PriKey, callback : AsyncCallback<void>) : void

使用私鑰初始化Sign對象，Callback形式，Sign類暫不支持重復(fù)init

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

init

init(priKey : PriKey) : Promise<void>

使用私鑰初始化Sign對象，Promise形式，Sign類暫不支持重復(fù)init

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

update

update(data : DataBlob, callback : AsyncCallback<void>) : void

追加待簽名數(shù)據(jù)，callback方式

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

update

update(data : DataBlob) : Promise<void>;

追加待簽名數(shù)據(jù)，promise方式

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：

錯(cuò)誤碼：

sign

sign(data : DataBlob, callback : AsyncCallback<DataBlob>) : void

對數(shù)據(jù)進(jìn)行簽名，返回簽名結(jié)果，callback方式

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

錯(cuò)誤碼：

sign

sign(data : DataBlob) : Promise<DataBlob>

對數(shù)據(jù)進(jìn)行簽名，返回簽名結(jié)果，promise方式

系統(tǒng)能力： SystemCapability.Security.CryptoFramework

參數(shù)：

返回值：