ResourceDefinition

uris

/redfish/v1/ComponentIntegrity/component_integrity_id

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	ComponentIntegrity资源模型的OData描述信息
@odata.id	string	true	-	ComponentIntegrity资源节点的访问路径
@odata.type	string	true	-	ComponentIntegrity资源类型
Id	string	true	-	ComponentIntegrity资源的ID
Name	string	true	-	ComponentIntegrity资源的名称
Description	string	true	-	ComponentIntegrity资源的描述
Actions {	object	true	-	ComponentIntegrity可执行的操作
Actions.#ComponentIntegrity.SPDMGetSignedMeasurements {	object	true	-	获取SPDM签名度量值操作
`Actions.#ComponentIntegrity.SPDMGetSignedMeasurements.@Redfish.ActionInfo`	string	true	-	操作信息查询路径
Actions.#ComponentIntegrity.SPDMGetSignedMeasurements.target	string	true	-	操作路径
}
}
ComponentIntegrityType	string	true	SPDM	上报本完整性报告所使用的安全技术类型
ComponentIntegrityTypeVersion	string	true	-	上报本完整性报告所使用的安全技术的版本号
LastUpdated	string	true	-	完整性报告最后刷新时间
TargetComponentURI	string	true	-	指向一个提供本报告中完整性信息的资源的链接
SPDM {	object	true	-	本资源基于SPDM协议呈现的完整性信息
SPDM.IdentityAuthentication {	object	true	-	身份认证相关信息
SPDM.IdentityAuthentication.ResponderAuthentication {	object	true	-	响应者的认证信息
SPDM.IdentityAuthentication.ResponderAuthentication.ComponentCertificate {	object	true	-	响应者证书集合资源
`SPDM.IdentityAuthentication.ResponderAuthentication.ComponentCertificate.@odata.id`	string	true	-	响应者证书集合资源访问路径
}
}
}
SPDM.MeasurementSet {	object	true	-	响应者的测量信息
SPDM.MeasurementSet.MeasurementSpecification	string	true	DMTF	请求方与响应方之间协商的测量规范
SPDM.MeasurementSet.MeasurementSummaryType	string	true	TCB	测量摘要的类型
SPDM.MeasurementSet.MeasurementSummaryHashAlgorithm	string	true	-	测量摘要使用的哈希算法
SPDM.MeasurementSet.MeasurementSummary	string	true	-	测量摘要
SPDM.MeasurementSet.Measurements [ {	array	true	-	响应者的测量块集合
SPDM.MeasurementSet.Measurements[].MeasurementIndex	number	true	-	测量块的索引
SPDM.MeasurementSet.Measurements[].MeasurementHashAlgorithm	string	true	-	用于计算该测量块的hash算法
SPDM.MeasurementSet.Measurements[].Measurement	string	true	-	测量值
SPDM.MeasurementSet.Measurements[].LastUpdated	string	true	-	本测量块的最后更新时间
SPDM.MeasurementSet.Measurements[].PartofSummaryHash	boolean	true	-	该块是否为属于计算SummaryHash时使用的度量块的一部分
SPDM.MeasurementSet.Measurements[].MeasurementType	string	true	FirmwareConfiguration、HardwareConfiguration、ImmutableROM、MeasurementManifest、MutableFirmware、MutableFirmwareSecurityVersionNumber、MutableFirmwareVersion	该测量块所代表的数据类型或特征。仅当MeasurementSpecification为DMTF时，才会呈现本属性
} ]
}
}
Status {	object	true	-	完整性报告资源状态
Status.State	string	true	-	是否使能
Status.Health	string	true	-	健康状态
}
SecurityVersionNumber	string	true	-	测量值所代表的安全版本号说明：仅当MeasurementSpecification为DMTF且MeasurementType为MutableFirmwareSecurityVersionNumber时，才会呈现本属性

supported_methods

GET
POST

HTTP methods

GET

命令功能

查询组件完整性报告单个资源信息

命令格式

URL: https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id

请求头:

text


X-Auth-Token: 123456789***********************

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
component_integrity_id	指定完整性报告的ID	可通过完整性报告集合资源获得
auth_value	执行该请求时，必须在"Headers"中携带"X-Auth-Token"值用于鉴权	可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

openUBMC 25.12 LTS及以上版本支持

使用实例

请求样例：

http

GET <https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id>

请求头：

text


X-Auth-Token: 123456789***********************

请求消息体：无

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#ComponentIntegrity.ComponentIntegrity",
"@odata.id": "/redfish/v1/ComponentIntegrity/SPDM_0_1",
"@odata.type": "#ComponentIntegrity.ComponentIntegrity",
"Id": "SPDM_0_1",
"Name": "Component Integrity",
"Description": "SPDM Integrity Information for Controller_1 reported by SPDM_0",
"ComponentIntegrityType": "SPDM",
"ComponentIntegrityTypeVersion": "1.0",
"LastUpdated": "1970-01-01T00:00:55Z",
"TargetComponentURI": "/redfish/v1/Systems/1/Storages/RAIDStorage0",
"SPDM": {
"IdentityAuthentication": {
"ResponderAuthentication": {
"ComponentCertificate": {
"@odata.id": "/redfish/v1/Chassis/1/TrustedComponents/SPDM_0/Certificates"
}
}
},
"MeasurementSet": {
"MeasurementSpecification": "DMTF",
"MeasurementSummaryType": "TCB",
"MeasurementSummaryHashAlgorithm": "TPM_ALG_SHA_256",
"MeasurementSummary": "0101010101010101010101010101010101010101010101010101010101010101",
"Measurements": [
{
"MeasurementIndex": 1,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000000",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
},
{
"MeasurementIndex": 2,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000001",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
},
{
"MeasurementIndex": 3,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000002",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
}
]
}
},
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Actions": {
"#ComponentIntegrity.SPDMGetSignedMeasurements": {
"target": "/redfish/v1/ComponentIntegrity/SPDM_0_1/Actions/ComponentIntegrity.SPDMGetSignedMeasurements",
"@Redfish.ActionInfo": "/redfish/v1/ComponentIntegrity/SPDM_0_1/SPDMGetSignedMeasurementsActionInfo"
}
}
}

响应码：200

POST (ACTION)

SPDMGetSignedMeasurements

命令功能

基于SPDM协议获取组件签名测量值

命令格式

URL: https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id/Actions/ComponentIntegrity.SPDMGetSignedMeasurements

请求头:

text


X-Auth-Token: 123456789***********************
Content-Type: header_type

请求消息体:

json

{
"MeasurementIndices": measurement_indices,
"SlotId": slot_id,
"Nonce": nonce
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
component_integrity_id	指定完整性报告的ID	可通过完整性报告集合资源获得
measurement_indices	请求测量块的数组	非必需参数，可选填如下几个使用方式： 1、[1~254] 中的一个或多个唯一值 2、[255] 3、无此参数，默认使用[255]
slot_id	签名使用的证书槽位ID	非必需参数，可选填如下几个使用方式： 1、0~7：指定使用特定槽位标识符的证书 2、无此参数，默认使用 0
nonce	挑战随机数	非必需参数，可选填如下几个使用方式： 1、有此参数时，需要遵循规则：`^[0-9a-fA-F]

ResourceDefinition

uris

/redfish/v1/ComponentIntegrity/component_integrity_id

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	ComponentIntegrity资源模型的OData描述信息
@odata.id	string	true	-	ComponentIntegrity资源节点的访问路径
@odata.type	string	true	-	ComponentIntegrity资源类型
Id	string	true	-	ComponentIntegrity资源的ID
Name	string	true	-	ComponentIntegrity资源的名称
Description	string	true	-	ComponentIntegrity资源的描述
Actions {	object	true	-	ComponentIntegrity可执行的操作
Actions.#ComponentIntegrity.SPDMGetSignedMeasurements {	object	true	-	获取SPDM签名度量值操作
`Actions.#ComponentIntegrity.SPDMGetSignedMeasurements.@Redfish.ActionInfo`	string	true	-	操作信息查询路径
Actions.#ComponentIntegrity.SPDMGetSignedMeasurements.target	string	true	-	操作路径
}
}
ComponentIntegrityType	string	true	SPDM	上报本完整性报告所使用的安全技术类型
ComponentIntegrityTypeVersion	string	true	-	上报本完整性报告所使用的安全技术的版本号
LastUpdated	string	true	-	完整性报告最后刷新时间
TargetComponentURI	string	true	-	指向一个提供本报告中完整性信息的资源的链接
SPDM {	object	true	-	本资源基于SPDM协议呈现的完整性信息
SPDM.IdentityAuthentication {	object	true	-	身份认证相关信息
SPDM.IdentityAuthentication.ResponderAuthentication {	object	true	-	响应者的认证信息
SPDM.IdentityAuthentication.ResponderAuthentication.ComponentCertificate {	object	true	-	响应者证书集合资源
`SPDM.IdentityAuthentication.ResponderAuthentication.ComponentCertificate.@odata.id`	string	true	-	响应者证书集合资源访问路径
}
}
}
SPDM.MeasurementSet {	object	true	-	响应者的测量信息
SPDM.MeasurementSet.MeasurementSpecification	string	true	DMTF	请求方与响应方之间协商的测量规范
SPDM.MeasurementSet.MeasurementSummaryType	string	true	TCB	测量摘要的类型
SPDM.MeasurementSet.MeasurementSummaryHashAlgorithm	string	true	-	测量摘要使用的哈希算法
SPDM.MeasurementSet.MeasurementSummary	string	true	-	测量摘要
SPDM.MeasurementSet.Measurements [ {	array	true	-	响应者的测量块集合
SPDM.MeasurementSet.Measurements[].MeasurementIndex	number	true	-	测量块的索引
SPDM.MeasurementSet.Measurements[].MeasurementHashAlgorithm	string	true	-	用于计算该测量块的hash算法
SPDM.MeasurementSet.Measurements[].Measurement	string	true	-	测量值
SPDM.MeasurementSet.Measurements[].LastUpdated	string	true	-	本测量块的最后更新时间
SPDM.MeasurementSet.Measurements[].PartofSummaryHash	boolean	true	-	该块是否为属于计算SummaryHash时使用的度量块的一部分
SPDM.MeasurementSet.Measurements[].MeasurementType	string	true	FirmwareConfiguration、HardwareConfiguration、ImmutableROM、MeasurementManifest、MutableFirmware、MutableFirmwareSecurityVersionNumber、MutableFirmwareVersion	该测量块所代表的数据类型或特征。仅当MeasurementSpecification为DMTF时，才会呈现本属性
} ]
}
}
Status {	object	true	-	完整性报告资源状态
Status.State	string	true	-	是否使能
Status.Health	string	true	-	健康状态
}
SecurityVersionNumber	string	true	-	测量值所代表的安全版本号说明：仅当MeasurementSpecification为DMTF且MeasurementType为MutableFirmwareSecurityVersionNumber时，才会呈现本属性

supported_methods

GET
POST

HTTP methods

GET

命令功能

查询组件完整性报告单个资源信息

命令格式

URL: https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id

请求头:

text


X-Auth-Token: 123456789***********************

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
component_integrity_id	指定完整性报告的ID	可通过完整性报告集合资源获得
auth_value	执行该请求时，必须在"Headers"中携带"X-Auth-Token"值用于鉴权	可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

openUBMC 25.12 LTS及以上版本支持

使用实例

请求样例：

http

GET <https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id>

请求头：

text


X-Auth-Token: 123456789***********************

请求消息体：无

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#ComponentIntegrity.ComponentIntegrity",
"@odata.id": "/redfish/v1/ComponentIntegrity/SPDM_0_1",
"@odata.type": "#ComponentIntegrity.ComponentIntegrity",
"Id": "SPDM_0_1",
"Name": "Component Integrity",
"Description": "SPDM Integrity Information for Controller_1 reported by SPDM_0",
"ComponentIntegrityType": "SPDM",
"ComponentIntegrityTypeVersion": "1.0",
"LastUpdated": "1970-01-01T00:00:55Z",
"TargetComponentURI": "/redfish/v1/Systems/1/Storages/RAIDStorage0",
"SPDM": {
"IdentityAuthentication": {
"ResponderAuthentication": {
"ComponentCertificate": {
"@odata.id": "/redfish/v1/Chassis/1/TrustedComponents/SPDM_0/Certificates"
}
}
},
"MeasurementSet": {
"MeasurementSpecification": "DMTF",
"MeasurementSummaryType": "TCB",
"MeasurementSummaryHashAlgorithm": "TPM_ALG_SHA_256",
"MeasurementSummary": "0101010101010101010101010101010101010101010101010101010101010101",
"Measurements": [
{
"MeasurementIndex": 1,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000000",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
},
{
"MeasurementIndex": 2,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000001",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
},
{
"MeasurementIndex": 3,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000002",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
}
]
}
},
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Actions": {
"#ComponentIntegrity.SPDMGetSignedMeasurements": {
"target": "/redfish/v1/ComponentIntegrity/SPDM_0_1/Actions/ComponentIntegrity.SPDMGetSignedMeasurements",
"@Redfish.ActionInfo": "/redfish/v1/ComponentIntegrity/SPDM_0_1/SPDMGetSignedMeasurementsActionInfo"
}
}
}

响应码：200

POST (ACTION)

SPDMGetSignedMeasurements

命令功能

基于SPDM协议获取组件签名测量值

命令格式

URL: https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id/Actions/ComponentIntegrity.SPDMGetSignedMeasurements

请求头:

text


X-Auth-Token: 123456789***********************
Content-Type: header_type

请求消息体:

json

{
"MeasurementIndices": measurement_indices,
"SlotId": slot_id,
"Nonce": nonce
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
component_integrity_id	指定完整性报告的ID	可通过完整性报告集合资源获得
measurement_indices	请求测量块的数组	非必需参数，可选填如下几个使用方式： 1、[1~254] 中的一个或多个唯一值 2、[255] 3、无此参数，默认使用[255]
slot_id	签名使用的证书槽位ID	非必需参数，可选填如下几个使用方式： 1、0~7：指定使用特定槽位标识符的证书 2、无此参数，默认使用 0
nonce	挑战随机数	非必需参数，可选填如下几个使用方式： 1、有此参数时，需要遵循规则： 2、无此参数时，自行生成随机数，需要遵循规则：`^[0-9a-fA-F]

ResourceDefinition

uris

/redfish/v1/ComponentIntegrity/component_integrity_id

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	ComponentIntegrity资源模型的OData描述信息
@odata.id	string	true	-	ComponentIntegrity资源节点的访问路径
@odata.type	string	true	-	ComponentIntegrity资源类型
Id	string	true	-	ComponentIntegrity资源的ID
Name	string	true	-	ComponentIntegrity资源的名称
Description	string	true	-	ComponentIntegrity资源的描述
Actions {	object	true	-	ComponentIntegrity可执行的操作
Actions.#ComponentIntegrity.SPDMGetSignedMeasurements {	object	true	-	获取SPDM签名度量值操作
`Actions.#ComponentIntegrity.SPDMGetSignedMeasurements.@Redfish.ActionInfo`	string	true	-	操作信息查询路径
Actions.#ComponentIntegrity.SPDMGetSignedMeasurements.target	string	true	-	操作路径
}
}
ComponentIntegrityType	string	true	SPDM	上报本完整性报告所使用的安全技术类型
ComponentIntegrityTypeVersion	string	true	-	上报本完整性报告所使用的安全技术的版本号
LastUpdated	string	true	-	完整性报告最后刷新时间
TargetComponentURI	string	true	-	指向一个提供本报告中完整性信息的资源的链接
SPDM {	object	true	-	本资源基于SPDM协议呈现的完整性信息
SPDM.IdentityAuthentication {	object	true	-	身份认证相关信息
SPDM.IdentityAuthentication.ResponderAuthentication {	object	true	-	响应者的认证信息
SPDM.IdentityAuthentication.ResponderAuthentication.ComponentCertificate {	object	true	-	响应者证书集合资源
`SPDM.IdentityAuthentication.ResponderAuthentication.ComponentCertificate.@odata.id`	string	true	-	响应者证书集合资源访问路径
}
}
}
SPDM.MeasurementSet {	object	true	-	响应者的测量信息
SPDM.MeasurementSet.MeasurementSpecification	string	true	DMTF	请求方与响应方之间协商的测量规范
SPDM.MeasurementSet.MeasurementSummaryType	string	true	TCB	测量摘要的类型
SPDM.MeasurementSet.MeasurementSummaryHashAlgorithm	string	true	-	测量摘要使用的哈希算法
SPDM.MeasurementSet.MeasurementSummary	string	true	-	测量摘要
SPDM.MeasurementSet.Measurements [ {	array	true	-	响应者的测量块集合
SPDM.MeasurementSet.Measurements[].MeasurementIndex	number	true	-	测量块的索引
SPDM.MeasurementSet.Measurements[].MeasurementHashAlgorithm	string	true	-	用于计算该测量块的hash算法
SPDM.MeasurementSet.Measurements[].Measurement	string	true	-	测量值
SPDM.MeasurementSet.Measurements[].LastUpdated	string	true	-	本测量块的最后更新时间
SPDM.MeasurementSet.Measurements[].PartofSummaryHash	boolean	true	-	该块是否为属于计算SummaryHash时使用的度量块的一部分
SPDM.MeasurementSet.Measurements[].MeasurementType	string	true	FirmwareConfiguration、HardwareConfiguration、ImmutableROM、MeasurementManifest、MutableFirmware、MutableFirmwareSecurityVersionNumber、MutableFirmwareVersion	该测量块所代表的数据类型或特征。仅当MeasurementSpecification为DMTF时，才会呈现本属性
} ]
}
}
Status {	object	true	-	完整性报告资源状态
Status.State	string	true	-	是否使能
Status.Health	string	true	-	健康状态
}
SecurityVersionNumber	string	true	-	测量值所代表的安全版本号说明：仅当MeasurementSpecification为DMTF且MeasurementType为MutableFirmwareSecurityVersionNumber时，才会呈现本属性

supported_methods

GET
POST

HTTP methods

GET

命令功能

查询组件完整性报告单个资源信息

命令格式

URL: https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id

请求头:

text


X-Auth-Token: 123456789***********************

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
component_integrity_id	指定完整性报告的ID	可通过完整性报告集合资源获得
auth_value	执行该请求时，必须在"Headers"中携带"X-Auth-Token"值用于鉴权	可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

openUBMC 25.12 LTS及以上版本支持

使用实例

请求样例：

http

GET <https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id>

请求头：

text


X-Auth-Token: 123456789***********************

请求消息体：无

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#ComponentIntegrity.ComponentIntegrity",
"@odata.id": "/redfish/v1/ComponentIntegrity/SPDM_0_1",
"@odata.type": "#ComponentIntegrity.ComponentIntegrity",
"Id": "SPDM_0_1",
"Name": "Component Integrity",
"Description": "SPDM Integrity Information for Controller_1 reported by SPDM_0",
"ComponentIntegrityType": "SPDM",
"ComponentIntegrityTypeVersion": "1.0",
"LastUpdated": "1970-01-01T00:00:55Z",
"TargetComponentURI": "/redfish/v1/Systems/1/Storages/RAIDStorage0",
"SPDM": {
"IdentityAuthentication": {
"ResponderAuthentication": {
"ComponentCertificate": {
"@odata.id": "/redfish/v1/Chassis/1/TrustedComponents/SPDM_0/Certificates"
}
}
},
"MeasurementSet": {
"MeasurementSpecification": "DMTF",
"MeasurementSummaryType": "TCB",
"MeasurementSummaryHashAlgorithm": "TPM_ALG_SHA_256",
"MeasurementSummary": "0101010101010101010101010101010101010101010101010101010101010101",
"Measurements": [
{
"MeasurementIndex": 1,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000000",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
},
{
"MeasurementIndex": 2,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000001",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
},
{
"MeasurementIndex": 3,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000002",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
}
]
}
},
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Actions": {
"#ComponentIntegrity.SPDMGetSignedMeasurements": {
"target": "/redfish/v1/ComponentIntegrity/SPDM_0_1/Actions/ComponentIntegrity.SPDMGetSignedMeasurements",
"@Redfish.ActionInfo": "/redfish/v1/ComponentIntegrity/SPDM_0_1/SPDMGetSignedMeasurementsActionInfo"
}
}
}

响应码：200

POST (ACTION)

SPDMGetSignedMeasurements

命令功能

基于SPDM协议获取组件签名测量值

命令格式

URL: https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id/Actions/ComponentIntegrity.SPDMGetSignedMeasurements

请求头:

text


X-Auth-Token: 123456789***********************
Content-Type: header_type

请求消息体:

json

{
"MeasurementIndices": measurement_indices,
"SlotId": slot_id,
"Nonce": nonce
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
component_integrity_id	指定完整性报告的ID	可通过完整性报告集合资源获得
measurement_indices	请求测量块的数组	非必需参数，可选填如下几个使用方式： 1、[1~254] 中的一个或多个唯一值 2、[255] 3、无此参数，默认使用[255]
slot_id	签名使用的证书槽位ID	非必需参数，可选填如下几个使用方式： 1、0~7：指定使用特定槽位标识符的证书 2、无此参数，默认使用 0
nonce	挑战随机数	非必需参数，可选填如下几个使用方式： 1、有此参数时，需要遵循规则：`^[0-9a-fA-F]

ResourceDefinition

uris

/redfish/v1/ComponentIntegrity/component_integrity_id

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	ComponentIntegrity资源模型的OData描述信息
@odata.id	string	true	-	ComponentIntegrity资源节点的访问路径
@odata.type	string	true	-	ComponentIntegrity资源类型
Id	string	true	-	ComponentIntegrity资源的ID
Name	string	true	-	ComponentIntegrity资源的名称
Description	string	true	-	ComponentIntegrity资源的描述
Actions {	object	true	-	ComponentIntegrity可执行的操作
Actions.#ComponentIntegrity.SPDMGetSignedMeasurements {	object	true	-	获取SPDM签名度量值操作
`Actions.#ComponentIntegrity.SPDMGetSignedMeasurements.@Redfish.ActionInfo`	string	true	-	操作信息查询路径
Actions.#ComponentIntegrity.SPDMGetSignedMeasurements.target	string	true	-	操作路径
}
}
ComponentIntegrityType	string	true	SPDM	上报本完整性报告所使用的安全技术类型
ComponentIntegrityTypeVersion	string	true	-	上报本完整性报告所使用的安全技术的版本号
LastUpdated	string	true	-	完整性报告最后刷新时间
TargetComponentURI	string	true	-	指向一个提供本报告中完整性信息的资源的链接
SPDM {	object	true	-	本资源基于SPDM协议呈现的完整性信息
SPDM.IdentityAuthentication {	object	true	-	身份认证相关信息
SPDM.IdentityAuthentication.ResponderAuthentication {	object	true	-	响应者的认证信息
SPDM.IdentityAuthentication.ResponderAuthentication.ComponentCertificate {	object	true	-	响应者证书集合资源
`SPDM.IdentityAuthentication.ResponderAuthentication.ComponentCertificate.@odata.id`	string	true	-	响应者证书集合资源访问路径
}
}
}
SPDM.MeasurementSet {	object	true	-	响应者的测量信息
SPDM.MeasurementSet.MeasurementSpecification	string	true	DMTF	请求方与响应方之间协商的测量规范
SPDM.MeasurementSet.MeasurementSummaryType	string	true	TCB	测量摘要的类型
SPDM.MeasurementSet.MeasurementSummaryHashAlgorithm	string	true	-	测量摘要使用的哈希算法
SPDM.MeasurementSet.MeasurementSummary	string	true	-	测量摘要
SPDM.MeasurementSet.Measurements [ {	array	true	-	响应者的测量块集合
SPDM.MeasurementSet.Measurements[].MeasurementIndex	number	true	-	测量块的索引
SPDM.MeasurementSet.Measurements[].MeasurementHashAlgorithm	string	true	-	用于计算该测量块的hash算法
SPDM.MeasurementSet.Measurements[].Measurement	string	true	-	测量值
SPDM.MeasurementSet.Measurements[].LastUpdated	string	true	-	本测量块的最后更新时间
SPDM.MeasurementSet.Measurements[].PartofSummaryHash	boolean	true	-	该块是否为属于计算SummaryHash时使用的度量块的一部分
SPDM.MeasurementSet.Measurements[].MeasurementType	string	true	FirmwareConfiguration、HardwareConfiguration、ImmutableROM、MeasurementManifest、MutableFirmware、MutableFirmwareSecurityVersionNumber、MutableFirmwareVersion	该测量块所代表的数据类型或特征。仅当MeasurementSpecification为DMTF时，才会呈现本属性
} ]
}
}
Status {	object	true	-	完整性报告资源状态
Status.State	string	true	-	是否使能
Status.Health	string	true	-	健康状态
}
SecurityVersionNumber	string	true	-	测量值所代表的安全版本号说明：仅当MeasurementSpecification为DMTF且MeasurementType为MutableFirmwareSecurityVersionNumber时，才会呈现本属性

supported_methods

GET
POST

HTTP methods

GET

命令功能

查询组件完整性报告单个资源信息

命令格式

URL: https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id

请求头:

text


X-Auth-Token: 123456789***********************

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
component_integrity_id	指定完整性报告的ID	可通过完整性报告集合资源获得
auth_value	执行该请求时，必须在"Headers"中携带"X-Auth-Token"值用于鉴权	可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

openUBMC 25.12 LTS及以上版本支持

使用实例

请求样例：

http

GET <https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id>

请求头：

text


X-Auth-Token: 123456789***********************

请求消息体：无

响应样例：

json

{
"@odata.context": "/redfish/v1/$metadata#ComponentIntegrity.ComponentIntegrity",
"@odata.id": "/redfish/v1/ComponentIntegrity/SPDM_0_1",
"@odata.type": "#ComponentIntegrity.ComponentIntegrity",
"Id": "SPDM_0_1",
"Name": "Component Integrity",
"Description": "SPDM Integrity Information for Controller_1 reported by SPDM_0",
"ComponentIntegrityType": "SPDM",
"ComponentIntegrityTypeVersion": "1.0",
"LastUpdated": "1970-01-01T00:00:55Z",
"TargetComponentURI": "/redfish/v1/Systems/1/Storages/RAIDStorage0",
"SPDM": {
"IdentityAuthentication": {
"ResponderAuthentication": {
"ComponentCertificate": {
"@odata.id": "/redfish/v1/Chassis/1/TrustedComponents/SPDM_0/Certificates"
}
}
},
"MeasurementSet": {
"MeasurementSpecification": "DMTF",
"MeasurementSummaryType": "TCB",
"MeasurementSummaryHashAlgorithm": "TPM_ALG_SHA_256",
"MeasurementSummary": "0101010101010101010101010101010101010101010101010101010101010101",
"Measurements": [
{
"MeasurementIndex": 1,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000000",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
},
{
"MeasurementIndex": 2,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000001",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
},
{
"MeasurementIndex": 3,
"MeasurementHashAlgorithm": "TPM_ALG_SHA_256",
"Measurement": "0000000000000000000000000000000000000000000000000000000000000002",
"LastUpdated": "1970-01-01T00:00:55Z",
"PartofSummaryHash": true,
"MeasurementType": "FirmwareConfiguration"
}
]
}
},
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Actions": {
"#ComponentIntegrity.SPDMGetSignedMeasurements": {
"target": "/redfish/v1/ComponentIntegrity/SPDM_0_1/Actions/ComponentIntegrity.SPDMGetSignedMeasurements",
"@Redfish.ActionInfo": "/redfish/v1/ComponentIntegrity/SPDM_0_1/SPDMGetSignedMeasurementsActionInfo"
}
}
}

响应码：200

POST (ACTION)

SPDMGetSignedMeasurements

命令功能

基于SPDM协议获取组件签名测量值

命令格式

URL: https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id/Actions/ComponentIntegrity.SPDMGetSignedMeasurements

请求头:

text


X-Auth-Token: 123456789***********************
Content-Type: header_type

请求消息体:

json

{
"MeasurementIndices": measurement_indices,
"SlotId": slot_id,
"Nonce": nonce
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
component_integrity_id	指定完整性报告的ID	可通过完整性报告集合资源获得
measurement_indices	请求测量块的数组	非必需参数，可选填如下几个使用方式： 1、[1~254] 中的一个或多个唯一值 2、[255] 3、无此参数，默认使用[255]
slot_id	签名使用的证书槽位ID	非必需参数，可选填如下几个使用方式： 1、0~7：指定使用特定槽位标识符的证书 2、无此参数，默认使用 0
nonce	挑战随机数	非必需参数，可选填如下几个使用方式： 1、有此参数时，需要遵循规则： 2、无此参数时，自行生成随机数，需要遵循规则：

使用指南

openUBMC 25.12 LTS及以上版本支持

使用实例

请求样例：

http

POST <https://device_ip/redfish/v1/ComponentIntegrity/component_integrity_id/Actions/ComponentIntegrity.SPDMGetSignedMeasurements>

请求头：

text


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体：

json

{
"MeasurementIndices": [
1,
2,
3
],
"SlotId": 0,
"Nonce": "000102030405060708090A0B0C0D0E0F101112131415161718191a1b1c1d1e1f"
}

响应样例：

json

{
"error": {
"code": "Base.1.0.GeneralError",
"message": "A general error has occurred. See ExtendedInfo for more information.",
"@Message.ExtendedInfo": [
{
"Certificate": {
"@odata.id": "/redfish/v1/Chassis/1/TrustedComponents/SPDM_0/Certificates/1"
},
"Version": "1.0",
"HashingAlgorithm": "TPM_ALG_SHA_256",
"SigningAlgorithm": "TPM_ALG_RSAPSS_2048",
"SignedMeasurements": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEB",
"@odata.type": "#Message.v1_0_0.Message",
"MessageId": "Base.1.0.Success",
"RelatedProperties": [],
"Message": "Successfully Completed Request",
"MessageArgs": [],
"Severity": "OK",
"Resolution": "None"
}
]
}
}

响应码：200

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

POST (ACTION) ​

SPDMGetSignedMeasurements ​

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

POST (ACTION) ​

SPDMGetSignedMeasurements ​

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

POST (ACTION) ​

SPDMGetSignedMeasurements ​

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

POST (ACTION) ​

SPDMGetSignedMeasurements ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

POST (ACTION)

SPDMGetSignedMeasurements

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

POST (ACTION)

SPDMGetSignedMeasurements

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

POST (ACTION)

SPDMGetSignedMeasurements

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

POST (ACTION)

SPDMGetSignedMeasurements