security_huks模块下hks_rkc.c代码评注第三部分

最新推荐文章于 2024-08-13 15:26:49 发布
最新推荐文章于 2024-08-13 15:26:49 发布
阅读量219 收藏
点赞数
分类专栏： OpenHarmony security_function 文章标签： 安全
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/HORHEART/article/details/119957147
版权

security_huks模块下hks_rkc.c代码评注第三部分

本篇概述

本篇接着

继续讲述有关hks_rkc.c代码中关于根密钥组件相关操作的内容。本篇将重点讲解密钥库文件的检查操作、密钥库文件中材料的生成相关操作和方法。

代码结构

hks_rkc.c
├── check
│ └── hks_rkc_chk_ksf
│ └── hks_rkc_chk_all_ksf
├── material
│ └── hks_rkc_get_fixed_material
│ └── hks_rkc_calc_material
│ └── hks_rkc_make_random_material

密钥库文件审查

1. hks_rkc_chk_ksf

  • 函数功能：检查一个密钥库文件
    root key component - check keystore file.

  • 参数说明：密钥库文件名、返回值（状态量）、密钥库文件数据、有效的密钥库文件数据
    parameter:
    ksf_name - [in] - ksf name.
    rc - [in] - return code.
    ksf_data - [in] - ksf data. 实际地址ksf_name下存放的数据
    valid_ksf_data - [in] - valid ksf data. 系统记录中的有效ksf_data

  • 返回值：成功或错误代码
    return value:
    success or error code

详细代码与评注如下：

static int32_t hks_rkc_chk_ksf(const char *ksf_name, int32_t rc,
    const struct hks_rkc_ksf_data *ksf_data,
    const struct hks_rkc_ksf_data *valid_ksf_data)
{
    if ((rc != HKS_STATUS_OK) ||
        memcmp(valid_ksf_data, ksf_data, HKS_RKC_KSF_DATA_SIZE)) {  //memcmp函数的原型为 int memcmp(const void *str1, const void *str2, size_t n));其功能是把存储区 str1 和存储区 str2 的前 n 个字节进行比较。该函数是按字节比较的，位于string.h
        /*
         * If this ksf is different from the first valid ksf,
         * try to overwrite it by the first valid ksf.
         */
        //如果这个ksf与第一个有效的ksf不同，请尝试用第一个有效的ksf覆盖它
        log_error("repair ksf[%s]", ksf_name);
        //将valid_ksf_data中的数据写入名为ksf_name的地址下
        return hks_rkc_write_ksf(ksf_name, valid_ksf_data);
    }

    return HKS_STATUS_OK;
}

2. hks_rkc_chk_all_ksf

  • 函数功能：检查所有的密钥库文件
    root key component - check all keystore files.

  • 参数说明：所有密钥库文件的返回值、所有密钥库文件的数据、有效密钥库文件数据、有效密钥库文件索引
    parameter:
    all_ksf_rc - [in] - all reture code.
    all_ksf_data - [in] - all data. 实际上的密钥库文件数据
    valid_ksf_data - [in] - the first valid data. 记录中有效密钥库文件数据
    valid_ksf_index - [in] - the index of first valid data.

  • 返回值：成功或错误代码
    return value:
    success or error code

检查所有密钥库文件是建立在检查单个密钥库文件的基础上进行完成的，因此该部分函数中有对hks_rkc_chk_ksf函数的调用。详细代码与评注如下：

static int32_t hks_rkc_chk_all_ksf(const int32_t *all_ksf_rc,
    const struct hks_rkc_ksf_data *all_ksf_data,
    const struct hks_rkc_ksf_data *valid_ksf_data, uint32_t valid_ksf_index)
{
    //检查密钥库文件数是否满足预定义要求
    if (g_hks_rkc_cfg.ksf_attr.num > HKS_RKC_KSF_NUM) {
        log_error("invalid ksf num=%u", g_hks_rkc_cfg.ksf_attr.num);
        return HKS_ERROR_INTERNAL_UNKOWN;
    }

    uint32_t i = 0;

    for (; i < g_hks_rkc_cfg.ksf_attr.num; ++i) {
        if (i == valid_ksf_index)
            continue;

        if (g_hks_rkc_cfg.ksf_attr.name[i] == NULL)
            continue;

        /*循环检查密钥库文件，检查地址（名）由根密钥组件配置提供，
        将检查返回值存入all_ksf_rc中、数据按照索引存入all_ksf_data并且跟valid_ksf_data进行对比，
        对比结果返回到rc中*/
        int32_t rc = hks_rkc_chk_ksf(g_hks_rkc_cfg.ksf_attr.name[i],
            all_ksf_rc[i], all_ksf_data + i, valid_ksf_data);

        if (rc != HKS_STATUS_OK) {
            log_error("check ksf fail,i=%u,rc=%d", i, rc);
            continue;
        }
    }

    return HKS_STATUS_OK;
}

密钥库材料的生成

1. hks_rkc_get_fixed_material

  • 函数功能：获得修复材料（材料的重置）
    root key component - get fixed material

  • 参数说明：输出：修复后的材料；输入：材料的长度
    parameter:
    material - [out] - fixed material.
    len - [in] - the length of material, it should be 32 bytes.

  • 返回值：成功或错误代码
    return value:
    success or error code

获得根密钥组件得修复材料实质上就是对源材料的重置，改代码并没有采用随机化的方法，而是通过直接定义（赋值）来完成的重置工作。详细代码如下：

static int32_t hks_rkc_get_fixed_material(uint8_t *material, uint32_t len)
{
    //定义修复后的材料数组fixed_material[],相当于一种重置
    const uint8_t fixed_material[HKS_RKC_MATERIAL_LEN] = {
        0xB2, 0xA1, 0x0C, 0x73, 0x52, 0x73, 0x76, 0xA1,
        0x60, 0x62, 0x2E, 0x08, 0x52, 0x08, 0x2E, 0xA9,
        0x60, 0xBC, 0x2E, 0x73, 0x52, 0x0B, 0x0C, 0xBC,
        0xEE, 0x0A, 0x2E, 0x08, 0x52, 0x9C, 0x76, 0xA9
    };

    //将fixed_material地址下的内容安全复制到material中
    int32_t rc = memcpy_s(material, len, fixed_material,
        HKS_RKC_MATERIAL_LEN);

    if (rc != HKS_STATUS_OK)
        return HKS_ERROR_INTERNAL_UNKOWN;

    return rc;
}

该部分需要注意的一点是函数memcpy_s的调用，它的功能是fixed_material地址下的内容安全复制到material中，详细的函数定义及使用方法详见：memcpy_s与wmemcpy_s函数的理解。

2. hks_rkc_calc_material

  • 函数功能：创建随机材料
    root key component - make random material

  • 参数说明：第一个随机数、第一个随机数的长度、第二个随机数、第二个随机数的长度、密钥库文件数据
    parameter:
    random1 - [in] - the first random number.
    random1_len - [in] - the length of first random number.
    random2 - [in] - the second random number.
    random2_len - [in] - the length of second random number.
    ksf_data - [in,out] - the data of keystore file.

  • 返回值：成功或错误代码
    return value:
    success or error code

与上个函数不同的是，hks_rkc_calc_material是利用随机数结合哈希算法SHA256创建随机材料，详细的代码及评注如下：

static int32_t hks_rkc_calc_material(const uint8_t *random1, uint32_t random1_len,
    const uint8_t *random2, uint32_t random2_len,
    struct hks_rkc_ksf_data *ksf_data)
{
    //两种材料的序列号分别定义为1和2
    /* two material sequence number */
    uint8_t material_sn[HKS_RKC_MATERIAL_NUM] = {
        HKS_RKC_MATERIAL1_SN, HKS_RKC_MATERIAL2_SN
    };

    //hash源的个数，此处定为3
    /* hash source number */
    uint32_t hash_src_num = HKS_RKC_MATERIAL_HASH_SRC_NUM_NO_E;
    //根密钥组件材料的hash源定义，定义了4个
    /* hash source */
    struct hks_blob hash_src[HKS_RKC_MATERIAL_HASH_SRC_NUM] = {
        { 0, NULL, 0 }, { 0, NULL, 0 }, { 0, NULL, 0 }, { 0, NULL, 0 }
    };
    //hash结果定义，根密钥组件数=hash结果数
    /* hash result */
    struct hks_blob hash_result[HKS_RKC_MATERIAL_NUM] = {
        { 0, NULL, 0 }, { 0, NULL, 0 }
    };

    /* 计算材料
     *  calculate material
     *  material1: SHA256(0x1 + R1 + R2 + E) 材料一使用的SHA256算法规则
     *  material2: SHA256(0x2 + R1 + R2 + E) 材料一使用的SHA256算法规则
     */
    //hash源的初始化
    hash_src[HKS_RKC_MATERIAL_HASH_SRC_R1].data = random1;
    hash_src[HKS_RKC_MATERIAL_HASH_SRC_R1].size = random1_len;
    hash_src[HKS_RKC_MATERIAL_HASH_SRC_R2].data = random2;
    hash_src[HKS_RKC_MATERIAL_HASH_SRC_R2].size = random2_len;

    //熵是可选择的
    /* the entropy is optional. */
    if (g_hks_rkc_cfg.entropy != NULL) {
        hash_src_num = HKS_RKC_MATERIAL_HASH_SRC_NUM;
        //HKS_RKC_MATERIAL_HASH_SRC_E 是熵的索引（3）
        hash_src[HKS_RKC_MATERIAL_HASH_SRC_E].data =
            g_hks_rkc_cfg.entropy;
        hash_src[HKS_RKC_MATERIAL_HASH_SRC_E].size =
            g_hks_rkc_cfg.entropy_len;
    }

    //两种材料将作为散列结果输出，此处为hash_result赋ksf_data中主密钥材料的原值
    /* Two material would be ouput as hash result. */
    hash_result[HKS_RKC_HASH_RESULT_MATERIAL1].data =
        ksf_data->rk_material1;
    hash_result[HKS_RKC_HASH_RESULT_MATERIAL1].size =
        HKS_RKC_MATERIAL_LEN;
    hash_result[HKS_RKC_HASH_RESULT_MATERIAL2].data =
        ksf_data->rk_material2;
    hash_result[HKS_RKC_HASH_RESULT_MATERIAL2].size =
        HKS_RKC_MATERIAL_LEN;

    //用SHA256（Secure Hash Algorithm 256）来生成两种材料
    /* generate two material by SHA256 */
    int32_t rc;
    uint32_t i = 0;

    for (; i < HKS_RKC_MATERIAL_NUM; ++i) {  //两次循环调用hks_calc_sha256，生成两个密钥材料存入hash_result中
        hash_src[HKS_RKC_MATERIAL_HASH_SRC_SN].data = &(material_sn[i]);
        hash_src[HKS_RKC_MATERIAL_HASH_SRC_SN].size = sizeof(uint8_t);
        rc = hks_calc_sha256(hash_src, hash_src_num, &(hash_result[i]));
        if (rc != HKS_STATUS_OK) {
            log_error("calc hash fail,rc=%d,i=%u", rc, i);
            return rc;
        }
    }

    return rc;
}

本部分的关键在调用了hks_calc_sha256，该函数利用SHA256算法能够将hash源生成我们想要的hash散列值，其中调用了mbedlts库中有关SHA-256算法组件，有关mbedlts组件的介绍详见：单向散列算法的配置与使用。

3. hks_rkc_make_random_material

  • 函数功能：创建随机材料，调用函数hks_rkc_calc_material
    root key component - make random material

  • 参数说明：密钥库文件数据
    parameter:
    ksf_data - [in,out] - the data of keystore file.

  • 返回值：成功或失败代码
    return value:
    success or error code

该部分函数较hks_rkc_calc_material的区别是传入参数中没有随机数，随机数需要调用hks_gen_random生成，而创建随机材料的方法则是通过调用hks_rkc_calc_material函数。详细代码及评注如下：

static int32_t hks_rkc_make_random_material(struct hks_rkc_ksf_data *ksf_data)
{
    //定义两个随机变量
    /* two random number */
    uint8_t random1[HKS_RKC_MATERIAL_LEN] = {0};
    uint8_t random2[HKS_RKC_MATERIAL_LEN] = {0};

    int32_t rc;

    do {
        //生成两个随机数分别存入random1、random2
        /* Generate 32*2 random number: R1 + R2 */
        rc = hks_gen_random(random1, HKS_RKC_MATERIAL_LEN);
        if (rc != HKS_STATUS_OK) {
            log_error("generate random1 fail,rc=%d", rc);
            break;
        }

        rc = hks_gen_random(random2, HKS_RKC_MATERIAL_LEN);
        if (rc != HKS_STATUS_OK) {
            log_error("generate random2 fail,rc=%d", rc);
            break;
        }

        //计算材料，将材料结果存入ksf_data中
        /* calculate material */
        rc = hks_rkc_calc_material(random1, HKS_RKC_MATERIAL_LEN,
            random2,
            HKS_RKC_MATERIAL_LEN, ksf_data);
        if (rc != HKS_STATUS_OK)
            break;
    } while (0);

    //随机数变量需要被释放空间，以确保安全
    /* the random number should be cleared after use */
    (void)memset_s(random1, sizeof(random1), 0, sizeof(random1));
    (void)memset_s(random2, sizeof(random2), 0, sizeof(random2));

    return rc;
}

本篇小结

本篇主要讲解密钥库文件的检查操作、密钥库文件中材料的生成相关操作和方法，往后会继续更新hks_rkc.c中更多函数及函数定义方法、内容及操作，敬请期待。

心永向阳
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
OpenHarmony解读之设备认证：数据接收管理-获取HiChain实例(4)
weixin_46669761的博客
05-28 852
一、概述 上一篇博客 OpenHarmony解读之设备认证：数据接收管理-获取HiChain实例(3)重点介绍了在生成本端长期存储的密钥对的过程中服务id的生成，本文将介绍后续两个阶段：密钥别名的生成过程以及密钥对的生成过程。 二、源码分析 这一模块的源码位于：/base/security/deviceauth。 密钥别名的生成过程主要是在函数generate_key_alias中实现的，对该函数以及相关数据结构的详细分析如下： /* 函数功能：通过服务id和认证id生成密钥别名 函数参数： s
security_huks模块下hks_rkc.h代码评注
HORHEART的博客
08-20 177
security_huks模块下hks_rkc.h代码评注本篇综述代码框架关键代码展开1. 枚举类型定义2. 预编译模块3. 结构体定义4. 函数声明本篇小结 本篇综述 本篇主要讲解hks_rkc头文件代码的主要内容。hks_rkc.h中主要定义了有关RKC（root key component）根密钥组件相关的一系列结构体、枚举类型、预编译以及函数声明部分，对hks_rkc.h的了解有助于我们进一步对hks_rkc.c的理解。因此，本篇我们会重点讲解hks_rkc.h中含有的关键定义，为hks_rkc.c
鸿蒙源码分析（十八）
安辰的博客
08-07 1553
文章目录hks_access.c代码分析一、背景知识二、hks_accesss.c代码详细分析2.1前期准备2.2 状态值status的获取返回原理2.3 根据不同命令申请空间并定义总结 hks_access.c代码分析 本篇主题：本篇博客主要分析hks_access.c相关代码 文件路径（security_huks\frameworks\huks_lite\source\hw_keystore_sdk\hks_access.c） 一、背景知识 hks_access.h介绍 access.c中主要用到两种
鸿蒙源码分析（十五）
安辰的博客
08-05 335
security_huks模块framework中hks_access.h分析 本文主要分析hks_access.h所定义的一些结构体 文件路径"\security_huks\frameworks\huks_lite\source\hks_access.h" 一、结构体 1. hks_types.h中结构体变量定义 hks_blob该结构体在hks_access.h常用来定义密钥变量，主要有三个参数组成：type类型，data数组，size大小。 struct hks_blob { uint8_t
security_huks/services/huks_standard/huks_engine/hks_auth+huks_core_service解读(一)
Enternalwiser的博客
08-27 387
warpKey模式简介。huks_core_service+hks_auth代码解读
鸿蒙security-huks的层次分析-国家一级假勤奋大学生制作
11-20
鸿蒙操作系统中的security_huks是其安全框架的重要组成部分，主要用于处理加密、解密、签名等安全相关的任务。本文将深入解析security_huks的各层次结构，帮助开发者理解和掌握其核心功能。 1. **frameworks层** -...
Hi3861_海思官方_安全模块使用指南1
08-04
【Hi3861安全模块使用指南】 本文档是针对Hi3861V100和Hi3861LV100芯片的安全模块使用的详细介绍，由上海海思技术有限公司编写并拥有版权。该指南旨在帮助技术支持工程师和软件开发工程师理解并有效利用安全模块的...
HarmonyOS应用开发者高级认证 word试题及答案
12-21
4. **配置文件**：oh-package.json用于管理第三方库的包依赖。 5. **发布流程**：发布应用时需创建发布Profile，选择发布类型，发布后应用可在华为应用市场获取。 **四、测试与发布** 1. **开放式测试**：发布后，...
鸿蒙高级开发者认证题库
05-21
**3. 前后端开发语言** - **错误判断：** 开发者需要精通前后端不同的开发语言。 - HarmonyOS支持使用一套代码在多个平台上运行，这意味着开发者可以使用单一语言（如JS）来编写前端和后端逻辑。 **4. 首选项存储*...
[练习题+答案]Harmony OS应用开发者高级认证
06-01
- **知识点21**：HUKS(通用密钥库系统)为HarmonyOS提供了一整套密钥管理和加密解密的功能，是确保应用数据安全的重要组成部分。 - **知识点22**：关于容器组件`Row`和`Column`的描述，二者确实存在主轴和交叉轴的...
Huks功能之frameworks解析:hks_access.h hks_access.c cipher.h cipher.c
weixin_50294842的博客
09-04 1158
openHarmony中的安全子系统huks为应用提供密钥库及密钥管理功能，包括密钥的生成，删除，更新。 为系统下应用提供KeyStore密钥库管理以及Crypto密钥密码学相关操作。
[HUKS]DtFuzz用例编写测试流程
qq_41568681的博客
06-15 2171
HUKS测试DTFuzz流程
Linux安全与高级应用（十三）深入解析Linux中的rsync远程同步：原理、配置与应用
最新发布
洛秋的博客
08-13 589
1.1 rsync的基本原理rsync（Remote Sync）是一种用于本地或远程的文件同步工具。与传统的文件拷贝工具不同，rsync的核心优势在于其增量同步的特性，即只传输源和目标之间不同的文件部分，极大地减少了数据传输量。rsync支持通过SSH或直接使用rsync协议进行数据同步，这使得它在跨网络的大数据备份中表现尤为出色。1.2 rsync的优势增量备份：只同步差异文件或文件的变化部分，大幅减少网络传输量和时间。安全性：通过SSH加密通道进行传输，保障数据的安全。灵活性。
在亚马逊云科技上安全、合规、私密地调用生成式AI大模型
m0_66628975的博客
08-13 1910
Amazon Bedrock 是亚马逊云科技提供的一项服务，旨在帮助开发者轻松构建和扩展生成式 AI 应用。Bedrock 提供了访问多种强大的基础模型（Foundation Models）的能力，支持多种不同大模型厂商的模型，如AI21 Labs, Anthropic, Cohere, Meta, Mistral AI, Stability AI, 和Amazon，用户可以使用这些模型来创建、定制和部署各种生成式 AI 应用程序，而无需从头开始训练模型。
H5直播行业的安全挑战：为何害怕黑客攻击？
@云安全小杜
08-13 294
随着移动互联网的快速发展，H5直播因其便捷性和互动性成为众多平台的选择。然而，这种开放性和交互性也带来了安全风险，使得H5直播行业成为了黑客攻击的目标之一。本文将探讨H5直播面临的常见威胁，并提供一些基本的防御措施。
安全无忧！Windows7全补丁旗舰版：集成所有补丁！
lihuiyun184291的博客
08-13 316
今日，系统之家小编给大家分享集成所有补丁的Windows7旗舰版系统，集成至2023.12所有官方补丁，修复了系统高危漏洞，让大家时刻都能舒心地展开操作。系统基于微软 Windows 7 2009 SP1 旗舰版进行离线制作，全新升级的优化方案，系统性能更好，运作更加流畅，且系统安装步骤简单易懂，支持硬盘安装。
某通电子文档安全管理系统 CDGAuthoriseTempletService1接口SQL注入漏洞复现 [附POC]
薛定谔嘚喵博客
08-09 570
某通电子文档安全管理系统的 CDGAuthoriseTempletService1 接口存在 SQL 注入漏洞。 攻击者可以通过构造特定的POST 请求注入恶意 SQL代码，利用该漏洞对数据库执行任意 SQL 操作，获取所有用户的账户密码信息，破解md5值后可直接接管后台，导致系统处于极不安全的状态。
自学黑客（网络安全）
热门推荐
2301_77160226的博客
08-05 2万+
想自学网络安全（黑客技术）首先你得了解什么是网络安全！什么是黑客！网络安全可以基于攻击和防御视角来分类，我们经常听到的 “红队”、“渗透测试” 等就是研究攻击技术，而“蓝队”、“安全运营”、“安全运维”则研究防御技术。无论网络、Web、移动、桌面、云等哪个领域，都有攻与防两面性，例如 Web 安全技术，既有 Web 渗透，也有 Web 防御技术（WAF）。作为一个合格的网络安全工程师，应该做到攻守兼备，毕竟知己知彼，才能百战百胜。
访问网站显示不安全打不开怎么办如何处理
playis的博客
08-09 427
当访问网站时浏览器提示“不安全”，这通常是由于多种原因造成的。
安全基础学习-RC4加密算法
小夭的博客
08-13 596
密钥调度算法 (KSA)：用密钥打乱一个初始数组。伪随机数生成算法 (PRGA)：使用打乱后的数组生成伪随机字节流。加密/解密：将明文与伪随机字节流异或生成密文，反过来也是一样的。RC4因其简单性和高效性被广泛使用，但其安全性在现代已经不再被推荐，尤其是当密钥长度不足或者使用不当时，可能会导致加密被破解。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值