内部状态

代表随机数生成器内存中的数值，当内部状态相同时，随机数生成器会生成固定的随机数序列。
随机种子

一个用来对伪随机数的内部状态进行初始化的数据，随机数生成器通过种子来生成一系列的随机序列。

当前OpenSSL实现方式，随机数生成器内部状态是不断变化的，即使设置相同的种子，生成的随机数序列也不会相同。

支持的算法与规格

随机数生成算法使用OpenSSL的RAND_priv_bytes接口生成安全随机数。

算法	长度（Byte）
CTR_DRBG	[1, INT_MAX]

开发步骤

调用cryptoFramework.createRandom，生成随机数实例。
（可选）设置DataBlob数据，调用Random.setSeed，为随机数生成池设置种子。
设置指定字节长度，调用Random.generateRandom或Random.generateRandomSync，生成安全随机数。

指定字节长度范围为1~INT_MAX。

通过await返回异步结果：

import { cryptoFramework } from '@kit.CryptoArchitectureKit';
import { BusinessError } from '@kit.BasicServicesKit';

async function doRand() {
  try {
    let rand = cryptoFramework.createRandom();
    let seed = new Uint8Array([1, 2, 3]);
    rand.setSeed({ data: seed });
    let len = 12;
    let randOutput = await rand.generateRandom(len);
    console.info('rand output: ' + randOutput.data);
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error(`call failed: errCode: ${e.code}, errMsg: ${e.message}`);
  }
}

同步返回结果：

import { cryptoFramework } from '@kit.CryptoArchitectureKit';
import { BusinessError } from '@kit.BasicServicesKit';

function doRandBySync() {
  let rand = cryptoFramework.createRandom();
  let len = 24; // 生成一个24字节的随机数。
  try {
    let randData = rand.generateRandomSync(len);
    if (randData.data.length !== 0) {
      console.info('[Sync]: rand result: ' + randData.data);
    } else {
      console.error('[Sync]: get rand result: fail!');
    }
  } catch (error) {
    let e: BusinessError = error as BusinessError;
    console.error(`do rand failed: errCode: ${e.code}, message: ${e.message}`);
  }
}

目录

安全随机数生成(ArkTS)

支持的算法与规格

开发步骤