CFG_GetAMTSetupAuditRecord

note-icon Note:

This command has been deprecated and from Intel AMT Release 6.0 and later is replaced by the CFG_GetMESetupAuditRecord command.

 

CFG_GetAMTSetupAuditRecord reads the Intel AMT configuration audit record. The audit record contains configuration information about the last configuration attempt, regardless if it was successful or unsuccessful.

This command is available in all boot modes.

This command is not allowed in small business mode.

CFG_GetAMTSetupAuditRecord Request

typedef struct _CFG_GET_AUDIT_RECORD_REQUEST

{

    PTHI_MESSAGE_HEADER     Header;

} CFG_GET_AUDIT_RECORD_REQUEST;

 

Field

Description

Header.Version

Major and minor interface version.

Header.Reserved

0000h

Header.Command

04000027h

Header.Length

Message Length, excluding the message header.

CFG_GetAMTSetupAuditRecord Response

typedef struct _CFG_GET_AUDIT_RECORD_RESPONSE

{

    PTHI_MESSAGE_HEADER                 Header;

    AMT_STATUS                          Status;

    [success] AMT_ADMIN_AUDIT_RECORD    AuditRecord;

} CFG_GET_AUDIT_RECORD_RESPONSE;

 

Field

Description

Header.Version

Major and minor interface version.

Header.Reserved

0000h

Header.Command

04800027h

Header.Length

Message Length, excluding the message header.

Status

A status code returned in a response message that indicates whether the operation specified in the corresponding request message succeeded or failed. If the operation failed, this code indicates the specific reason for failure.

AuditRecord.ProvisioningMethod

Valid values:

0 – PKI-CH (Remote Configuration)

1 – PSK

AuditRecord.HashValue

Hash of the root of the certificate used for configurationing.

AuditRecord.CA

Intermediate CA serial numbers, first value being the signer of the leaf certificate.

AuditRecord.HashAlgo

Hash algorithm for the hash value (SHA1, SHA256, or SHA384).

AuditRecord.IsDefault

State of the IsDefault bit in the certificate hash table.

AuditRecord.IntermidiateCa

True if the certificate chain includes additional intermediate CAs not recorded.

AuditRecord.TimeAndDate

Time of the last configurationing.

AuditRecord.IpAddress

The IP address of the configuration server.

AuditRecord.TimeValidityPass

Indicates whether the certificate passed the time validity check.

AuditRecord.FQDN

FQDN of configuration server mentioned in the certificate.

 

CFG_GetAMTSetupAuditRecord Status Codes

Status

Description

AMT_STATUS_SUCCESS

Request succeeded.

AMT_STATUS_INTERNAL_ERROR

An internal error in the Intel AMT device has occurred.

AMT_STATUS_NOT_READY

Management controller has not progressed far enough in its initialization to process the command.

AMT_STATUS_INVALID_MESSAGE_LENGTH

Length field of header is invalid.

AMT_STATUS_INVALID_AMT_MODE

Returned when the device is in PSK mode

 

Copyright © 2006-2022, Intel Corporation. All rights reserved.