Internet-Draft | Application Layer Attestation | May 2025 |
Fossati, et al. | Expires 21 November 2025 | [Page] |
This specification defines a method for two parties in a communication interaction to exchange Evidence and Attestation Results using exported authenticators, as defined in RFC 9261. Additionally, it introduces the cmw_attestation
extension, which allows attestation credentials to be included directly in the Certificate message sent during the Exported Authenticator-based post-handshake authentication. The approach supports both the passport and background check models from the RATS architecture while ensuring that attestation remains bound to the underlying communication channel.¶
This note is to be removed before publishing as an RFC.¶
The latest revision of this draft can be found at https://hannestschofenig.github.io/exported-attestation/draft-fossati-tls-exported-attestation.html. Status information for this document may be found at https://datatracker.ietf.org/doc/draft-fossati-tls-exported-attestation/.¶
Discussion of this document takes place on the tls Working Group mailing list (mailto:tls@ietf.org), which is archived at https://datatracker.ietf.org/wg/tls/about/. Subscribe at https://www.ietf.org/mailman/listinfo/tls/.¶
Source for this draft and an issue tracker can be found at https://github.com/tls-attestation/exported-attestation.¶
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."¶
This Internet-Draft will expire on 21 November 2025.¶
Copyright (c) 2025 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.¶
There is a growing need to demonstrate to a remote party that cryptographic keys are stored in a secure element, the device is in a known good state, secure boot has been enabled, and that low-level software and firmware have not been tampered with. Remote attestation provides this capability.¶
More technically, an Attester produces a signed collection of Claims that constitute Evidence about its running environment(s). A Relying Party may consult an Attestation Result produced by a Verifier that has appraised the Evidence to make policy decisions regarding the trustworthiness of the Target Environment being assessed. This is, in essence, what RFC 9334 [RFC9334] defines.¶
At the time of writing, several standard and proprietary remote attestation technologies are in use. This specification aims to remain as technology-agnostic as possible concerning implemented remote attestation technologies. To streamline attestation in TLS, this document introduces the cmw_attestation extension, which allows attestation credentials to be conveyed directly in the Certificate message during the Exported Authenticator-based post-handshake authentication. This eliminates reliance on real-time certificate issuance from a Certificate Authority (CA), reducing handshake delays while ensuring attestation evidence remains bound to the TLS session. The extension supports both the passport and background check models from the RATS architecture, enhancing flexibility for different deployment scenarios.¶
This document builds upon three foundational specifications:¶
RATS (Remote Attestation Procedures) Architecture [RFC9334]: RFC 9334 defines how remote attestation systems establish trust between parties by exchanging Evidence and Attestation Results. These interactions can follow different models, such as the passport or the background check model, depending on the order of data flow in the system.¶
TLS Exported Authenticators [RFC9261]: RFC 9261 offers bi-directional, post-handshake authentication. Once a TLS connection is established, both peers can send an authenticator request message at any point after the handshake. This message from the server and the client uses the CertificateRequest and the ClientCertificateRequest messages, respectively. The peer receiving the authenticator request message can respond with an Authenticator consisting of Certificate, CertificateVerify, and Finished messages. These messages can then be validated by the other peer.¶
RATS Conceptual Messages Wrapper (CMW) [I-D.ietf-rats-msg-wrap]: CMW provides a structured encapsulation of Evidence and Attestation Result payloads, abstracting the underlying attestation technology.¶
This specification introduces the cmw_attestation extension, enabling attestation evidence to be included directly in the Certificate message during the Exported Authenticator-based post-handshake authentication defined in [RFC9261]. This approach enhances flexibility and efficiency, supporting key attestation mechanisms without being restricted to X.509 certificate encoding formats.¶
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.¶
The reader is assumed to be familiar with the vocabulary and concepts defined in RFC 9334 and RFC 9261.¶
"Remote attestation credentials", or "attestation credentials", is used to refer to both attestation evidence and attestation results, when no distinction needs to be made between them.¶
It introduces a new TLS extension, cmw_attestation, which enables the inclusion of either Attestation Evidence or Attestation Results in the extensions field associated with the end-entity certificate in the TLS Certificate message.¶
As defined in Section 4.4.2 of [RFC8446], the TLS Certificate message consists of a certificate_list, which is a sequence of CertificateEntry structures. Each CertificateEntry contains a certificate and a set of associated extensions. The cmw_attestation extension MUST appear only in the first CertificateEntry of the Certificate message and applies exclusively to the end-entity certificate. It MUST NOT be included in entries corresponding to intermediate or trust anchor certificates. This design ensures that attestation information is tightly bound to the entity being authenticated.¶
The cmw_attestation
extension is defined to be included only in the Certificate message during the Exported Authenticator-based post-handshake authentication. This ensures that attestation credentials is conveyed within the Certificate message without requiring modifications to the X.509 certificate structure.¶
cmw_data: Encapsulates the attestation credentials in a format compatible with CMW. The cmw_data field MUST be encoded using CBOR or JSON (as per [I-D.ietf-rats-msg-wrap]).¶
This approach eliminates the need for real-time certificate issuance from a Certificate Authority (CA) and minimizes handshake delays. Typically, CAs require several seconds to minutes to issue a certificate due to verification steps such as validating subject identity, signing the certificate, and distributing it. These delays introduce latency into the TLS handshake, making real-time certificate generation impractical. The cmw_attestation extension circumvents this issue by embedding attestation data within the Certificate message itself, removing reliance on external certificate issuance processes.¶
Clients and servers use the TLS flags extension defined in [I-D.ietf-tls-tlsflags] to indicate support for the functionality defined in this document. We refer to the previously defined "cmw_attestation" extension, and the corresponding flag is called the "CMW_Attestation" flag.¶
The "CMW_Attestation" flag proposed by the client in the ClientHello MUST be acknowledged in the EncryptedExtensions if the server also supports the functionality defined in this document and is configured to use it.¶
If the "CMW_Attestation" flag is not set, servers ignore any of the functionality specified in this document, and attestation credentials cannot be conveyed using "Exported TLS Authenticators".¶
The cmw_attestation
extension is designed to be used exclusively in post-handshake authentication as defined in [RFC9261]. It allows attestation credentials to be transmitted in the authenticator (Certificate) message only in response to an authenticator request. This ensures that attestation credentials are provided on demand rather than being included in the initial TLS handshake.¶
To maintain a cryptographic binding between the attestation evidence and the authentication request, the cmw_attestation
extension MUST be associated with the certificate_request_context of the corresponding CertificateRequest or ClientCertificateRequest message. This binding ensures that:¶
The cmw_attestation
extension does not modify or replace X.509 certificate validation mechanisms. It serves as an additional source of authentication data rather than altering the trust model of PKI-based authentication. Specifically:¶
Certificate validation (e.g., signature verification, revocation checks) MUST still be performed according to TLS [RFC8446] and PKIX [RFC5280].¶
The attestation credentials carried in cmw_attestation
MUST NOT be used as a substitute for X.509 certificate validation but can be used alongside standard certificate validation for additional security assurances.¶
Implementations MAY reject connections where the certificate is valid but the attestation credentials is missing or does not meet security policy.¶
The cmw_attestation
extension is applicable to both client and server authentication in Exported Authenticator-based post-handshake authentication.¶
In TLS, one party acts as the relying party, and the other party acts as the attester. Either the client or the server may fulfill these roles depending on the authentication direction.¶
The attester may respond with either:¶
Attestation Evidence (Background Check Model):¶
The attester generates Evidence and includes it in the cmw_attestation
extension.¶
The relying party forwards the Evidence to an external Verifier for evaluation and waits for an Attestation Result.¶
The relying party grants or denies access, or continues or terminates the TLS session, based on the Verifier's Attestation Result.¶
Attestation Result (Passport Model):¶
The attester sends Evidence to a Verifier beforehand.¶
The Verifier issues an Attestation Result to the attester.¶
The attester includes the Attestation Result in the cmw_attestation
extension and sends it to the relying party.¶
The relying party validates the Attestation Result directly without needing to contact an external Verifier.¶
By allowing both Evidence and Attestation Results to be conveyed within cmw_attestation
, this mechanism supports flexible attestation workflows depending on the chosen trust model.¶
The cmw_attestation
extension enables attestation credentials to be included in the Certificate message during Exported Authenticator-based post-handshake authentication, ensuring that attestation remains bound to the TLS session.¶
However, applications using this mechanism still need to negotiate the encoding format (e.g., JOSE or COSE) and specify how attestation credentials are processed. This negotiation can be done via application-layer signaling or predefined profiles. Future specifications may define mechanisms to streamline this negotiation.¶
Upon receipt of a Certificate message containing the cmw_attestation
extension, an endpoint MUST take the following steps to validate the attestation credentials:¶
Background Check Model:¶
Verify Integrity and Authenticity: The attestation evidence must be cryptographically verified against a known trust anchor, typically provided by the hardware manufacturer.¶
Ensure Certificate Binding and Freshness: The attestation evidence must be explicitly associated with the certificate_request_context
in the authenticator request to ensure relevance, freshness, and protection against replay.¶
Evaluate Security Policy Compliance: The attestation evidence must be evaluated against the relying party's security policies to determine if the attesting device and the private key storage meet the required criteria.¶
Passport Model:¶
Verify the Attestation Result: The relying party MUST check that the Attestation Result is correctly signed by the issuing authority and that it meets the relying party’s security requirements.¶
By integrating cmw_attestation
directly into the Certificate message during Exported Authenticator-based post-handshake authentication, this approach reduces latency and complexity while maintaining strong security guarantees.¶
In the following examples, the server possesses an identity certificate, while the client is not authenticated during the initial TLS exchange.¶
Figure 1 shows the passport model while Figure 2 illustrates the background-check model.¶
Figure 2 shows an example using the background-check model.¶
To enable attestation workflows, implementations of the Exported Authenticator API MUST support the following:¶
Authenticator Generation¶
The API MUST support the inclusion of attestation credentials within the Certificate message provided as input.¶
Context Retrieval¶
The certificate_request_context MUST be provided in all cases to ensure proper validation of attestation evidence.¶
The receiving endpoint MUST use the "get context" API to retrieve the certificate_request_context
associated with the exported authenticator as attestation-based authentication requires strict enforcement of the request context. This ensures that the freshness of attestation evidence can be verified.¶
Authenticator Validation¶
The API MUST verify that the attestation evidence within the Certificate message is cryptographically valid and bound to the certificate_request_context.¶
This document inherits the security considerations of RFC 9261 and RFC 9334. The integrity of the exported authenticators must be guaranteed, and any failure in validating Evidence SHOULD be treated as a fatal error in the communication channel. Additionally, in order to benefit from remote attestation, Evidence MUST be protected using dedicated attestation keys chaining back to a trust anchor. This trust anchor will typically be provided by the hardware manufacturer.¶
This specification assumes that the Hardware Security Module (HSM) or Trusted Execution Environment (TEE) is responsible for generating the key pair and producing either attestation evidence or attestation results, which is included in the Certificate Signing Request (CSR) as defined in [I-D.ietf-lamps-csr-attestation]. This attestation enables the CA to verify that the private key is securely stored and that the platform meets the required security standards before issuing a certificate.¶
Remote attestation in this document occurs within the context of a TLS handshake, and the TLS connection remains valid after this process. Care must be taken when handling this TLS connection, as both the client and server must agree that remote attestation was successfully completed before exchanging data with the attested party.¶
Session resumption presents special challenges since it happens at the TLS level, which is not aware of the application-level Authenticator. The application (or the modified TLS library) must ensure that a resumed session has already completed remote attestation before the session can be used normally, and race conditions are possible.¶
The attestation evidence carried in cmw_attestation does not require an additional freshness mechanism, such as a nonce or timestamp, since freshness is inherently provided by the certificate_request_context in the authenticator request.¶
The evidence presented in this protocol is valid only at the time it is generated and presented. To ensure that the attested peer remains in a secure state, remote attestation may be re-initiated periodically. In the current protocol, this can be achieved by initiating a new Exported Authenticator-based post-handshake authentication exchange, which will generate a new certificate_request_context to maintain freshness.¶
This section defines the necessary updates to the IANA "TLS ExtensionType Values" registry to include the newly introduced cmw_attestation
extension.¶
IANA is requested to register the following new extension type in the "TLS ExtensionType Values" registry:¶
Value | Extension Name | TLS 1.3 | DTLS 1.3 | Recommended | Reference |
---|---|---|---|---|---|
TBD | cmw_attestation | Y | Y | Yes | This Document |
IANA is requested to add the following entry to the "TLS Flags" extension registry [TLS-Ext-Registry]:¶
We would like to thank Chris Patton for his proposal to explore RFC 9261 for attested TLS. We would also like to thank Paul Howard and Yogesh Deshpande for their input.¶