使用硬件熵源生成安全随机数(ArkTS)

介绍

随机数主要用于临时会话密钥生成和非对称加密算法密钥生成等场景。在加解密场景中，安全随机数生成器需要具备随机性、不可预测性和不可重现性。使用更安全的熵源，对随机数而言，就意味着 “结果难以被猜测或复现”，是 “真随机性” 的量化体现。

当前硬件熵源随机数的实现依赖HUKS。对于具备安全环境（如TEE、安全芯片）的系统或设备，开启硬件熵源后，将通过HUKS从TEE中获取安全随机数（其熵源为硬件熵源）作为算法库生成随机数的熵源。由于安全环境依赖硬件支持，在开源仓中仅为模拟实现，需OEM厂商适配。当前硬件熵源的实现是通过调用HUKS的相关接口完成的。

本示例主要展示了使用硬件熵源生成安全随机数场景。该示例提供了异步（await）和同步两种调用方式，同时提供了ArkTS和C/C++两种实现方式。该工程中展示的代码详细描述可查如下链接。

效果预览

首页效果图	执行结果图

使用说明

运行Index主界面。
页面呈现上述执行结果图效果，主界面包含以下功能按钮：
- await（异步）：使用异步方式生成硬件熵源随机数
- 同步：使用同步方式生成硬件熵源随机数
- C++测试：使用C++方式生成硬件熵源随机数
点击不同按钮可以跳转到对应功能页面，点击跳转页面中按钮可以执行对应操作，并更新文本内容。
运行测试用例SecureRandomNumberGeneration.test.ets文件对页面代码进行测试可以全部通过。

工程目录

entry/src/
 ├── main
 │   ├── cpp
 │   │   ├── types
 │   │   │   ├── libentry
 │   │   │   │   ├── index.d.ts
 │   │   │   │   └── oh-package.json5
 │   │   │   └── project
 │   │   │       ├── file.h
 │   │   │       └── rand_test.cpp
 │   │   ├── CMakeLists.txt
 │   │   └── napi_init.cpp
 │   ├── ets
 │   │   ├── entryability
 │   │   ├── entrybackupability
 │   │   └── pages
 │   │       ├── Index.ets                    // 使用硬件熵源生成安全随机数主界面
 │   │       ├── Await.ets                    // 异步方式生成随机数
 │   │       ├── Sync.ets                     // 同步方式生成随机数
 │   │       └── CppTest.ets                  // C++测试页面
 │   ├── module.json5
 │   └── resources
 └── ohosTest
     ├── ets
     │   └── test
     │       ├── Ability.test.ets 
     │       ├── SecureRandomNumberGeneration.test.ets  // 自动化测试代码
     │       └── List.test.ets

依赖

不涉及。

约束与限制

1.本示例仅支持标准系统上运行，支持设备：RK3568。

2.本示例为Stage模型，支持API22版本SDK，版本号：6.1.0.17，镜像版本号：OpenHarmony_6.1.0.17。

3.本示例需要使用DevEco Studio 6.0.1 Release(6.0.1.251)及以上版本才可编译运行。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/DocsSample/Security/CryptoArchitectureKit/SecureHardWareRandomNumberGeneration > .git/info/sparse-checkout
git remote add origin https://gitcode.com/openharmony/applications_app_samples.git
git pull origin master

使用硬件熵源生成安全随机数(ArkTS)

介绍

效果预览

使用说明

工程目录

相关权限

依赖

约束与限制

下载