harmony 鸿蒙security子系统ChangeLog

  • 2023-02-17
  • 浏览 (664)

security子系统ChangeLog

cl.security.1 ParamsSpec属性名变更为algName。

结构体ParamsSpec的属性algoName由于API命名统一,名称更改为algName。

变更影响

影响已发布的JS接口,对ParamsSpec以及其子类IvParamsSpec,GcmParamsSpec与CcmParamsSpec,使用这些对象作为参数或返回值时,其属性名需要更改为algName。 应用需要进行适配,才可以在新版本SDK环境正常编译通过。

关键的接口/组件变更

修改前的接口原型:

interface ParamsSpec {
    /**
     * Indicates the algorithm name. Should be set before initialization of a cipher object.
     * @type { string }
     * @syscap SystemCapability.Security.CryptoFramework
     * @since 9
     */
    algoName : string;
}

修改后的接口原型:

interface ParamsSpec {
    /**
     * Indicates the algorithm name. Should be set before initialization of a cipher object.
     * @type { string }
     * @syscap SystemCapability.Security.CryptoFramework
     * @since 9
     */
    algName : string;
}

适配指导

对ParamsSpec以及其子类IvParamsSpec,GcmParamsSpec与CcmParamsSpec,使用这些对象作为参数或返回值时,其属性名需要从algoName更改为algName。

function genGcmParamsSpec() {
  let arr = [0, 0, 0, 0 , 0, 0, 0, 0, 0, 0 , 0, 0]; // 12 bytes
  let dataIv = new Uint8Array(arr);
  let ivBlob = {data : dataIv};

  arr = [0, 0, 0, 0 , 0, 0, 0, 0]; // 8 bytes
  let dataAad = new Uint8Array(arr);
  let aadBlob = {data : dataAad};

  arr = [0, 0, 0, 0 , 0, 0, 0, 0, 0, 0, 0, 0 , 0, 0, 0, 0]; // 16 bytes
  let dataTag = new Uint8Array(arr);
  let tagBlob = {data : dataTag};
  let gcmParamsSpec = {iv : ivBlob, aad : aadBlob, authTag : tagBlob, algName : "GcmParamsSpec"};
  return gcmParamsSpec;
}

详细查看API参考中ParamsSpec对应的接口适配指南: 加解密算法库框架-ParamsSpec-API参考

cl.security.2 ECC密码算法的参数名从ECC512变更为ECC521

变更影响

影响已发布的JS接口,接口行为发生变更。 应用需要进行适配,才可以在新版本SDK环境获取正确结果。

关键的接口/组件变更 发布的JS接口不变, 传入接口的参数发生变化,由ECC512变化为ECC521,具体可见加解密算法库框架-ECC密码算法参数参考,涉及的接口有:

cryptoFramework.createAsyKeyGenerator

cryptoFramework.createSign

cryptoFramework.createVerify

cryptoFramework.createKeyAgreement

适配指导

import cryptoFramework from "@ohos.security.cryptoFramework"

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

你可能感兴趣的鸿蒙文章

harmony 鸿蒙程序访问控制子系统ChangeLog

harmony 鸿蒙软总线子系统ChangeLog

harmony 鸿蒙web子系统ChangeLog

harmony 鸿蒙帐号子系统ChangeLog

harmony 鸿蒙arkui子系统ChangeLog

harmony 鸿蒙包管理子系统ChangeLog

harmony 鸿蒙公共事件子系统ChangeLog

harmony 鸿蒙文件管理子系统ChangeLog

harmony 鸿蒙剪贴板子系统ChangeLog

harmony 鸿蒙电源子系统ChangeLog

0  赞