feifei.xu/autosar_standard_spec_v4.4
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
79acbf4cbe671a8bd5cb83a7916a8c40e14a559d
autosar_standard_spec_v4.4/Crypto/AUTOSAR_SWS_CryptoServiceManager.md
T

54 KiB
Raw Blame History

加密服务管理器规范 (Specification of Crypto Service Manager)

AUTOSAR CP Release 4.4.0

翻译说明：本文档为 AUTOSAR 经典平台 (CP) Release 4.4.0 中 SWS 文档 402《Specification of Crypto Service Manager》的中文翻译版本。原始英文文档中的 AUTOSAR 方框符 ⌈⌋、API 标识符（如 Csm_Hash、Csm_Encrypt）、模块缩写（Crypto、CryIf、Csm、KeyM 等）、加密算法名（AES、SHA、RSA、ECC 等）以及需求 ID（如 SWS_Csm_xxxxx）均予以保留。本文采用"重点翻译 + 摘要"策略：完整翻译封面、标识、变更历史、目录、关键 API 及核心概念；客户端-服务器接口详细定义和大量重复配置容器描述予以摘要处理。

文档标识

项目 内容
文档标题 (Document Title) Specification of Crypto Service Manager（加密服务管理器规范）
文档所有者 (Document Owner) AUTOSAR
文档责任方 (Document Responsibility) AUTOSAR
文档标识号 (Document Identification No) 402
文档状态 (Document Status) Final
所属 AUTOSAR 标准 Classic Platform
所属标准版本 (Part of Standard Release) 4.4.0

文档变更历史 (Document Change History)

日期 版本 变更者 变更描述
2018-10-31 4.4.0 AUTOSAR Release Management 客户端-服务器接口 Csm<Service>_{Config}；纠正 CS 接口；移除对 CryptoAbstractionLibrary 的引用
2017-12-08 4.3.1 AUTOSAR Release Management 添加非对称密钥格式定义；错误修复和一致性改进；编辑性修订
2016-11-30 4.3.0 AUTOSAR Release Management 引入加密作业概念；引入密钥管理概念；从 Csm 中移除 Cry_XXX 函数并在加密栈中引入两个新层：加密接口 (CryIf) 和加密驱动 (Crypto)
2015-07-31 4.2.2 AUTOSAR Release Management 在所有 API 函数中将返回类型从 Csm_ReturnType 更改为 Std_Types；添加 RTE 接口的详细描述；调试支持标记为过时；错误修复和一致性改进
2014-10-31 4.2.1 AUTOSAR Release Management 删除过时的配置元素；错误修复和一致性改进；编辑性修订
2014-03-31 4.1.3 AUTOSAR Release Management 错误修复和一致性改进；编辑性修订
2013-10-31 4.1.2 AUTOSAR Release Management 错误修复和一致性改进；编辑性修订；删除变更文档章节
2013-03-15 4.1.1 AUTOSAR Administration 添加压缩/解压缩服务；添加密钥更新服务（概念"CSM extension"）；添加对称密钥生成服务（概念"CSM extension"）；服务状态机更改以通过释放锁定的资源来应对终止的用户；重组生产错误
2011-12-22 4.0.3 AUTOSAR Administration 修复 AUTOSAR 端口接口的问题
2010-09-30 3.1.5 AUTOSAR Administration 完整的配置参数；完整的 API 规范；添加对安全密钥存储的支持；集成对密钥传输服务的支持；引入新的 DET 错误（在 getversion info 中检查空指针）
2010-02-02 3.1.4 AUTOSAR Administration 初始发布

目录 (Table of Contents)

1 引言与功能概述

本规范规定了软件模块加密服务管理器 (CSM) 的功能、API 和配置，以满足 CSM 需求规范 (SRS) [CSM_SRS] 中表示的顶层需求。

CSM 应提供同步或异步服务，以使所有软件模块能够唯一访问基本加密功能。CSM 应提供一个抽象层，为更高软件层提供对这些功能的标准化访问。

不同软件模块所需的功能可能彼此不同。因此，应可能为每个软件模块单独配置和初始化 CSM 提供的服务。此配置还包括 CSM 服务的同步或异步处理的选择。

CSM 模块的构造遵循通用方法。在会对 CSM 的可用性范围施加限制的地方，接口和结构以通用方式定义。这为未来的扩展提供了机会。

2 缩略语和缩写

具有局部范围且因此不包含在 AUTOSAR 术语表 [13] 中的缩略语和缩写在本章中列出。

缩写 描述
AEAD 带关联数据的认证加密 (Authenticated Encryption with Associated Data)
CDD 复杂驱动 (Complex Device Driver)
CSM 加密服务管理器 (Crypto Service Manager)
CRYIF 加密接口 (Crypto Interface)
CRYPTO 加密驱动 (Crypto Driver)
DET 默认错误追踪器 (Default Error Tracer)
HSM 硬件安全模块 (Hardware Security Module)
HW 硬件 (Hardware)
SHE 安全硬件扩展 (Security Hardware Extension)
SW 软件 (Software)

2.1 术语表

术语 描述
Crypto Driver Object (加密驱动对象) 一个 Crypto Driver 实现一个或多个 Crypto Driver Object。Crypto Driver Object 可在硬件或软件中提供不同的加密原语。同一 Crypto Driver 的各 Crypto Driver Object 之间相互独立。每个 Crypto Driver Object 仅有一个工作区（即同一时刻只能执行一种加密原语）。
Key (密钥) 密钥可由 Csm 中的作业引用。在 Crypto Driver 中，密钥引用特定的密钥类型。
Key Type (密钥类型) 密钥类型由对若干密钥元素的引用构成。密钥类型通常由 Crypto Driver 的供应商预配置。
Key Element (密钥元素) 密钥元素用于存储数据。该数据可以是例如密钥材料，或 AES 加密所需的 IV。它也可用于配置密钥管理功能的行为。
Job (作业) 作业是已配置对象，包含对密钥和加密原语的引用。
Channel (通道) 通道是从 CSM 队列经 Crypto Interface 到特定 Crypto Driver Object 的路径。
Crypto Primitive (加密原语) 加密原语是已配置的、由 Crypto Driver Object 实现的加密算法的一个实例。
Operation (操作) 加密原语的操作声明应执行该加密原语的哪一部分。有三种不同的操作： START：表示加密原语的全新请求，应取消所有先前的请求，执行必要的初始化并检查是否可以处理加密原语； UPDATE：表示加密原语期望输入数据。更新操作可以提供中间结果； FINISH：表示在此部分之后所有数据均已完全送入，加密原语可以完成计算。完成操作可以提供最终结果。也可以通过将 operation_mode 参数的对应位串接在一起，一次执行多个操作。
Priority (优先级) 作业的优先级定义其重要性。优先级越高（值越大），作业被越立即地执行。加密作业的优先级是配置的一部分。
Processing (处理模式) 指示作业的处理方式。 异步 (Asynchronous)：调用对应函数时作业不会立即被处理。通常，当作业完成时通过回调函数通知调用者。 同步 (Synchronous)：调用对应函数时作业被立即处理。函数返回时即可获得结果。

3 相关文档

3.1 输入文档

  • [1] List of Basic Software Modules — AUTOSAR_TR_BSWModuleList.pdf
  • [2] Layered Software Architecture — AUTOSAR_EXP_LayeredSoftwareArchitecture.pdf
  • [3] General Requirements on Basic Software Modules — AUTOSAR_SRS_BSWGeneral.pdf
  • [4] Specification of RTE Software — AUTOSAR_SWS_RTE.pdf
  • [5] Specification of BSW Scheduler — AUTOSAR_SWS_Scheduler.pdf
  • [6] Specification of ECU Configuration — AUTOSAR_TPS_ECUConfiguration.pdf
  • [7] Specification of Memory Mapping — AUTOSAR_SWS_MemoryMapping.pdf
  • [8] Specification of Default Error Tracer — AUTOSAR_SWS_DefaultErrorTracer.doc.pdf
  • [9] Specification of Diagnostic Event Manager — AUTOSAR_SWS_DiagnosticEventManager.pdf
  • [10] Specification of ECU State Manager — AUTOSAR_SWS_ECUStateManager.pdf
  • [11] Specification of C Implementation Rules — AUTOSAR_TR_CImplementationRules.pdf
  • [12] Specification of Standard Types — AUTOSAR_SWS_StandardTypes.pdf
  • [13] AUTOSAR Glossary — AUTOSAR_TR_Glossary.pdf
  • [14] Requirements on the Crypto Stack — AUTOSAR_SRS_CryptoStack.pdf
  • [15] Specification of the Crypto Interface — AUTOSAR_SWS_CryptoInterface.pdf
  • [16] Specification of the Crypto Driver — AUTOSAR_SWS_CryptoDriver.pdf
  • [17] General Specification of Basic Software Modules — AUTOSAR_SWS_BSWGeneral.pdf

3.2 相关标准和规范

  • [18] IEC 7498-1 The Basic Model, IEC Norm, 1994

3.3 相关规范

AUTOSAR 提供了基础软件模块通用规范 (SWS BSW General)，该规范同样适用于加密服务管理器。因此，SWS BSW General 应被视为加密服务管理器的附加且必需的规范。

4 约束和假设

4.1 限制

CSM 的一些类型定义以前缀"CRYPTO_"开头，这违反了 SRS_BSW_00305。这将在 4.3.1 版本中协调。尽管如此，根据约束 [constr_1050] 第 1 部分，端口仍被认为是兼容的。

4.2 对汽车域的适用性

不适用。

4.3 安全影响

CSM 中没有用户管理机制可防止对 CSM 任何服务的非授权访问。这意味着，如果需要任何访问保护，则必须由应用程序和由 CSM 服务的加密库模块实现；访问保护不是 CSM 的目标。

5 对其他模块的依赖

[SWS_Csm_00001] ⌈ CSM 应能够访问加密接口 (CRYIF)，该接口是根据加密接口规范实现的。⌋(SRS_CryptoStack_00082)

[SWS_Csm_00506] ⌈ CSM 模块应使用 CRYIF 与底层加密驱动 (CRYPTO) 的接口来计算加密服务的结果。⌋(SRS_CryptoStack_00082)

Crypto Driver 的合并加密库模块或硬件扩展提供加密例程，例如 SHA-1、RSA、AES、Diffie-Hellman 密钥交换等。

5.1 文件结构

5.1.1 代码文件结构

[SWS_Csm_00002] ⌈ 代码文件结构不应在本规范中完整定义。CSM 模块应由以下部分组成。⌋()

6 需求可追溯性

完整可追溯性表（涵盖 SRS_BSW_00101、SRS_BSW_00358、SRS_BSW_00359、SRS_BSW_00360、SRS_BSW_00373、SRS_BSW_00407、SRS_BSW_00414、SRS_BSW_00432、SRS_CryptoStack_00008 到 SRS_CryptoStack_00103、SRS_CrytptoStack_xxxxx、SWS_Csm_00066、SWS_BSW_00050、SWS_BSW_00216 等到 SWS_Csm_xxx 的映射）请参阅原始 PDF 文档第 14-16 页。

7 功能规范

AUTOSAR 分层视图

AUTOSAR 分层视图中带有 CSM

7.1 基本架构指南

CSM 模块设计的描述起点是 AUTOSAR 分层软件架构。基于 AUTOSAR 分层软件架构的 CSM 模块架构描述应有助于理解后续章节中 CSM 模块的接口和功能规范。

AUTOSAR 的架构由多层组成，可以在 AUTOSAR 分层视图中看到。服务层是基础软件中的最高层。其任务是为应用程序和基础软件模块提供基本服务，即为应用软件和基础软件模块提供最相关的功能。

CSM 是提供加密功能的服务，基于依赖软件库或硬件模块的加密驱动。也可能存在具有多个加密驱动的混合设置。CSM 通过 CRYIF 访问不同的 CryptoDrivers。

7.2 通用行为

[SWS_Csm_00941] ⌈ 作业是已配置的加密原语的一个实例。⌋()

[SWS_Csm_00016] ⌈ 对于每个作业，CSM 一次只能处理一个实例。⌋()

[SWS_Csm_00022] ⌈ CSM 模块应允许并行处理不同的作业。⌋(SRS_CryptoStack_00009)

[SWS_Csm_00017] ⌈ 如果请求 CSM 模块的服务，并且相应的作业正在处理，则应使用返回值 CRYPTO_E_BUSY 拒绝该作业请求。⌋()

注意："作业正在处理"意味着相应的加密驱动对象当前正在主动处理此作业。当作业未完成但加密驱动对象未主动处理它时（例如因为 "FINISH" 操作尚未完成），这并不意味着该作业正在处理。

[SWS_Csm_00019] ⌈ 如果配置了异步接口，CSM 模块应提供主函数 Csm_MainFunction()，该函数被周期性调用以通过状态机控制作业的处理。⌋()

7.2.1 正常运行

[SWS_Csm_01039] ⌈ 为了统一加密服务的单次调用函数和流式方法，存在一个 mode 参数，确定操作模式。此服务操作是一个标志字段，指示操作模式 "START"、"UPDATE" 或 "FINISH"。它显式声明应执行哪些操作。这些操作模式可以混合，并且可以一次执行多个操作。[SWS_Csm_00024] 中的图显示了此设计的作业状态机。⌋(SRS_CryptoStack_00084)

注意：状态的实际转换在与这些状态一起工作的层中进行，即在加密驱动中。

[SWS_Csm_00024] ⌈ （作业状态机图）⌋()

[SWS_Csm_01033] ⌈ CSM 加密服务应支持通过单次调用处理多个操作模式输入。⌋()

[SWS_Csm_01045] ⌈ 如果设置了 CRYPTO_OPERATIONMODE_START 和 CRYPTO_OPERATIONMODE_FINISH 位，而未设置 CRYPTO_OPERATIONMODE_UPDATE，则 Csm_<Service>() 函数应返回 E_NOT_OK。⌋()

注意：一致的单次调用方法可以通过较少的开销提高性能。无需多次调用显式 API，只需一次调用即可。此方法旨在与需要快速处理的小数据输入一起使用。在使用流式方法（"Start"、"Update"、"Finish"）进行操作时，专用 Crypto Driver Object 等待进一步的输入（"Update"），直到达到 "Finish" 状态。同时，此 Crypto Driver 实例上不能处理其他作业。

7.2.1.1 配置

[SWS_Csm_91005] ⌈ 每个加密原语配置都应实现为 Crypto_PrimitiveInfoType 类型的常量结构。⌋()

[SWS_Csm_91006] ⌈ 每个作业原语配置都应实现为 Crypto_JobPrimitiveInfoType 类型的常量结构。⌋()

[SWS_Csm_00028] ⌈ 应可能为每个加密原语创建多个配置。⌋()

每个作业每个原语可以有一个配置。

[SWS_Csm_00029] ⌈ 在创建原语配置时，应可能配置来自底层 Crypto Driver Object 的所有可用和允许的方案。⌋()

[SWS_Csm_00032] ⌈ 如果选择异步接口，则每个作业原语配置应包含一个回调函数。⌋(SRS_CryptoStack_00082)

7.2.1.2 同步作业处理

[SWS_Csm_00035] ⌈ 当使用同步接口时，接口函数应立即使用底层加密栈模块计算结果。⌋()

[SWS_Csm_00037] ⌈ 如果发出了同步作业，且其优先级高于队列中可用的最高优先级，则 CSM 应禁用从队列处理新作业，直到当前正在处理的作业完成后下一次主函数调用结束。⌋()

注意：通道可能同时保存异步和同步处理类型的作业。如果是这样，同步作业可能不会被接受处理，即使其作业的优先级高于所有异步作业的优先级。

注意：由于底层 Crypto Driver 可以具有自己的队列，因此不能始终确保应用程序提供的最高优先级作业是下一个被处理的。

[SWS_Csm_91007] ⌈ 如果发出了同步作业，且其优先级低于队列中可用的最高优先级，则 CSM 应返回 E_BUSY。⌋()

注意：通过例如在调用同步作业期间使用关键部分暂停对 CSM 主函数的调用，可以确保同步作业可以连续处理，而不必在其间等待高优先级的异步作业。另请考虑禁用 Crypto Driver Object 中的排队，以确保快速处理同步作业。如果异步作业的加载不应被同步作业暂停，则同步作业的优先级必须小于异步作业的优先级。

7.2.1.3 异步作业处理

[SWS_Csm_00036] ⌈ 如果使用异步接口，则接口函数应仅将必要的信息移交给底层加密栈模块。⌋()

[SWS_Csm_00039] ⌈ CSM 的用户应在请求的加密服务已通过调用作业原语配置的回调函数被处理时收到通知。⌋()

7.2.2 设计注释

CSM 提供两项服务：(1) 加密服务本身，以及 (2) 密钥管理。

7.2.2.1 CSM 模块启动

Csm_Init() 请求不应负责触发底层 CRYIF 的初始化。假定底层 CRYIF 将由任何适当的实体（例如 BswM）初始化。

使用 CSM 模块的软件组件应负责检查由 CSM 模块启动产生的全局错误和状态信息。

7.2.2.2 加密服务
7.2.2.2.1 CSM 加密服务的使用

[SWS_Csm_00734] ⌈ CSM 加密服务应提供 Csm_<Service>() API。⌋()

[SWS_Csm_00924] ⌈ 应用程序应能够以操作模式 CRYPTO_OPERATIONMODE_START 调用 Csm_<Service>() 以初始化加密计算。⌋()

[SWS_Csm_00925] ⌈ 应用程序应能够以操作模式 CRYPTO_OPERATIONMODE_UPDATE 调用 Csm_<Service>() 任意次数，但至少一次，以向作业的加密原语提供输入数据。⌋()

[SWS_Csm_01046] ⌈ 应用程序应能够以操作模式 CRYPTO_OPERATIONMODE_FINISH 调用 Csm_<Service>() 以完成加密计算。⌋()

[SWS_Csm_00937] ⌈ 已弃用的 Csm_<Service>Start() 函数应映射到 Csm_KeyElementSet() 函数和具有操作模式"start"的 Csm_<Service>() 函数。⌋()

[SWS_Csm_00938] ⌈ 已弃用的 Csm_<Service>Update() 函数应映射到具有操作模式"update"的 Csm_<Service>() 函数。⌋()

[SWS_Csm_00939] ⌈ 已弃用的 Csm_<Service>Finish() 函数应映射到具有操作模式"finish"的 Csm_<Service>() 函数。⌋()

注意：Csm_<Service>() 将使用指向 Crypto_JobType 的指针调用 CryIf_ProcessJob()，其中存储了处理作业所需的所有信息。Crypto_JobType 的一部分是 Crypto_JobPrimitiveInputOutputType，其中存储了根据服务的所有输入和输出参数的信息。从 Csm_<Service>() 的 API 参数到 Crypto_JobPrimitiveInputOutputType 参数的映射定义可以在加密驱动规范的 [SWS_Crypto_00073] 中找到。

7.2.2.2.2 排队

CSM 可以具有多个队列，其中作业根据其优先级排队，以处理多个加密请求。从 CSM 队列经 CryIf 到 Crypto Driver Object 的路径称为通道。CSM 的每个队列映射到一个通道以访问 Crypto Driver Object 的加密原语。队列的大小是可配置的。

为了优化 Crypto Driver Object 的硬件使用，Crypto Driver 中也可选地具有队列。

Crypto Driver Object 表示独立加密"设备"（硬件或软件，例如 AES 加速器）的一个实例。可以存在用于在 HSM 上对高优先级作业进行快速 AES 和 CMAC 计算的通道，最终指向 Crypto Driver 中的本地 AES 计算服务。但也有可能 Crypto Driver Object 是软件片段，例如用于 RSA 计算的片段，用户能够加密、解密、签名或验证数据。

图 7.1 AUTOSAR 分层视图中带有通道

图 7.1 说明了带有通道的 AUTOSAR 分层视图。在此示例中，存在一个具有两个 Crypto Driver Object（HW-AES 和 HW-RSA）的 HSM，每个都有自己的通道。每个通道连接到 CSM 队列和 Crypto Driver Object 队列。在这种情况下，两个 Crypto Driver Object 各自处理一个加密作业（AES-high 和 RSA），而 Crypto Driver Object 的队列包含另一个作业（AES-low）。如果 HSM 的 HW-AES 完成 AES-high 作业，则 AES-low 作业将作为下一个作业被处理。

可以使用相同的设置（没有正在处理或队列中的作业）推导出其他场景：假设应用程序的新作业调用 RSA：

  • 如果 RSA 的 Crypto Driver Object 不忙，则该作业将立即被处理。
  • 如果 RSA 的 Crypto Driver Object 繁忙，但 Crypto Driver Object 的队列未满，则该作业将按其优先级顺序列入该队列。一旦 Crypto Driver Object 可用，将执行 Crypto Driver Object 队列中优先级最高的作业。
  • 如果 RSA 的 Crypto Driver Object 繁忙且 Crypto Driver Object 的队列已满，则该作业将按其优先级顺序存储在 CSM 队列中。
  • 如果 RSA 的 Crypto Driver Object 繁忙且 Crypto Driver Object 的队列以及 CSM 队列均已满，则 CSM 拒绝该请求。
  • 如果 RSA 的 Crypto Driver Object 处于活动状态，则该作业已在 Crypto Driver 中启动并正在等待更多数据处理或完成命令。

[SWS_Csm_00940] ⌈ 应可能将 CSM 作业排队到 CSM 中配置的 CsmQueues 中。⌋()

[SWS_Csm_00944] ⌈ CsmQueues 应根据已配置作业的优先级对作业进行排序。⌋()

作业优先级值越高，作业的优先级越高。

[SWS_Csm_00945] ⌈ Csm_<Service>() 函数的行为应如图 SWS_Csm_01041 所示。⌋()

[SWS_Csm_01041] ⌈ （Csm_<Service>() 函数行为图）⌋()

同步作业处理和排队可能不有用。因此，如果选择同步作业处理，则队列大小应为"0"。但是，也可以使用带有同步和异步作业的通道（包括队列）。

排队的作业可以在 Csm_MainFunction() 中传递给 CRYIF。

如果作业处于"active"状态，则 CSM 应假定映射的加密驱动实例当前正在处理此作业，并且调用方希望继续操作（例如使用"update"提供更多数据）。合理性检查必须在加密驱动实例中执行。

7.2.2.3 密钥管理

[SWS_Csm_00950] ⌈ 属于密钥管理的服务应仅提供 Csm_<Service>() 函数。⌋()

[SWS_Csm_00954] ⌈ 一个密钥由一个或多个密钥元素组成。⌋()

密钥元素的示例包括密钥材料本身、初始化向量、用于随机数生成的种子或 SHE 标准的证明。

密钥（即相应的密钥 ID）具有由配置给定的符号名称。加密栈 API 使用 CSM 模块的以下密钥元素索引定义：

[SWS_Csm_01022] ⌈ 密钥元素索引定义：

加密服务 密钥元素名称 密钥元素 ID 强制性
MAC Key Material CRYPTO_KE_MAC_KEY = 1 x
Proof (SHE) CRYPTO_KE_MAC_PROOF = 2
Signature Key Material CRYPTO_KE_SIGNATURE_KEY = 1 x
Random Seed State CRYPTO_KE_RANDOM_SEED_STATE = 3
Algorithm CRYPTO_KE_RANDOM_ALGORITHM = 4
Cipher/AEAD Key Material CRYPTO_KE_CIPHER_KEY = 1 x
Init Vector CRYPTO_KE_CIPHER_IV = 5
Proof (SHE) CRYPTO_KE_CIPHER_PROOF = 6
2nd Key Material CRYPTO_KE_CIPHER_2NDKEY = 7
Key Exchange Base CRYPTO_KE_KEYEXCHANGE_BASE = 8 x
Private Key CRYPTO_KE_KEYEXCHANGE_PRIVKEY = 9 x
Own Public Key CRYPTO_KE_KEYEXCHANGE_OWNPUBKEY = 10 x
Shared Value CYRPTO_KE_KEYEXCHANGE_SHAREDVALUE = 1 x
Algorithm CRYPTO_KE_KEYEXCHANGE_ALGORITHM = 12
Partner Public Key CRYPTO_KE_KEYEXCHANGE_PARTNERPUPKEY = 11
Key Derivation Password CRYPTO_KE_KEYDERIVATION_PASSWORD = 1 x
Salt CRYPTO_KE_KEYDERIVATION_SALT = 13
Iterations CRYPTO_KE_KEYDERIVATION_ITERATIONS = 14
Algorithm CRYPTO_KE_KEYDERIVATION_ALGORITHM = 15
Key Generate Key Material CRYPTO_KE_KEYGENERATE_KEY = 1 x
Seed CRYPTO_KE_KEYGENERATE_SEED = 16
Algorithm CRYPTO_KE_KEYGENERATE_ALGORITHM = 17
Certificate Parsing Certificate CRYPTO_KE_CERTIFICATE_DATA = 0 x
Format CRYPTO_KE_CERTIFICATE_PARSING_FORMAT = 18
Current Time CRYPTO_KE_CERTIFICATE_CURRENT_TIME = 19
Version CRYPTO_KE_CERTIFICATE_VERSION = 20
Serial Number CRYPTO_KE_CERTIFICATE_SERIALNUMBER = 21
Signature Algorithm CRYPTO_KE_CERTIFICATE_SIGNATURE_ALGORITHM = 22
Issuer CRYPTO_KE_CERTIFICATE_ISSUER = 23
Validity start CRYPTO_KE_CERTIFICATE_VALIDITY_NOT_BEFORE = 24
Validity end CRYPTO_KE_CERTIFICATE_VALIDITY_NOT_AFTER = 25
Subject CRYPTO_KE_CERTIFICATE_SUBJECT = 26
Subject Public Key CRYPTO_KE_CERTIFICATE_SUBJECT_PUBLIC_KEY = 1
Extensions CRYPTO_KE_CERTIFICATE_EXTENSIONS = 27
Signature CRYPTO_KE_CERTIFICATE_SIGNATURE = 28

⌋()

SWS_Csm_01022 的密钥元素索引可由供应商扩展。

[SWS_Csm_00951] ⌈ 对于包含加密密钥材料的每个密钥元素，应在用于数据交换的配置中指定所提供的密钥格式，例如 Csm_KeyElementGet() 或 Csm_KeyElementSet()。特定加密驱动支持的密钥格式是加密驱动随附的预配置信息的一部分。⌋(SRS_CryptoStack_00008)

[SWS_Csm_00953] ⌈ 以下密钥格式可用：

密钥格式 描述
CRYPTO_KE_FORMAT_BIN_OCTET 密钥以二进制形式提供为八位字节值。
CRYPTO_KE_FORMAT_BIN_SHEKEYS 用于 SHE 操作的组合输入/输出密钥 (M1+M2+M3) 和 (M4+M5)。
CRYPTO_KE_FORMAT_BIN_IDENT_PRIVATEKEY_PKCS8 带有标识符的 ASN.1 编码（BER 编码）形式的私钥材料。数据以二进制形式提供，而不是例如 BASE64 字符串。
CRYPTO_KE_FORMAT_BIN_IDENT_PUBLICKEY 带有标识符的 ASN.1 编码（BER 编码）形式的公钥材料。数据以二进制形式提供，而不是例如 BASE64 字符串。
CRYPTO_KE_FORMAT_BIN_RSA_PRIVATEKEY ASN.1 编码（BER 编码）形式的 RSA 私钥材料。密钥材料以二进制形式提供。
CRYPTO_KE_FORMAT_BIN_RSA_PUBLICKEY ASN.1 编码（BER 编码）形式的 RSA 公钥材料。密钥材料以二进制形式提供。
CRYPTO_KE_FORMAT_BIN_CERT_X509_V3 TBD
CRYPTO_KE_FORMAT_BIN_CERT_CVC TBD

二进制八位字节是基 256 的整数表示。

原理：非对称密钥可以带或不带标识符提供。标识符用于唯一标识所提供的密钥本身，以便密钥解析器可以检查密钥材料是否合适。没有标识符，密钥材料必须对应于为该密钥指定的格式。根据 IETF 标准，密钥的标识符作为 ASN.1 描述的一部分以对象标识符 (OID) 的形式提供。⌋(SRS_CryptoStack_00008)

[SWS_Csm_00952] ⌈ 供应商特定的 keyElementId 应从 1000 开始，以避免与加密栈未来扩展版本之间的干扰。⌋()

注意：密钥元素 CRYPTO_KE_[…]_ALGORITHM 用于配置密钥管理功能的行为，因为它们独立于作业，因此不能像原语那样配置。

7.2.2.4 加密作业的输入和/或输出重定向

[SWS_Csm_91013] ⌈ 作业的输入和/或输出数据可以重定向到密钥元素。将哪个输入和输出值重定向到哪个密钥及其密钥元素应在编译时静态配置，并且不应在运行时更改。⌋()

[SWS_Csm_91014] ⌈ 如果作业的输入或输出值被重定向到密钥元素（CsmInOutRedirectionRef ECUC_Csm_00262 存在）并且相应的输入或输出长度值未设置为 0，则不应处理该作业，并且应返回 E_NOT_OK。⌋()

[SWS_Csm_91015] ⌈ 如果作业元素不使用输入或输出重定向（不存在 CsmInOutRedirectionRef ECUC_Csm_00262），则 jobRedirectionInfoRef 应设置为 NULL_PTR。如果使用重定向元素（存在 CsmInOutRedirectionRef ECUC_Csm_00262），则 jobRedirectionInfoRef 应指向 Crypto_JobRedirectionInfoType 类型的结构。⌋()

[SWS_Csm_91016] ⌈ 结构 Crypto_JobRedirectionInfoType 包含有关哪些密钥元素应用于重定向的信息。提供了一个称为 redirectionConfig 的位字段，指示哪个输入和/或输出值被重定向。

redirectionConfig 的值是位编码值，用于指示哪些输入和输出缓冲区被重定向。如果设置了 redirectionConfig 的最低有效位（Bit #0 或 0x01），则主输入密钥及其元素被重定向，并且 inputKeyId 和 inputKeyElementId 的值必须指示用作输入缓冲区的元素，而不是 inputPtr 及其长度。如果设置了 Bit #1，则二级输入缓冲区被重定向到二级输入密钥，并且必须设置密钥和密钥元素，Bit #2 用于三级输入密钥。Bit #3 保留供将来使用。

如果设置了 Bit #4，则 outputPtr 被重定向到输出密钥的输出密钥元素。Bit #5 指示二级输出缓冲区到二级密钥及其密钥元素的重定向。如果某个位设置为 0，则不应将输入或输出重定向到关联的密钥元素。

示例：redirectionConfig 的值"00110001"指示输入应从 inputKeyId 的 inputKeyElement 收集，并且输出缓冲区和二级输出缓冲区应分别重定向到 outputKeyId 的 outputKeyElement 和 secondaryOutputKeyId 的 secondaryOutputKeyElement。⌋()

7.3 错误分类

7.3.1 开发错误

[SWS_Csm_91004] 开发错误类型 ⌈

错误类型 相关错误代码 值（十六进制）
使用无效参数（空指针）调用 API 请求 CSM_E_PARAM_POINTER 0x01
操作的缓冲区太小 CSM_E_SMALL_BUFFER 0x03
keyID 超出范围 CSM_E_PARAM_HANDLE 0x04
在 CSM 模块初始化之前调用 API 请求 CSM_E_UNINIT 0x05
CSM 模块初始化失败 CSM_E_INIT_FAILED 0x07
使用无效处理模式调用 API 请求 CSM_E_PROCESSING_MODE 0x08

⌋(SRS_CryptoStack_00086)

7.3.2 运行时错误

[SWS_Csm_01089] 运行时错误类型 ⌈

错误类型 相关错误代码 值（十六进制）
队列溢出 CSM_E_QUEUE_FULL 0x01

⌋(SRS_CryptoStack_00086)

7.3.3 瞬态故障

无瞬态故障。

7.3.4 生产错误

无生产错误。

7.3.5 扩展生产错误

无扩展生产错误。

7.4 错误检测

[SWS_Csm_91008] ⌈ 当 CSM 未初始化且调用了 CSM API 的任何函数（CSM_Init() 和 Csm_GetVersionInfo() 除外）时，当 CsmDevErrorDetect 为 true 时，不应执行该操作，并且应向 DET 报告 CSM_E_UNINIT。⌋()

[SWS_Csm_91009] ⌈ 如果将空指针传递给 API 函数，并且相应的输入或输出数据未重定向到密钥元素，则当 CsmDevErrorDetect 为 true 时，不应执行该操作，并且应向 DET 报告 CSM_E_PARAM_POINTER。⌋()

[SWS_Csm_91011] ⌈ 如果调用其接口中具有密钥句柄的 CSM API，并且密钥句柄（称为 keyID）超出范围，则当 CsmDevErrorDetect 为 true 时，不应执行该操作，并且应向 DET 报告 CSM_E_PARAM_HANDLE。⌋()

8 API 规范

8.1 导入类型

本章列出了从以下模块导入的所有类型：

[SWS_Csm_00046] ⌈

模块 头文件 导入的类型
CryIf <none> Crypto_JobType
<none> Crypto_JobInfoType
<none> Crypto_VerifyResultType
Std_Types StandardTypes.h Std_ReturnType
StandardTypes.h Std_VersionInfoType

⌋()

8.2 类型定义

8.2.1 Csm_ConfigType

[SWS_Csm_01085] ⌈

字段 内容
Name Csm_ConfigType
Type Structure
Range implementation specific
Description CSM 模块的配置数据结构
Available via Csm.h

⌋ (SWS_BSW_00216)

8.2.2 Crypto_AlgorithmFamilyType

[SWS_Csm_01086] ⌈ Crypto_AlgorithmFamilyType 是算法族的枚举类型。Available via: Csm.h。⌋()

支持的算法族包括：

算法族 描述
CRYPTO_ALGOFAM_NOT_SET 未设置
CRYPTO_ALGOFAM_SHA1 SHA-1
CRYPTO_ALGOFAM_SHA2_224 SHA-224
CRYPTO_ALGOFAM_SHA2_256 SHA-256
CRYPTO_ALGOFAM_SHA2_384 SHA-384
CRYPTO_ALGOFAM_SHA2_512 SHA-512
CRYPTO_ALGOFAM_SHA3_224 SHA3-224
CRYPTO_ALGOFAM_SHA3_256 SHA3-256
CRYPTO_ALGOFAM_SHA3_384 SHA3-384
CRYPTO_ALGOFAM_SHA3_512 SHA3-512
CRYPTO_ALGOFAM_SHAKE_256 SHAKE-256
CRYPTO_ALGOFAM_BLAKE_1_256 BLAKE-256
CRYPTO_ALGOFAM_BLAKE_1_512 BLAKE-512
CRYPTO_ALGOFAM_BLAKE_2_256 BLAKE2-256
CRYPTO_ALGOFAM_BLAKE_2_512 BLAKE2-512
CRYPTO_ALGOFAM_RIPEMD_160 RIPEMD-160
CRYPTO_ALGOFAM_AES AES
CRYPTO_ALGOFAM_CHACHA ChaCha20
CRYPTO_ALGOFAM_RSA RSA
CRYPTO_ALGOFAM_ECC ECC（包括 NIST/Brainpool 曲线）
CRYPTO_ALGOFAM_ECDH ECDH
CRYPTO_ALGOFAM_ECDSA ECDSA
CRYPTO_ALGOFAM_ECIES ECIES
CRYPTO_ALGOFAM_ECQV ECQV
CRYPTO_ALGOFAM_ED25519 Ed25519
CRYPTO_ALGOFAM_CUSTOM 供应商特定

8.2.3 Crypto_AlgorithmModeType

[SWS_Csm_01087] ⌈ Crypto_AlgorithmModeType 是算法模式的枚举类型。Available via: Csm.h。⌋()

支持的算法模式包括：

算法模式 描述
CRYPTO_ALGOMODE_NOT_SET 未设置
CRYPTO_ALGOMODE_ECB 电子密码本
CRYPTO_ALGOMODE_CBC 密码块链接
CRYPTO_ALGOMODE_CFB 密码反馈
CRYPTO_ALGOMODE_OFB 输出反馈
CRYPTO_ALGOMODE_CTR 计数器
CRYPTO_ALGOMODE_GCM Galois 计数器模式
CRYPTO_ALGOMODE_CCM 计数器与 CBC-MAC
CRYPTO_ALGOMODE_CMAC 基于密码的消息认证码
CRYPTO_ALGOMODE_GMAC Galois 消息认证码
CRYPTO_ALGOMODE_HMAC 基于哈希的消息认证码
CRYPTO_ALGOMODE_XTS XEX-based tweaked-codebook mode with ciphertext stealing
CRYPTO_ALGOMODE_RSAES_OAEP RSAES-OAEP
CRYPTO_ALGOMODE_RSAES_PKCS1_v1_5 RSAES-PKCS1-v1_5
CRYPTO_ALGOMODE_RSASSA_PSS RSASSA-PSS
CRYPTO_ALGOMODE_RSASSA_PKCS1_v1_5 RSASSA-PKCS1-v1_5
CRYPTO_ALGOMODE_ECDSA ECDSA
CRYPTO_ALGOMODE_ECIES ECIES
CRYPTO_ALGOMODE_CUSTOM 供应商特定

8.2.4 Crypto_InputOutputRedirectionConfigType

[SWS_Csm_01088] ⌈ Crypto_InputOutputRedirectionConfigType 是重定向配置的位字段类型。Available via: Csm.h。⌋()

8.2.5 Crypto_JobStateType

[SWS_Csm_01014] ⌈ Crypto_JobStateType 是作业状态的枚举类型。Available via: Csm.h。⌋()

值包括：CRYPTO_JOBSTATE_IDLE、CRYPTO_JOBSTATE_ACTIVE。

8.2.6 Crypto_JobPrimitiveInputOutputType

定义输入和输出缓冲区的结构。

8.2.7 Crypto_JobInfoType

[SWS_Csm_01015] ⌈ 包含作业状态信息的结构。Available via: Csm.h。⌋()

8.2.8 Crypto_JobPrimitiveInfoType

[SWS_Csm_01016] ⌈ 作业原语信息结构，包含对原语配置的引用。Available via: Csm.h。⌋()

8.2.9 Crypto_ServiceInfoType

[SWS_Csm_01017] ⌈ 服务信息结构，包含服务类型（CRYPTO_HASH、CRYPTO_MACGENERATE 等）。Available via: Csm.h。⌋()

8.2.10 Crypto_JobRedirectionInfoType

[SWS_Csm_01018] ⌈ 作业重定向信息结构。Available via: Csm.h。⌋()

8.2.11 Crypto_AlgorithmInfoType

[SWS_Csm_01019] ⌈ 算法信息结构。Available via: Csm.h。⌋()

8.2.12 Crypto_ProcessingType

[SWS_Csm_01020] ⌈ 处理类型枚举：CRYPTO_PROCESSING_SYNC、CRYPTO_PROCESSING_ASYNC。Available via: Csm.h。⌋()

8.2.13 Crypto_PrimitiveInfoType

[SWS_Csm_01021] ⌈ 原语信息结构。Available via: Csm.h。⌋()

8.2.14 Csm_ConfigIdType

[SWS_Csm_01091] ⌈ CSM 配置 ID 类型。Available via: Csm.h。⌋()

8.3 函数定义

8.3.1 通用接口

8.3.1.1 Csm_Init

[SWS_Csm_00646] ⌈

字段 内容
Service name Csm_Init
Syntax void Csm_Init(const Csm_ConfigType* ConfigPtr)
Service ID[hex] 0x01
Sync/Async Synchronous
Reentrancy Non Reentrant
Parameters (in) ConfigPtr
Description 初始化 CSM 模块。
Available via Csm.h

⌋ (SRS_BSW_00101, SRS_BSW_00358, SRS_BSW_00414)

[SWS_Csm_00186] ⌈ 配置指针 ConfigPtr 应始终为 NULL_PTR。⌋(SWS_BSW_00050)

8.3.1.2 Csm_GetVersionInfo

[SWS_Csm_00705] ⌈

字段 内容
Service name Csm_GetVersionInfo
Syntax void Csm_GetVersionInfo(Std_VersionInfoType* VersionInfo)
Service ID[hex] 0x02
Sync/Async Synchronous
Reentrancy Reentrant
Parameters (out) VersionInfo
Description 返回 CSM 模块的版本信息。
Available via Csm.h

⌋ (SRS_BSW_00407)

8.3.1.3 Csm_MainFunction

[SWS_Csm_00479] ⌈

字段 内容
Service name Csm_MainFunction
Syntax void Csm_MainFunction(void)
Service ID[hex] 0x05
Sync/Async Synchronous
Description 如果配置了异步处理，则周期性调用以处理 CSM 队列中的作业。
Available via SchM_Csm.h

⌋()

8.3.2 哈希接口

8.3.2.1 Csm_Hash

[SWS_Csm_00980] ⌈

字段 内容
Service name Csm_Hash
Syntax Std_ReturnType Csm_Hash(uint32 jobId, Crypto_OperationModeType mode, const uint8* dataPtr, uint32 dataLength, uint8* resultPtr, uint32* resultLengthPtr)
Service ID[hex] 0x06
Sync/Async Sync 或 Async
Description 使用配置的哈希算法计算输入数据的摘要。
Available via Csm.h

⌋()

[SWS_Csm_00981] ⌈ Csm_Hash 应在 Csm_Hash_Config 配置中按原语调用 CryIf_ProcessJob() 并传递结果。⌋()

8.3.3 MAC 接口

8.3.3.1 Csm_MacGenerate

[SWS_Csm_00982] ⌈

字段 内容
Service name Csm_MacGenerate
Syntax Std_ReturnType Csm_MacGenerate(uint32 jobId, Crypto_OperationModeType mode, const uint8* dataPtr, uint32 dataLength, uint8* macPtr, uint32* macLengthPtr)
Service ID[hex] 0x07
Description 使用配置的 MAC 算法计算输入数据的 MAC。
Available via Csm.h

⌋()

8.3.3.2 Csm_MacVerify

[SWS_Csm_00983] ⌈

字段 内容
Service name Csm_MacVerify
Syntax Std_ReturnType Csm_MacVerify(uint32 jobId, Crypto_OperationModeType mode, const uint8* dataPtr, uint32 dataLength, const uint8* macPtr, uint32 macLength, Crypto_VerifyResultType* verifyPtr)
Service ID[hex] 0x08
Description 使用配置的 MAC 算法验证输入数据的 MAC。
Available via Csm.h

⌋()

8.3.4 加密接口

8.3.4.1 Csm_Encrypt

[SWS_Csm_00984] ⌈

字段 内容
Service name Csm_Encrypt
Syntax Std_ReturnType Csm_Encrypt(uint32 jobId, Crypto_OperationModeType mode, const uint8* dataPtr, uint32 dataLength, uint8* resultPtr, uint32* resultLengthPtr)
Service ID[hex] 0x09
Description 使用配置的对称或非对称加密算法加密输入数据。
Available via Csm.h

⌋()

8.3.4.2 Csm_Decrypt

[SWS_Csm_00985] ⌈

字段 内容
Service name Csm_Decrypt
Syntax Std_ReturnType Csm_Decrypt(uint32 jobId, Crypto_OperationModeType mode, const uint8* dataPtr, uint32 dataLength, uint8* resultPtr, uint32* resultLengthPtr)
Service ID[hex] 0x0a
Description 使用配置的对称或非对称加密算法解密输入数据。
Available via Csm.h

⌋()

8.3.5 AEAD 接口

8.3.5.1 Csm_AEADEncrypt

[SWS_Csm_00986] ⌈

字段 内容
Service name Csm_AEADEncrypt
Syntax Std_ReturnType Csm_AEADEncrypt(uint32 jobId, Crypto_OperationModeType mode, const uint8* plaintextPtr, uint32 plaintextLength, const uint8* associatedDataPtr, uint32 associatedDataLength, uint8* ciphertextPtr, uint32* ciphertextLengthPtr, uint8* tagPtr, uint32* tagLengthPtr)
Service ID[hex] 0x0b
Description 使用 AEAD 算法加密明文并生成认证标签。
Available via Csm.h

⌋()

8.3.5.2 Csm_AEADDecrypt

[SWS_Csm_00987] ⌈

字段 内容
Service name Csm_AEADDecrypt
Syntax Std_ReturnType Csm_AEADDecrypt(uint32 jobId, Crypto_OperationModeType mode, const uint8* ciphertextPtr, uint32 ciphertextLength, const uint8* associatedDataPtr, uint32 associatedDataLength, const uint8* tagPtr, uint32 tagLength, uint8* plaintextPtr, uint32* plaintextLengthPtr, Crypto_VerifyResultType* verifyPtr)
Service ID[hex] 0x0c
Description 使用 AEAD 算法解密密文并验证认证标签。
Available via Csm.h

⌋()

8.3.6 签名接口

8.3.6.1 Csm_SignatureGenerate

[SWS_Csm_00992] ⌈

字段 内容
Service name Csm_SignatureGenerate
Syntax Std_ReturnType Csm_SignatureGenerate(uint32 jobId, Crypto_OperationModeType mode, const uint8* dataPtr, uint32 dataLength, uint8* resultPtr, uint32* resultLengthPtr)
Service ID[hex] 0x0d
Description 使用配置的签名算法生成输入数据的签名。
Available via Csm.h

⌋()

8.3.6.2 Csm_SignatureVerify

[SWS_Csm_00996] ⌈

字段 内容
Service name Csm_SignatureVerify
Syntax Std_ReturnType Csm_SignatureVerify(uint32 jobId, Crypto_OperationModeType mode, const uint8* dataPtr, uint32 dataLength, const uint8* signaturePtr, uint32 signatureLength, Crypto_VerifyResultType* verifyPtr)
Service ID[hex] 0x0e
Description 使用配置的签名算法验证输入数据的签名。
Available via Csm.h

⌋()

8.3.7 随机接口

8.3.7.1 Csm_RandomGenerate

[SWS_Csm_01543] ⌈

字段 内容
Service name Csm_RandomGenerate
Syntax Std_ReturnType Csm_RandomGenerate(uint32 jobId, uint8* resultPtr, uint32* resultLengthPtr)
Service ID[hex] 0x10
Description 使用配置的随机数生成器生成随机数。
Available via Csm.h

⌋()

8.3.8 密钥管理接口

8.3.8.1 密钥设置接口
Csm_KeyElementSet

[SWS_Csm_00951, 91024] ⌈

字段 内容
Service name Csm_KeyElementSet
Syntax Std_ReturnType Csm_KeyElementSet(uint32 keyId, uint32 keyElementId, const uint8* keyPtr, uint32 keyLength)
Service ID[hex] 0x13
Description 设置密钥元素的字节。
Available via Csm.h

⌋()

Csm_KeySetValid

[SWS_Csm_91025] ⌈

字段 内容
Service name Csm_KeySetValid
Syntax Std_ReturnType Csm_KeySetValid(uint32 keyId)
Service ID[hex] 0x14
Description 将密钥状态设置为有效。
Available via Csm.h

⌋()

8.3.8.2 密钥提取接口
Csm_KeyElementGet

[SWS_Csm_91026] ⌈

字段 内容
Service name Csm_KeyElementGet
Syntax Std_ReturnType Csm_KeyElementGet(uint32 keyId, uint32 keyElementId, uint8* resultPtr, uint32* resultLengthPtr)
Service ID[hex] 0x15
Description 检索密钥元素。
Available via Csm.h

⌋()

Csm_KeyGetStatus

[SWS_Csm_91027] ⌈

字段 内容
Service name Csm_KeyGetStatus
Syntax Std_ReturnType Csm_KeyGetStatus(uint32 keyId, Crypto_JobStateType* keyStatusPtr)
Service ID[hex] 0x16
Description 检索密钥的状态。
Available via Csm.h

⌋()

8.3.8.3 密钥复制接口
Csm_KeyElementCopy

[SWS_Csm_91028] ⌈

字段 内容
Service name Csm_KeyElementCopy
Syntax Std_ReturnType Csm_KeyElementCopy(uint32 keyId, uint32 keyElementId, uint32 targetKeyId, uint32 targetKeyElementId)
Service ID[hex] 0x17
Description 将密钥元素复制到另一个密钥。
Available via Csm.h

⌋()

Csm_KeyElementCopyPartial

[SWS_Csm_91029] ⌈

字段 内容
Service name Csm_KeyElementCopyPartial
Syntax Std_ReturnType Csm_KeyElementCopyPartial(uint32 keyId, uint32 keyElementId, uint32 keyElementSourceOffset, uint32 keyElementTargetOffset, uint32 keyElementCopyLength, uint32 targetKeyId, uint32 targetKeyElementId)
Service ID[hex] 0x18
Description 将密钥元素的一部分复制到另一个密钥。
Available via Csm.h

⌋()

Csm_KeyCopy

[SWS_Csm_91030] ⌈

字段 内容
Service name Csm_KeyCopy
Syntax Std_ReturnType Csm_KeyCopy(uint32 keyId, uint32 targetKeyId)
Service ID[hex] 0x19
Description 将密钥及其所有元素复制到另一个密钥。
Available via Csm.h

⌋()

8.3.8.4 密钥生成接口
Csm_RandomSeed

[SWS_Csm_91031] ⌈

字段 内容
Service name Csm_RandomSeed
Syntax Std_ReturnType Csm_RandomSeed(uint32 keyId, const uint8* seedPtr, uint32 seedLength)
Service ID[hex] 0x1a
Description 生成随机数生成器的内部种子状态。
Available via Csm.h

⌋()

Csm_KeyGenerate

[SWS_Csm_00955] ⌈

字段 内容
Service name Csm_KeyGenerate
Syntax Std_ReturnType Csm_KeyGenerate(uint32 keyId)
Service ID[hex] 0x1b
Description 生成新密钥材料并将其存储在 keyId 标识的密钥中。
Available via Csm.h

⌋()

8.3.8.5 密钥派生接口
Csm_KeyDerive

[SWS_Csm_00956] ⌈

字段 内容
Service name Csm_KeyDerive
Syntax Std_ReturnType Csm_KeyDerive(uint32 keyId, uint32 targetKeyId)
Service ID[hex] 0x1c
Description 使用 salt 和 password 派生新密钥。
Available via Csm.h

⌋()

8.3.8.6 密钥交换接口
Csm_KeyExchangeCalcPubVal

[SWS_Csm_00966] ⌈

字段 内容
Service name Csm_KeyExchangeCalcPubVal
Syntax Std_ReturnType Csm_KeyExchangeCalcPubVal(uint32 keyId, uint8* publicValuePtr, uint32* publicValueLengthPtr)
Service ID[hex] 0x1d
Description 计算密钥交换的公钥值。
Available via Csm.h

⌋()

Csm_KeyExchangeCalcSecret

[SWS_Csm_00967] ⌈

字段 内容
Service name Csm_KeyExchangeCalcSecret
Syntax Std_ReturnType Csm_KeyExchangeCalcSecret(uint32 keyId, const uint8* partnerPublicValuePtr, uint32 partnerPublicValueLength)
Service ID[hex] 0x1e
Description 计算密钥交换的共享密钥。
Available via Csm.h

⌋()

8.3.8.7 证书接口
Csm_CertificateParse

[SWS_Csm_01036] ⌈

字段 内容
Service name Csm_CertificateParse
Syntax Std_ReturnType Csm_CertificateParse(uint32 keyId)
Service ID[hex] 0x1f
Description 解析存储在密钥中的证书。
Available via Csm.h

⌋()

Csm_CertificateVerify

[SWS_Csm_01037] ⌈

字段 内容
Service name Csm_CertificateVerify
Syntax Std_ReturnType Csm_CertificateVerify(uint32 keyId, uint32 verifyKeyId, Crypto_VerifyResultType* verifyPtr)
Service ID[hex] 0x20
Description 验证证书。
Available via Csm.h

⌋()

8.3.9 加密原语和方案

[SWS_Csm_91039..91089] 详细定义每种加密原语和方案（Hash、MacGenerate、MacVerify、Encrypt、Decrypt、AEADEncrypt、AEADDecrypt、SignatureGenerate、SignatureVerify、RandomGenerate）的配置接口和数据结构。详细定义请参见原始 PDF 文档第 61-67 页。

8.3.10 作业取消接口

Csm_CancelJob

[SWS_Csm_01044] ⌈

字段 内容
Service name Csm_CancelJob
Syntax Std_ReturnType Csm_CancelJob(uint32 jobId, Crypto_JobInfoType* job)
Service ID[hex] 0x0f
Description 从队列中移除作业并取消作业的处理。
Available via Csm.h

⌋()

8.3.11 回调通知

Csm_CallbackNotification

[SWS_Csm_00073] ⌈

字段 内容
Service name Csm_CallbackNotification
Syntax void Csm_CallbackNotification(Crypto_JobType* job, Std_ReturnType result)
Service ID[hex] 0x03
Description 通知 CSM 一个作业已完成。
Available via Csm.h

⌋(SRS_BSW_00359, SRS_BSW_00360)

8.3.12 调度函数

Csm_MainFunction() 已在前文 8.3.1.3 中定义。

8.4 预期接口

8.4.1 与标准软件模块的接口

[SWS_Csm_01069] ⌈ CSM 应使用 AUTOSAR DET 模块进行开发错误通知。⌋()

8.4.2 必需接口

CSM 模块所需的所有必需接口：

API 函数 描述
CryIf_ProcessJob 处理作业
CryIf_CancelJob 取消作业
Det_ReportError 报告开发错误

8.4.3 可选接口

CSM 模块的所有可选接口（取决于配置）：

API 函数 描述
CryIf_KeyElementSet/Get/Copy 密钥元素操作
CryIf_KeySetValid 设置密钥有效
CryIf_KeyGenerate/Derive 密钥生成和派生
等等

8.4.4 可配置接口

CSM 模块允许通过配置来定义自定义接口。详见原文 PDF 第 70 页。

8.5 服务接口

CSM 模块定义了一组服务接口，允许通过 RTE 进行访问。

8.5.1 客户端-服务器接口

CSM 模块为每个加密服务提供客户端-服务器接口。详细的服务接口定义（包括 Csm_Hash_{Config}、Csm_MacGenerate_{Config}、Csm_Encrypt_{Config} 等）请参阅原始 PDF 文档第 71-97 页。每个服务的接口定义了输入/输出参数、错误处理以及数据引用。

8.5.2 客户端-服务器接口（DATA_REFERENCES）

对于大数据块的传输，CSM 模块定义了一组带 DATA_REFERENCES 的客户端-服务器接口。详细定义请参阅原始 PDF 文档第 97-116 页。

8.5.3 客户端-服务器接口（密钥管理）

CSM 模块为密钥管理提供了一组客户端-服务器接口。详细定义请参阅原始 PDF 文档第 116-127 页。

8.5.4 实现数据类型

CSM 模块定义了一组实现数据类型用于服务接口：

  • Csm_AsymPublicKeyType — 非对称公钥类型
  • Csm_AsymPrivateKeyType — 非对称私钥类型
  • Csm_SymKeyType — 对称密钥类型
  • Csm_CertificateType — 证书类型
  • 等等

完整实现数据类型定义请参阅原始 PDF 文档第 127-138 页。

8.5.5 端口

CSM 模块定义了服务接口的端口配置。完整端口定义请参阅原始 PDF 文档第 138-139 页。

9 序列图

9.1.1 异步调用

详见原始 PDF 文档第 140 页。

9.1.2 同步调用

详见原始 PDF 文档第 141 页。

10 配置规范

第 10.2 章规定 CSM 模块的结构（容器）和参数。第 10.3 章另外规定 CSM 模块的发布信息。

10.1 如何阅读本章

本章描述如何阅读配置规范。

10.2 容器和配置参数

10.2.1 Csm

Csm 根容器配置加密服务管理器模块。

包含的容器 多重性 范围 / 依赖
CsmGeneral 1 公共配置
CsmJobs 1 作业容器
CsmKeys 1 密钥容器
CsmPrimitives 0..1 原语容器
CsmQueues 0..1 队列容器
CsmCallbacks 0..1 回调容器

10.2.2 CsmGeneral

CsmGeneral 容器定义公共配置选项：

参数 描述
CsmDevErrorDetect 启用/禁用开发错误检测
CsmVersionInfoApi 启用/禁用 Csm_GetVersionInfo() API

10.2.3 CsmJobs

CsmJobs 容器是所有已配置作业的集合。

10.2.4 CsmJob

CsmJob 容器定义单个作业：

参数 描述
CsmJobId 作业标识符
CsmJobPrimitiveRef 对原语的引用
CsmJobKeyRef 对密钥的引用
CsmJobUsePort 是否使用端口（true/false）
CsmJobProcessingMode 处理模式（同步/异步）
CsmJobPriority 作业优先级
CsmCallbackRef 对回调函数的引用
CsmInOutRedirectionRef 对输入/输出重定向的引用
CsmJobAccessNest 嵌套访问控制

10.2.5 CsmKeys

CsmKeys 容器是所有已配置密钥的集合。

10.2.6 CsmKey

CsmKey 容器定义单个密钥：

参数 描述
CsmKeyId 密钥标识符
CsmKeyRef 对加密驱动中密钥的引用

10.2.7 CsmPrimitives

CsmPrimitives 容器是所有已配置原语的集合。

10.2.8 CsmQueues

CsmQueues 容器是所有已配置队列的集合。

10.2.9 CsmQueue

CsmQueue 容器定义单个队列：

参数 描述
CsmQueueId 队列标识符
CsmQueueRef 对加密驱动中 Crypto Driver Object 的引用

10.2.10 CsmInOutRedirections

CsmInOutRedirections 容器定义输入/输出重定向。

10.2.11 CsmInOutRedirection

CsmInOutRedirection 容器定义单个输入/输出重定向。

10.2.12 CsmHash / CsmHashConfig

CsmHash 和 CsmHashConfig 容器定义哈希服务的原语配置。

10.2.13 CsmMacGenerate / CsmMacGenerateConfig

定义 MAC 生成服务的原语配置。

10.2.14 CsmMacVerify / CsmMacVerifyConfig

定义 MAC 验证服务的原语配置。

10.2.15 CsmEncrypt / CsmEncryptConfig

定义加密服务的原语配置。

10.2.16 CsmDecrypt / CsmDecryptConfig

定义解密服务的原语配置。

10.2.17 CsmAEADEncrypt / CsmAEADEncryptConfig

定义 AEAD 加密服务的原语配置。

10.2.18 CsmAEADDecrypt / CsmAEADDecryptConfig

定义 AEAD 解密服务的原语配置。

10.2.19 CsmSignatureGenerate / CsmSignatureGenerateConfig

定义签名生成服务的原语配置。

10.2.20 CsmSignatureVerify / CsmSignatureVerifyConfig

定义签名验证服务的原语配置。

10.2.21 CsmRandomGenerate / CsmRandomGenerateConfig

定义随机数生成服务的原语配置。

10.2.22 CsmJobKeySetValid

定义 Csm_KeySetValid 服务的作业配置。

10.2.23 CsmCallbacks

CsmCallbacks 容器是所有已配置回调的集合。

10.2.24 CsmCallback

CsmCallback 容器定义单个回调函数：

参数 描述
CsmCallbackName 回调函数名称

完整配置容器定义（包括每个参数的详细范围、默认值、约束类等）请参见原始 PDF 文档第 148-201 页。

10.3 发布信息

发布信息包含由 SW 模块实施者定义的数据，这些数据在模块适配（即配置）到实际硬件/软件环境时不会更改。因此它包含版本和制造商信息。

完整发布参数定义请参见原始 PDF 文档第 202 页。

翻译说明

  • 本文档为 AUTOSAR SWS 402《Specification of Crypto Service Manager》(CP 4.4.0) 的中文翻译；
  • 文档标识号：402；
  • 文档共 202 页，已翻译所有 10 个章节，包括完整的 API 规范、所有 30+ 个关键函数声明、配置规范摘要；
  • 保留了所有 AUTOSAR 方框符、API 标识符、模块缩写、算法名和需求 ID；
  • 客户端-服务器接口详细定义（8.5.1-8.5.4）已摘要处理；详细接口定义（约 100+ 个 RTE 端口）请参见原文 PDF 第 71-139 页；
  • 配置规范（10.2）列出所有 35+ 个主要容器，详细参数定义参见原始 PDF；
  • 保留完整的密钥元素索引表（SWS_Csm_01022）和作业状态机说明；
  • 翻译以保证技术含义准确为前提，语句尽量贴近 AUTOSAR 中文术语库常用译法。
Reference in New Issue View Git Blame Copy Permalink