【已评审】新增SPDM相关接口用于通信报文交互

Interface SIG Interface评审
1

背景

支持SPDM接入认证能力，在 XPU 等部件接入后通过 SPDM 协议进行认证，由 spdm 组件处理协议层处理，compute 组件提供 RPC 方法进行传输层处理。

关联ISSUE

[需求]: 支持SPDM可信根互联

整体方案

spdm 组件通过监听 bmc.kepler.Inventory.Hardware.SPDM 接口资源新增从而触发 SPDM 协议交互流程。

其中，spdm 组件负责协议业务触发执行，compute 组件负责传输层消息封装和转发行为。

sequenceDiagram
	participant spdm
	participant compute
	participant XPU

	%% 初始化与资源发现阶段
	spdm->>compute: 资源监听
	XPU->>XPU: 上电接入
	compute->>XPU: 资源发现
	compute->>compute: 资源上树
	compute-->>spdm: 发送信号
	spdm->>spdm: 触发 SPDM 认证流程

	%% SPDM 认证交互阶段
	spdm->>compute: RPC发送消息（SPDM请求报文）
	compute->>compute: 组装IPMI结构
	compute->>XPU: 发送请求（IPMI请求，payload为SPDM请求）
	XPU->>XPU: 解析为SPDM请求报文
	XPU->>XPU: 内部处理
	XPU->>XPU: 将SPDM响应报文组装IPMI结构响应
	XPU-->>compute: 返回响应（IPMI响应，payload为SPDM响应）
	compute->>compute: 解析IPMI响应
	compute-->>spdm: RPC响应（SPDM响应报文）

评审点

新增资源协作接口 bmc.kepler.Inventory.Hardware.SPDM 承载 SPDM 协议相关能力

详细描述

评审点1：新增资源协作接口 bmc.kepler.Inventory.Hardware.SPDM

接口描述：硬件资产承载 SPDM 相关能力

新增方法

方法名称 请求签名 请求参数描述 响应签名 响应参数描述 方法描述 访问权限
Transmit uayu RequestLength: u SPDM请求报文长度
Request：ay SPDM请求报文
TimeoutMilliseconds：u 超时时长，单位：ms		 ay Response：ay SPDM响应报文 spdm报文传输方法 SecurityMgmt

新增接口影响

路径 新增接口影响 CSR配置影响 持久化影响 其他影响
/bmc/kepler/Systems/:SystemId/Processors/CPU/:ID
/bmc/kepler/Systems/:SystemId/Processors/NPU/:ID		 对外提供SPDM协议交互能力 无影响 不涉及持久化，无影响 需实现新增方法

是否准备好AI预审

是

评审结论

已线下审视，同意新增接口 bmc.kepler.Inventory.Hardware.SPDM，实现方法 Transmit，请求参数签名 uayu，响应参数签名 ay。

2

预审答案内容由AI生成，仅供参考：

帖子评审结论：【待评审】新增SPDM相关接口用于通信报文交互

帖子相关性：相关（MDB 相关: 内容含强特征: 资源协作）

  • 总评审点数：1
  • MDB 资源协作接口评审点：1
  • 其他评审点：0

总体结果：不通过（0/1 个评审点通过）

评审点 1：新增资源协作接口 bmc.kepler.Inventory.Hardware.SPDM【MDB】

结果：不通过

  • 规则合规性检查：不通过（2/28 项失败）

    • 规则合规性失败项（必须项）：
      规则ID：MDB-PROPERTY-011
      级别：必须项
      问题描述：方法请求参数 Timeout 描述中声明单位为 ms，但正式名称未使用规范后缀 Milliseconds。
      处理建议：将参数名 Timeout 修改为 TimeoutMilliseconds，以符合物理量单位后缀规范。

      规则ID：MDB-METHOD-017
      级别：必须项
      问题描述：方法 Transmit 涉及硬件通信和超时设置，存在明确的业务失败场景（如超时、通信错误），但未说明失败时的错误返回机制或错误引擎映射。
      处理建议：请在方法描述或响应参数描述中补充失败语义说明，例如明确“失败时通过错误引擎抛出 xyz.Error.Timeout 或 xyz.Error.CommunicationFailed”，或列出关键业务错误消息。

    • 警告项（建议性）：
      规则ID：MDB-REVIEW-003
      级别：建议性
      问题描述：缺少消费方和使用场景说明，背景信息不够充分。
      处理建议：severity=‘should’ 建议性规则，建议修改以提升规范符合性

      规则ID：MDB-RISK-004
      级别：建议性
      问题描述：接口涉及安全协议 SPDM 报文传输，属于强触发场景，已说明权限但未说明审计日志策略及防误操作措施。
      处理建议：severity=‘should’ 建议性规则，建议修改以提升规范符合性

3

AI审核问题已进行响应调整

4

已线下审视：

  1. 同意新增接口 bmc.kepler.Inventory.Hardware.SPDM，实现方法 Transmit，接口权限为SecurityMgmt
    命令详细信息见评审点1。