从6.1.1(24)版本开始,新增设置HDC认证密钥接口,支持用户在企业设备上开展安全调试,进一步强化设备安全性。
详细接口说明可参考接口文档。
| 接口名 | 描述 |
|---|---|
| setHdcAuthenticationKey(devType: AuthenticateDeviceType, keyType: AuthenticateKeyType, key: Uint8Array): Promise<void> | 使用Promise方式设置上下位机间的HDC认证密钥。 |
应用需要通过OpenSSL在本地生成一个3072位的RSA密钥对。
通过OpenSSL生成私钥:
openssl genpkey -algorithm RSA -out private_key_3072.pem -pkeyopt rsa_keygen_bits:3072
根据私钥提取公钥:
openssl rsa -in private_key_3072.pem -pubout -out public_key_3072.pem
导入模块。
import { BusinessError } from '@kit.BasicServicesKit';
import { fileGuard } from '@kit.EnterpriseDataGuardKit';
import { hilog } from '@kit.PerformanceAnalysisKit'; 初始化FileGuard对象guard,调用接口setHdcAuthenticationKey,设置上下位机之间的HDC认证密钥。上位机需要下发私钥,下位机下发公钥,从而实现上位机对下位机的安全调试。
const TAG: string = 'FileGuard_HDCAuthenticationKey';
const DOMAIN: number = 0x0000;
/**
* 设置上下位机间的HDC认证密钥。使用Promise异步回调。
* 示例仅供参考,调用时需要分别设置上位机的私钥以及下位机的公钥,才能进行HDC安全调试。
*/
function testSetHdcAuthenticationKey() {
let guard: fileGuard.FileGuard = new fileGuard.FileGuard();
let devType: fileGuard.AuthenticateDeviceType = fileGuard.AuthenticateDeviceType.UPPER;
let keyType: fileGuard.AuthenticateKeyType = fileGuard.AuthenticateKeyType.PRIVATE_KEY;
// 将对应的密钥转为Uint8Array类型
let key: Uint8Array = new Uint8Array([0]);
guard.setHdcAuthenticationKey(devType, keyType, key).then(() => {
hilog.info(DOMAIN, TAG, `Succeeded in setting the HDC authentication key.`);
}).catch((error: BusinessError) => {
hilog.error(DOMAIN, TAG,
`Failed to set the HDC authentication key. Code: ${error.code}, message: ${error.message}.`);
})
}