RFC 9683
Remote Integrity Verification of Network Devices Containing Trusted Platform Modules
1. Introduction β¨
okay so bestie, RFC 9683 is giving remote attestation for network gear π₯. Let me walk you through the title block first π
This one is from the IETF (Internet Engineering Task Force) πΈ. The editor is G. C. Fedorkow (Juniper Networks, Inc.), and E. Voit (Cisco) and J. Fitzgerald-McKay (National Security Agency) are co-authors π«Ά. It's an Informational document, which means it is not an Internet Standards Track spec π. It's dated December 2024 and it has ISSN 2070-1721. Nothing in the title block says it obsoletes or updates another RFC π¦.
The title is "Remote Integrity Verification of Network Devices Containing Trusted Platform Modules" π§. Iconic.
Abstract
This document describes a workflow for remote attestation of the integrity of firmware and software installed on network devices that contain Trusted Platform Modules (TPMs), as defined by the Trusted Computing Group (TCG), or equivalent hardware implementations that include the protected capabilities, as provided by TPMs π.
Status of This Memo
This document is not an Internet Standards Track specification; it is published for informational purposes π .
This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Not all documents approved by the IESG are candidates for any level of Internet Standard; see Section 2 of RFC 7841 β¨.
Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at https://www.rfc-editor.org/info/rfc9683 π.
Copyright Notice
Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved π.
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License π.
Table of Contents
1. Introduction
1.1. Requirements Notation
1.2. Terminology
1.3. Document Organization
1.4. Goals
1.5. Description of Remote Integrity Verification (RIV)
1.6. Solution Requirements
1.7. Scope
1.7.1. Out of Scope
2. Solution Overview
2.1. RIV Software Configuration Attestation Using TPM
2.1.1. What Does RIV Attest?
2.1.2. Notes on PCR Allocations
2.2. RIV Keying
2.3. RIV Information Flow
2.4. RIV Simplifying Assumptions
2.4.1. Reference Integrity Manifests (RIMs)
2.4.2. Attestation Logs
3. Standards Components
3.1. Prerequisites for RIV
3.1.1. Unique Device Identity
3.1.2. Keys
3.1.3. Appraisal Policy for Evidence
3.2. Reference Model for Challenge-Response
3.2.1. Transport and Encoding
3.3. Centralized vs. Peer-to-Peer
4. Privacy Considerations
5. Security Considerations
5.1. Keys Used in RIV
5.2. Prevention of Spoofing and Person-in-the-Middle Attacks
5.3. Replay Attacks
5.4. Owner-Signed Keys
5.5. Other Factors for Trustworthy Operation
6. IANA Considerations
7. Conclusion
8. References
8.1. Normative References
8.2. Informative References
Appendix A. Supporting Materials
A.1. Using a TPM for Attestation
A.2. Root of Trust for Measurement (RTM)
A.3. Layering Model for Network Equipment Attester and Verifier
A.4. Implementation Notes
Acknowledgements
Authors' Addresses
1.1. Requirements Notation π
The key words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, NOT RECOMMENDED, MAY, and OPTIONAL in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here π.
1.2. Terminology π
A number of terms are reused from [RFC9334]. These include Appraisal Policy for Evidence, Attestation Result, Attester, Evidence, Reference Value, Relying Party, Verifier, and Verifier Owner πΈ.
Additionally, this document defines the following term:
Attestation: The process of generating, conveying, and appraising claims, backed by evidence, about device trustworthiness characteristics, including supply chain trust, identity, device provenance, software configuration, device composition, compliance to test suites, functional and assurance evaluations, etc. π§
The goal of attestation is simply to assure an administrator or auditor that the device's configuration and software were authentic and unmodified when the device started. The determination of software authenticity is not prescribed in this document, but it's typically taken to mean a software image generated by an authority trusted by the administrator, such as the device manufacturer π₯.
Within the context of the Trusted Computing Group (TCG), the scope of attestation is typically narrowed to describe the process by which an independent Verifier can obtain cryptographic proof as to the identity of the device in question, evidence of the integrity of the device's software that was loaded upon startup, and verification that the current configuration matches the intended configuration. For network equipment, a Verifier capability can be embedded in a Network Management Station, a posture collection server, or other network analytics tool (such as a software asset management solution, or a threat detection and mitigation tool, etc.). This document focuses on a specific subset of attestation tasks, defined here as Remote Integrity Verification (RIV), and informally referred to as attestation. RIV in this document takes a network-equipment-centric perspective that includes a set of protocols and procedures for determining whether a particular device was launched with authentic software, starting from Roots of Trust. While there are many ways to accomplish attestation, RIV sets out a specific set of protocols and tools that work in environments commonly found in network equipment. RIV does not cover other device characteristics that could be attested (e.g., geographic location or connectivity; see [RATS-USECASES]), although it does provide evidence of a secure infrastructure to increase the level of trust in other device characteristics attested by other means (e.g., by Entity Attestation Tokens [RATS-EAT]) π¦.
In line with definitions found in [RFC9334], this document uses the term Endorser to refer to the role that signs identity and attestation certificates used by the Attester, while Reference Values are signed by a Reference Value Provider. Typically, the manufacturer of a network device would be accepted as both the Endorser and Reference Value Provider, although the choice is ultimately up to the Verifier Owner π.
1.3. Document Organization πΊοΈ
The remainder of this document is organized into several sections:
- The remainder of this section covers goals and requirements, plus a top-level description of RIV.
- The Solution Overview section (Section 2) outlines how RIV works.
- The Standards Components section (Section 3) links components of RIV to normative standards.
- The Privacy and Security Considerations sections (Sections 4 and 5) shows how specific features of RIV contribute to the trustworthiness of the Attestation Result.
- Supporting material is in an appendix (Appendix A).
1.4. Goals π―
Network operators benefit from a trustworthy attestation mechanism that provides assurance that their network comprises authentic equipment and has loaded software free of known vulnerabilities and unauthorized tampering. In line with the overall goal of assuring integrity, attestation can be used to assist in asset management, vulnerability and compliance assessment, plus configuration management π.
The RIV attestation workflow outlined in this document is intended to meet the following high-level goals:
- Provable Device Identity - This specification requires that an Attester (i.e., the attesting device) includes a cryptographic identifier unique to each device. Effectively, this means that the device's TPM must be provisioned with this during the manufacturing cycle. π
- Software Inventory - Key goals are to identify the software release(s) installed on the Attester and to provide evidence that the software stored within hasn't been altered without authorization. π¦
- Verifiability - Verification of the device's software and configuration shows that the software that the administrator authorized for use was actually launched. β
In addition, RIV is designed to operate either in a centralized environment, such as with a central authority that manages and configures a number of network devices, or "peer-to-peer", where network devices independently verify one another to establish a trust relationship. (See Section 3.3.) π«Ά
Heads up: I've kept the Table of Contents, the Copyright boilerplate and the reference-heavy bits exactly as written, since they're the parts implementers look up. Part 2 picks up at Section 1.5 ππ
1.5. Description of Remote Integrity Verification (RIV) π
okay so attestation needs two interlocking mechanisms between the Attester network device and the Verifier π
- Device Identity is the mechanism that gives trusted identity πͺͺ. It can reassure network managers that the specific devices they ordered from authorized manufacturers for attaching to their network are the ones that were installed, and that they're still present in their network β¨. As part of Device Identity, cryptographic proof of the manufacturer's identity is also provided π.
- Software Measurement is the mechanism that reports the state of mutable software components on the device π§©. It can assure admins that they have known, authentic software configured to run in their network π«Ά.
By using these two interlocking mechanisms, RIV (which is a component in a chain of procedures π) can assure a network operator that the equipment in their network can be reliably identified and that authentic software of a known version is installed on each device. Equipment in the network includes devices that make up the network itself, such as routers, switches, and firewalls π.
Software used to boot a device can be identified by a chain of measurements, anchored at the start by a Root of Trust for Measurement (RTM) (see Appendix A.2). An attestation function embedded in each stage, verified by the previous stage, measures the next stage and records the result in tamper-resistant storage. A measurement signifies the identity, integrity, and version of each software component registered with an Attester's TPM [TPM-1.2] [TPM-2.0], so that a subsequent verification stage can determine if the software installed is authentic, up-to-date, and free of tampering π.
RIV includes several major processes, which are split between the Attester and Verifier π§ :
- Generation of Evidence is the process whereby an Attester generates cryptographic proof (Evidence) of claims about device properties π. In particular, the device identity and its software configuration are both of critical importance π.
- Device Identification refers to the mechanism assuring the Relying Party (ultimately, a network administrator) of the identities of devices, and the identities of their manufacturers, that make up their network πͺ.
- Conveyance of Evidence reliably transports the collected Evidence from the Attester to a Verifier, so a management station can perform a meaningful appraisal in Step 4 π. The transport is typically carried out via a management network. Although not required for reliable attestation, an encrypted channel may be used to provide integrity, authenticity, or confidentiality once attestation is complete π. It should be noted that critical attestation evidence from the TPM is signed by a key known only to TPM, and is not dependent on encryption carried out as part of a reliable transport π.
- Appraisal is the last step π. This is the process of verifying the Evidence received by a Verifier from the Attester, and using an Appraisal Policy to develop an Attestation Result, which is used to inform decision-making. In practice, this means comparing the Attester's measurements reported as Evidence with the device configuration expected by the Verifier. Subsequently, the Appraisal Policy for Evidence might match Evidence found against Reference Values (aka Golden Measurements), which represent the intended configured state of the connected device β .
All implementations supporting this RIV specification require support for the following three technologies π§°:
- Identity: Device identity in RIV is based on Device Identity (DevID) defined by IEEE Std 802.1AR [IEEE-802-1AR], coupled with careful supply-chain management by the manufacturer π. The Initial DevID (IDevID) certificate contains a statement by the manufacturer that establishes the identity of the device as it left the factory π·οΈ. Some applications with a more complex post-manufacture supply chain (e.g., value added resellers), or with different privacy concerns, may want to use alternative mechanisms for platform authentication. Examples are TCG Platform Certificates [PLATFORM-CERTS] or post-manufacture installation of Local DevID (LDevID) πΈ.
- Platform attestation provides evidence of configuration of software elements present in the device π». This form of attestation can be implemented with TPM Platform Configuration Registers (PCRs) and Quote and Log mechanisms, which provide cryptographically authenticated evidence to report what software was started on the device through the boot cycle π₯Ύ. Successful attestation requires an unbroken chain from a boot-time Root of Trust through all layers of software needed to bring the device to an operational state. In that chain, each stage computes the hash of components of the next stage, then updates the attestation log and the TPM πͺ’. The TPM can then report the hashes of all the measured hashes as signed evidence called a Quote (see Appendix A.1 for an overview of TPM operation, or [TPM-1.2] and [TPM-2.0] for many more details) π¦.
- Signed Reference Values (aka reference integrity measurements) must be conveyed from the Reference Value Provider (the entity accepted as the software authority, often the manufacturer of the network device) to the Verifier π¬.
1.6. Solution Requirements π
RIV must address the "Lying Endpoint" problem, in which malicious software on an endpoint may subvert the intended function and also prevent the endpoint from reporting its compromised status. (See Section 5 for further Security Considerations. This is very important π.)
RIV attestation is designed to be simple to deploy at scale π. RIV should work "out of the box" as far as possible. That means the fewest possible provisioning steps or configuration databases needed at the end user's site π. Network equipment is often required to "self-configure": it has to reliably reach out, without manual intervention, to prove its identity and operating posture, and then download its own configuration. This process precludes pre-installation configuration π€. See [RFC8572] for an example of Secure Zero Touch Provisioning (SZTP) β.
1.7. Scope π·
The need for assurance of software integrity, addressed by Remote Attestation, is a very general problem that could apply to most network-connected computing devices. However, this document includes several assumptions that limit the scope to network equipment (e.g., routers, switches, and firewalls) π―:
- This solution is for use in non-privacy-preserving applications (for example, networking or industrial Internet of Things (IoT) applications). This avoids the need for a Privacy Certification Authority (also called an Attestation CA) for Attestation Keys (AKs) [AIK-ENROLL] or TCG Platform Certificates [PLATFORM-CERTS] π.
- This document assumes network protocols that are common in network equipment, such as YANG [RFC7950] and Network Configuration Protocol (NETCONF) [RFC6241], but not generally used in other applications π οΈ.
- The approach outlined in this document mandates the use of a TPM [TPM-1.2] [TPM-2.0] or a compatible cryptoprocessor π.
1.7.1. Out of Scope π«
- Run-Time Attestation: The Linux Integrity Measurement Architecture [IMA] attests each process launched after a device is started, and that is in scope for RIV in general. But continuous run-time attestation of Linux or other multi-threaded operating system processes after the OS has started considerably expands the scope of the problem. Many researchers are working on that problem, but this document defers the problem of continuous, in-memory run-time attestation π§΅.
- Multi-Vendor Embedded Systems: Additional coordination would be needed for devices that themselves comprise hardware and software from multiple vendors and are integrated by the end user. Although out of scope for this document, these issues are accommodated in [RFC9334] π€.
- Processor Sleep Modes: Network equipment typically does not "sleep", so sleep and hibernate modes are not considered. Although out of scope for RIV in this document, TCG specifications do encompass sleep and hibernate states, which could be incorporated into remote attestation for network equipment in the future, given a compelling need π΄.
- Virtualization and Containerization: In a non-virtualized system, the host OS is responsible for measuring each user-space file or process throughout the operational lifetime of the system. For virtualized systems, the host OS must verify the hypervisor, but then the hypervisor must manage its own chain of trust through the virtual machine. Virtualization and containerization technologies are increasingly used in network equipment, but are not considered in this document π¦.
2. Solution Overview β¨
2.1. RIV Software Configuration Attestation Using TPM β¨
okay bestie, RIV Attestation is a process for figuring out the identity of the software running on a specifically identified device π It's giving detective energy. The Remote Attestation steps from Section 1.5 get split into two phases, as you can see in Figure 1 π
- Boot Phase: during system startup, each distinct software object gets "measured" by the Attester πΈ Its identity, hash (aka cryptographic digest), and version info get recorded in a log. The hashes also get extended into the TPM (check Appendix A.1 for more on extending hashes) in a way that lets you validate the log entries later. This measuring usually follows the layered chain-of-trust model used in Measured Boot, where each stage measures the next one and extends that measurement into the TPM before launching it. See Section 3.2 of [RFC9334], "Layered Attestation Environments", for the architectural definition of this model π
- Verification Phase: once the device is up and running with operational network connectivity, verification can happen π¦ A separate Verifier, running in its own trusted environment, goes and interrogates the network device to grab the logs and a copy of the digests collected by hashing each software object. Those digests are signed by an attestation private key that the TPM secures but never releases. The YANG model described in [RFC9684] makes this whole operation easier π
So the result is that the Verifier can confirm the device's identity by checking the subject [RFC5280] and signature of the certificate that holds the TPM's attestation public key π Then it can verify the log is correct by accumulating all the hashes in the log and comparing that to the signed digests from the TPM. From there, the Verifier can validate the launched software by comparing the digests in the log with Reference Values. Iconic behaviour, honestly β¨
Also, it's worth noting that attestation and identity are inextricably linked π«Ά Signed Evidence that a particular version of software was loaded is basically useless without cryptographic proof of who the Attester producing that Evidence actually is π
+-------------------------------------------------------+
| +---------+ +--------+ +--------+ +---------+ |
| |UEFI BIOS|--->| Loader |-->| Kernel |--->|Userland | |
| +---------+ +--------+ +--------+ +---------+ |
| | | | |
| | | | |
| +------------+-----------+-+ |
| Boot Phase | |
| V |
| +--------+ |
| | TPM | |
| +--------+ |
| Router | |
+--------------------------------|----------------------+
|
| Verification Phase
| +-----------+
+--->| Verifier |
+-----------+
Reset---------------flow-of-time-during-boot...--------->
Figure 1: Layered RIV Attestation Model
In the Boot Phase, measurements get "extended" (hashed) into the TPM as processes start, so the TPM ends up holding hashes of all the measured hashes π§ Later, once the system is operational, signed digests get pulled from the TPM during the Verification Phase for off-box analysis π
2.1.1. What Does RIV Attest?
okay so TPM attestation is focused on PCRs, but honestly those registers are just vehicles for certifying the Evidence that comes along in the log entries π It's the hashes in the log entries that get extended into PCRs. The final PCR values can then be retrieved in the form of a structure called a Quote, which is signed by an AK known only to the TPM π Using multiple PCRs only exists to give some independence between different classes of object, so one class can be updated without changing the extended hash for other classes. PCRs can be used for any purpose, but this section outlines the objects in scope for this document that may be extended into the TPM π
In general, deciding which measurements go to which PCRs is a policy choice made by the device manufacturer π It's picked to independently attest three classes of object:
- Code: instructions to be executed by a CPU β‘
- Configuration: many devices offer loads of options controlled by non-volatile configuration variables that can change the device's security posture π These settings may come with vendor defaults, but administrators often change them, and they may want to verify through attestation that the operational state of the settings matches their intended state π
- Credentials: administrators may wish to verify through attestation that public keys and credentials outside the Root of Trust haven't been messed with by anyone unauthorized π (By definition, keys protecting the Root of Trust can't be verified independently. Plot twist, I know π)
The "TCG PC Client Specific Platform Firmware Profile Specification" [PC-CLIENT-BIOS-TPM-2.0] details what gets measured during the Boot Phase of platform startup using a Unified Extensible Firmware Interface (UEFI) BIOS (<www.uefi.org>). The big goal, though, is simply to measure every bit of code executed while starting the device, along with any configuration info related to security posture. That way there's no gap where unmeasured code could hide undetected and potentially subvert the chain βοΈβ¨
For devices using a UEFI BIOS, [PC-CLIENT-BIOS-TPM-2.0] and [PC-CLIENT-EFI-TPM-1.2] give detailed normative requirements for PCR usage π For other platform architectures, where TCG normative requirements don't currently exist, Table 1 offers non-normative guidance for PCR assignment. It generalizes the specific details of [PC-CLIENT-BIOS-TPM-2.0] πΈ
By convention, most PCRs are assigned in pairs: the even-numbered PCR measures executable code, and the odd-numbered PCR measures whatever data and configuration go with that code π Also, each PCR may contain results from dozens (or even thousands) of individual measurements. Wild, right? π€―
+===========================================+======================+
| | Assigned PCR # |
+===========================================+======+===============+
| Function | Code | Configuration |
+===========================================+======+===============+
| Firmware Static Root of Trust (i.e., | 0 | 1 |
| initial boot firmware and drivers) | | |
+-------------------------------------------+------+---------------+
| Drivers and initialization for optional | 2 | 3 |
| or add-in devices | | |
+-------------------------------------------+------+---------------+
| OS loader code and configuration (i.e., | 4 | 5 |
| the code launched by firmware) to load an | | |
| operating system kernel. These PCRs | | |
| record each boot attempt, and an | | |
| identifier for where the loader was found | | |
+-------------------------------------------+------+---------------+
| Vendor-specific measurements during boot | 6 | 6 |
+-------------------------------------------+------+---------------+
| Secure Boot Policy. This PCR records | | 7 |
| keys and configuration used to validate | | |
| the OS loader | | |
+-------------------------------------------+------+---------------+
| Measurements made by the OS loader (e.g., | 8 | 9 |
| GRUB2 for Linux) | | |
+-------------------------------------------+------+---------------+
| Measurements made by OS (e.g., Linux IMA) | 10 | 10 |
+-------------------------------------------+------+---------------+
Table 1: Attested Objects
2.1.2. Notes on PCR Allocations π¦
okay so PCR[0] is literally the most important one, bestie π The first measurement into PCR[0] is taken by the Root of Trust for Measurement, which is code that, by definition, cannot be verified by measurement. π That measurement sets up the chain of trust for every measurement after it. So if the PCR[0] measurement can't be trusted, the whole chain is giving "questionable" π
Here's the quick breakdown of how PCR[0], PCR[2], PCR[4], and PCR[8] are different π
PCR[0] πΈ is usually a consistent view of the rarely changed boot components of the host platform. That's what lets Attestation policies be defined using the less changeable parts of the transitive trust chain. This PCR usually gives a consistent view of the platform no matter what the user picked in their options. Iconic, honestly β¨
PCR[2] π is meant to represent a "user-configurable" environment, where the user can change what gets measured into PCR[2]. This usually happens when you add adapter cards and stuff into user-accessible Peripheral Component Interconnect (PCI) or other slots. In UEFI systems, these devices may be configured by Option ROMs that get measured into PCR[2] and run by the UEFI BIOS. Main character energy for hardware, ngl π₯
PCR[4] π§ is meant to represent the software that handles the handoff between the platform's pre-OS start and the state where the OS is present. This PCR, together with PCR[5], identifies the initial OS loader (for example, GRUB for Linux). lowkey the transition era π¦
PCR[8] π is used by the OS loader (like GRUB) to record measurements of the various components of the operating system.
Now, [PC-CLIENT-BIOS-TPM-2.0] specifies how the first eight PCRs are used super carefully so that multiple UEFI BIOS vendors can interoperate π«Ά But embedded software vendors may have way more flexibility, so it's not all identical. Verifiers usually need to know which log entries are consequential and which aren't (this might be controlled by local policies), but a Verifier doesn't necessarily need to know what each log entry means or why it went into a particular PCR.
Heads up, bestie: some PCRs may cover log entries that one Verifier thinks are critical and other entries it thinks are unimportant. So different PCR values may not, on their own, count as a check for authenticity. β οΈ
For example, on a UEFI system, some admins might think booting from a removable drive (which gets recorded in a PCR) is a security violation, while others might see it as an authorized recovery procedure. Same event, totally different vibes π
Designers can assign particular events to specific PCRs to hit a certain goal with local attestation. For instance, a procedure can only run, or a decryption key can only be released, if a given PCR is in a given state π It may also matter to designers whether streaming notification of PCR updates is required (see [RATS-NET-DEV-SUB]). Here's the key bit: specific log entries can only be validated if the Verifier gets every log entry that affects the relevant PCR. So a designer might want to separate rare, high-value events, like configuration changes, from high-volume, routine measurements like IMA logs [IMA] π
2.2. RIV Keying π
RIV attestation relies on two credentials π
- An identity key pair and matching certificate is required to certify the identity of the Attester itself. RIV specifies the use of an IEEE 802.1AR DevID [IEEE-802-1AR] that is signed by the device manufacturer and contains the device serial number. This requirement goes slightly beyond 802.1AR; see Section 2.4 for notes.
- An Attestation key pair and matching certificate is required to sign the Quote generated by the TPM to report evidence of software configuration.
In a TPM application, both the Attestation private key and the DevID private key MUST be protected by the TPM. Depending on other TPM configuration procedures, the two keys are likely to be different. Some of the considerations are outlined in the "TPM 2.0 Keys for Device Identity and Attestation" document [PLATFORM-DEVID-TPM-2.0] π
The "TPM 2.0 Keys for Device Identity and Attestation" document [PLATFORM-DEVID-TPM-2.0] also specifies further conventions for these keys:
- When separate Identity and Attestation keys are used, the AK and its X.509 certificate should parallel the DevID, with the same unique device identification as the DevID certificate (that is, the same subject and subjectAltName (if present), even though the key pairs are different). By examining the corresponding AK certificate, the Verifier can directly link a device's quote, which was signed by an AK, to the device that provided it. If the subject in the AK certificate doesn't match the corresponding DevID certificate, or if they're signed by different authorities, the Verifier may signal the detection of an Asokan-style person-in-the-middle attack (see Section 5.2). π΅οΈββοΈ
- Network devices that are expected to use SZTP as specified in [RFC8572] MUST be shipped by the manufacturer with pre-provisioned keys (Initial DevID and Initial AK, called IDevID and IAK, respectively). IDevID and IAK certificates MUST both be signed by the Endorser (typically the device manufacturer). Inclusion of an IDevID and IAK by a vendor does not preclude a mechanism whereby an administrator can define LDevID and Local Attestation Keys (LAK) if desired. π
2.3. RIV Information Flow π¦
RIV workflow for network equipment is organized around a simple use case: a network operator wants to verify the integrity of software installed in specific, fielded devices. A normative taxonomy of terms is given in [RFC9334], but as a reminder, this use case implies several roles and objects π§
Attester: The device that the network operator wants to examine.
Verifier: Which might be a Network Management Station. It's somewhat separate from the Device that will retrieve the signed evidence and measurement logs, and analyze them to pass judgment on the security posture of the device.
Relying Party: Can act on Attestation Results. Interaction between the Relying Party and the Verifier is considered out of scope for RIV.
Signed Reference Integrity Manifests (RIMs): Contains Reference Values. RIMs can either be created by the device manufacturer and shipped along with the device as part of its software image, or they could be obtained several other ways (direct to the Verifier from the manufacturer, from a third party, from the owner's concept of a "known good system", etc.). Retrieving RIMs from the device itself allows attestation to be done in systems that may not have access to the public Internet, or by other devices that are not management stations per se (e.g., a peer device; see Section 3.1.3). If Reference Values are obtained from multiple sources, the Verifier may need to evaluate the relative level of trust to be placed in each source in case of a discrepancy. π
These components are illustrated in Figure 2 π
+----------------+ +-------------+ +---------+--------+
|Reference Value | | Attester | Step 1 | Verifier| |
|Provider | | (Device |<-------| (Network| Relying|
|(Device | | under |------->| Mgmt | Party |
|Manufacturer | | attestation)| Step 2 | Station)| |
|or other | | | | | |
|authority) | | | | | |
+----------------+ +-------------+ +---------+--------+
| /\
| Step 0 |
-----------------------------------------------
Figure 2: RIV Reference Configuration for Network Equipment
Step 0: The Reference Value Provider (the device manufacturer or other authority) makes one or more RIMs, which correspond to the software image expected to be found on the device and are signed by the Reference Value Provider, available to the Verifier. (See Section 3.1.3 for "in-band" and "out of band" ways to make this happen.) β¨
Step 1: On behalf of a Relying Party, the Verifier (Network Management Station) requests DevID, Measurement Values, and possibly RIMs from the Attester. π¨
Step 2: The Attester responds to the request by providing a DevID, quotes (measured values that are signed by the Attester), and optionally RIMs. π
The use of the following standards components allows for interoperability π«Ά
- TPM keys MUST be configured according to [PLATFORM-DEVID-TPM-2.0] or [PLATFORM-ID-TPM-1.2].
- For devices using UEFI and Linux, measurements of firmware and bootable modules MUST be taken according to "TCG EFI Platform Specification" [PC-CLIENT-EFI-TPM-1.2] or "TCG PC Client Specific Platform Firmware Profile Specification" [PC-CLIENT-BIOS-TPM-2.0], and Linux IMA [IMA].
- DevID MUST be managed as DevID certificates as specified in IEEE Std 802.1AR [IEEE-802-1AR], with keys protected by TPMs.
- Attestation logs from Linux-based systems MUST be formatted according to the "Canonical Event Log Format" [CEL]. UEFI-based systems MUST use the TCG UEFI BIOS event log [PC-CLIENT-EFI-TPM-1.2] for TPM 1.2 systems and the "TCG PC Client Specific Platform Firmware Profile" [PC-CLIENT-BIOS-TPM-2.0] for TPM 2.0 systems.
- Quotes MUST be retrieved from the TPM according to the TCG Trusted Attestation Protocol Information Model (TAP IM) [TAP] and the Challenge-Response-based Remote Attestation (CHARRA) YANG model [RFC9684]. While the TAP IM gives a protocol-independent description of the data elements involved, it's important to note that quotes from the TPM are signed inside the TPM and MUST be retrieved in a way that does not invalidate the signature, to preserve the trust model. The CHARRA YANG model [RFC9684] is used for this purpose. (See Section 5, Security Considerations). π
- Reference Values MUST be encoded as defined in the TCG RIM document [RIM], typically using Software Identification (SWID) tags [SWID] [NIST-IR-8060] or Concise SWID (CoSWID) tags [RFC9393]. πΈ
2.4. RIV Simplifying Assumptions β¨
okay bestie, so to keep things from getting totally out of hand π«Ά this document makes some simplifying assumptions. Here they are:
- The product to be attested MUST be shipped by the equipment vendor with both a DevID as specified by IEEE Std 802.1AR and an IAK, with certificates in place. The IAK certificate must contain the same identity information as the DevID (specifically, the same subject and subjectAltName (if used), signed by the manufacturer). The IAK is a type of key that can be used to sign a TPM Quote, but not other objects (i.e., it's marked as a TCG "Restricted" key; this convention is described in "TPM 2.0 Keys for Device Identity and Attestation" [PLATFORM-DEVID-TPM-2.0]). For network equipment, which is generally not privacy sensitive, shipping a device with both an IDevID and an IAK already provisioned substantially simplifies initial startup. π
- IEEE Std 802.1AR does not require a product serial number as part of the subject, but RIV-compliant devices MUST include their serial numbers in the DevID/IAK certificates to simplify tracking logistics for network equipment users. All other optional 802.1AR fields remain optional in RIV.
It should be noted that the use of X.509 certificate fields as specified by IEEE Std 802.1AR is not identical to that described in [RFC9525] for representation of application service identity. π
- The product MUST be equipped with an RTM, a Root of Trust for Storage, and a Root of Trust for Reporting (as defined in [SP800-155]), which together are capable of conforming to the TCG TAP IM [TAP]. π₯
- The authorized software supplier MUST make available Reference Values in the form of signed SWID or CoSWID tags. π
2.4.1. Reference Integrity Manifests (RIMs)
[RFC9684] is all about collecting and transmitting evidence in the form of PCR measurements and attestation logs. But the critical part of the whole process is letting the Verifier decide whether the measurements are "the right ones" or not. Main character energy, the Verifier is literally the one deciding. π¦
While it must be up to network administrators to decide what they want on their networks, the software supplier should supply the Reference Values, in signed RIMs, that may be used by a Verifier to determine if evidence shows known good, known bad, or unknown software configurations. πΈ
In general, there are two kinds of reference measurements:
- Measurements of early system startup (e.g., BIOS, boot loader, OS kernel) are essentially single threaded and executed exactly once, in a known sequence, before any results can be reported. In this case, while the method for computing the hash and extending relevant PCRs may be complicated, the net result is that the software (more likely, firmware) vendor will have one known good PCR value that "should" be present in the relevant PCRs after the box has booted. In this case, the signed reference measurement could simply list the expected hashes for the given version. However, a RIM that contains the intermediate hashes can be useful in debugging cases where the expected final hash is not the one reported. π§
- Measurements taken later in operation of the system, once an OS has started (for example, Linux IMA [IMA]), may be more complex, with unpredictable "final" PCR values. In this case, the Verifier must have enough information to reconstruct the expected PCR values from logs and signed reference measurements from a trusted authority. π
In both cases, the expected values can be expressed as signed SWID or CoSWID tags, but the SWID structure in the second case is somewhat more complex, as reconstruction of the extended hash in a PCR may involve thousands of files and other objects. Thousands. π
TCG has published an information model defining elements of RIMs under the title "TCG Reference Integrity Manifest (RIM) Information Model" [RIM]. This information model outlines how SWID tags should be structured to allow attestation, and it defines "bundles" of SWID tags that may be needed to describe a complete software release. The RIM contains metadata relating to the software release it belongs to, plus hashes for each individual file or other object that could be attested. β¨
Many network equipment vendors use a UEFI BIOS to launch their network operating system. These vendors may want to also use the "TCG PC Client Reference Integrity Manifest Specification" [PC-CLIENT-RIM], which focuses specifically on a SWID-compatible format suitable for expressing measurement values expected from a UEFI BIOS. π
2.4.2. Attestation Logs
Quotes from a TPM can provide evidence of the state of a device up to the time the evidence was recorded. However, to make sense of the quote in cases where several events are extended into one PCR, an event log that identifies which software modules contributed which values to the quote during startup must also be provided. When required, the log MUST contain enough information to demonstrate its integrity by allowing exact reconstruction of the digest conveyed in the signed quote (that is, calculating the hash of all the hashes in the log should produce the same values as contained in the PCRs; if they don't match, the log may have been tampered with. See Appendix A.1). π΅οΈββοΈ
There are multiple event log formats that may be supported as viable formats of Evidence between the Attester and Verifier; however, to simplify interoperability, RIV focuses on just three:
- TCG UEFI BIOS event log for TPM 2.0 ("TCG PC Client Specific Platform Firmware Profile Specification") [PC-CLIENT-BIOS-TPM-2.0]
- TCG UEFI BIOS event log for TPM 1.2 ("TCG EFI Platform Specification" for TPM Family 1.1 or 1.2, Section 7) [PC-CLIENT-EFI-TPM-1.2]
- TCG "Canonical Event Log Format" [CEL] π
3. Standards Components
3.1. Prerequisites for RIV
The Reference Interaction Model for Challenge-Response-based Remote Attestation ([RATS-INTERACTION-MODELS]) is based on the standard roles defined in [RFC9334]. However, additional prerequisites have been established to allow for interoperable implementations of RIV use cases. These prerequisites are intended to provide sufficient context information so that the Verifier can acquire and evaluate measurements collected by the Attester. π
3.1.1. Unique Device Identity
A DevID in the form of a DevID certificate as specified by IEEE Std 802.1AR [IEEE-802-1AR] must be provisioned in the Attester's TPMs. π
3.1.2. Keys
The AK and certificate must also be provisioned on the Attester according to [PLATFORM-DEVID-TPM-2.0] or [PLATFORM-ID-TPM-1.2].
It MUST be possible for the Verifier to determine that the Attester's AKs are resident in the same TPM as its DevID keys (see Section 2.2 and Section 5, Security Considerations). This one is a big deal, so don't skip it! π¨
3.1.3. Appraisal Policy for Evidence
As noted in Section 2.3, the Verifier may obtain Reference Values from several sources. In addition, administrators may make authorized, site-specific changes (e.g., keys in key databases) that could impact attestation results. As such, there could be conflicts, omissions, or ambiguities between some Reference Values and collected Evidence.
The Verifier MUST have an Appraisal Policy for Evidence to evaluate the significance of any discrepancies between different reference sources, or between Reference Values and evidence from logs and quotes. While there must be an Appraisal Policy, this document does not specify the format or mechanism to convey the intended policy, nor does RIV specify mechanisms by which the results of applying the policy are communicated to the Relying Party. π
3.2. Reference Model for Challenge-Response
Okay so once the prerequisites for RIV are met, a Verifier is finally able to acquire Evidence from an Attester π¦ Figure 3 shows a RIV information flow between a Verifier and an Attester, derived from Section 7.1 of [RATS-INTERACTION-MODELS]. Each event and its input and output parameters is written as Event(input-params)=>(outputs). The event times match the time types described in Appendix A of [RFC9334] π§
.----------. .-----------------------.
| Attester | | Relying Party/Verifier |
'----------' '------------------------'
time(VG) |
generateClaims(attestingEnvironment) |
| => claims, eventLogs |
| |
| time(NS)
| <-- requestAttestation(handle, authSecIDs, claimSelection) |
| |
time(EG) |
collectClaims(claims, claimSelection) |
| => collectedClaims |
| |
generateEvidence(handle, authSecIDs, collectedClaims) |
| => evidence |
| time(RG,RA)
| evidence, eventLogs -------------------------------------> |
| |
| appraiseEvidence(evidence, eventLogs, refValues)
| attestationResult <= |
| |
~ ~
| time(RX)
Figure 3: IETF Attestation Information Flow
Step 1 (time(VG)): One or more attesting network device PCRs get extended with measurements πΈ RIV doesn't give you a direct link between when the event happens and when it gets attested, although streaming attestation as described in [RATS-NET-DEV-SUB] could β¨
Step 2 (time(NS)): The Verifier makes a unique random nonce ("number used once") π and asks an Attester for one or more PCRs. For interoperability, this must be accomplished as specified in "A YANG Data Model for Challenge-Response-Based Remote Attestation (CHARRA) Procedures Using Trusted Platform Modules (TPMs)" [RFC9684]. Both TPM 1.2 and TPM 2.0 allow nonces as large as the operative digest size (i.e., 20 or 32 bytes; see [TPM-1.2] Part 2, Section 5.5, and [TPM-2.0] Part 2, Section 10.4.4) π
Step 3 (time(EG)): On the Attester, the measured values get pulled out of the Attester's TPM π₯ This requested PCR evidence, along with the Verifier's nonce, is called a Quote, and it's signed by the AK associated with the DevID. Quotes are retrieved according to the CHARRA YANG model [RFC9684]. At the same time, the Attester collects log evidence showing the values have been extended into that PCR. Appendix A.1 goes deeper on how this works and has references to the structure and contents of quotes in TPM documents π§
Step 4: The collected Evidence gets passed from the Attester to the Verifier π¨
Step 5 (time(RG,RA)): The Verifier reviews the Evidence and takes action as needed π Since the interaction between Relying Party and Verifier is out of scope for RIV, this can be described as one step.
- If the signature covering TPM Evidence is not correct, the device SHOULD NOT be trusted. π
- If the nonce in the response doesn't match the Verifier's nonce, the response may be a replay, and the device SHOULD NOT be trusted. π
- If the signed PCR values do not match the set of log entries that have extended a particular PCR, the device SHOULD NOT be trusted. π
- If the log entries that the Verifier considers important do not match known good values, the device SHOULD NOT be trusted. We note that the process of collecting and analyzing the log can be omitted if the value in the relevant PCR is already a known-good value. β¨
- If the set of log entries are not seen as acceptable by the Appraisal Policy for Evidence, the device SHOULD NOT be trusted. π«
- If time(RG)-time(NS) is greater than the Appraisal Policy for Evidence's threshold for assessing freshness, the Evidence is considered stale and SHOULD NOT be trusted. π₯
3.2.1. Transport and Encoding
Network Management systems may retrieve signed PCR-based Evidence using NETCONF or RESTCONF with [RFC9684]. Either way, implementations must do so using a secure tunnel π
Log Evidence MUST be retrieved via log interfaces specified in [RFC9684]. Non-negotiable, bestie π
3.3. Centralized vs. Peer-to-Peer
Figure 3 assumes that the Verifier is trusted, while the Attester is not π«Ά In a peer-to-peer application, like two routers negotiating a trust relationship, the two peers can each ask the other to prove software integrity. The information flow is the same here, but each side plays both roles, as an Attester and as a Verifier. Each device issues a challenge, and each device responds to the other's challenge, as shown in Figure 4 π¦ Peer-to-peer challenges, especially when they're used to build trust between routers, require devices to carry their own signed reference measurements (RIMs). Devices may also have to carry an appraisal policy for evidence for each possible peer device, so every device has everything it needs for remote attestation without having to rely on a central authority π
+---------------+ +---------------+
| RefVal | | RefVal |
| Provider A | | Provider B |
| Firmware | | Firmware |
| Configuration | | Configuration |
| Authority | | Authority |
| | | |
+---------------+ +---------------+
| |
| |Step 0B
| +------------+ +------------+ |
| | | Step 1 | | | \
| | Attester |<------>| Verifier | | |
| | |<------>| | | | Router B
+------>| | Step 2 | | | |- Challenges
Step 0A| | | | | | Router A
| |------->| | | |
|- Router A -| Step 3 |- Router B -| | /
| | | | |
| | | | |
| | Step 1 | | | \
| Verifier |<------>| Attester |<-+ | Router A
| |<------>| | |- Challenges
| | Step 2 | | | Router B
| | | | |
| |<-------| | |
+------------+ Step 3 +------------+ /
Figure 4: Peer-to-Peer Attestation Information Flow
In this application, each device may need to be equipped with signed RIMs so it can act as an Attester π And so each device can act as a Verifier, it may also need an Appraisal Policy for Evidence and a selection of trusted X.509 root certificates. An existing link layer protocol, such as 802.1X [IEEE-802.1X] or 802.1AE [IEEE-802.1AE], with Evidence enclosed over a variant of the Extensible Authentication Protocol (EAP) [RFC3748] or Link Layer Discovery Protocol (LLDP) [LLDP], are suitable methods for such an exchange π§ Details of peer-to-peer operation are out of scope for this document π
4. Privacy Considerations π
Network equipment, such as routers, switches, and firewalls, has a key role to play in guarding the privacy of individuals using the network π Network equipment generally follows several rules to protect privacy:
- Packets passing through the device must not be sent to unauthorized destinations. For example:
- Routers often act as Policy Enforcement Points, where individual subscribers may be checked for authorization to access a network. Subscriber login information must not be released to unauthorized parties.
- Network equipment is often called upon to block access to protected resources from unauthorized users.
- Routing information, such as the identity of a router's peers, must not be leaked to unauthorized neighbors.
- If configured, encryption and decryption of traffic must be carried out reliably, while protecting keys and credentials.
Functions that protect privacy are built into each layer of hardware and software that makes up the networking device β¨ Given these requirements for protecting the privacy of network users, the network equipment must identify itself, along with its boot configuration and measured device state (for example, PCR values), to the equipment's administrator, so there's no uncertainty about the device's function and configuration π Attestation is the piece that lets the administrator make sure the network provides individual and peer privacy guarantees, even though the device itself may not have a right to keep its identity secret π«Ά
See [NET-EQ] for more context on privacy in networking devices π
While attestation information from network devices is not likely to contain privacy-sensitive content about network users, administrators may want to keep attestation records confidential. That's so they don't disclose which versions of software are loaded on the device, which is information that could make attacks against known vulnerabilities easier ππ¨
5. Security Considerations π‘οΈ
Specifications such as TLS [RFC8446] and YANG [RFC7950] have a ton of solid advice on keeping network-connected systems secure π This section lays out the specific risks and mitigations related to attestation.
Attestation Evidence obtained by the RIV procedure is subject to a number of attacks, and bestie, these are serious π
- Keys may be compromised. π
- A counterfeit device may attempt to impersonate (spoof) a known authentic device. π»
- Person-in-the-middle attacks may be used by a compromised device to attempt to deliver responses that originate in an authentic device. π΅οΈββοΈ
- Replay attacks may be attempted by a compromised device. π
5.1. Keys Used in RIV π
Okay bestie, trustworthiness of RIV attestation depends strongly on whether the keys used for identity and attestation reports are valid. RIV takes full advantage of TPM capabilities so the evidence can actually be trusted π
Two sets of key pairs are relevant here:
- A DevID key pair is used to certify the identity of the device the TPM is installed in. πͺͺ
- An AK key pair is used to certify attestation Evidence (i.e., quotes) and to provide evidence for the integrity of the device software. π§©
TPM practices usually require these keys to be different, so a general-purpose signing key can't be used to spoof an attestation quote. π ββοΈ
In each case the private half of the key is known only to the TPM and can't be retrieved externally, even by a trusted party. π To make sure that's the case, specification-compliant private/public key pairs are generated inside the TPM, where they're never exposed and can't be extracted (see [PLATFORM-DEVID-TPM-2.0]).
Keeping keys safe is a huge enabler of trustworthiness, but it's just one part of attestation security. Knowing which keys are bound to the device in question is just as important, especially in an environment where private keys are never exposed. π«Ά
There are many ways to manage keys in a TPM (see [PLATFORM-DEVID-TPM-2.0]). RIV includes support for "zero touch" provisioning (also known as zero touch onboarding) of fielded devices (e.g., SZTP [RFC8572]), where keys with predictable trust properties are provisioned by the device vendor. π
Device identity in RIV is based on DevID, defined by IEEE Std 802.1AR. This specification provides several elements:
- A DevID requires a unique key pair for each device, accompanied by an X.509 certificate.
- The private portion of the DevID key is to be stored in the device, in a manner that provides confidentiality (Section 6.2.5 of [IEEE-802-1AR]).
The X.509 certificate contains several components:
- The public part of the unique DevID key assigned to that device allows a challenge of identity.
- An identifying string that's unique to the manufacturer of the device. This is normally the serial number of the unit, which might also be printed on a label on the device.
- The certificate must be signed by a key traceable to the manufacturer's root key.
With these elements, the device's manufacturer and serial number can be identified by analyzing the DevID certificate plus the chain of intermediate certificates leading back to the manufacturer's root certificate. As is conventional in TLS or SSH connections, a random nonce must be signed by the device in response to a challenge, proving possession of its DevID private key. π
RIV uses the DevID to validate a TLS or SSH connection to the device as the attestation session begins. Security of this process comes from TLS or SSH security, with the DevID (which contains a device serial number) providing proof that the session terminates on the intended device. See [RFC8446] [RFC4253]. π€
Evidence of software integrity is delivered as a quote that is signed by the TPM itself and accompanied by an IAK certificate containing the same identity information as the DevID. Because the contents of the quote are signed inside the TPM, any external modification (including reformatting to a different data format) after measurements have been taken will be detected as tampering. π¨ An unbroken chain of trust is essential for making sure the blocks of code taking measurements were verified before execution (see Figure 1).
Requiring measurements of the operating software to be signed by a key known only to the TPM also removes the need to trust the device's operating software (beyond the first measurement in the RTM; see below). π€ If malicious software makes any changes to a quote in the device itself, or in the path back to the Verifier, the signature on the quote will be invalidated. π
A critical feature of the YANG model described in [RFC9684] is the ability to carry TPM data structures in their TCG-defined format, without requiring any changes to the structures as they were signed and delivered by the TPM. β¨ Alternate methods of conveying TPM quotes could reduce redundant information, or add another layer of signing using external keys, but the implementation MUST preserve the TPM signing so that tampering anywhere in the path between the TPM itself and the Verifier can be detected. π
5.2. Prevention of Spoofing and Person-in-the-Middle Attacks π΅οΈββοΈ
Preventing spoofing attacks against attestation systems is also super important. There are several cases to consider:
- The entire device could be spoofed. If the Verifier goes to appraise a specific Attester, it might be redirected to a different Attester.
- A compromised device could have a valid DevID, but substitute a quote from a known-good device instead of returning its own, as described in [RFC6813].
- A device with a compromised OS could return a fabricated quote, providing spoofed attestation Evidence.
Using the 802.1AR DevID in the TPM protects against the spoofed-device case by making sure the Verifier's TLS or SSH session actually terminates on the right device. π―
Protecting against spoofed quotes from a device with a valid identity is a bit more complex. An identity key must be available to sign any kind of nonce or hash offered by the Verifier, and so it could be used to sign a fabricated quote. π¬ To block a spoofed Attestation Result, the quote generated inside the TPM must be signed by a key, known as an AK, that's different from the DevID.
Given separate Attestation and DevID keys, the binding between the AK and the same device must also be proven to prevent a person-in-the-middle attack (e.g., the "Asokan Attack" [RFC6813]). π
RIV handles this with an AK certificate that has the same elements as the DevID (same manufacturer's serial number, signed by the same manufacturer's key), but containing the device's unique AK public key instead of the DevID public key. This binding between DevID and AK certificates is critical to reliable attestation. π
The TCG document "TPM 2.0 Keys for Device Identity and Attestation" [PLATFORM-DEVID-TPM-2.0] specifies OIDs for Attestation Certificates that let the CA mark a key as specifically known to be an AK. π·οΈ
These two key pairs and certificates are used together:
- The DevID is used to validate a TLS connection terminating on the device with a known serial number.
- The AK is used to sign attestation quotes, which provides proof that the attestation evidence comes from the same device.
5.3. Replay Attacks π
Replay attacks, where the results of a previous attestation are submitted in response to subsequent requests, are usually prevented by including a random nonce in the request to the TPM for a quote. Every request from the Verifier includes a new random number (a nonce). The resulting quote signed by the TPM contains the same nonce, which lets the Verifier determine freshness (i.e., that the quote was generated in response to the Verifier's specific request). π "Time-Based Uni-Directional Attestation" [RATS-TUDA] provides an alternate mechanism to verify freshness without requiring a request/response cycle. β°
5.4. Owner-Signed Keys ποΈ
Although device manufacturers must pre-provision devices with easily verified DevID and AK certificates if SZTP, such as the one described in [RFC8572], is to be supported, using those credentials is not mandatory. π IEEE Std 802.1AR incorporates the idea of an IDevID, which is provisioned by the manufacturer, and an LDevID, which is provisioned by the owner of the device. RIV and [PLATFORM-DEVID-TPM-2.0] extend that concept by defining an IAK and LAK with the same properties. π§
Device owners can use any method to provision the local credentials.
- The TCG document [PLATFORM-DEVID-TPM-2.0] shows how the IAKs can be used to certify LDevID and LAK keys. Using the LDevID and LAK lets the device owner use a uniform identity structure across device types from multiple manufacturers (in the same way that an "Asset Tag" is used by many enterprises to identify devices they own). π’ The TCG document [PROV-TPM-2.0] also has guidance on provisioning local identity keys in TPM 2.0. Owners should follow the same practice of binding LDevID and LAK as the manufacturer would for IDevID and IAK. See Section 2.2.
- Device owners, however, can use any other mechanism they want, including physical inspection and programming in a secure location, to assure themselves that local identity certificates are inserted into the intended device if they'd rather not place trust in the manufacturer-provided keys. π‘οΈ
Clearly, local keys can't be used for SZTP. Installing the local keys can only be done by a process that runs before the device is installed for network operation, or by using procedures such as those outlined in Bootstrapping Remote Secure Key Infrastructure (BRSKI) [RFC8995]. π οΈ
On the other end of the device lifecycle, provision should be made to wipe local keys when a device is decommissioned, to indicate that the device is no longer owned by the enterprise. π§Ή The manufacturer's initial identity keys must be preserved, as they contain no information that's not already printed on the device's serial number plate. π·οΈβ¨
5.5. Other Factors for Trustworthy Operation β¨
okay so, beyond getting the keys provisioned safely π, RIV needs a bunch of other stuff to be trustworthy too. bestie, this part is lowkey the foundation of the whole vibe π«Ά
- Secure identity depends on mechanisms that stop per-device secret keys from getting compromised π. The TPM handles this as a Root of Trust for Storage, and it's giving security queen energy π
- Attestation depends on an unbroken chain of measurements, starting from the very first one π. For TPM background, check Appendix A.1 π
- That first measurement is made by code called the RTM π§±. It's usually trusted firmware sitting in boot flash. Keeping the RTM trustworthy is out of scope for RIV π ββοΈ, but it could involve immutable firmware, signed updates, or a vendor-specific hardware verification technique π οΈ. For Roots of Trust background, see Appendix A.2 π
- The device owner SHOULD provide some level of physical defense for the device π°. If a TPM that's already been programmed with an authentic DevID gets stolen and popped into a counterfeit device π, attestation of that fake device could end up looking exactly like an authentic one. not it π
RIV also depends on reliable Reference Values, as expressed by the RIM [RIM] π. Defining trust procedures for RIMs is out of scope for RIV π, so the device owner can use any policy they want to validate a set of reference measurements π . Also, RIV can give a reliable indication that a known software package is in use and hasn't been tampered with β , but figuring out whether it's the correct package for the application is the device owner's job π§.
RIMs can be conveyed out-of-band or in-band as part of the attestation process (see Section 3.1.3) π¬. For network devices, though, software usually ships as a self-contained package π¦, so RIMs signed by the manufacturer and delivered in-band may be way more convenient for the device owner π«Ά.
The validity of RIV attestation results is also shaped by how the Reference Values get made π:
- Even though the RIM itself is signed, supply chains SHOULD be carefully scrutinized π so the values can't be messed with before signing. Insider attacks against code bases and build chains are especially sneaky and hard to spot π₯·
- Designers SHOULD guard against hash collision attacks π‘οΈ. RIMs often give hashes for large objects of indeterminate size. If one of the measured objects gets swapped for an implant engineered to produce the same hash π, RIV won't be able to detect the substitution. TPM 1.2 only uses SHA-1 hashes, which have been shown to be susceptible to collision attack π. TPM 2.0 produces quotes with SHA-256, which so far has resisted such attacks πͺ. So, RIV implementations SHOULD use TPM 2.0 π
6. IANA Considerations πΈ
This document has no IANA actions. nothing to register, zero registry drama π§
7. Conclusion π
TCG technologies can play a major role in implementing RIV π¦. Standards for a lot of the components RIV needs already exist, and honestly they're giving everything π€©:
- Platform identity can be based on IEEE 802.1AR DevID, paired with careful supply-chain management by the manufacturer π
- Complex supply chains can be certified using TCG Platform Certificates [PLATFORM-CERTS] π
- The TCG TAP mechanism, coupled with [RFC9684], can be used to retrieve attestation evidence π
- Reference Values have to be conveyed from the software authority (for example, the manufacturer) in RIMs to the system where verification happens π. IETF and TCG SWID and CoSWID work ([RFC9393] [RIM]) forms the basis for this function π§©
8. References π
8.1. Normative References
- [CEL] Trusted Computing Group, "Canonical Event Log Format", Version 1.0, Revision 0.41, February 2022,
https://trustedcomputinggroup.org/wp-content/uploads/TCG_IWG_CEL_v1_r0p41_pub.pdf. - [IEEE-802-1AR] IEEE, "IEEE Standard for Local and Metropolitan Area Networks - Secure Device Identity", IEEE Std 802.1AR-2018, DOI 10.1109/IEEESTD.2018.8423794, August 2018,
https://doi.org/10.1109/IEEESTD.2018.8423794. - [IMA] The kernel development community, "dm-ima", Linux Kernel 6.11, 15 September 2024,
https://www.kernel.org/doc/html/v6.11/admin-guide/device-mapper/dm-ima.html. The latest version can be found athttps://docs.kernel.org/admin-guide/device-mapper/dm-ima.html. - [PC-CLIENT-BIOS-TPM-2.0] Trusted Computing Group, "TCG PC Client Specific Platform Firmware Profile Specification", Family "2.0", Level 00, Version 1.05, Revision 23, May 2021,
https://trustedcomputinggroup.org/resource/pc-client-specific-platform-firmware-profile-specification/. - [PC-CLIENT-EFI-TPM-1.2] Trusted Computing Group, "TCG EFI Platform Specification", For TPM Family 1.1 or 1.2, Version 1.22, Revision 15, January 2014,
https://trustedcomputinggroup.org/resource/tcg-efi-platform-specification/. - [PC-CLIENT-RIM] Trusted Computing Group, "TCG PC Client Reference Integrity Manifest Specification", Version 1.04, November 2020,
https://trustedcomputinggroup.org/resource/tcg-pc-client-reference-integrity-manifest-specification/. - [PLATFORM-DEVID-TPM-2.0] Trusted Computing Group, "TPM 2.0 Keys for Device Identity and Attestation", Version 1.00, Revision 12, October 2021,
https://trustedcomputinggroup.org/resource/tpm-2-0-keys-for-device-identity-and-attestation/. - [PLATFORM-ID-TPM-1.2] Trusted Computing Group, "TCG Infrastructure WG TPM Keys for Platform Identity for TPM 1.2", Specification Version 1.0, Revision 3, August 2015,
https://trustedcomputinggroup.org/resource/tpm-keys-for-platform-identity-for-tpm-1-2-2/. - [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997,
https://www.rfc-editor.org/info/rfc2119. - [RFC4253] Ylonen, T. and C. Lonvick, Ed., "The Secure Shell (SSH) Transport Layer Protocol", RFC 4253, DOI 10.17487/RFC4253, January 2006,
https://www.rfc-editor.org/info/rfc4253. - [RFC5280] Cooper, D., Santesson, S., Farrell, S., Boeyen, S., Housley, R., and W. Polk, "Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile", RFC 5280, DOI 10.17487/RFC5280, May 2008,
https://www.rfc-editor.org/info/rfc5280. - [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., and A. Bierman, Ed., "Network Configuration Protocol (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011,
https://www.rfc-editor.org/info/rfc6241. - [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017,
https://www.rfc-editor.org/info/rfc8174. - [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018,
https://www.rfc-editor.org/info/rfc8446. - [RFC9334] Birkholz, H., Thaler, D., Richardson, M., Smith, N., and W. Pan, "Remote ATtestation procedureS (RATS) Architecture", RFC 9334, DOI 10.17487/RFC9334, January 2023,
https://www.rfc-editor.org/info/rfc9334. - [RFC9393] Birkholz, H., Fitzgerald-McKay, J., Schmidt, C., and D. Waltermire, "Concise Software Identification Tags", RFC 9393, DOI 10.17487/RFC9393, June 2023,
https://www.rfc-editor.org/info/rfc9393. - [RFC9684] Birkholz, H., Eckel, M., Bhandari, S., Voit, E., Sulzen, B., Xia, L., Laffey, T., and G. C. Fedorkow, "A YANG Data Model for Challenge-Response-Based Remote Attestation (CHARRA) Procedures Using Trusted Platform Modules (TPMs)", RFC 9684, DOI 10.17487/RFC9684, December 2024,
https://www.rfc-editor.org/info/rfc9684. - [RIM] Trusted Computing Group, "TCG Reference Integrity Manifest (RIM) Information Model", Version 1.01, Revision 0.16, November 2020,
https://trustedcomputinggroup.org/resource/tcg-reference-integrity-manifest-rim-information-model/. - [SWID] ISO/IEC, "Information technology - IT asset management - Part 2: Software identification tag", ISO/IEC 19770-2:2015, October 2015,
https://www.iso.org/standard/65666.html. - [TAP] Trusted Computing Group, "TCG Trusted Attestation Protocol (TAP) Information Model for TPM Families 1.2 and 2.0 and DICE Family 1.0", Version 1.0, Revision 0.36, October 2018,
https://trustedcomputinggroup.org/wp-content/uploads/TNC_TAP_Information_Model_v1.00_r0.36-FINAL.pdf.
8.2. Informative References
[AIK-ENROLL] Trusted Computing Group, "TCG Infrastructure Working Group A CMC Profile for AIK Certificate Enrollment", Version 1.0, Revision 7, March 2011, <https://trustedcomputinggroup.org/resource/tcg-infrastructure-working-group-a-cmc-profile-for-aik-certificate-enrollment/>.
Okay so this is the bit where we collect all the extra reading materials, the informative ones. Not required to build the thing, but SO worth bookmarking. π First up is the TCG's CMC profile for AIK certificate enrollment. π π
[IEEE-802.1AE] IEEE, "IEEE Standard for Local and metropolitan area networks - Media Access Control (MAC) Security", IEEE Std 802.1AE-2018, DOI 10.1109/IEEESTD.2018.8585421, 2018, <https://doi.org/10.1109/IEEESTD.2018.8585421>.
MAC Security, aka 802.1AE, which is giving link-layer encryption energy. π β¨
[IEEE-802.1X] IEEE, "IEEE Standard for Local and Metropolitan Area Networks - Port-Based Network Access Control", IEEE Std 802.1X-2020, DOI 10.1109/IEEESTD.2020.9018454, February 2020, <https://doi.org/10.1109/IEEESTD.2020.9018454>.
Port-based network access control, the 802.1X bouncer at the door. πͺ πΈ
[LLDP] IEEE, "IEEE Standard for Local and metropolitan area networks - Station and Media Access Control Connectivity Discovery", IEEE Std 802.1AB-2016, DOI 10.1109/IEEESTD.2016.7433915, March 2016, <https://doi.org/10.1109/IEEESTD.2016.7433915>.
LLDP is the neighbour-introducing standard, aka the devices saying hi to each other. π π¦
[NET-EQ] Trusted Computing Group, "TCG Guidance for Securing Network Equipment Using TCG Technology", Version 1.0, Revision 29, January 2018, <https://trustedcomputinggroup.org/resource/tcg-guidance-securing-network-equipment/>.
Guidance for locking down network gear with TCG tech. Serious stuff, bestie. π π₯
[NIST-IR-8060] Waltermire, D., Cheikes, B. A., Feldman, L., and G. Witte, "Guidelines for the Creation of Interoperable Software Identification (SWID) Tags", NIST NISTIR 8060, DOI 10.6028/NIST.IR.8060, April 2016, <https://nvlpubs.nist.gov/nistpubs/ir/2016/NIST.IR.8060.pdf>.
SWID tags, the software ID labels, very organised. π·οΈ π
[PLATFORM-CERTS] Trusted Computing Group, "TCG Platform Attribute Credential Profile", Specification Version 1.0, Revision 16, January 2018, <https://trustedcomputinggroup.org/resource/tcg-platform-attribute-credential-profile/>.
Platform attribute credentials, which is a whole vibe. β¨ π§
[PROV-TPM-2.0] Trusted Computing Group, "TCG TPM v2.0 Provisioning Guidance", Version 1.0, Revision 1.0, March 2017, <https://trustedcomputinggroup.org/wp-content/uploads/TCG-TPM-v2.0-Provisioning-Guidance-Published-v1r1.pdf>.
TPM 2.0 provisioning guidance, the setup manual of the TPM world. π π
[RATS-EAT] Lundblade, L., Mandyam, G., O'Donoghue, J., and C. Wallace, "The Entity Attestation Token (EAT)", Work in Progress, Internet-Draft, draft-ietf-rats-eat-31, 6 September 2024, <https://datatracker.ietf.org/doc/html/draft-ietf-rats-eat-31>.
EAT is the token format for attestation evidence, and it's still a draft, so it's giving work in progress. π¦ π
[RATS-INTERACTION-MODELS] Birkholz, H., Eckel, M., Pan, W., and E. Voit, "Reference Interaction Models for Remote Attestation Procedures", Work in Progress, Internet-Draft, draft-ietf-rats-reference-interaction-models-11, 22 July 2024, <https://datatracker.ietf.org/doc/html/draft-ietf-rats-reference-interaction-models-11>.
Reference interaction models for remote attestation, aka how the RATS parties chat with each other. π¬ π«Ά
[RATS-NET-DEV-SUB] Birkholz, H., Voit, E., and W. Pan, "Attestation Event Stream Subscription", Work in Progress, Internet-Draft, draft-ietf-rats-network-device-subscription-05, 7 July 2024, <https://datatracker.ietf.org/doc/html/draft-ietf-rats-network-device-subscription-05>.
Subscribing to attestation event streams, so you get updates without asking every time. π β¨
[RATS-TUDA] Fuchs, A., Birkholz, H., McDonald, I., and C. Bormann, "Time-Based Uni-Directional Attestation", Work in Progress, Internet-Draft, draft-birkholz-rats-tuda-07, 10 July 2022, <https://datatracker.ietf.org/doc/html/draft-birkholz-rats-tuda-07>.
Time-based uni-directional attestation, one-way vibes only. β° πΈ
[RATS-USECASES] Richardson, M., Wallace, C., and W. Pan, "Use cases for Remote Attestation common encodings", Work in Progress, Internet-Draft, draft-richardson-rats-usecases-08, 2 November 2020, <https://datatracker.ietf.org/doc/html/draft-richardson-rats-usecases-08>.
The use cases draft for common encodings, the "why we need this" file. π§ π
[RFC3748] Aboba, B., Blunk, L., Vollbrecht, J., Carlson, J., and H. Levkowetz, Ed., "Extensible Authentication Protocol (EAP)", RFC 3748, DOI 10.17487/RFC3748, June 2004, <https://www.rfc-editor.org/info/rfc3748>.
EAP, the extensible authentication protocol, a classic. π π
[RFC6813] Salowey, J. and S. Hanna, "The Network Endpoint Assessment (NEA) Asokan Attack Analysis", RFC 6813, DOI 10.17487/RFC6813, December 2012, <https://www.rfc-editor.org/info/rfc6813>.
The NEA Asokan attack analysis, which is a whole plot twist. π π₯
[RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", RFC 7950, DOI 10.17487/RFC7950, August 2016, <https://www.rfc-editor.org/info/rfc7950>.
YANG 1.1, the data modeling language. Very neat and tidy. π β¨
[RFC8572] Watsen, K., Farrer, I., and M. Abrahamsson, "Secure Zero Touch Provisioning (SZTP)", RFC 8572, DOI 10.17487/RFC8572, April 2019, <https://www.rfc-editor.org/info/rfc8572>.
SZTP, secure zero touch provisioning, so devices set themselves up. π§ π
[RFC8995] Pritikin, M., Richardson, M., Eckert, T., Behringer, M., and K. Watsen, "Bootstrapping Remote Secure Key Infrastructure (BRSKI)", RFC 8995, DOI 10.17487/RFC8995, May 2021, <https://www.rfc-editor.org/info/rfc8995>.
BRSKI is the bootstrapping one, and it's iconic. π¦ π
[RFC9525] Saint-Andre, P. and R. Salz, "Service Identity in TLS", RFC 9525, DOI 10.17487/RFC9525, November 2023, <https://www.rfc-editor.org/info/rfc9525>.
Service identity in TLS, so the certificate checks out for the right service. π π«Ά
[SP800-155] NIST, "BIOS Integrity Measurement Guidelines (Draft)", NIST SP 800-155 (Draft), December 2011, <https://csrc.nist.gov/files/pubs/sp/800/155/ipd/docs/draft-sp800-155_dec2011.pdf>.
BIOS integrity measurement guidelines, the draft one. πΈ π
[SP800-193] NIST, "Platform Firmware Resiliency Guidelines", NIST SP 800-193, DOI 10.6028/NIST.SP.800-193, May 2018, <https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-193.pdf>.
Platform firmware resiliency, keeping the firmware healthy. π‘οΈ π
[SWID-GEN] Labs64, "SoftWare IDentification (SWID) Tags Generator (Maven Plugin)", <https://github.com/Labs64/swid-maven-plugin>.
A Maven plugin that generates SWID tags, very handy. π§° β¨
[TCG-RT] Trusted Computing Group, "TCG Roots of Trust Specification", (Draft), Family "1.0", Level 00, Revision 0.20, July 2018, <https://trustedcomputinggroup.org/wp-content/uploads/TCG_Roots_of_Trust_Specification_v0p20_PUBLIC_REVIEW.pdf>.
Roots of trust, where the chain of trust starts. π± π₯
[TPM-1.2] Trusted Computing Group, "TPM 1.2 Main Specification", Level 2, Version 1.2, Revision 116, March 2011, <https://trustedcomputinggroup.org/resource/tpm-main-specification/>.
TPM 1.2, the older generation, still iconic. π΅ π
[TPM-2.0] Trusted Computing Group, "Trusted Platform Module Library", Family "2.0", Level 00, Revision 01.83, March 2024, <https://trustedcomputinggroup.org/resource/tpm-library-specification/>.
TPM 2.0 library spec, the big one. π π
Appendix A. Supporting Materials
A.1. Using a TPM for Attestation
The TPM and surrounding ecosystem provide three interlocking capabilities to enable secure collection of evidence from a remote device: PCRs, a Quote mechanism, and a standardized Event Log. π¦ β¨
Each TPM has at least eight and at most twenty-four PCRs (depending on the profile and vendor choices), each one large enough to hold one hash value (SHA-1, SHA-256, and other hash algorithms can be used, depending on TPM version). PCRs can't be accessed directly from outside the chip, but the TPM interface provides a way to "extend" a new security measurement hash into any PCR, a process by which the existing value in the PCR is hashed with the new security measurement hash, and the result placed back into the same PCR. The result is a composite fingerprint comprising the hash of all the security measurements extended into each PCR since the system was reset. π π
Every time a PCR is extended, an entry should be added to the corresponding Event Log. Logs contain the security measurement hash plus informative fields offering hints as to which event generated the security measurement. The Event Log itself is protected against accidental manipulation, but it is implicitly tamper-evident: Any verification process can read the security measurement hash from the log events, compute the composite value, and compare that to what is in the PCR. If there's no discrepancy, the logs do provide an accurate view of what was placed into the PCR. π πΈ
Note that the composite hash-of-hashes recorded in PCRs is order-dependent, resulting in different PCR values for different ordering of the same set of events (e.g., Event A followed by Event B yields a different PCR value than B followed by A). For single-threaded code, where both the events and their order are fixed, a Verifier may validate a single PCR value, and use the log only to diagnose a mismatch from Reference Values. However, operating system code is usually nondeterministic, meaning that there may never be a single "known good" PCR value. In this case, the Verifier may have to verify that the log is correct, and then analyze each item in the log to determine if it represents an authorized event. π§ β¨
In a conventional TPM Attestation environment, the first measurement must be made and extended into the TPM by trusted device code (called the RTM). That first measurement should cover the segment of code that is run immediately after the RTM, which then measures the next code segment before running it, and so on, forming an unbroken chain of trust. See [TCG-RT] for more on Mutable vs. Immutable Roots of Trust. π± π₯
The TPM provides another mechanism called a Quote that can read the current value of the PCRs and package them, along with the Verifier's nonce, into a TPM-specific data structure signed by an Attestation private key, known only to the TPM. π π
It's important to note that the Quote data structure is signed inside the TPM (see Section 5, Security Considerations). The trust model is preserved by retrieving the Quote in a way that does not invalidate the signature, as specified in [RFC9684]. The structure of the command and response for a quote, including its signature, as generated by the TPM, can be seen in Part 3, Section 16.5, of [TPM-1.2] and Section 18.4.2 of [TPM-2.0]. π«Ά π
The Verifier uses the Quote and Log together. The Quote contains the composite hash of the complete sequence of security measurement hashes, signed by the TPM's private AK. The Log contains a record of each measurement extended into the TPM's PCRs. By computing the composite hash of all the measurements, the Verifier can verify the integrity of the Event Log, even though the Event Log itself is not signed. Each hash in the validated Event Log can then be compared to corresponding expected values in the set of Reference Values to validate overall system integrity. π π
A summary of information exchanged in obtaining quotes from TPM 1.2 and TPM 2.0 can be found in [TAP], Section 4. Detailed information about PCRs and Quote data structures can be found in [TPM-1.2], [TPM-2.0]. Recommended log formats include [PC-CLIENT-BIOS-TPM-2.0], and [CEL]. π β¨
A.2. Root of Trust for Measurement (RTM) π
okay so attestation only works if the device has an RTM, which is some trustworthy mechanism that computes the very first measurement in the chain of trust. That chain is what proves every stage of startup got verified. The device also needs a Root of Trust for Storage (aka the TPM PCRs) to record the results, and a Root of Trust for Reporting to report them. no RTM, no receipts, bestie π
there's a lot of drama in Roots of Trust ([TCG-RT] [SP800-155] [SP800-193]), but two parts matter most for attestation:
- The first measurement computed by the RTM and stored in the TPM's Root of Trust for Storage must be assumed to be correct. π«‘
- There must not be a way to reset the Root of Trust for Storage without re-entering the RTM code. π«
the first measurement has to come from code that's implicitly trusted. if that first measurement gets subverted, none of the rest can be trusted either, and the whole thing collapses π (See [SP800-155].)
and this is the part people forget π the TPM or its supplier can't vouch for the RTM code by itself. code or procedures outside the TPM have to guarantee the RTM is secure. it's not the TPM's job to babysit the RTM, periodt π
A.3. Layering Model for Network Equipment Attester and Verifier π§©
so retrieving identity and attestation state runs on one protocol stack, and fetching Reference Values runs on a totally different set of protocols. Figure 5 shows who's who π¦
+-----------------------+ +-------------------------+
| | | |
| Attester |<-------------| Verifier |
| (Device) |------------->| (Management Station) |
| | | | |
+-----------------------+ | +-------------------------+
|
-------------------- --------------------
| |
------------------------------- ---------------------------------
| Reference Values | | Attestation |
------------------------------- ---------------------------------
********************************************************************
* IETF Remote Attestation Conceptual Data Flow *
* RFC9334, Figure 1 *
********************************************************************
......................... .........................
. Reference Integrity . . TAP Info .
. Manifest . . Model and Canonical .
. . . Log Format .
......................... .........................
************************* *************************
* YANG SWID Module * * YANG Attestation *
* RFC9393 * * Module *
* * * RFC9684 *
* * * *
************************* *************************
************************* *************************
* XML, JSON, CBOR, etc. * * XML, JSON, CBOR, etc. *
************************* *************************
************************* *************************
* RESTCONF/NETCONF * * RESTCONF/NETCONF *
************************* *************************
************************* *************************
* TLS, SSH * * TLS, SSH *
************************* *************************
Figure 5: RIV Protocol Stacks
IETF docs get boxes with asterisks around them, and TCG docs get boxes with dots. easy way to tell who wrote what, no cap β¨
A.4. Implementation Notes π οΈ
okay so Table 2 recaps a bunch of the actions you'll need to finish an Attestation system, with links to the relevant docs. the docs come from lots of standards orgs, but the implied actions are all the manufacturer's responsibility unless noted otherwise. main character manufacturer energy π
as I mentioned, SWID tags can be generated a bunch of ways, but one possible tool is [SWID-GEN] πΈ
+========================================+==========================+
| Component | Controlling |
| | Specification |
+========================================+==========================+
| Make a Secure execution environment: | [TCG-RT] |
| | |
| * Attestation depends on a secure | <www.uefi.org> |
| RTM outside the TPM, as well as | |
| Roots for Storage and Reporting | |
| inside the TPM. | |
| | |
| * Refer to "TCG Roots of Trust | |
| Specification" [TCG-RT]. | |
| | |
| * [SP800-193] also provides | |
| guidelines on Roots of Trust. | |
+----------------------------------------+--------------------------+
| Provision the TPM as described in the | [PLATFORM-DEVID-TPM-2.0] |
| TCG documents. | |
| | [PLATFORM-CERTS] |
+----------------------------------------+--------------------------+
| Put a DevID or Platform Certificate | [PLATFORM-DEVID-TPM-2.0] |
| in the TPM: | |
| | [PLATFORM-CERTS] |
| * Install an IAK at the same time so | |
| that Attestation can work out of | |
| the box. | |
| | |
| * Equipment suppliers and owners may | |
| want to implement LDevID as well | |
| as IDevID. | |
| +--------------------------+
| | [IEEE-802-1AR] |
+----------------------------------------+--------------------------+
| Connect the TPM to the TLS stack: | Vendor TLS stack (This |
| | action configures TLS to |
| * Use the DevID in the TPM to | use the DevID as its |
| authenticate TAP connections, | client certificate.) |
| identifying the device. | |
+----------------------------------------+--------------------------+
| Make CoSWID tags for BIOS/Loader/ | [RFC9393] |
| Kernel objects: | |
| | [SWID] |
| * Add reference measurements into | |
| SWID tags. | [NIST-IR-8060] |
| | |
| * Manufacturer should sign the SWID | |
| tags. | |
| | |
| * The TCG RIM-IM [RIM] identifies | |
| further procedures to create | |
| signed RIM documents that provide | |
| the necessary reference | |
| information. | |
+----------------------------------------+--------------------------+
| Package the SWID tags with a vendor | Retrieve tags with |
| software release: | [RFC9393]. |
| | |
| * A tag-generator plugin such as | |
| [SWID-GEN] can be used. | |
| +--------------------------+
| | [PC-CLIENT-RIM] |
+----------------------------------------+--------------------------+
| Use PC Client measurement definitions | [PC-CLIENT-BIOS-TPM-2.0] |
| to define the use of PCRs (although | |
| Windows OS is rare on Networking | |
| Equipment, UEFI BIOS is not). | |
+----------------------------------------+--------------------------+
| Use TAP to retrieve measurements: | [RFC9684] |
| | |
| * Map to YANG. | [CEL] |
| | |
| * Use Canonical Log Format. | |
+----------------------------------------+--------------------------+
| A Verifier (as described in | |
| [RFC9334], Section 3) should request | |
| the attestation and analyze the | |
| result. The Verifier application | |
| might be broken down to several more | |
| components: | |
| | |
| * A Posture Manager Server that | |
| collects reports and stores them | |
| in a database. | |
| | |
| * One or more Analyzers that can | |
| look at the results and figure out | |
| what it means. | |
+----------------------------------------+--------------------------+
Table 2: Component Status π
Acknowledgements π«Ά
the authors want to thank a whole squad of reviewers for their generous help, including William Bellingrath, Mark Baushke, Ned Smith, Henk Birkholz, Tom Laffey, Dave Thaler, Wei Pan, Michael Eckel, Thomas Hardjono, Bill Sulzen, Willard (Monty) Wiseman, Kathleen Moriarty, Nancy Cam-Winget, and Shwetha Bhandari πβ¨
Authors' Addresses π
Guy C. Fedorkow (editor)
Juniper Networks, Inc.
10 Technology Park Drive
Westford, Massachusetts 01886
United States of America
Email: gfedorkow@juniper.net
Eric Voit
Cisco Systems
Email: evoit@cisco.com
Jessica Fitzgerald-McKay
National Security Agency
9800 Savage Road
Ft. Meade, Maryland 20755
United States of America
Email: jmfitz2@nsa.gov
π¦ where this page comes from
- ietf: rfc9683 2024-12
- π girlified by claude-haiku-5-5 on : a language model's rewrite of the original, under its terms