ResourceDefinition

uris

/redfish/v1/Managers/manager_id/SecurityService/TpcmService

properties

名称	类型	是否只读	说明
@odata.context	string	true	TPCM服务的OData描述信息
@odata.id	string	true	TPCM服务的访问路径
@odata.type	string	true	TPCM服务的类型
Description	string	true	TPCM服务的描述
Id	string	true	TPCM服务的ID
Name	string	true	TPCM服务的名称
TrustedCenterServerAddr	string	false	可信中心服务器地址
MeasureEnabled	boolean	false	度量开关
ControlPolicy	string	false	固件度量失败后的控制策略
LicenseType	int	true	License的类型：1-测试版，3-正式版
ExpiredTime	string	true	License的到期时间
Bios	string	false	Bios实际度量值
Shim	string	false	Shim实际度量值
Grub	string	false	Grub实际度量值
GrubCfg	string	false	GrubCfg实际度量值
Kernel	string	false	Kernel实际度量值
Initrd	string	false	Initrd实际度量值

supported_methods

GET
PATCH

HTTP methods

GET

命令功能

查询 TPCM 服务信息

命令格式

URL: https://device_ip/redfish/v1/Managers/manager_id/SecurityService/TpcmService

请求头:

X-Auth-Token: auth_value

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
auth_value	请求消息的鉴权参数	可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

支持的BMC版本：BMC300 5.3.0.1及之后的版本。插TPCM之后才支持。

使用实例

请求样例： GET https://device_ip/redfish/v1/Managers/manager_id/SecurityService/TpcmService

X-Auth-Token: auth_value 请求消息体：无

响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#TpcmService.TpcmService",
  "@odata.id": "/redfish/v1/Managers/1/SecurityService/TpcmService",
  "@odata.type": "#TpcmService.v1_0_0.TpcmService",
  "Description": "Tpcm Service",
  "Name": "TpcmService",
  "Id": "TpcmService",
  "TrustedCenterServerAddr": "10.10.10.1",
  "MeasureEnabled": true,
  "ControlPolicy": "intercept boot",
  "TsbLicenseInfo": {
    "LicenseType": 1,
    "ExpiredTime": "2024-05-28 08:59:46"
  },
  "ActualDigest": {
    "Bios": "c41937dfb6a5124d4cae70c8c54fceee1248bdd4a921eaf4f81938d37b32e261",
    "Shim": "d03437f2e3d87830b17ab4cc5b060d180b04acffc9b375275677fdf704cc7320",
    "Grub": "b513badc535f42d0e6cfd2a7765904e3f2751fed522685dabf59ee71160bf9f3",
    "GrubCfg": "86a709533576d370ec2b7eae6c6c7b21b8afcf37fc2be6919bbb8e12addf889d",
    "Kernel": "62210c63132546ead45a7723f2bd0ee33335f6ff5e242bd10996edc27cb96033",
    "Initrd": "5ebca95e07fc0f418ad79ad0e25273c41d7929c51be6d8015ecf788c73094914"
  },
  "StandardDigest": {
    "Bios": "c41937dfb6a5124d4cae70c8c54fceee1248bdd4a921eaf4f81938d37b32e261",
    "Shim": "d03437f2e3d87830b17ab4cc5b060d180b04acffc9b375275677fdf704cc7320",
    "Grub": "b513badc535f42d0e6cfd2a7765904e3f2751fed522685dabf59ee71160bf9f3",
    "GrubCfg": "86a709533576d370ec2b7eae6c6c7b21b8afcf37fc2be6919bbb8e12addf889d",
    "Kernel": "62210c63132546ead45a7723f2bd0ee33335f6ff5e242bd10996edc27cb96033",
    "Initrd": "5ebca95e07fc0f418ad79ad0e25273c41d7929c51be6d8015ecf788c73094914"
  }
}

响应码：200

PATCH

命令功能

设置 TPCM 服务信息

命令格式

URL: https://device_ip/redfish/v1/Managers/manager_id/SecurityService/TpcmService

请求头:

X-Auth-Token: auth_value
Content-Type: header_type
If-Match: ifmatch_value

请求消息体:

json

{
  "TrustedCenterServerAddr": addr,
  "MeasureEnabled": enable,
  "ControlPolicy": policy,
  "StandardDigest": {
    "Bios": bios_value,
    "Shim": shim_value,
    "Grub": grub_value,
    "GrubCfg": grubcfg_value,
    "Kernel": kernel_value,
    "Initrd": initrd_value
  }
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
ifmatch_value	请求消息的匹配参数	可通过对相应资源发起GET操作，从响应头中获取（对应于“ETag” 参数）
addr	可信中心服务器地址	ipv4、IPv6或域名
enable	度量开关	● false：关闭 ● true：开启默认开启
policy	固件度量失败后的控制策略	● no action：无动作 ● intercept boot：阻止启动默认无动作
bios_value	Bios基准值	● null：自动获取当前实际度量值 ● 字符串：64个字符
shim_value	Shim基准值	● null：自动获取当前实际度量值 ● 字符串：64个字符
grub_value	Grub基准值	● null：自动获取当前实际度量值 ● 字符串：64个字符
grubcfg_value	GrubCfg基准值	● null：自动获取当前实际度量值 ● 字符串：64个字符
kernel_value	Kernel基准值	● null：自动获取当前实际度量值 ● 字符串：64个字符
initrd_value	Initrd基准值	● null：自动获取当前实际度量值 ● 字符串：64个字符

使用指南

支持的BMC版本：BMC300 5.3.0.1及之后的版本。插TPCM之后才支持。

使用实例

请求样例： PATCH https://device_ip/redfish/v1/Managers/manager_id/SecurityService/TpcmService

X-Auth-Token: auth_value Content-Type: header_type If-Match: ifmatch_value 请求消息体：

json

{
  "TrustedCenterServerAddr": addr,
  "MeasureEnabled": enable,
  "ControlPolicy": policy,
  "StandardDigest": {
    "Bios": bios_value,
    "Shim": shim_value,
    "Grub": grub_value,
    "GrubCfg": grubcfg_value,
    "Kernel": kernel_value,
    "Initrd": initrd_value
  }
}

响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#TpcmService.TpcmService",
  "@odata.id": "/redfish/v1/Managers/1/SecurityService/TpcmService",
  "@odata.type": "#TpcmService.v1_0_0.TpcmService",
  "Description": "Tpcm Service",
  "Name": "TpcmService",
  "Id": "TpcmService",
  "TrustedCenterServerAddr": "127.0.0.1",
  "MeasureEnabled": enable,
  "ControlPolicy": policy,
  "ActualDigest": {
    "Bios": bios_value,
    "Shim": shim_value,
    "Grub": grub_value,
    "GrubCfg": grubcfg_value,
    "Kernel": kernel_value,
    "Initrd": initrd_value
  },
  "StandardDigest": {
    "Bios": bios_value,
    "Shim": shim_value,
    "Grub": grub_value,
    "GrubCfg": grubcfg_value,
    "Kernel": kernel_value,
    "Initrd": initrd_value
  }
}

响应码：200

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

PATCH ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

PATCH