1{ 2 "$id": "http://redfish.dmtf.org/schemas/v1/ComponentIntegrity.v1_2_3.json", 3 "$ref": "#/definitions/ComponentIntegrity", 4 "$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json", 5 "copyright": "Copyright 2014-2024 DMTF. For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright", 6 "definitions": { 7 "Actions": { 8 "additionalProperties": false, 9 "description": "The available actions for this resource.", 10 "longDescription": "This type shall contain the available actions for this resource.", 11 "patternProperties": { 12 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 13 "description": "This property shall specify a valid odata or Redfish property.", 14 "type": [ 15 "array", 16 "boolean", 17 "integer", 18 "number", 19 "null", 20 "object", 21 "string" 22 ] 23 } 24 }, 25 "properties": { 26 "#ComponentIntegrity.SPDMGetSignedMeasurements": { 27 "$ref": "#/definitions/SPDMGetSignedMeasurements" 28 }, 29 "#ComponentIntegrity.TPMGetSignedMeasurements": { 30 "$ref": "#/definitions/TPMGetSignedMeasurements" 31 }, 32 "Oem": { 33 "$ref": "#/definitions/OemActions", 34 "description": "The available OEM-specific actions for this resource.", 35 "longDescription": "This property shall contain the available OEM-specific actions for this resource." 36 } 37 }, 38 "type": "object" 39 }, 40 "CommonAuthInfo": { 41 "additionalProperties": false, 42 "description": "Common Authentication information.", 43 "longDescription": "This object shall contain common identity-related authentication information.", 44 "patternProperties": { 45 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 46 "description": "This property shall specify a valid odata or Redfish property.", 47 "type": [ 48 "array", 49 "boolean", 50 "integer", 51 "number", 52 "null", 53 "object", 54 "string" 55 ] 56 } 57 }, 58 "properties": { 59 "ComponentCertificate": { 60 "$ref": "http://redfish.dmtf.org/schemas/v1/Certificate.json#/definitions/Certificate", 61 "description": "A link to the certificate that represents the identity of the component.", 62 "longDescription": "This property shall contain a link to a resource of type `Certificate` that represents the identity of the component referenced by the `TargetComponentURI` property.", 63 "readonly": true 64 }, 65 "VerificationStatus": { 66 "anyOf": [ 67 { 68 "$ref": "#/definitions/VerificationStatus" 69 }, 70 { 71 "type": "null" 72 } 73 ], 74 "description": "The status of the verification of the identity of the component.", 75 "longDescription": "This property shall contain the status of the verification of the identity of the component referenced by the `TargetComponentURI` property.", 76 "readonly": true 77 } 78 }, 79 "type": "object" 80 }, 81 "CommunicationInfo": { 82 "additionalProperties": false, 83 "description": "Information about communication between two components.", 84 "longDescription": "This object shall contain information about communication between two components.", 85 "patternProperties": { 86 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 87 "description": "This property shall specify a valid odata or Redfish property.", 88 "type": [ 89 "array", 90 "boolean", 91 "integer", 92 "number", 93 "null", 94 "object", 95 "string" 96 ] 97 } 98 }, 99 "properties": { 100 "Sessions": { 101 "description": "The active sessions or communication channels between two components.", 102 "items": { 103 "anyOf": [ 104 { 105 "$ref": "#/definitions/SingleSessionInfo" 106 }, 107 { 108 "type": "null" 109 } 110 ] 111 }, 112 "longDescription": "This property shall contain an array of the active sessions or communication channels between two components. The active sessions or communication channels do not reflect how future sessions or communication channels are established.", 113 "type": "array" 114 } 115 }, 116 "type": "object" 117 }, 118 "ComponentIntegrity": { 119 "additionalProperties": false, 120 "description": "The `ComponentIntegrity` resource provides critical and pertinent security information about a specific device, system, software element, or other managed entity.", 121 "longDescription": "This resource shall represent critical and pertinent security information about a specific device, system, software element, or other managed entity.", 122 "patternProperties": { 123 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 124 "description": "This property shall specify a valid odata or Redfish property.", 125 "type": [ 126 "array", 127 "boolean", 128 "integer", 129 "number", 130 "null", 131 "object", 132 "string" 133 ] 134 } 135 }, 136 "properties": { 137 "@odata.context": { 138 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/context" 139 }, 140 "@odata.etag": { 141 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/etag" 142 }, 143 "@odata.id": { 144 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/id" 145 }, 146 "@odata.type": { 147 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/type" 148 }, 149 "Actions": { 150 "$ref": "#/definitions/Actions", 151 "description": "The available actions for this resource.", 152 "longDescription": "This property shall contain the available actions for this resource." 153 }, 154 "ComponentIntegrityEnabled": { 155 "description": "An indication of whether security protocols are enabled for the component.", 156 "longDescription": "This property shall indicate whether security protocols are enabled for the component. If `ComponentIntegrityType` contains `SPDM`, a value of `false` shall prohibit the SPDM Requester from using SPDM to communicate with the component identified by the `TargetComponentURI` property. If `ComponentIntegrityType` contains `TPM`, a value of `false` shall disable the TPM component identified by the `TargetComponentURI` property entirely. If `false`, services shall not provide the TPM and SPDM properties in response payloads for this resource. If `false`, services shall reject action requests to this resource. If `true`, services shall allow security protocols with the component identified by the `TargetComponentURI` property.", 157 "readonly": false, 158 "type": "boolean" 159 }, 160 "ComponentIntegrityType": { 161 "$ref": "#/definitions/ComponentIntegrityType", 162 "description": "The type of security technology for the component.", 163 "longDescription": "This value of this property shall contain the underlying security technology providing integrity information for the component.", 164 "readonly": true 165 }, 166 "ComponentIntegrityTypeVersion": { 167 "description": "The version of the security technology.", 168 "longDescription": "This value of this property shall contain the version of the security technology indicated by the `ComponentIntegrityType` property. If the service has not established secure communication with the device or if security protocols are disabled, this property shall contain an empty string. If `ComponentIntegrityType` contains `SPDM`, this property shall contain the negotiated or selected SPDM protocol and shall follow the regular expression pattern `^\\d+\\.\\d+\\.\\d+$`. If `ComponentIntegrityType` contains `TPM`, this property shall contain the version of the TPM.", 169 "readonly": true, 170 "type": "string" 171 }, 172 "Description": { 173 "anyOf": [ 174 { 175 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Description" 176 }, 177 { 178 "type": "null" 179 } 180 ], 181 "readonly": true 182 }, 183 "Id": { 184 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Id", 185 "readonly": true 186 }, 187 "LastUpdated": { 188 "description": "The date and time when information for the component was last updated.", 189 "format": "date-time", 190 "longDescription": "This property shall contain the date and time when information for the component was last updated.", 191 "readonly": true, 192 "type": [ 193 "string", 194 "null" 195 ] 196 }, 197 "Links": { 198 "$ref": "#/definitions/Links", 199 "description": "The links to other resources that are related to this resource.", 200 "longDescription": "This property shall contain links to resources that are related to but are not contained by, or subordinate to, this resource." 201 }, 202 "Name": { 203 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Name", 204 "readonly": true 205 }, 206 "Oem": { 207 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", 208 "description": "The OEM extension property.", 209 "longDescription": "This property shall contain the OEM extensions. All values for properties that this object contains shall conform to the Redfish Specification-described requirements." 210 }, 211 "SPDM": { 212 "$ref": "#/definitions/SPDMinfo", 213 "description": "Integrity information about the SPDM Responder as reported by an SPDM Requester.", 214 "longDescription": "This property shall contain integrity information about the SPDM Responder identified by the `TargetComponentURI` property as reported by an SPDM Requester. This property shall be present if `ComponentIntegrityType` contains `SPDM` and if `ComponentIntegrityEnabled` contains `true`. For other cases, this property shall be absent." 215 }, 216 "Status": { 217 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Status", 218 "description": "The status and health of the resource and its subordinate or dependent resources.", 219 "longDescription": "This property shall contain any status or health properties of the resource." 220 }, 221 "TPM": { 222 "$ref": "#/definitions/TPMinfo", 223 "description": "Integrity information about the Trusted Platform Module (TPM).", 224 "longDescription": "This property shall contain integrity information about the Trusted Platform Module (TPM) identified by the `TargetComponentURI` property. This property shall be present if `ComponentIntegrityType` contains `TPM` and if `ComponentIntegrityEnabled` contains `true`. For other cases, this property shall be absent." 225 }, 226 "TargetComponentURI": { 227 "description": "The link to the component whose integrity that this resource reports.", 228 "format": "uri-reference", 229 "longDescription": "This value of this property shall contain a link to the resource whose integrity information is reported in this resource. If `ComponentIntegrityType` contains `SPDM`, this property shall contain a URI to the resource that represents the SPDM Responder. If `ComponentIntegrityType` contains `TPM`, this property shall contain a URI with RFC6901-defined JSON fragment notation to a member of the TrustedModules array in a ComputerSystem resource that represents the TPM or a resource of type `TrustedComponent` that represents the TPM.", 230 "readonly": true, 231 "type": "string" 232 } 233 }, 234 "required": [ 235 "ComponentIntegrityType", 236 "ComponentIntegrityTypeVersion", 237 "TargetComponentURI", 238 "@odata.id", 239 "@odata.type", 240 "Id", 241 "Name" 242 ], 243 "type": "object" 244 }, 245 "ComponentIntegrityType": { 246 "enum": [ 247 "SPDM", 248 "TPM", 249 "OEM" 250 ], 251 "enumDescriptions": { 252 "OEM": "OEM-specific.", 253 "SPDM": "Security Protocol and Data Model (SPDM) protocol.", 254 "TPM": "Trusted Platform Module (TPM)." 255 }, 256 "enumLongDescriptions": { 257 "OEM": "This value shall indicate the integrity information is OEM-specific and the OEM section may include additional information.", 258 "SPDM": "This value shall indicate the integrity information is obtained through the Security Protocol and Data Model (SPDM) protocol as defined in DMTF DSP0274.", 259 "TPM": "This value shall indicate the integrity information is related to a Trusted Platform Module (TPM) as defined by the Trusted Computing Group (TCG)." 260 }, 261 "type": "string" 262 }, 263 "DMTFmeasurementTypes": { 264 "enum": [ 265 "ImmutableROM", 266 "MutableFirmware", 267 "HardwareConfiguration", 268 "FirmwareConfiguration", 269 "MutableFirmwareVersion", 270 "MutableFirmwareSecurityVersionNumber", 271 "MeasurementManifest" 272 ], 273 "enumDescriptions": { 274 "FirmwareConfiguration": "Firmware configuration, such as configurable firmware policy.", 275 "HardwareConfiguration": "Hardware configuration, such as straps.", 276 "ImmutableROM": "Immutable ROM.", 277 "MeasurementManifest": "Measurement Manifest.", 278 "MutableFirmware": "Mutable firmware or any mutable code.", 279 "MutableFirmwareSecurityVersionNumber": "Mutable firmware security version number.", 280 "MutableFirmwareVersion": "Mutable firmware version." 281 }, 282 "type": "string" 283 }, 284 "Links": { 285 "additionalProperties": false, 286 "description": "The links to other resources that are related to this resource.", 287 "longDescription": "This Redfish Specification-described type shall contain links to resources that are related to but are not contained by, or subordinate to, this resource.", 288 "patternProperties": { 289 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 290 "description": "This property shall specify a valid odata or Redfish property.", 291 "type": [ 292 "array", 293 "boolean", 294 "integer", 295 "number", 296 "null", 297 "object", 298 "string" 299 ] 300 } 301 }, 302 "properties": { 303 "ComponentsProtected": { 304 "description": "An array of links to resources that the target component protects.", 305 "items": { 306 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/idRef" 307 }, 308 "longDescription": "This property shall contain an array of links to resources that the component identified by the `TargetComponentURI` property provides integrity protection. This property shall not contain the value of the `TargetComponentURI` property.", 309 "readonly": true, 310 "type": "array" 311 }, 312 "ComponentsProtected@odata.count": { 313 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count" 314 }, 315 "Oem": { 316 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", 317 "description": "The OEM extension property.", 318 "longDescription": "This property shall contain the OEM extensions. All values for properties contained in this object shall conform to the Redfish Specification-described requirements." 319 } 320 }, 321 "type": "object" 322 }, 323 "MeasurementSpecification": { 324 "enum": [ 325 "DMTF" 326 ], 327 "enumDescriptions": { 328 "DMTF": "DMTF." 329 }, 330 "enumLongDescriptions": { 331 "DMTF": "This value shall indicate the measurement specification is defined by DMTF in DSP0274." 332 }, 333 "type": "string" 334 }, 335 "OemActions": { 336 "additionalProperties": true, 337 "description": "The available OEM-specific actions for this resource.", 338 "longDescription": "This type shall contain the available OEM-specific actions for this resource.", 339 "patternProperties": { 340 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 341 "description": "This property shall specify a valid odata or Redfish property.", 342 "type": [ 343 "array", 344 "boolean", 345 "integer", 346 "number", 347 "null", 348 "object", 349 "string" 350 ] 351 } 352 }, 353 "properties": {}, 354 "type": "object" 355 }, 356 "SPDMGetSignedMeasurements": { 357 "actionResponse": { 358 "$ref": "#/definitions/SPDMGetSignedMeasurementsResponse" 359 }, 360 "additionalProperties": false, 361 "description": "This action generates an SPDM cryptographic signed statement over the given nonce and measurements of the SPDM Responder.", 362 "longDescription": "This action shall generate a cryptographic signed statement over the given nonce and measurements corresponding to the SPDM Responder. This action shall not be present if the `ComponentIntegrityType` property does not contain the value `SPDM`. The SPDM Requester shall issue one or more SPDM 'GET_MEASUREMENTS' requests for each of the requested measurement indices to the SPDM Responder. When the SPDM 'GET_MEASUREMENTS' requests are made for version 1.2, the parameter 'RawBitStreamRequested' shall contain `0`. The SPDM Requester shall provide the nonce for the action to the SPDM Responder in the last SPDM 'GET_MEASUREMENTS' request. The SPDM Requester shall request a signature in the last SPDM 'GET_MEASUREMENTS' request.", 363 "parameters": { 364 "MeasurementIndices": { 365 "description": "An array of indices that identify the measurement blocks to sign.", 366 "items": { 367 "type": "integer" 368 }, 369 "longDescription": "This parameter shall contain an array of indices that identify the measurement blocks to sign. This array shall contain one or more unique values between `0` to `254`, inclusive, or contain a single value of `255`. If not provided by the client, the value shall be assumed to be an array containing a single value of `255`.", 370 "type": "array" 371 }, 372 "Nonce": { 373 "description": "A 32-byte hex-encoded string that is signed with the measurements. The value should be unique.", 374 "longDescription": "This parameter shall contain a 32-byte hex-encoded string that is signed with the measurements. If not provided by the client, the SPDM Requester shall generate the nonce. The value should be unique and generated using a random or a pseudo-random generator. The SPDM Requester shall send this value to the SPDM Responder in the SPDM 'GET_MEASUREMENTS' request.", 375 "pattern": "^[0-9a-fA-F]{64}$", 376 "type": "string" 377 }, 378 "SlotId": { 379 "description": "The slot identifier for the certificate containing the private key to generate the signature over the measurements.", 380 "longDescription": "This parameter shall contain the SPDM slot identifier for the certificate containing the private key to generate the signature over the measurements. If not provided by the client, the value shall be assumed to be `0`. The SPDM Requester shall send this value to the SPDM Responder in the SPDM 'GET_MEASUREMENTS' request.", 381 "type": "integer" 382 } 383 }, 384 "patternProperties": { 385 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 386 "description": "This property shall specify a valid odata or Redfish property.", 387 "type": [ 388 "array", 389 "boolean", 390 "integer", 391 "number", 392 "null", 393 "object", 394 "string" 395 ] 396 } 397 }, 398 "properties": { 399 "target": { 400 "description": "Link to invoke action", 401 "format": "uri-reference", 402 "type": "string" 403 }, 404 "title": { 405 "description": "Friendly action name", 406 "type": "string" 407 } 408 }, 409 "type": "object" 410 }, 411 "SPDMGetSignedMeasurementsResponse": { 412 "additionalProperties": false, 413 "description": "The SPDM signed measurement from an SPDM Responder.", 414 "longDescription": "This object shall contain the SPDM signed measurements from an SPDM Responder.", 415 "patternProperties": { 416 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 417 "description": "This property shall specify a valid odata or Redfish property.", 418 "type": [ 419 "array", 420 "boolean", 421 "integer", 422 "number", 423 "null", 424 "object", 425 "string" 426 ] 427 } 428 }, 429 "properties": { 430 "Certificate": { 431 "$ref": "http://redfish.dmtf.org/schemas/v1/Certificate.json#/definitions/Certificate", 432 "description": "A link to the certificate corresponding to the SPDM slot identifier that can be used to validate the signature.", 433 "longDescription": "This property shall contain a link to a resource of type `Certificate` that represents the certificate corresponding to the SPDM slot identifier that can be used to validate the signature. This property shall not be present if the SlotId parameter contains the value `15`.", 434 "readonly": true 435 }, 436 "HashingAlgorithm": { 437 "description": "The hashing algorithm used for generating the cryptographic signed statement.", 438 "longDescription": "This property shall contain the hashing algorithm negotiated between the SPDM Requester and the SPDM Responder. The allowable values for this property shall be the hash algorithm names found in the 'BaseHashAlgo' field of the 'NEGOTIATE_ALGORITHMS' request message in DSP0274. If the algorithm is an extended algorithm, this property shall contain the value `OEM`.", 439 "readonly": true, 440 "type": "string" 441 }, 442 "Oem": { 443 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", 444 "description": "The OEM extension property.", 445 "longDescription": "This property shall contain the OEM extensions. All values for properties contained in this object shall conform to the Redfish Specification-described requirements." 446 }, 447 "PublicKey": { 448 "description": "A Privacy Enhanced Mail (PEM)-encoded public key that can be used to validate the signature.", 449 "longDescription": "This property shall contain a Privacy Enhanced Mail (PEM)-encoded public key, as defined in section 13 of RFC7468, that can be used to validate the signature. This property shall only be present when the SPDM Requester was pre-provisioned with the SPDM Responder's public key and the SlotId parameter contains the value `15`.", 450 "readonly": true, 451 "type": "string" 452 }, 453 "SignedMeasurements": { 454 "description": "Base64-encoded cryptographic signed statement generated by the signer.", 455 "longDescription": "This property shall contain the cryptographic signed statement over the given nonce and measurement blocks corresponding to the requested measurement indices. If the SPDM version is 1.2, this value shall be a concatenation of SPDM 'VCA' and 'GET_MEASUREMENTS' requests and responses exchanged between the SPDM Requester and the SPDM Responder. If SPDM version is 1.0 or 1.1, this value shall be a concatenation of SPDM 'GET_MEASUREMENTS' requests and responses exchanged between the SPDM Requester and the SPDM Responder. The last 'MEASUREMENTS' response shall contain a signature generated over the 'L2' string by the SPDM Responder.", 456 "readonly": true, 457 "type": "string" 458 }, 459 "SigningAlgorithm": { 460 "description": "The asymmetric signing algorithm used for generating the cryptographic signed statement.", 461 "longDescription": "This property shall contain the asymmetric signing algorithm negotiated between the SPDM Requester and the SPDM Responder. The allowable values for this property shall be the asymmetric key signature algorithm names found in the 'BaseAsymAlgo' field of the 'NEGOTIATE_ALGORITHMS' request message in DSP0274. If the algorithm is an extended algorithm, this property shall contain the value `OEM`.", 462 "readonly": true, 463 "type": "string" 464 }, 465 "Version": { 466 "description": "The SPDM version used by the SPDM Responder to generate the cryptographic signed statement.", 467 "longDescription": "This property shall contain the SPDM version negotiated between the SPDM Requester and the SPDM Responder to generate the cryptographic signed statement. For example, `1.0`, `1.1`, or `1.2`.", 468 "readonly": true, 469 "type": "string" 470 } 471 }, 472 "required": [ 473 "SignedMeasurements", 474 "Version", 475 "HashingAlgorithm", 476 "SigningAlgorithm" 477 ], 478 "type": "object" 479 }, 480 "SPDMcommunication": { 481 "additionalProperties": false, 482 "description": "Information about communication between two components.", 483 "longDescription": "This object shall contain information about communication between two components.", 484 "patternProperties": { 485 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 486 "description": "This property shall specify a valid odata or Redfish property.", 487 "type": [ 488 "array", 489 "boolean", 490 "integer", 491 "number", 492 "null", 493 "object", 494 "string" 495 ] 496 } 497 }, 498 "properties": { 499 "Sessions": { 500 "description": "The active sessions or communication channels between two components.", 501 "items": { 502 "anyOf": [ 503 { 504 "$ref": "#/definitions/SingleSessionInfo" 505 }, 506 { 507 "type": "null" 508 } 509 ] 510 }, 511 "longDescription": "This property shall contain an array of the active sessions or communication channels between two components. The active sessions or communication channels do not reflect how future sessions or communication channels are established.", 512 "type": "array" 513 } 514 }, 515 "type": "object" 516 }, 517 "SPDMidentity": { 518 "additionalProperties": false, 519 "description": "Identity authentication information about the SPDM Requester and SPDM Responder.", 520 "longDescription": "This object shall contain identity authentication information about the SPDM Requester and SPDM Responder.", 521 "patternProperties": { 522 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 523 "description": "This property shall specify a valid odata or Redfish property.", 524 "type": [ 525 "array", 526 "boolean", 527 "integer", 528 "number", 529 "null", 530 "object", 531 "string" 532 ] 533 } 534 }, 535 "properties": { 536 "RequesterAuthentication": { 537 "anyOf": [ 538 { 539 "$ref": "#/definitions/SPDMrequesterAuth" 540 }, 541 { 542 "type": "null" 543 } 544 ], 545 "description": "Authentication information of the identity of the SPDM Requester.", 546 "longDescription": "This property shall contain authentication information of the identity of the SPDM Requester." 547 }, 548 "ResponderAuthentication": { 549 "anyOf": [ 550 { 551 "$ref": "#/definitions/SPDMresponderAuth" 552 }, 553 { 554 "type": "null" 555 } 556 ], 557 "description": "Authentication information of the identity of the SPDM Responder.", 558 "longDescription": "This property shall contain authentication information of the identity of the SPDM Responder." 559 } 560 }, 561 "type": "object" 562 }, 563 "SPDMinfo": { 564 "additionalProperties": false, 565 "description": "Integrity information about an SPDM Responder as reported by an SPDM Requester.", 566 "longDescription": "This object shall contain integrity information about an SPDM Responder as reported by an SPDM Requester.", 567 "patternProperties": { 568 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 569 "description": "This property shall specify a valid odata or Redfish property.", 570 "type": [ 571 "array", 572 "boolean", 573 "integer", 574 "number", 575 "null", 576 "object", 577 "string" 578 ] 579 } 580 }, 581 "properties": { 582 "ComponentCommunication": { 583 "anyOf": [ 584 { 585 "$ref": "#/definitions/SPDMcommunication" 586 }, 587 { 588 "type": "null" 589 } 590 ], 591 "description": "Information about communication between the SPDM Requester and SPDM Responder.", 592 "longDescription": "This property shall contain information about communication between the SPDM Requester and SPDM Responder." 593 }, 594 "IdentityAuthentication": { 595 "anyOf": [ 596 { 597 "$ref": "#/definitions/SPDMidentity" 598 }, 599 { 600 "type": "null" 601 } 602 ], 603 "description": "Identity authentication information about the SPDM Requester and SPDM Responder.", 604 "longDescription": "This property shall contain identity authentication information about the SPDM Requester and SPDM Responder." 605 }, 606 "MeasurementSet": { 607 "anyOf": [ 608 { 609 "$ref": "#/definitions/SPDMmeasurementSet" 610 }, 611 { 612 "type": "null" 613 } 614 ], 615 "description": "Measurement information about the SPDM Responder.", 616 "longDescription": "This property shall contain measurement information for the SPDM Responder." 617 }, 618 "Requester": { 619 "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/idRef", 620 "description": "The link to the component that is reporting the integrity information of the target component.", 621 "longDescription": "This property shall contain a link to the resource representing the SPDM Responder that is reporting the integrity of the SPDM Responder identified by the `TargetComponentURI` property.", 622 "readonly": true 623 } 624 }, 625 "required": [ 626 "Requester" 627 ], 628 "type": "object" 629 }, 630 "SPDMmeasurementSet": { 631 "additionalProperties": false, 632 "description": "SPDM Responder measurement information.", 633 "longDescription": "This object shall contain SPDM Responder measurement information.", 634 "patternProperties": { 635 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 636 "description": "This property shall specify a valid odata or Redfish property.", 637 "type": [ 638 "array", 639 "boolean", 640 "integer", 641 "number", 642 "null", 643 "object", 644 "string" 645 ] 646 } 647 }, 648 "properties": { 649 "MeasurementSpecification": { 650 "anyOf": [ 651 { 652 "$ref": "#/definitions/MeasurementSpecification" 653 }, 654 { 655 "type": "null" 656 } 657 ], 658 "description": "The measurement specification negotiated between the SPDM Requester and SPDM Responder.", 659 "longDescription": "This property shall contain the measurement specification negotiated between the SPDM Requester and SPDM Responder.", 660 "readonly": true 661 }, 662 "MeasurementSummary": { 663 "description": "The measurement summary data.", 664 "longDescription": "This property shall contain the Base64-encoded measurement summary using the hash algorithm indicated by the `MeasurementSummaryHashAlgorithm` property.", 665 "pattern": "^[A-Za-z0-9+/]+={0,2}$", 666 "readonly": true, 667 "type": [ 668 "string", 669 "null" 670 ] 671 }, 672 "MeasurementSummaryHashAlgorithm": { 673 "description": "The hash algorithm used to compute the measurement summary.", 674 "longDescription": "This property shall contain the hash algorithm used to compute the measurement summary. The allowable values for this property shall be the hash algorithm names found in the 'BaseHashAlgo' field of the 'NEGOTIATE_ALGORITHMS' request message in DSP0274. If the algorithm is an extended algorithm, this property shall contain the value `OEM`.", 675 "readonly": true, 676 "type": [ 677 "string", 678 "null" 679 ] 680 }, 681 "MeasurementSummaryType": { 682 "anyOf": [ 683 { 684 "$ref": "#/definitions/SPDMmeasurementSummaryType" 685 }, 686 { 687 "type": "null" 688 } 689 ], 690 "description": "The type of measurement summary.", 691 "longDescription": "This property shall contain the type of measurement summary.", 692 "readonly": true 693 }, 694 "Measurements": { 695 "description": "Measurements from an SPDM Responder.", 696 "items": { 697 "anyOf": [ 698 { 699 "$ref": "#/definitions/SPDMsingleMeasurement" 700 }, 701 { 702 "type": "null" 703 } 704 ] 705 }, 706 "longDescription": "This property shall contain measurements from an SPDM Responder.", 707 "type": "array" 708 }, 709 "Oem": { 710 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", 711 "description": "The OEM extension property.", 712 "longDescription": "This property shall contain the OEM extensions. All values for properties contained in this object shall conform to the Redfish Specification-described requirements." 713 } 714 }, 715 "type": "object" 716 }, 717 "SPDMmeasurementSummaryType": { 718 "enum": [ 719 "TCB", 720 "All" 721 ], 722 "enumDescriptions": { 723 "All": "The measurement summary covers all measurements in SPDM.", 724 "TCB": "The measurement summary covers the TCB." 725 }, 726 "type": "string" 727 }, 728 "SPDMrequesterAuth": { 729 "additionalProperties": false, 730 "description": "Authentication information of the identity of the SPDM Requester.", 731 "longDescription": "This object shall contain authentication information of the identity of the SPDM Requester.", 732 "patternProperties": { 733 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 734 "description": "This property shall specify a valid odata or Redfish property.", 735 "type": [ 736 "array", 737 "boolean", 738 "integer", 739 "number", 740 "null", 741 "object", 742 "string" 743 ] 744 } 745 }, 746 "properties": { 747 "ProvidedCertificate": { 748 "$ref": "http://redfish.dmtf.org/schemas/v1/Certificate.json#/definitions/Certificate", 749 "description": "A link to the certificate that represents the identity of the SPDM Requester provided in mutual authentication.", 750 "longDescription": "This property shall contain a link to a resource of type `Certificate` that represents the identity of the SPDM Requester provided in mutual authentication.", 751 "readonly": true 752 } 753 }, 754 "type": "object" 755 }, 756 "SPDMresponderAuth": { 757 "additionalProperties": false, 758 "description": "Common Authentication information.", 759 "longDescription": "This object shall contain common identity-related authentication information.", 760 "patternProperties": { 761 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 762 "description": "This property shall specify a valid odata or Redfish property.", 763 "type": [ 764 "array", 765 "boolean", 766 "integer", 767 "number", 768 "null", 769 "object", 770 "string" 771 ] 772 } 773 }, 774 "properties": { 775 "ComponentCertificate": { 776 "$ref": "http://redfish.dmtf.org/schemas/v1/Certificate.json#/definitions/Certificate", 777 "description": "A link to the certificate that represents the identity of the component.", 778 "longDescription": "This property shall contain a link to a resource of type `Certificate` that represents the identity of the component referenced by the `TargetComponentURI` property.", 779 "readonly": true 780 }, 781 "VerificationStatus": { 782 "anyOf": [ 783 { 784 "$ref": "#/definitions/VerificationStatus" 785 }, 786 { 787 "type": "null" 788 } 789 ], 790 "description": "The status of the verification of the identity of the component.", 791 "longDescription": "This property shall contain the status of the verification of the identity of the component referenced by the `TargetComponentURI` property.", 792 "readonly": true 793 } 794 }, 795 "type": "object" 796 }, 797 "SPDMsingleMeasurement": { 798 "additionalProperties": false, 799 "description": "A single SPDM measurement for an SPDM Responder.", 800 "longDescription": "This object shall contain a single SPDM measurement for an SPDM Responder.", 801 "patternProperties": { 802 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 803 "description": "This property shall specify a valid odata or Redfish property.", 804 "type": [ 805 "array", 806 "boolean", 807 "integer", 808 "number", 809 "null", 810 "object", 811 "string" 812 ] 813 } 814 }, 815 "properties": { 816 "LastUpdated": { 817 "description": "The date and time when information for the measurement was last updated.", 818 "format": "date-time", 819 "longDescription": "This property shall contain the date and time when information for the measurement was last updated.", 820 "readonly": true, 821 "type": [ 822 "string", 823 "null" 824 ] 825 }, 826 "Measurement": { 827 "description": "The measurement data.", 828 "longDescription": "This property shall contain the Base64-encoded measurement using the hash algorithm indicated by the `MeasurementHashAlgorithm` property. This property shall not contain a raw bit stream as a measurement. If the SPDM Responder provides a raw bit stream, the SPDM Requester may apply a hash algorithm to the raw bit stream in order to report the measurement.", 829 "pattern": "^[A-Za-z0-9+/]+={0,2}$", 830 "readonly": true, 831 "type": [ 832 "string", 833 "null" 834 ] 835 }, 836 "MeasurementHashAlgorithm": { 837 "description": "The hash algorithm used to compute the measurement.", 838 "longDescription": "This property shall contain the hash algorithm used to compute the measurement. The allowable values for this property shall be the hash algorithm names found in the 'BaseHashAlgo' field of the 'NEGOTIATE_ALGORITHMS' request message in DSP0274. If the algorithm is an extended algorithm, this property shall contain the value `OEM`. This property shall not be present if MeasurementSpecification does not contain `DMTF`.", 839 "readonly": true, 840 "type": [ 841 "string", 842 "null" 843 ] 844 }, 845 "MeasurementIndex": { 846 "description": "The index of the measurement.", 847 "longDescription": "This property shall contain the index of the measurement.", 848 "readonly": true, 849 "type": [ 850 "integer", 851 "null" 852 ] 853 }, 854 "MeasurementType": { 855 "anyOf": [ 856 { 857 "$ref": "#/definitions/DMTFmeasurementTypes" 858 }, 859 { 860 "type": "null" 861 } 862 ], 863 "description": "The type or characteristics of the data that this measurement represents.", 864 "longDescription": "This property shall contain the type or characteristics of the data that this measurement represents. This property shall not be present if MeasurementSpecification does not contain `DMTF`.", 865 "readonly": true 866 }, 867 "Oem": { 868 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", 869 "description": "The OEM extension property.", 870 "longDescription": "This property shall contain the OEM extensions. All values for properties contained in this object shall conform to the Redfish Specification-described requirements." 871 }, 872 "PartofSummaryHash": { 873 "description": "Indicates whether this measurement is part of the measurement summary.", 874 "longDescription": "This property shall indicate if this measurement is part of the measurement summary in the `MeasurementSummary` property. If this property is not present, it shall be assumed to be `false`.", 875 "readonly": true, 876 "type": [ 877 "boolean", 878 "null" 879 ] 880 }, 881 "SecurityVersionNumber": { 882 "description": "The security version number the measurement represents.", 883 "longDescription": "This property shall contain an 8-byte hex-encoded string of the security version number the measurement represents. This property shall only be present if `MeasurementType` contains the value `MutableFirmwareSecurityVersionNumber`.", 884 "pattern": "^[A-Za-z0-9]{16}$", 885 "readonly": true, 886 "type": [ 887 "string", 888 "null" 889 ], 890 "versionAdded": "v1_1_0" 891 } 892 }, 893 "type": "object" 894 }, 895 "SecureSessionType": { 896 "enum": [ 897 "Plain", 898 "EncryptedAuthenticated", 899 "AuthenticatedOnly" 900 ], 901 "enumDescriptions": { 902 "AuthenticatedOnly": "An established session where only authentication is protecting the communication.", 903 "EncryptedAuthenticated": "An established session where both encryption and authentication are protecting the communication.", 904 "Plain": "A plain text session without any protection." 905 }, 906 "type": "string" 907 }, 908 "SingleSessionInfo": { 909 "additionalProperties": false, 910 "description": "Information about a single communication channel or session between two components.", 911 "longDescription": "This object shall contain information about a single communication channel or session between two components.", 912 "patternProperties": { 913 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 914 "description": "This property shall specify a valid odata or Redfish property.", 915 "type": [ 916 "array", 917 "boolean", 918 "integer", 919 "number", 920 "null", 921 "object", 922 "string" 923 ] 924 } 925 }, 926 "properties": { 927 "SessionId": { 928 "description": "The identifier for an active session or communication channel between two components.", 929 "longDescription": "This property shall contain the unique identifier for the active session or communication channel between two components.", 930 "readonly": true, 931 "type": [ 932 "integer", 933 "null" 934 ] 935 }, 936 "SessionType": { 937 "anyOf": [ 938 { 939 "$ref": "#/definitions/SecureSessionType" 940 }, 941 { 942 "type": "null" 943 } 944 ], 945 "description": "The type of session or communication channel between two components.", 946 "longDescription": "This property shall contain the type of session or communication channel between two components.", 947 "readonly": true 948 } 949 }, 950 "type": "object" 951 }, 952 "TPMGetSignedMeasurements": { 953 "actionResponse": { 954 "$ref": "#/definitions/TPMGetSignedMeasurementsResponse" 955 }, 956 "additionalProperties": false, 957 "description": "This action generates a TPM cryptographic signed statement over the given nonce and PCRs of the TPM for TPM 2.0 devices.", 958 "longDescription": "This action shall generate a cryptographic signed statement over the given nonce and PCRs of the TPM for TPM 2.0 devices. This action shall not be present if the `ComponentIntegrityType` property does not contain the value `TPM`.", 959 "parameters": { 960 "Certificate": { 961 "$ref": "http://redfish.dmtf.org/schemas/v1/Certificate.json#/definitions/Certificate", 962 "description": "The URI for the certificate that represents the TPM attestation key.", 963 "longDescription": "This parameter shall contain the reference to the certificate installed on the TPM that represents the TPM's attestation key for the 'signHandle' parameter of the 'TPM2_Quote' command defined in the Trusted Platform Module Library Specification.", 964 "requiredParameter": true 965 }, 966 "Nonce": { 967 "description": "A set of bytes as a hex-encoded string that is signed with the measurements. The value should be unique.", 968 "longDescription": "This parameter shall contain a set of bytes as a hex-encoded string that is signed with the measurements. Services shall reject the action request if the number of bytes provided is larger than the value specified by the `NonceSizeBytesMaximum` property in the `TPM` property. If not provided by the client, the service shall generate the nonce. The value should be unique and generated using a random or a pseudo-random generator. The service shall send this value to the TPM in the 'qualifyingData' parameter of the 'TPM2_Quote' command defined in the Trusted Platform Module Library Specification.", 969 "pattern": "^[0-9a-fA-F]$", 970 "type": "string" 971 }, 972 "PCRSelection": { 973 "description": "An object that identifies the PCRs to sign.", 974 "longDescription": "This parameter shall contain the Base64-encoded representation of the 'TPML_PCR_SELECTION' object, as defined by the Trusted Platform Module Library Specification, that identifies the PCRs to sign. The service shall send this value to the TPM in the 'PCRselect' parameter of the 'TPM2_Quote' command defined in the Trusted Platform Module Library Specification.", 975 "requiredParameter": true, 976 "type": "string" 977 }, 978 "Scheme": { 979 "description": "The signing scheme to use for the TPM attestation key.", 980 "longDescription": "This parameter shall contain the Base64-encoded representation of the 'TPMT_SIG_SCHEME' object, as defined in the Trusted Platform Module Library Specification, that identifies the signing scheme to use for the TPM attestation key. The service shall send this value to the TPM in the 'inScheme' parameter of the 'TPM2_Quote' command defined in the Trusted Platform Module Library Specification.", 981 "requiredParameter": true, 982 "type": "string" 983 } 984 }, 985 "patternProperties": { 986 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 987 "description": "This property shall specify a valid odata or Redfish property.", 988 "type": [ 989 "array", 990 "boolean", 991 "integer", 992 "number", 993 "null", 994 "object", 995 "string" 996 ] 997 } 998 }, 999 "properties": { 1000 "target": { 1001 "description": "Link to invoke action", 1002 "format": "uri-reference", 1003 "type": "string" 1004 }, 1005 "title": { 1006 "description": "Friendly action name", 1007 "type": "string" 1008 } 1009 }, 1010 "type": "object", 1011 "versionAdded": "v1_2_0" 1012 }, 1013 "TPMGetSignedMeasurementsResponse": { 1014 "additionalProperties": false, 1015 "description": "The TPM signed measurement from a TPM.", 1016 "longDescription": "This object shall contain the TPM signed PCR measurements from a TPM.", 1017 "patternProperties": { 1018 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 1019 "description": "This property shall specify a valid odata or Redfish property.", 1020 "type": [ 1021 "array", 1022 "boolean", 1023 "integer", 1024 "number", 1025 "null", 1026 "object", 1027 "string" 1028 ] 1029 } 1030 }, 1031 "properties": { 1032 "Oem": { 1033 "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", 1034 "description": "The OEM extension property.", 1035 "longDescription": "This property shall contain the OEM extensions. All values for properties contained in this object shall conform to the Redfish Specification-described requirements.", 1036 "versionAdded": "v1_2_0" 1037 }, 1038 "SignedMeasurements": { 1039 "description": "The Base64-encoded cryptographic signed statement generated by the signer.", 1040 "longDescription": "This property shall contain a Base64-encoded cryptographic signed statement generated by the signer. This value shall be the concatenation of the 'quoted' and 'signature' response values of the 'TPM2_Quote' command defined in the Trusted Platform Module Library Specification.", 1041 "readonly": true, 1042 "type": "string", 1043 "versionAdded": "v1_2_0" 1044 } 1045 }, 1046 "required": [ 1047 "SignedMeasurements" 1048 ], 1049 "type": "object" 1050 }, 1051 "TPMauth": { 1052 "additionalProperties": false, 1053 "description": "Common Authentication information.", 1054 "longDescription": "This object shall contain common identity-related authentication information.", 1055 "patternProperties": { 1056 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 1057 "description": "This property shall specify a valid odata or Redfish property.", 1058 "type": [ 1059 "array", 1060 "boolean", 1061 "integer", 1062 "number", 1063 "null", 1064 "object", 1065 "string" 1066 ] 1067 } 1068 }, 1069 "properties": { 1070 "ComponentCertificate": { 1071 "$ref": "http://redfish.dmtf.org/schemas/v1/Certificate.json#/definitions/Certificate", 1072 "description": "A link to the certificate that represents the identity of the component.", 1073 "longDescription": "This property shall contain a link to a resource of type `Certificate` that represents the identity of the component referenced by the `TargetComponentURI` property.", 1074 "readonly": true 1075 }, 1076 "VerificationStatus": { 1077 "anyOf": [ 1078 { 1079 "$ref": "#/definitions/VerificationStatus" 1080 }, 1081 { 1082 "type": "null" 1083 } 1084 ], 1085 "description": "The status of the verification of the identity of the component.", 1086 "longDescription": "This property shall contain the status of the verification of the identity of the component referenced by the `TargetComponentURI` property.", 1087 "readonly": true 1088 } 1089 }, 1090 "type": "object" 1091 }, 1092 "TPMcommunication": { 1093 "additionalProperties": false, 1094 "description": "Information about communication between two components.", 1095 "longDescription": "This object shall contain information about communication between two components.", 1096 "patternProperties": { 1097 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 1098 "description": "This property shall specify a valid odata or Redfish property.", 1099 "type": [ 1100 "array", 1101 "boolean", 1102 "integer", 1103 "number", 1104 "null", 1105 "object", 1106 "string" 1107 ] 1108 } 1109 }, 1110 "properties": { 1111 "Sessions": { 1112 "description": "The active sessions or communication channels between two components.", 1113 "items": { 1114 "anyOf": [ 1115 { 1116 "$ref": "#/definitions/SingleSessionInfo" 1117 }, 1118 { 1119 "type": "null" 1120 } 1121 ] 1122 }, 1123 "longDescription": "This property shall contain an array of the active sessions or communication channels between two components. The active sessions or communication channels do not reflect how future sessions or communication channels are established.", 1124 "type": "array" 1125 } 1126 }, 1127 "type": "object" 1128 }, 1129 "TPMinfo": { 1130 "additionalProperties": false, 1131 "description": "Integrity information about a Trusted Platform Module (TPM).", 1132 "longDescription": "This object shall contain integrity information about a Trusted Platform Module (TPM).", 1133 "patternProperties": { 1134 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 1135 "description": "This property shall specify a valid odata or Redfish property.", 1136 "type": [ 1137 "array", 1138 "boolean", 1139 "integer", 1140 "number", 1141 "null", 1142 "object", 1143 "string" 1144 ] 1145 } 1146 }, 1147 "properties": { 1148 "ComponentCommunication": { 1149 "anyOf": [ 1150 { 1151 "$ref": "#/definitions/TPMcommunication" 1152 }, 1153 { 1154 "type": "null" 1155 } 1156 ], 1157 "description": "Information about communication with the TPM.", 1158 "longDescription": "This property shall contain information about communication with the TPM." 1159 }, 1160 "IdentityAuthentication": { 1161 "anyOf": [ 1162 { 1163 "$ref": "#/definitions/TPMauth" 1164 }, 1165 { 1166 "type": "null" 1167 } 1168 ], 1169 "description": "Identity authentication information about the TPM.", 1170 "longDescription": "This property shall contain identity authentication information about the TPM." 1171 }, 1172 "MeasurementSet": { 1173 "anyOf": [ 1174 { 1175 "$ref": "#/definitions/TPMmeasurementSet" 1176 }, 1177 { 1178 "type": "null" 1179 } 1180 ], 1181 "description": "Measurement information from the TPM.", 1182 "longDescription": "This property shall contain measurement information from the TPM." 1183 }, 1184 "NonceSizeBytesMaximum": { 1185 "description": "The maximum number of bytes that can be specified in the `Nonce` parameter of the `TPMGetSignedMeasurements` action.", 1186 "longDescription": "This property shall contain the maximum number of bytes that can be specified in the `Nonce` parameter of the `TPMGetSignedMeasurements` action.", 1187 "minimum": 0, 1188 "readonly": true, 1189 "type": [ 1190 "integer", 1191 "null" 1192 ], 1193 "versionAdded": "v1_2_0" 1194 } 1195 }, 1196 "type": "object" 1197 }, 1198 "TPMmeasurementSet": { 1199 "additionalProperties": false, 1200 "description": "Trusted Computing Group TPM measurement information.", 1201 "longDescription": "This object shall contain Trusted Computing Group TPM measurement information.", 1202 "patternProperties": { 1203 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 1204 "description": "This property shall specify a valid odata or Redfish property.", 1205 "type": [ 1206 "array", 1207 "boolean", 1208 "integer", 1209 "number", 1210 "null", 1211 "object", 1212 "string" 1213 ] 1214 } 1215 }, 1216 "properties": { 1217 "Measurements": { 1218 "description": "Measurements from a TPM.", 1219 "items": { 1220 "anyOf": [ 1221 { 1222 "$ref": "#/definitions/TPMsingleMeasurement" 1223 }, 1224 { 1225 "type": "null" 1226 } 1227 ] 1228 }, 1229 "longDescription": "This property shall contain measurements from a TPM.", 1230 "type": "array" 1231 } 1232 }, 1233 "type": "object" 1234 }, 1235 "TPMsingleMeasurement": { 1236 "additionalProperties": false, 1237 "description": "A single Trusted Computing Group TPM measurement.", 1238 "longDescription": "This object shall contain a single Trusted Computing Group TPM measurement.", 1239 "patternProperties": { 1240 "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 1241 "description": "This property shall specify a valid odata or Redfish property.", 1242 "type": [ 1243 "array", 1244 "boolean", 1245 "integer", 1246 "number", 1247 "null", 1248 "object", 1249 "string" 1250 ] 1251 } 1252 }, 1253 "properties": { 1254 "LastUpdated": { 1255 "description": "The date and time when information for the measurement was last updated.", 1256 "format": "date-time", 1257 "longDescription": "This property shall contain the date and time when information for the measurement was last updated.", 1258 "readonly": true, 1259 "type": [ 1260 "string", 1261 "null" 1262 ] 1263 }, 1264 "Measurement": { 1265 "description": "The measurement data.", 1266 "longDescription": "This property shall contain the Base64-encoded PCR digest using the hashing algorithm indicated by the `MeasurementHashAlgorithm` property.", 1267 "pattern": "^[A-Za-z0-9+/]+={0,2}$", 1268 "readonly": true, 1269 "type": [ 1270 "string", 1271 "null" 1272 ] 1273 }, 1274 "MeasurementHashAlgorithm": { 1275 "description": "The hash algorithm used to compute the measurement.", 1276 "longDescription": "This property shall contain the hash algorithm used to compute the measurement. The allowable values for this property shall be the strings in the 'Algorithm Name' field of the 'TPM_ALG_ID Constants' table within the 'Trusted Computing Group Algorithm Registry'.", 1277 "readonly": true, 1278 "type": [ 1279 "string", 1280 "null" 1281 ] 1282 }, 1283 "PCR": { 1284 "description": "The Platform Configuration Register (PCR) bank of the measurement.", 1285 "longDescription": "This property shall contain the Platform Configuration Register (PCR) bank of the measurement.", 1286 "readonly": true, 1287 "type": [ 1288 "integer", 1289 "null" 1290 ] 1291 } 1292 }, 1293 "type": "object" 1294 }, 1295 "VerificationStatus": { 1296 "enum": [ 1297 "Success", 1298 "Failed" 1299 ], 1300 "enumDescriptions": { 1301 "Failed": "Unsuccessful verification.", 1302 "Success": "Successful verification." 1303 }, 1304 "type": "string" 1305 } 1306 }, 1307 "language": "en", 1308 "owningEntity": "DMTF", 1309 "release": "2022.2", 1310 "title": "#ComponentIntegrity.v1_2_3.ComponentIntegrity" 1311}