背景
支持TPCM扩展能力
ISSUE链接
【需求】支持TPCM扩展能力北向接口
支持TPCM扩展能力资源树
决策点及结论
1、新增资源树接口 bmc.kepler.Managers.SecureBoot 提供安全启动相关配置能力
结论：同意新增资源协作接口
资源path: /bmc/kepler/Managers/:ManagerId/SecureBoot
资源interface：bmc.kepler.Managers.SecureBoot
变化类型：新增interface，包含属性 VerificationEnabled 和方法SetBiosSignature
应用场景：用于承载安全启动相关配置
2、新增资源树接口 bmc.kepler.Managers.SecureBoot.Signature 承载各启动阶段的安全启动信息
结论：同意新增资源协作接口
资源path：
/bmc/kepler/Managers/:ManagerId/SecureBoot/Signatures/Uboot
/bmc/kepler/Managers/:ManagerId/SecureBoot/Signatures/Rootfs
/bmc/kepler/Systems/:SystemId/SecureBoot/Signatures/Bios
资源interface：bmc.kepler.Managers.SecureBoot.Signature
变化类型：新增资源路径及接口，包含属性 Name、Signature、VerificationResult
应用场景：承载安全启动的签名校验信息，用于前端呈现
3、新增资源树接口 bmc.kepler.Systems.TPCM.Measured.Component 承载关键处理器身份度量明细信息
结论：同意新增资源协作接口
资源path：
/bmc/kepler/Systems/:SystemId/TPCM/Measured/CPU/:Id
/bmc/kepler/Systems/:SystemId/TPCM/Measured/NetworkAdapter/:Id
/bmc/kepler/Systems/:SystemId/TPCM/Measured/NPU/:Id
/bmc/kepler/Systems/:SystemId/TPCM/Measured/GPU/:Id
资源interface：bmc.kepler.Systems.TPCM.Component
变化类型：新增资源路径及接口，包含属性ActualManufacturer、ActualModel、ActualUniqueIdentifier、StandardManufacturer、StandardModel、StandardUniqueIdentifier、Status
应用场景：该资源承载硬件身份度量明细信息，用于前端呈现
4、在资源树接口bmc.kepler.AssetService.AssetChange新增方法，实现刷新关键处理器基准值的能力
结论：不同意新增资源协作方法
方法归属不合理，调用关系违反逻辑架构约束
资源path：/bmc/kepler/AssetService/AssetChange
资源interface：bmc.kepler.AssetService.AssetChange
变化类型：新增方法
应用场景：用于在部件变更后，收集数据触发硬件身份度量基准值刷新行为
操作权限：UserMgmt
5、在 bmc.kepler.Managers.TPCM.Config 接口中新增方法提供关键处理器身份度量能力
结论：不同意新增资源协作方法
方法归属不合理，调用关系违反逻辑架构约束
资源path：/bmc/kepler/Managers/${ManagerId}/TPCM/Config
资源interface：bmc.kepler.Managers.TPCM.Config
变化类型：新增方法
应用场景：用于各部件加载完成后，收集数据触发硬件身份度量行为
操作权限：UserMgmt（不提供对外北向接口）
6、新增Rest接口GET /UI/Rest/TrustedComputing/SecureBoot 呈现安全启动验签信息
结论：同意新增rest接口
uri：/UI/Rest/TrustedComputing/SecureBoot
变化类型：新增uri
操作类型： GET
应用场景：前端页面《可信计算》呈现《安全启动信息》
详细描述：仅当支持安全启动时可用
| 属性名称 | 取值类型 | 取值范围 | 默认值 | 操作权限 | 属性说明 | 约束 |
|---|---|---|---|---|---|---|
| SecureBootVerification[{ | array | ReadOnly | 承载安全启动各固件的校验情况 | 只读 | ||
| Name | string | 长度：0~32 | (实际固件名） | ReadOnly | 安全启动固件名称，不同Systems下通过后缀区分，如Bios_1、Bios_2 | 只读 |
| Version | string | 长度：0~64 | “” | ReadOnly | 安全启动固件版本 | 只读 |
| Signature | string | 长度：0/64 | “” | ReadOnly | 安全启动固件签名值 | 只读 |
| VerificationResult | number | 0 - 校验成功 1 - 校验失败 255 - 未进行校验 | 255 | ReadOnly | 安全启动固件验签结果 | 只读 |
| }] |
7、新增Rest接口GET /UI/Rest/TrustedComputing/HardwareIdentity 呈现关键处理器身份度量信息
结论：同意新增Rest接口
uri：/UI/Rest/TrustedComputing/HardwareIdentity
变化类型：新增uri
操作类型： GET
应用场景：前端页面《可信计算》呈现《硬件身份度量信息》
详细描述：仅在TCM在位场景下可用
| 属性名称 | 取值类型 | 取值范围 | 默认值 | 操作权限 | 属性说明 | 约束 |
|---|---|---|---|---|---|---|
| HardwareIdentityMeasured[{ | array | ReadOnly | 承载关键处理部件的度量情况 | 只读 | ||
| Name | String | CPU, NetworkAdapter, NPU, GPU | ReadOnly | 单个System下的部件信息，如CPU | 只读 | |
| SystemId | Number | 1 | ReadOnly | 当前部件所在的SystemId | 只读 | |
| ComparedResult | Number | 0 – 度量成功 1 – 度量失败 255 – 未度量 | 255 | ReadOnly | 单System下的部件整体度量结果 | 只读 |
| Details[{ | array | ReadOnly | 单System下的部件度量明细信息集合 | 只读 | ||
| Name | String | 长度：0~32 | “” | ReadOnly | 部件(槽位)名称，如CPU1 | 只读 |
| ActualIdentifier | String | 长度：0~128 | “” | ReadOnly | 当前槽位上实际部件信息（型号+唯一标识） | 只读 |
| ActualDigest | String | 长度：0/64 | “” | ReadOnly | 当前槽位上实际部件度量值 | 只读 |
| StandardIdentifier | String | 长度：0~128 | “” | ReadOnly | 当前槽位上基准部件信息（型号+唯一标识） | 只读 |
| StandardDigest | String | 长度：0/64 | “” | ReadOnly | 当前槽位上基准部件度量值 | 只读 |
| Status | Number | 0 – 正常 1 – 新增 2 – 移除 3 – 变更 | 0 | ReadOnly | 部件状态，标识当前槽位上的部件操作行为 | 只读 |
| }]}] |
8、新增Rest接口POST /UI/Rest/TrustedComputing/HardwareIdentity/ResetComponentStandardDigest，提供关键处理器身份基准值刷新能力
结论：同意新增rest接口
uri：/UI/Rest/TrustedComputing/HardwareIdentity/ResetComponentStandardDigest
变化类型：新增uri
操作类型： POST
应用场景：提供前端页面《可信计算》-《硬件身份度量信息》中触发刷新部件基准值的能力
9、扩展Rest接口GET /UI/Rest/AccessMgnt/TpcmService ，增加对 tpcm license 状态的呈现
结论：同意扩展rest接口
uri：/UI/Rest/AccessMgnt/TpcmService
变化类型：新增属性 LicenseType、ExpiredTime
操作类型： GET
应用场景：增加TSB license状态呈现
备注：前端呈现字符串映射 1-调测，3-商用
10、扩展Rest接口GET /UI/Rest/GenericInfo，新增响应值标识当前是否支持安全启动
结论：同意扩展rest接口
uri：/UI/Rest/GenericInfo
变化类型：新增属性SecureBootVerificationEnabled、BasicSafeRunEnabled（仅V2）
操作类型： GET
应用场景：增加标识，用于判断前端呈现
11、新增 ipmi 接口
结论：同意新增 ipmi 接口
NetFn: 0x30 Cmd: 0x93
SubCmd: 0x88 Get Trusted Computing Configuration
SubCmd: 0x89 Set Trusted Computing Configuration
① Get Trusted Computing Configuration
命令功能：查询可信计算相关配置
权限说明：ReadOnly
使用示例：
Ipmitool raw 0x30 0x93 0xdb 0x07 0x00 0x88 0x01 0x00 0x00
请求：
响应：
②Set Trusted Computing Configuration
命令功能：设置可信计算相关配置
权限说明：UserMgmt
使用示例：
Ipmitool raw 0x30 0x93 0xdb 0x07 0x00 0x89 0x02 0x00 0x00 0x01 0x01
请求：
响应：
③功能号对照表
④功能状态对照表
