| Internet-Draft | Freshness for Evidence in CSRs | November 2026 |
| Tschofenig, et al. | Expires 6 May 2027 | [Page] |
When an end entity includes attestation statements in a Certificate Signing Request (CSR), the freshness of the conveyed Evidence often needs to be established. A common mechanism is a nonce that is obtained from a Relying Party or Verifier and included by the Attester in the Evidence.¶
This document specifies how an end entity requests such an attestation freshness nonce from a Registration Authority or Certification Authority (RA/CA) when using certificate lifecycle management protocols. It defines message formats and protocol bindings for the conveyance of nonce request and response messages in the Certificate Management Protocol (CMP), Enrollment over Secure Transport (EST), and Certificate Management over CMS (CMC), including optional type-specific information needed to produce fresh Evidence for inclusion in a CSR.¶
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 6 May 2027.¶
Copyright (c) 2026 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.¶
[I-D.ietf-lamps-csr-attestation] specifies how Evidence, as defined in the RATS Architecture [RFC9334], can be conveyed in a Certificate Signing Request (CSR) using PKCS#10 [RFC2986] or the Certificate Request Message Format (CRMF) [RFC4211]. The RATS Architecture calls for establishing the freshness of Evidence, see Section 10 of [RFC9334]. A common method for establishing freshness is the use of nonces. Such nonces must be provided by the Relying Party or Verifier and included in the Evidence by the Attester.¶
When the CSR is conveyed using a certificate lifecycle management protocol, such as CMP [RFC9810], EST [RFC7030], or CMC [RFC10002], the end entity can request the required nonce from a Registration Authority or Certification Authority (RA/CA) in a prior message exchange and pass it to the Attester to produce fresh Evidence.¶
This document describes how an end entity can request a nonce from an RA/CA using CMP, EST, and CMC.¶
The following topics are out of scope for this document and either covered in other specifications or are implementation or deployment details:¶
whether a CSR requires one or more nonces,¶
how the end entity forwards the nonce to the Attester,¶
whether the RA/CA or the Verifier generates the nonce and how those entities communicate with each other, and¶
other methods for establishing freshness.¶
In this context, the end entity is a device that contains one or more Attesters, and the RA/CA acts as a Relying Party that communicates with one or more Verifiers.¶
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.¶
This document uses RATS and PKIX terminology as described in Section 3 of [I-D.ietf-lamps-csr-attestation]. It also uses terminology from the applicable certificate lifecycle management protocols: CMP, EST, and CMC.¶
According to [I-D.ietf-lamps-csr-attestation], a CSR can contain multiple
AttestationStatements and multiple certificates for validating those
AttestationStatements. This document describes how an end entity can use CMP,
EST, or CMC to request a nonce from the RA/CA for a specific type of Evidence
to be included in the CSR.¶
The end entity sends a nonce request message with the following fields:¶
len: In this OPTIONAL field, the end entity can specify the desired length of
the requested nonce in bytes as a value between 8 and 64.¶
reqTypeInfo: This OPTIONAL structure groups the type-specific information
for the nonce request. It contains:¶
The RA/CA can return the requested nonce in a nonce response message together with information specific to the generation of the Evidence.¶
The nonce response message has the following fields:¶
nonce: This field MUST contain the nonce if the RA/CA is able and willing to
provide it. If a specific length was requested, the RA/CA SHOULD provide a
nonce of that size. If the RA/CA doesn't need a proof of freshness, the nonce MUST be zero-length.¶
expiry: In this OPTIONAL field, the RA/CA can indicate in seconds, as a
non-negative integer value, how long it expects the nonce to remain acceptable;
the response therefore needs to be conveyed promptly. The field is only a hint
to the end entity about how long the RA/CA (and possibly the Verifier)
anticipate storing state. If this field is absent, no indication about the
expected lifetime of the nonce is provided. An end entity MAY send Evidence
containing this nonce even after the indicated period has elapsed. It is then
up to the RA/CA to decide whether to accept the Evidence.¶
respTypeInfo: This OPTIONAL structure groups the type-specific information
for the nonce response. It contains:¶
This document does not further specify the content of the reqInfo and respInfo
structures; those structures must be defined elsewhere. Each definition must
assign an object identifier and specify the exact content of the corresponding
field. The definition of the reqInfo structure must also specify the type of the expected
respInfo structure. The message structure and the reqInfo or respInfo structures
can use different encodings. For example, an ASN.1 message can contain reqInfo or
respInfo encoded as JSON, if necessary. The reqInfo structure may be used to
provide the required information to the RA/CA to route the nonce request
to the appropriate Verifier when multiple Verifiers are supported. The respInfo
structure may be used to convey Generic Information Elements
(Section 6 of [I-D.ietf-rats-reference-interaction-models]) such as Attesting
Environment IDs and Claim Selection. Appendix A provides an
informative example using a TPM PCR selection.¶
The generic message flow between the end entity and the RA/CA is shown in Figure 1.¶
The nonce request and response messages MUST be transferred within the same PKI management operation context provided by the certificate lifecycle management protocol being used, just as the certification request and response messages are, so that the RA/CA can unambiguously associate the provided nonce with the Evidence in the CSR. This association is required because the RA/CA treats the Evidence carried in the CSR as opaque and therefore cannot rely on inspecting the Evidence to determine which previously issued nonce applies to that CSR.¶
The nonce request and nonce response messages allow the end entity to request
only one nonce and one respInfo structure from the RA/CA. If the end entity
wants to include multiple attestation statements in a CSR, it can use the
Composite Attester model described in Section 3.3 of [RFC9334] and
[I-D.richardson-rats-composite-attesters], i.e., together with a conceptual
message wrapper (CMW) [I-D.ietf-rats-msg-wrap] structure, as described in
Section 4.3 of [I-D.ietf-lamps-csr-attestation]. The Lead Attester
should then pass the nonce, or a value derived from it if the selected
attestation statement type defines a deterministic nonce transformation
(see Section 8), to the sub-Attesters. Based on Figure 2 of
[I-D.richardson-rats-composite-attesters], Figure 2 shows an
example of how a nonce can be distributed among several Attesters in an end
entity. If multiple respInfo structures are required, the reqInfo and respInfo
structures can also use a CMW.¶
The interaction between the end entity and the RA/CA is illustrated in Figure 3.¶
The following sections define the generic data structures for nonce request and nonce response message content. CMP and CMC use ASN.1, while EST uses JSON and CBOR, both defined using CDDL.¶
This section defines nonce request and nonce response message content as ASN.1 types for use in CMP, see Section 4, and CMC, see Section 6. Nonce values conveyed as ASN.1 OCTET STRING values in CMP and CMC are between 8 and 64 bytes in length. A zero-length OCTET STRING indicates that the RA/CA does not require proof of freshness for the upcoming certification request.¶
ATTESTATION-NONCE-REQUEST ::= TYPE-IDENTIFIER
AttestationNonceRequestSet ATTESTATION-NONCE-REQUEST ::= {
... -- None defined in this document --
}
ATTESTATION-NONCE-RESPONSE ::= TYPE-IDENTIFIER
AttestationNonceResponseSet ATTESTATION-NONCE-RESPONSE ::= {
... -- None defined in this document --
}
NonceRequestTypeInfo ::= SEQUENCE {
type ATTESTATION-NONCE-REQUEST.&id(
{AttestationNonceRequestSet}),
-- identifies the nonce-request syntax for the selected
-- attestation statement type
reqInfo ATTESTATION-NONCE-REQUEST.&Type(
{AttestationNonceRequestSet}{@type}) OPTIONAL
-- contains type-specific nonce-request information
}
NonceResponseTypeInfo ::= SEQUENCE {
type ATTESTATION-NONCE-RESPONSE.&id(
{AttestationNonceResponseSet}),
-- identifies the nonce-response syntax for the selected
-- attestation statement type
respInfo ATTESTATION-NONCE-RESPONSE.&Type(
{AttestationNonceResponseSet}{@type}) OPTIONAL
-- contains type-specific nonce-response information
}
NonceRequest ::= SEQUENCE {
len INTEGER (8..64) OPTIONAL,
-- indicates the desired length of the requested nonce
reqTypeInfo NonceRequestTypeInfo OPTIONAL
}
NonceResponse ::= SEQUENCE {
nonce OCTET STRING (SIZE(0 | 8..64)),
-- contains the nonce, preferably of length len
-- a zero-length OCTET STRING indicates that no proof of
-- freshness is required
expiry INTEGER (0..MAX) OPTIONAL,
-- hint indicating how long in seconds the nonce issuer
-- expects the nonce to remain acceptable
respTypeInfo NonceResponseTypeInfo OPTIONAL
}
¶
This section provides a CDDL [RFC8610] definition for the JSON and CBOR nonce request and nonce response message content. The nonce-request rule applies to both JSON and CBOR. The nonce-response-json and nonce-response-cbor rules define the encoding-specific representation of the nonce value. For JSON, the base64url-nonce rule captures the allowed character set and encoded length; the decoded nonce length requirements are specified in Section 5.1.¶
nonce-request = {
? "len": nonce-length,
? "reqTypeInfo": nonce-request-type-info
}
nonce-request-type-info = {
"type": dotted-decimal-oid,
? "reqInfo": any
}
nonce-response-json = {
"nonce": json-nonce,
? "expiry": uint,
? "respTypeInfo": nonce-response-type-info-json
}
nonce-response-type-info-json = {
"type": dotted-decimal-oid,
? "respInfo": any
}
nonce-response-cbor = {
"nonce": cbor-nonce,
? "expiry": uint,
? "respTypeInfo": nonce-response-type-info-cbor
}
nonce-response-type-info-cbor = {
"type": dotted-decimal-oid,
? "respInfo": any
}
nonce-length = 8..64
cbor-nonce = h'' / bstr .size (8..64)
json-nonce = "" / base64url-nonce
base64url-nonce = tstr .regexp "[A-Za-z0-9_-]{11,86}"
dotted-decimal-oid = tstr
¶
The nonce request and nonce response message content is conveyed as ASN.1 content,
see Section 3.1, in a general message (genm) Section 5.3.19 of [RFC9810]
and general response (genp) Section 5.3.20 of [RFC9810], respectively.¶
GenMsg: {id-it TBD1}, NonceRequest
GenRep: {id-it TBD2}, NonceResponse
id-it-nonceRequest OBJECT IDENTIFIER ::= { id-it TBD1 }
NonceRequestValue ::= NonceRequest
id-it-nonceResponse OBJECT IDENTIFIER ::= { id-it TBD2 }
NonceResponseValue ::= NonceResponse
¶
When CMP is transferred over HTTP, the OPTIONAL <operation> path segment
defined in Section 3.4 of [RFC9811] MAY be used for the nonce request message.¶
| Operation | Path segment | Details |
|---|---|---|
| Get Attestation Freshness Nonce over HTTP |
getnonce
|
Section 4 |
When CMP is transferred over CoAP, the OPTIONAL <operation> path segment
defined in Section 2.1 of [RFC9482] MAY be used for the nonce request message.¶
| Operation | Path segment | Details |
|---|---|---|
| Get Attestation Freshness Nonce over CoAP |
nonce
|
Section 4 |
To ensure that the nonce request and response messages are associated with the subsequent request and response messages used to transmit the CSR, the transaction identifier specified in Section 5.1.1 of [RFC9810] MUST be used.¶
In the event of a possible error or if the RA/CA is unable or unwilling to provide the requested nonce, CMP offers several ways to indicate this. Which variant fits depends on the circumstances.¶
The nonce request and nonce response message content is conveyed as JSON [RFC8259]
or CBOR [RFC8949] according to the CDDL definition, see Section 3.2, between end
entity (EST client) and
RA/CA (EST server). A compliant EST server MUST provide an EST endpoint with
the path segment getnonce when EST is transferred over HTTPS and with the path
segment nonce when EST is transferred over secure CoAP.¶
| Operation | Path segment | Details |
|---|---|---|
| Get Attestation Freshness Nonce over HTTP |
getnonce
|
Section 5.1 |
| Get Attestation Freshness Nonce over CoAP |
nonce
|
Section 5.2 |
Depending on whether additional parameters are to be transferred, the end entity
uses either the GET or POST method:¶
The GET method MUST be used if no optional content is to be transferred.¶
The POST method MUST be used if nonce request message content encoded in JSON
or CBOR is to be transferred.¶
If the nonce request and nonce response message content is transferred over HTTPS, the specification in [RFC7030] applies.¶
The JSON nonce request object is formally described by the nonce-request CDDL rule in Section 3.2. The JSON nonce response object is formally described by the nonce-response-json CDDL rule in Section 3.2.¶
The JSON structure has the following members:¶
The OPTIONAL "len" and "expiry" members, if present, MUST be unsigned integers.¶
The "nonce" member MUST either contain a zero-length string or the nonce value between 8 and 64 bytes in length conveyed as a JSON string containing the unpadded base64url encoding, as specified in Section 5 of [RFC4648]. Such encodings are between 11 and 86 characters in length.¶
The OPTIONAL "reqTypeInfo" member (in requests) and "respTypeInfo" member (in responses) are JSON objects that group the type-specific information. Each object contains:¶
If the nonce request message was successful, the EST server MUST respond with an HTTP 200 status code and the nonce response message content MUST be encoded as a JSON object. The HTTP 200 status code MUST also be used if the nonce is a zero-length string.¶
The EST server MUST include a Cache-Control header field [RFC9111] with the "no-store" directive in the nonce response to disable HTTP-level caching.¶
In the event of a possible error, the EST server MUST respond with an HTTP status code 400 (Bad Request) and MUST omit the nonce response message content. If the nonce request message has been made correctly, but the EST server is unable or unwilling to provide the requested nonce, it MUST respond with an HTTP 503 (Service Unavailable).¶
The EST server MAY request HTTP-based client authentication as described in Section 3.2.3 of [RFC7030].¶
The following media types MUST be used as the Content-Type of the POST request
and the response.¶
| Message type (per operation) |
Media type(s) | Reference |
|---|---|---|
| NonceRequest | N/A (for GET) or application/est-attestation-freshness+json (for POST) |
Section 5.1 |
| NonceResponse | application/est-attestation-freshness+json | Section 5.1 |
The following example shows a nonce request and nonce response message exchange without transmitting optional parameters in the request:¶
GET /.well-known/est/getnonce HTTP/1.1
HTTP/1.1 200 OK
Cache-Control: no-store
Content-Type: application/est-attestation-freshness+json
{
"nonce": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
"expiry": 600
}
¶
The following example shows a nonce request and nonce response message exchange:¶
POST /.well-known/est/getnonce HTTP/1.1
Content-Type: application/est-attestation-freshness+json
{
"len": 32
}
HTTP/1.1 200 OK
Cache-Control: no-store
Content-Type: application/est-attestation-freshness+json
{
"nonce": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
"expiry": 600
}
¶
To ensure that the nonce request and response messages are associated with the subsequent request and response messages used to transmit the CSR, the EST server MUST use a session-maintenance mechanism that binds the nonce request and response messages to the subsequent request and response messages used to transmit the CSR. This can be achieved by using the same TLS session or by using an HTTP state mechanism, such as cookies, when EST is transferred over HTTPS. If the EST server cannot associate the CSR with the prior nonce request and response messages, it MUST NOT treat the CSR as associated with the previously provided nonce. In case an end entity wants to request multiple certificates and therefore needs multiple nonces, the end entity MUST request a new nonce only after the previous CSR has been processed. Concurrent, interleaved transactions are not supported.¶
If the nonce request and nonce response message content is transferred via secure CoAP, the specification in [RFC9148] applies.¶
The CBOR nonce request object is formally described by the nonce-request CDDL rule in Section 3.2. The CBOR nonce response object is formally described by the nonce-response-cbor CDDL rule in Section 3.2.¶
The CBOR structure has the following members:¶
All map keys are text strings.¶
The "nonce" member MUST either contain a zero-length byte string or the nonce value between 8 and 64 bytes in length conveyed as a CBOR byte string.¶
The OPTIONAL "reqTypeInfo" member (in requests) and "respTypeInfo" member (in responses) are CBOR maps that group the type-specific information. Each map contains:¶
If the nonce request message was successful, the EST server MUST respond to a GET request with a code 2.05 and to a POST request with code 2.04 and the nonce response message content MUST be encoded as a CBOR map. The code 2.05 or code 2.04 MUST also be used if the nonce is a zero-length byte string.¶
The EST server MUST include a Max-Age Option with the value 0 in the nonce response to disable CoAP-level caching.¶
In the event of a possible error, the EST server MUST respond with a code 4.00 (Bad Request) and MUST omit the nonce response message content. If the nonce request message has been made correctly, but the EST server is unable or unwilling to provide the requested nonce, it MUST respond with a code 5.03 (Service Unavailable).¶
The following media type MUST be used for nonce request and nonce response message content. The corresponding CoAP Content-Format value is used in the CoAP Content-Format and Accept options as specified in [RFC9148].¶
| Message type (per operation) |
Media type | Reference |
|---|---|---|
| NonceRequest NonceResponse |
application/est-attestation-freshness+cbor | Section 5.2 |
To ensure that the nonce request and response messages are associated with the subsequent request and response messages used to transmit the CSR, the EST server MUST use a session-maintenance mechanism that binds the nonce request and response messages to the subsequent request and response messages used to transmit the CSR. CoAP does not define HTTP cookies. This association can be achieved by using the same secure CoAP security association, such as the same DTLS connection, or by using an integrity-protected CoAP mechanism that carries server-generated opaque state, such as the Echo option defined in [RFC9175]. If the EST server cannot associate the CSR with the prior nonce request and response messages, it MUST NOT treat the CSR as associated with the previously provided nonce. In case an end entity wants to request multiple certificates and therefore needs multiple nonces, the end entity MUST request a new nonce only after the previous CSR has been processed. Concurrent, interleaved transactions are not supported.¶
The nonce request and nonce response message content is conveyed as ASN.1, see Section 3.1, as CMC Controls in a Full PKI Request, see Section 6 of [RFC10002]. The received nonce can be used for a CSR to be transferred in a Full PKI Request. A Simple PKI Request cannot be used because it cannot carry the required transaction identifier.¶
To transfer the controls, the content type id-data SHOULD be used.¶
cmc-nonceReq CMC-CONTROL ::=
{ NonceRequest IDENTIFIED BY id-cmc-nonceReq }
id-cmc-nonceReq OBJECT IDENTIFIER ::= { id-cmc TBD4 }
cmc-nonceResp CMC-CONTROL ::=
{ NonceResponse IDENTIFIED BY id-cmc-nonceResp }
id-cmc-nonceResp OBJECT IDENTIFIER ::= { id-cmc TBD5 }
¶
The following example shows the nonce request and nonce response message content:¶
ContentInfo.contentType = id-data
ContentInfo.content
controlSequence
{101, id-cmc-transactionId, 10132985123483401}
{102, id-cmc-senderNonce, 10001}
{103, id-cmc-nonceReq, <NonceRequest>}
ContentInfo.contentType = id-data
ContentInfo.content
controlSequence
{101, id-cmc-transactionId, 10132985123483401}
{102, id-cmc-senderNonce, 10005}
{103, id-cmc-recipientNonce, 10001}
{104, id-cmc-nonceResp, <NonceResponse>}
¶
To ensure that the nonce request and response messages are associated with the subsequent request and response messages used to transmit the CSR, the transaction identifier specified in Section 6.6 of [RFC10002] MUST be used. The same transaction identifier MUST be used for the nonce request and response messages and for the subsequent request and response messages used to transmit the CSR. The senderNonce and recipientNonce controls specified in Section 6.6 of [RFC10002] can be used to pair each CMC request with its corresponding response, but they do not replace the transaction identifier used to associate the nonce exchange with the subsequent CSR exchange.¶
In the event of an error, or if the CMC server is unable or unwilling to provide the requested nonce, the CMC server MAY return status information about the request using either an Extended CMC Status Info Control or a CMC Status Info Control, as defined in Section 6.1 of [RFC10002].¶
IANA is requested to add the following entries to the "CMP Well-Known URI Path Segments" registry [RFC9811]:¶
| Path Segment | Description | Reference |
|---|---|---|
getnonce
|
Get Attestation Freshness Nonce over HTTP | This-RFC |
nonce
|
Get Attestation Freshness Nonce over CoAP | This-RFC |
IANA is requested to register the following object identifier in the "SMI Security for PKIX CMP Information Types" registry (1.3.6.1.5.5.7.4):¶
| Decimal | Description | Reference |
|---|---|---|
| TBD1 | id-it-nonceRequest | This-RFC |
| TBD2 | id-it-nonceResponse | This-RFC |
This document defines a new protocol registry group entitled "Enrollment over Secure
Transport (EST)" (at https://www.iana.org/assignments/est) with a new "EST
Well-Known URI Path Segments" registry for path segments below the
/.well-known/est URI [RFC8615]. The registry contains three columns: Path
Segment, Description, and Reference. New items can be added using the
Specification Required [RFC8126] process.¶
The initial entries of this registry contain the path segments defined by [RFC7030], [RFC9148], and [RFC8295] and two additional path segments defined by this document:¶
| Path Segment | Description | Reference |
|---|---|---|
cacerts
|
Distribution of CA Certificates over HTTP | [RFC7030] |
simpleenroll
|
Enrollment of Clients over HTTP | [RFC7030] |
simplereenroll
|
Re-enrollment of Clients over HTTP | [RFC7030] |
fullcmc
|
Full CMC over HTTP | [RFC7030] |
serverkeygen
|
Server-Side Key Generation over HTTP | [RFC7030] [RFC8295] |
serverkeygen/return
|
Server-Side Key Generation Receipts & Errors over HTTP | [RFC8295] |
csrattrs
|
CSR Attributes over HTTP | [RFC7030] |
pal
|
Package Availability List over HTTP | [RFC8295] |
eecerts
|
Distribution of End-Entity Certificates over HTTP | [RFC8295] |
crls
|
Distribution of CRLs over HTTP | [RFC8295] |
symmetrickeys
|
Distribution of Symmetric Keys over HTTP | [RFC8295] |
symmetrickeys/return
|
Return of Symmetric Keys Receipts & Errors over HTTP | [RFC8295] |
firmware
|
Distribution of Firmware over HTTP | [RFC8295] |
firmware/return
|
Return of Firmware Receipts & Errors over HTTP | [RFC8295] |
tamp
|
Distribution of TAMP Messages over HTTP | [RFC8295] |
tamp/return
|
Return of TAMP Receipts & Errors over HTTP | [RFC8295] |
crts
|
Distribution of CA Certificates over CoAP | [RFC9148] |
sen
|
Enrollment of Clients over CoAP | [RFC9148] |
sren
|
Re-enrollment of Clients over CoAP | [RFC9148] |
skg
|
Server-Side Key Generation (PKCS #7) over CoAP | [RFC9148] |
skc
|
Server-Side Key Generation (application/pkix-cert) over CoAP | [RFC9148] |
att
|
CSR Attributes over CoAP | [RFC9148] |
getnonce
|
Get Attestation Freshness Nonce over HTTP | This-RFC |
nonce
|
Get Attestation Freshness Nonce over CoAP | This-RFC |
IANA is requested to register the following media type in the "Media Types" registry [RFC6838]:¶
application¶
est-attestation-freshness+json¶
N/A¶
N/A¶
binary¶
The same media type is used for EST attestation freshness nonce requests and nonce responses. The protocol context determines whether the JSON payload is a request or response.¶
This RFC.¶
EST implementations using attestation freshness nonces over HTTPS.¶
The syntax and semantics of fragment identifiers are as specified for "application/json". At publication of this specification, no fragment identification syntax is defined for "application/json".¶
Deprecated alias names for this type: N/A¶
Magic number(s): N/A¶
File extension(s): N/A¶
Macintosh file type code(s): N/A¶
IETF LAMPS Working Group (spasm@ietf.org)¶
COMMON¶
N/A¶
IETF LAMPS Working Group¶
IETF¶
IANA is requested to register the following media type in the "Media Types" registry [RFC6838]:¶
application¶
est-attestation-freshness+cbor¶
N/A¶
N/A¶
binary¶
The same media type is used for EST attestation freshness nonce requests and nonce responses. The protocol context determines whether the CBOR payload is a request or response.¶
This RFC.¶
EST implementations using attestation freshness nonces over CoAP.¶
The syntax and semantics of fragment identifiers are as specified for "application/cbor". At publication of this specification, no fragment identification syntax is defined for "application/cbor".¶
Deprecated alias names for this type: N/A¶
Magic number(s): N/A¶
File extension(s): N/A¶
Macintosh file type code(s): N/A¶
IETF LAMPS Working Group (spasm@ietf.org)¶
COMMON¶
N/A¶
IETF LAMPS Working Group¶
IETF¶
IANA is requested to register the following Content-Format in the "CoAP Content-Formats" subregistry within the "CoRE Parameters" registry [RFC7252]. This registration uses the IETF Review or IESG Approval range defined for that registry.¶
| Media Type | ID | Reference |
|---|---|---|
| application/est-attestation-freshness+cbor | TBD3 | This-RFC |
IANA is requested to register the following ASN.1 [X.680] module OID in the "SMI Security for PKIX Module Identifier" registry (1.3.6.1.5.5.7.0). This OID is defined in Appendix B.¶
| Decimal | Description | References |
|---|---|---|
| TBDMOD |
id-mod-att-fresh-req
|
This-RFC |
When the RA/CA is requested to provide a nonce to an end entity, it can generate the nonce locally or obtain it through an interaction with the Verifier. According to the IETF RATS architecture [RFC9334], the Verifier is responsible for validating Evidence about an Attester and generating Attestation Results for use by a Relying Party.¶
A non-empty nonce MUST contain a random byte sequence with at least 64 bits of entropy. The RA/CA MUST ensure that a nonce it generates is unique and MUST NOT reuse it. If the RA/CA obtains a nonce from the Verifier, it MUST ensure that the Verifier uses the same policy for uniqueness and non-reuse properties.¶
The length of the nonce depends on the attestation technology in use, as specific nonce lengths may be required by the end entity. This specification assumes that the RA/CA possesses knowledge, either out-of-band or through the len field in the nonce request message, regarding the required nonce length for the attestation technology. Nonces of incorrect length may cause the attestation to fail.¶
For instance, the PSA attestation token [RFC9783] supports nonce lengths of 32, 48, and 64 bytes. Other attestation technologies employ nonces of similar lengths.¶
The end entity MUST use the received nonce if the attestation technology supports its length. If the selected attestation statement type defines a deterministic nonce transformation for use by a specific Attester or sub-Attester, the end entity MUST apply only that transformation and only for the purpose defined by that specification.¶
If type-specific response information is returned with the nonce, the end entity MUST process that information according to the selected type when invoking the attestation technology. Such information MAY include parameters or metadata needed to apply, identify, or validate a deterministic nonce transformation defined by the attestation statement type.¶
While this specification does not address the semantics of the attestation API
or the underlying software/hardware architecture, the API returns Evidence from
the Attester in a format specific to the attestation technology used and
identified by the AttestationStatement type. The returned Evidence is encapsulated
in the AttestationStatement within the AttestationBundle carried in the CSR, as
defined in [I-D.ietf-lamps-csr-attestation]. The software generating the CSR
treats the attestation statement payload as an opaque blob and does not
interpret its format. It is crucial to note that the nonce is included in the
Evidence, either implicitly or explicitly, and MUST NOT be conveyed in CSR
structures outside of the attestation statement payload.¶
The freshness established by the nonce applies to the Evidence as bound to the nonce used by the attestation technology. This specification does not assign independent freshness semantics to other claims contained in the Evidence. The interpretation of any other claim, including whether it represents current state, historical state, configuration state, or measurement results, is defined by the attestation technology, the appraisal policy, and the Verifier or Relying Party processing rules.¶
Using nonces causes the RA/CA to create state for outstanding freshness challenges. This state increases the attack surface for denial-of-service attacks, for example by causing the RA/CA to allocate memory for many nonce requests that never result in corresponding Evidence. The RA/CA SHOULD reduce this exposure by limiting nonce lifetimes, bounding the number of outstanding nonces, applying rate limits, associating nonce state with an authenticated or otherwise constrained requester where possible, and promptly discarding expired state. The use of a stateless cookie mechanism to reduce this state-management burden is also possible but not further detailed in this specification.¶
This specification details the process of obtaining a nonce via CMP, EST, and CMC. Therefore, the security considerations of these protocols apply. Regarding the use of attestation statements in a CSR, the security considerations outlined in [I-D.ietf-lamps-csr-attestation] are pertinent to this specification.¶
The security properties of remote attestation do not generally depend on the confidentiality of the nonce. However, optional type-specific request or response information conveyed together with the nonce can reveal privacy-sensitive or deployment-sensitive information, such as platform topology, certificate identifiers, or measurement selections.¶
[RFC9334] defines the IETF remote attestation architecture and extensively discusses nonce-based freshness. Specific attestation technology specifications such as [RFC9711] and [RFC9783] offer guidance on replay protection using nonces. This document defers specific recommendations to those specifications.¶
If an attestation technology or Composite Attester profile transforms a received nonce before embedding it in Evidence, that transformation MUST be deterministic and MUST preserve at least the minimum entropy required by the attestation technology. The defining specification MUST ensure that the Verifier has enough information to reconstruct or validate the transformed value. Specifications defining such transformations SHOULD use well-analyzed cryptographic mechanisms for nonce expansion or size adjustment to ensure that the resulting entropy and security properties remain acceptable.¶
If type-specific information is used, the corresponding specification MUST define the syntax and semantics of that information, including any confidentiality requirements. Implementations SHOULD minimize the amount of such information returned by the RA/CA. When confidentiality is required by deployment policy or by the attestation technology specification, implementations MUST protect this information using the message or transport security mechanisms of the enrollment protocol.¶
reqInfo and respInfo
This appendix provides an informative example showing how reqInfo and
respInfo can be used with a TPM 2.0-based attestation procedure such as the
challenge-response exchange described in Section 2.1.1.3.2 of [RFC9684].¶
In this example, the end entity wants to obtain a nonce for use with a TPM 2.0
attestation statement. The end entity first requests a nonce from the
RA/CA. The reqInfo field can carry optional information
from the Attester side that helps the Verifier prepare the TPM 2.0 challenge,
such as which Attestation Key certificates are available.¶
The resulting NonceResponse corresponds to the TPM 2.0 challenge parameters
from [RFC9684], with one exception: the nonce-value from the RFC 9684
challenge is conveyed in this document's top-level nonce field rather than
inside respInfo. The remaining challenge parameters, such as the selected PCR
bank, PCR indices, and the selected Attestation Key certificate, are conveyed
in respInfo.¶
The exact syntax of reqInfo and respInfo is defined by the specification
of the OID in the respective type field. The JSON-like notation below
shows examples only and is used to explain the role of these fields:¶
NonceRequest = {
"len": 32,
"reqTypeInfo": {
"type": "1.2.3.4.5",
"reqInfo": {
"certificate-name": ["aik-1", "aik-2"],
"supported-hash-algo": ["TPM_ALG_SHA256"]
}
}
}
NonceResponse = {
"nonce": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
"expiry": 600,
"respTypeInfo": {
"type": "1.2.3.4.6",
"respInfo": {
"tpm20-pcr-selection": [
{
"tpm20-hash-algo": "TPM_ALG_SHA256",
"pcr-index": [0, 1, 2, 3]
}
],
"certificate-name": "aik-1"
}
}
}
¶
In this example:¶
reqInfo.certificate-name lets the Attester indicate more than one available
Attestation Key certificate when multiple TPM attestation keys are present.¶
respInfo.tpm20-pcr-selection identifies the PCR bank and PCR indices that
the Attester is expected to include in the TPM quote or equivalent Evidence.¶
respInfo.certificate-name identifies which Attestation Key certificate the
Attester is to use when generating the fresh Evidence associated with the
returned nonce.¶
This example is intended only to explain the purpose of reqInfo and
respInfo. It does not define a new reqInfo or respInfo type, a new OID,
or a TPM attestation profile. The TPM quote itself, its signature, and any optional
unsigned PCR values are conveyed later as Evidence and are not part of
respInfo.¶
The following module adheres to ASN.1 specifications [X.680] and [X.690].¶
<CODE BEGINS>
Att-Fresh-Req
{ iso(1) identified-organization(3) dod(6) internet(1)
security(5) mechanisms(5) pkix(7) id-mod(0)
id-mod-att-fresh-req (TBDMOD) }
DEFINITIONS IMPLICIT TAGS ::=
BEGIN
EXPORTS ALL;
IMPORTS
id-it
FROM PKIXCMP-2023
{ iso(1) identified-organization(3) dod(6) internet(1)
security(5) mechanisms(5) pkix(7) id-mod(0)
id-mod-cmp2023-02(116) }
id-cmc, CMC-CONTROL
FROM EnrollmentMessageSyntax-2025
{ iso(1) identified-organization(3) dod(6) internet(1)
security(5) mechanisms(5) pkix(7) id-mod(0)
id-mod-enrollMsgSyntax-2025(124) }
;
-- NonceRequest and NonceResponse types
ATTESTATION-NONCE-REQUEST ::= TYPE-IDENTIFIER
AttestationNonceRequestSet ATTESTATION-NONCE-REQUEST ::= {
... -- None defined in this document --
}
ATTESTATION-NONCE-RESPONSE ::= TYPE-IDENTIFIER
AttestationNonceResponseSet ATTESTATION-NONCE-RESPONSE ::= {
... -- None defined in this document --
}
NonceRequestTypeInfo ::= SEQUENCE {
type ATTESTATION-NONCE-REQUEST.&id(
{AttestationNonceRequestSet}),
-- identifies the nonce-request syntax for the selected
-- attestation statement type
reqInfo ATTESTATION-NONCE-REQUEST.&Type(
{AttestationNonceRequestSet}{@type}) OPTIONAL
-- contains type-specific nonce-request information
}
NonceResponseTypeInfo ::= SEQUENCE {
type ATTESTATION-NONCE-RESPONSE.&id(
{AttestationNonceResponseSet}),
-- identifies the nonce-response syntax for the selected
-- attestation statement type
respInfo ATTESTATION-NONCE-RESPONSE.&Type(
{AttestationNonceResponseSet}{@type}) OPTIONAL
-- contains type-specific nonce-response information
}
NonceRequest ::= SEQUENCE {
len INTEGER (8..64) OPTIONAL,
-- indicates the desired length of the requested nonce
reqTypeInfo NonceRequestTypeInfo OPTIONAL
}
NonceResponse ::= SEQUENCE {
nonce OCTET STRING (SIZE(0 | 8..64)),
-- contains the nonce, preferably of length len
-- a zero-length OCTET STRING indicates that no proof of
-- freshness is required
expiry INTEGER (0..MAX) OPTIONAL,
-- hint indicating how long in seconds the nonce issuer
-- expects the nonce to remain acceptable
respTypeInfo NonceResponseTypeInfo OPTIONAL
}
id-it-nonceRequest OBJECT IDENTIFIER ::= { id-it TBD1 }
NonceRequestValue ::= NonceRequest
id-it-nonceResponse OBJECT IDENTIFIER ::= { id-it TBD2 }
NonceResponseValue ::= NonceResponse
cmc-nonceReq CMC-CONTROL ::=
{ NonceRequest IDENTIFIED BY id-cmc-nonceReq }
id-cmc-nonceReq OBJECT IDENTIFIER ::= { id-cmc TBD4 }
cmc-nonceResp CMC-CONTROL ::=
{ NonceResponse IDENTIFIED BY id-cmc-nonceResp }
id-cmc-nonceResp OBJECT IDENTIFIER ::= { id-cmc TBD5 }
END
<CODE ENDS>
¶
We would like to thank Russ Housley, Thomas Fossati, Watson Ladd, Ionut Mihalcea, Carl Wallace, and Michael StJohns for their review comments.¶