HIRS/tools/tcg_eventlog_tool
iadgovuser26 72b37cec61
Merge pull request from SuperPotato27/v3_issue_810
(WIP) Added action to package the RIM tool and the EventLog tool for windows.
2024-09-04 10:30:21 -04:00
..
config/spotbugs This commit sets up the suppression filter file. The locations previous 2024-02-05 10:50:12 -05:00
gradle/wrapper added VERSION file to /opt/hirs 2024-01-16 18:28:40 -05:00
scripts updated with package for tcg_rim_tool [no ci] 2023-03-17 14:47:10 -04:00
src/main/java/hirs/tcg_eventlog debugging SLF4J warning 2024-08-09 13:50:15 -04:00
build.gradle Merge pull request from SuperPotato27/v3_issue_810 2024-09-04 10:30:21 -04:00
gradlew added a eventcheck script to check and event log against a signed RIM 2020-05-27 17:31:15 -04:00
gradlew.bat added a gradlew.bat for bulding the tcg_event_log on windows 2020-07-23 10:59:46 -04:00
README.md Update README.md 2024-08-27 18:47:04 -04:00
VERSION Updated README.md and VERSION files 2024-08-22 16:40:03 -04:00

The tcg_eventlog_tool is a command line application that allows a user to inspect the Trusted Platform Module (TPM) Event Log's contents. This command tool supports the PC Client RIM Specification, which specifies the use of the TPM Event Log as a Support RIM type. This tool can be used to parse and print human readable output, provide hexadecimal events which can be used as test patterns, and provide details in the case of events failing comparison.

Note that a TPM Event Log will only be populated on a given device if the device:

  1. Utilizes TCG compliant UEFI Firmware
  2. Has a TPM 2.0
  3. Has a TPM aware OS (true for most flavors of Linux and Windows)

The default locations for the TPM Event Log are:

  • Windows: C:\Windows\Logs\MeasuredBoot\
  • Linux: /sys/kernel/security/tpm0/ with a default name of "binary_bios_measurements"

Building

Linux

To build this tool, navigate to the tcg_eventlog_tool directory and use the following command:

./gradlew clean build

Windows

Several options exist for building on Windows 11:

  1. Windows command shell (CMD.exe):
    • Navigate to the tcg_eventlog_tool folder and run the Windows gradle wrapper:

    gradlew.bat clean build

  2. Windows powershell with Windows Subsystem for Linux enabled:
    • Navigate to the tcg_eventlog_tool folder and run the Linux gradle wrapper:

    ./gradlew clean build

The tcg_eventlog_tool-X.X.jar file should populate in the build\libs\ (Windows) or build/libs/tools/ (Linux) folder.

Packaging

Packages for this tool can be found on the HIRS release page. Download the RPM files which apply to the latest release. Currently installation packages for HIRS V3 are only available for Rocky and RHEL version 8 and 9, and Ubuntu 22 and 24.

To create an RPM on a Redhat or Rocky linux device use the following command in the same directory:

./gradlew buildRpm

or for a Debian or Ubuntu Linux device:

./gradlew buildDeb

The package can be found under the build/distributions/ folder.

Installing

Currently only an install package for Linux is supported.

To install this tool on a Redhat or Rocky Linux distro use the following command from the same directory:

sudo dnf install build/distributions/tcg_eventlog_tool*.rpm

or for a Debian or Ubuntu Linux distro:

sudo apt-get install build/distributions/tcg_eventlog_tool*.deb

Notes:

  • Package naming convention: tcg_eventlog_tool-X.X.X-Y.Z.el8-1.x86_64.rpm
    • Where X.X.X is the latest version of the tcg_eventlog_tool package, Y is the date and Z is the git commit hash associated with that version tag
  • Once installed, the tcg_eventlog_tool can be run from any directory in Linux

Usage

Additional details on using the tcg_eventlog_tool can be found in the TCG Event Log Tool user Guide. A quick summary is listed below.

Linux

The tcg_eventlog_tool installation package provides an elt command. The elt command has various command line options to view all events, specific events, or to display expected PCRs.

Current options for the tool can be found using the -h option:

elt -h

With No FILE the default event log path (e.g. /sys/kernel/security/tpm0/binary_bios_measurements on Linux) is used. Note admin privileges are required for accessing the default path in Linux.

All OPTIONS must be separated by a space delimiter, no concatenation of OPTIONS is currently supported.

An example output for the tcg_eventlog_tool filtering on event 1 would be:

elt -f ~/TpmLog.bin -e 1

Windows

Currently there is not an install package for the tcg_eventlog_tool for Windows. It can be invoked using java:

To run the tcg_eventlog_tool from a command shell:

navigate to the tcg_eventlog_tool folder invoke using java -jar option to the tcg_eventlog_tool jar file with options:

java -jar build\libs\tcg_eventlog_tool-1.0.jar -h

another example:

java -jar build\libs\tcg_eventlog_tool-1.0.jar -f C:\Windows\Logs\MeasuredBoot\0000000059-0000000000.log -e