Support for Short-Term, Automatically Renewed (STAR) Certificates in the Automated Certificate Management Environment (ACME) Intuit
yaronf.ietf@gmail.com
Telefonica I+D
diego.r.lopez@telefonica.com
Telefonica I+D
oscar.gonzalezdedios@telefonica.com
Telefonica I+D
antonio.pastorperales@telefonica.com
ARM
thomas.fossati@arm.com
Security ACME Working Group OCSP CRL revocation Public key certificates need to be revoked when they are compromised, that is, when the associated private key is exposed to an unauthorized entity. However, the revocation process is often unreliable. An alternative to revocation is issuing a sequence of certificates, each with a short validity period, and terminating the sequence upon compromise. This memo proposes an Automated Certificate Management Environment (ACME) extension to enable the issuance of Short-Term, Automatically Renewed (STAR) X.509 certificates.
Status of This Memo This is an Internet Standards Track document. 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). Further information on Internet Standards is available in 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 .
Copyright Notice Copyright (c) 2020 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 () 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 Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.
Table of Contents
  • .  Introduction
    • .  Name Delegation Use Case
    • .  Terminology
    • .  Conventions Used in This Document
  • .  Protocol Flow
    • .  Bootstrap
    • .  Auto Renewal
    • .  Termination
  • .  Protocol Details
    • .  ACME Extensions
      • .  Extending the Order Resource
      • .  Canceling an Auto-renewal Order
    • .  Capability Discovery
    • .  Fetching the Certificates
    • .  Negotiating an Unauthenticated GET
    • .  Computing notBefore and notAfter of STAR Certificates
      • .  Example
  • .  Operational Considerations
    • .  The Meaning of "Short Term" and the Impact of Skewed Clocks
    • .  Impact on Certificate Transparency (CT) Logs
    • .  HTTP Caching and Dependability
  • .  IANA Considerations
    • .  New Registries
    • .  New Error Types
    • .  New Fields in Order Objects
    • .  Fields in the "auto-renewal" Object within an Order Object
    • .  New Fields in the "meta" Object within a Directory Object
    • .  Fields in the "auto-renewal" Object within a Directory Metadata Object
    • .  Cert-Not-Before and Cert-Not-After HTTP Headers
  • .  Security Considerations
    • .  No Revocation
    • .  Denial-of-Service Considerations
    • .  Privacy Considerations
  • .  References
    • .  Normative References
    • .  Informative References
  • Acknowledgments
  • Authors' Addresses
Introduction The ACME protocol automates the process of issuing a certificate to a named entity (an Identifier Owner or IdO). Typically, but not always, the identifier is a domain name. If the IdO wishes to obtain a string of short-term certificates originating from the same private key (see about why using short-lived certificates might be preferable to explicit revocation), she must go through the whole ACME protocol each time a new short-term certificate is needed, e.g., every 2-3 days. If done this way, the process would involve frequent interactions between the registration function of the ACME Certification Authority (CA) and the identity provider infrastructure (e.g., DNS, web servers), therefore making the issuance of short-term certificates exceedingly dependent on the reliability of both. This document presents an extension of the ACME protocol that optimizes this process by making short-term certificates first-class objects in the ACME ecosystem. Once the Order for a string of short-term certificates is accepted, the CA is responsible for publishing the next certificate at an agreed upon URL before the previous one expires. The IdO can terminate the automatic renewal before the negotiated deadline if needed, e.g., on key compromise. For a more generic treatment of STAR certificates, readers are referred to .
Name Delegation Use Case The proposed mechanism can be used as a building block of an efficient name-delegation protocol, for example, one that exists between a Content Distribution Network (CDN) or a cloud provider and its customers . At any time, the service customer (i.e., the IdO) can terminate the delegation by simply instructing the CA to stop the automatic renewal and letting the currently active certificate expire shortly thereafter. Note that in the name delegation use case, the delegated entity needs to access the auto-renewed certificate without being in possession of the ACME account key that was used for initiating the STAR issuance. This leads to the optional use of unauthenticated GET in this protocol ().
Terminology
IdO
Identifier Owner, the owner of an identifier, e.g., a domain name, a telephone number, etc.
STAR
Short-Term, Automatically Renewed X.509 certificates.
Conventions Used in This Document 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 when, and only when, they appear in all capitals, as shown here.
Protocol Flow The following subsections describe the three main phases of the protocol:
  • Bootstrap: the IdO asks an ACME CA to create a short-term, automatically renewed (STAR) certificate ();
  • Auto-renewal: the ACME CA periodically reissues the short-term certificate and posts it to the star-certificate URL ();
  • Termination: the IdO requests the ACME CA to discontinue the automatic renewal of the certificate ().
Bootstrap The IdO, in its role as an ACME client, requests the CA to issue a STAR certificate, i.e., one that:
  • Has a short validity, e.g., 24 to 72 hours. Note that the exact definition of "short" depends on the use case;
  • Is automatically renewed by the CA for a certain period of time;
  • Is downloadable from a (highly available) location.
Other than that, the ACME protocol flows as usual between IdO and CA. In particular, IdO is responsible for satisfying the requested ACME challenges until the CA is willing to issue the requested certificate. Per normal ACME processing, the IdO is given back an Order resource associated with the STAR certificate to be used in subsequent interaction with the CA (e.g., if the certificate needs to be terminated.) The bootstrap phase ends when the ACME CA updates the Order resource to include the URL for the issued STAR certificate.
Auto Renewal The CA issues the initial certificate after the authorization completes successfully. It then automatically reissues the certificate using the same Certificate Signing Request (CSR) (and therefore the same identifier and public key) before the previous one expires and publishes it to the URL that was returned to the IdO at the end of the bootstrap phase. The certificate user, which could be either the IdO itself or a delegated third party as described in , obtains the certificate () and uses it. The auto-renewal process () goes on until either:
  • IdO explicitly terminates the automatic renewal (); or
  • Automatic renewal expires.
Auto-renewal Certificate ACME/STAR User Server | Retrieve cert | [...] |---------------------->| | | +------. / | | | / | | Automatic renewal : | | | \ | |<-----' \ | Retrieve cert | | |---------------------->| short validity period | | | | +------. / | | | / | | Automatic renewal : | | | \ | |<-----' \ | Retrieve cert | | |---------------------->| short validity period | | | | +------. / | | | / | | Automatic renewal : | | | \ | |<-----' \ | | | | [...] | [...]
Termination The IdO may request early termination of the STAR certificate by sending a cancellation request to the Order resource as described in . After the CA receives and verifies the request, it shall:
  • Cancel the automatic renewal process for the STAR certificate;
  • Change the certificate publication resource to return an error indicating the termination of the issuance;
  • Change the status of the Order to "canceled".
Note that it is not necessary to explicitly revoke the short-term certificate.
Termination Certificate ACME/STAR User IdO Server | | | | | Cancel Order | | +---------------------->| | | +-------. | | | | | | | End auto-renewal | | | Remove cert link | | | etc. | | | | | | Done |<------' | |<----------------------+ | | | | | | Retrieve cert | +---------------------------------------------->| | Error: autoRenewalCanceled | |<----------------------------------------------+ | |
Protocol Details This section describes the protocol details, namely the extensions to the ACME protocol required to issue STAR certificates.
ACME Extensions This protocol extends the ACME protocol to allow for automatically renewed Orders.
Extending the Order Resource The Order resource is extended with a new "auto-renewal" object that MUST be present for STAR certificates. The "auto-renewal" object has the following structure:
  • start-date (optional, string): The earliest date of validity of the first certificate issued, in format. When omitted, the start date is as soon as authorization is complete.
  • end-date (required, string): The latest date of validity of the last certificate issued, in format.
  • lifetime (required, integer): The maximum validity period of each STAR certificate, an integer that denotes a number of seconds. This is a nominal value that does not include any extra validity time due to server or client adjustment (see below).
  • lifetime-adjust (optional, integer): The amount of "left pad" added to each STAR certificate, an integer that denotes a number of seconds. The default is 0. If present, the value of the notBefore field that would otherwise appear in the STAR certificates is pre-dated by the specified number of seconds. See for why a client might want to use this control, and for how the effective certificate lifetime is computed. The value reflected by the server, together with the value of the lifetime attribute, can be used by the client as a hint to configure its polling timer.
  • allow-certificate-get (optional, boolean): See .
These attributes are included in a POST message when creating the Order as part of the object encoded as "payload". They are returned when the Order has been created. The ACME server MAY adjust them at will according to its local policy (see also ). The optional notBefore and notAfter fields defined in MUST NOT be present in a STAR Order. If they are included, the server MUST return an error with status code 400 (Bad Request) and type "malformedRequest". defines the following values for the Order resource's status: "pending", "ready", "processing", "valid", and "invalid". In the case of auto-renewal Orders, the status MUST be "valid" as long as STAR certificates are being issued. This document adds a new status value: "canceled" (see ). A STAR certificate is by definition a dynamic resource, i.e., it refers to an entity that varies over time. Instead of overloading the semantics of the "certificate" attribute, this document defines a new attribute, "star-certificate", to be used instead of "certificate".
  • star-certificate (optional, string): A URL for the (rolling) STAR certificate that has been issued in response to this Order.
Canceling an Auto-renewal Order An important property of the auto-renewal Order is that it can be canceled by the IdO with no need for certificate revocation. To cancel the Order, the ACME client sends a POST to the Order URL as shown in .
Canceling an Auto-renewal Order POST /acme/order/ogfr8EcolOT HTTP/1.1 Host: example.com Content-Type: application/jose+json { "protected": base64url({ "alg": "ES256", "kid": "https://example.com/acme/acct/gw06UNhKfOve", "nonce": "Alc00Ap6Rt7GMkEl3L1JX5", "url": "https://example.com/acme/order/ogfr8EcolOT" }), "payload": base64url({ "status": "canceled" }), "signature": "g454e3hdBlkT4AEw...nKePnUyZTjGtXZ6H" }
After a successful cancellation, the server MUST NOT issue any additional certificates for this Order. When the Order is canceled, the server:
  • MUST update the status of the Order resource to "canceled" and MUST set an appropriate "expires" date;
  • MUST respond with 403 (Forbidden) to any requests to the star-certificate endpoint. The response SHOULD provide additional information using a problem document with type "urn:ietf:params:acme:error:autoRenewalCanceled".
Issuing a cancellation for an Order that is not in "valid" state is not allowed. A client MUST NOT send such a request, and a server MUST return an error response with status code 400 (Bad Request) and type "urn:ietf:params:acme:error:autoRenewalCancellationInvalid". The state machine described in is extended as illustrated in .
State Transitions for STAR Order Objects pending --------------+ | | | All authz | | "valid" | V | ready ---------------+ | | | Receive | | finalize | | request | V | processing ------------+ | | | First | | certificate | Error or | issued | Authorization failure | | | V | invalid V valid----------------+ | | | STAR | | Certificate | Natural | canceled | Expiration V | canceled ='=
Explicit certificate revocation using the revokeCert interface () is not supported for STAR certificates. A server receiving a revocation request for a STAR certificate MUST return an error response with status code 403 (Forbidden) and type "urn:ietf:params:acme:error:autoRenewalRevocationNotSupported".
Capability Discovery In order to support the discovery of STAR capabilities, the "meta" field inside the directory object defined in is extended with a new "auto-renewal" object. The "auto-renewal" object MUST be present if the server supports STAR. Its structure is as follows:
  • min-lifetime (required, integer): Minimum acceptable value for auto-renewal lifetime, in seconds.
  • max-duration (required, integer): Maximum allowed delta between the end-date and start-date attributes of the Order's auto-renewal object.
  • allow-certificate-get (optional, boolean): See .
An example directory object advertising STAR support with one-day min-lifetime and one-year max-duration and supporting certificate fetching with an HTTP GET is shown in .
Directory Object with STAR Support { "new-nonce": "https://example.com/acme/new-nonce", "new-account": "https://example.com/acme/new-account", "new-order": "https://example.com/acme/new-order", "new-authz": "https://example.com/acme/new-authz", "revoke-cert": "https://example.com/acme/revoke-cert", "key-change": "https://example.com/acme/key-change", "meta": { "terms-of-service": "https://example.com/acme/terms/2017-5-30", "website": "https://www.example.com/", "caa-identities": ["example.com"], "auto-renewal": { "min-lifetime": 86400, "max-duration": 31536000, "allow-certificate-get": true } } }
Fetching the Certificates The certificate is fetched from the star-certificate endpoint with POST-as-GET as per unless the client and server have successfully negotiated the "unauthenticated GET" option described in . In such case, the client can simply issue a GET to the star-certificate resource without authenticating itself to the server as illustrated in .
Fetching a STAR Certificate with Unauthenticated GET GET /acme/cert/g7m3ZQeTEqa HTTP/1.1 Host: example.com Accept: application/pem-certificate-chain HTTP/1.1 200 OK Content-Type: application/pem-certificate-chain Link: <https://example.com/acme/some-directory>;rel="index" Cert-Not-Before: Thu, 3 Oct 2019 00:00:00 GMT Cert-Not-After: Thu, 10 Oct 2019 00:00:00 GMT -----BEGIN CERTIFICATE----- [End-entity certificate contents] -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- [Issuer certificate contents] -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- [Other certificate contents] -----END CERTIFICATE-----
The server SHOULD include the "Cert-Not-Before" and "Cert-Not-After" HTTP header fields in the response. When they exist, they MUST be equal to the respective fields inside the end-entity certificate. Their format is "HTTP-date" as defined in . Their purpose is to enable client implementations that do not parse the certificate. The following are further clarifications regarding usage of these header fields as per . All apply to both headers.
  • This header field is a single value, not a list.
  • The header field is used only in responses to GET, HEAD, and POST-as-GET requests, and only for MIME types that denote public key certificates.
  • Header field semantics are independent of context.
  • The header field is not hop-by-hop.
  • Intermediaries MAY insert or delete the value;
  • If an intermediary inserts the value, it MUST ensure that the newly added value matches the corresponding value in the certificate.
  • The header field is not appropriate for a Vary field.
  • The header field is allowed within message trailers.
  • The header field is not appropriate within redirects.
  • The header field does not introduce additional security considerations. It discloses in a simpler form information that is already available inside the certificate.
To improve robustness, the next certificate MUST be made available by the ACME CA at the URL indicated by "star-certificate" halfway through the lifetime of the currently active certificate at the latest. It is worth noting that this has an implication in case of cancellation; in fact, from the time the next certificate is made available, the cancellation is not completely effective until the "next" certificate also expires. To avoid the client accidentally entering a broken state, the notBefore of the "next" certificate MUST be set so that the certificate is already valid when it is published at the "star-certificate" URL. Note that the server might need to increase the auto-renewal lifetime-adjust value to satisfy the latter requirement. For a detailed description of the renewal scheduling logic, see . For further rationale on the need for adjusting the certificate validity, see . The server MUST NOT issue any certificates for this Order with notAfter after the auto-renewal end-date. For expired Orders, the server MUST respond with 403 (Forbidden) to any requests to the star-certificate endpoint. The response SHOULD provide additional information using a problem document with type "urn:ietf:params:acme:error:autoRenewalExpired". Note that the Order resource's state remains "valid", as per the base protocol.
Negotiating an Unauthenticated GET In order to enable the name delegation workflow defined in and to increase the reliability of the STAR ecosystem (see for details), this document defines a mechanism that allows a server to advertise support for accessing star-certificate resources via unauthenticated GET (in addition to POST-as-GET), and a client to enable this service with per-Order granularity. Specifically, a server states its availability to grant unauthenticated access to a client's Order star-certificate by setting the allow-certificate-get attribute to "true" in the auto-renewal object of the meta field inside the directory object:
  • allow-certificate-get (optional, boolean): If this field is present and set to "true", the server allows GET (and HEAD) requests to star-certificate URLs.
A client states its desire to access the issued star-certificate via unauthenticated GET by adding an allow-certificate-get attribute to the auto-renewal object of the payload of its newOrder request and setting it to "true".
  • allow-certificate-get (optional, boolean): If this field is present and set to "true", the client requests the server to allow unauthenticated GET (and HEAD) to the star-certificate associated with this Order.
If the server accepts the request, it MUST reflect the attribute setting in the resulting order object. Note that even when the use of unauthenticated GET has been agreed upon, the server MUST also allow POST-as-GET requests to the star-certificate resource.
Computing notBefore and notAfter of STAR Certificates We define "nominal renewal date" as the point in time when a new short-term certificate for a given STAR Order is due. Its cadence is a multiple of the Order's auto-renewal lifetime that starts with the issuance of the first short-term certificate and is upper-bounded by the Order's auto-renewal end-date ().
Nominal Renewal Date T - STAR Order's auto-renewal lifetime end - STAR Order's auto-renewal end-date nrd[i] - nominal renewal date of the i-th STAR certificate .- T -. .- T -. .- T -. .__. / \ / \ / \ / end -----------o---------o---------o---------o----X-------> t nrd[0] nrd[1] nrd[2] nrd[3]
The rules to determine the notBefore and notAfter values of the i-th STAR certificate are as follows: notAfter = min(nrd[i] + T, end) notBefore = nrd[i] - max(adjust_client, adjust_server) Where "adjust_client" is the minimum value between the auto-renewal lifetime-adjust value ("la"), optionally supplied by the client, and the auto-renewal lifetime of each short-term certificate ("T"); "adjust_server" is the amount of padding added by the ACME server to make sure that all certificates being published are valid at the time of publication. The server padding is a fraction (f) of T (i.e., f * T with .5 <= f < 1; see ): adjust_client = min(T, la) adjust_server = f * T Note that the ACME server MUST NOT set the notBefore of the first STAR certificate to a date prior to the auto-renewal start-date.
Example Given a server that intends to publish the next STAR certificate halfway through the lifetime of the previous one, and a STAR Order with the following attributes: "auto-renewal": { "start-date": "2019-01-10T00:00:00Z", "end-date": "2019-01-20T00:00:00Z", "lifetime": 345600, // 4 days "lifetime-adjust": 259200 // 3 days } The amount of time that needs to be subtracted from each nominal renewal date is 3 days, i.e., max(min(345600, 259200), 345600 * .5). The notBefore and notAfter of each short-term certificate are:
notBefore notAfter
2019-01-10T00:00:00Z 2019-01-14T00:00:00Z
2019-01-11T00:00:00Z 2019-01-18T00:00:00Z
2019-01-15T00:00:00Z 2019-01-20T00:00:00Z
The value of the notBefore is also the time at which the client should expect the new certificate to be available from the star-certificate endpoint.
Operational Considerations
The Meaning of "Short Term" and the Impact of Skewed Clocks "Short Term" is a relative concept; therefore, trying to define a cutoff point that works in all cases would be a useless exercise. In practice, the expected lifetime of a STAR certificate will be counted in minutes, hours, or days, depending on different factors: the underlying requirements for revocation, how much clock synchronization is expected among relying parties and the issuing CA, etc. Nevertheless, this section attempts to provide reasonable suggestions for the Web use case, informed by current operational and research experience. Acer et al.  find that one of the main causes of "HTTPS error" warnings in browsers is misconfigured client clocks. In particular, they observe that roughly 95% of the "severe" clock skews -- the 6.7% of clock-related breakage reports that account for clients that are more than 24 hours behind -- happen to be within 6-7 days. In order to avoid these spurious warnings about a not yet valid server certificate, site owners could use the auto-renewal lifetime-adjust attribute to control the effective lifetime of their Web-facing certificates. The exact number depends on the percentage of the "clock-skewed" population that the site owner expects to protect -- 5 days cover 97.3%, 7 days cover 99.6% -- as well as the nominal auto-renewal lifetime of the STAR Order. Note that exact choice is also likely to depend on the kinds of client that are prevalent for a given site or app -- for example, Android and Mac OS clients are known to behave better than Windows clients. These considerations are clearly out of scope of this document. In terms of security, STAR certificates and certificates with the Online Certificate Status Protocol (OCSP) "must-staple" flag asserted can be considered roughly equivalent if the STAR certificate's and the OCSP response's lifetimes are the same. (Here, "must-staple" refers to a certificate carrying a TLS feature extension with the "status_request" extension identifier .) Given OCSP responses can be cached, on average, for 4 days , it is RECOMMENDED that a STAR certificate that is used on the Web has an "effective" lifetime (excluding any adjustment to account for clock skews) no longer than 4 days.
Impact on Certificate Transparency (CT) Logs Even in the highly unlikely case STAR becomes the only certificate issuance model, discussion with the IETF TRANS Working Group and implementers of Certificate Transparency (CT) logs suggests that existing CT Log server implementations are capable of sustaining the resulting 100-fold increase in ingestion rate. Additionally, such a future higher load could be managed with a variety of techniques (e.g., sharding by modulo of certificate hash, using "smart" load-balancing CT proxies, etc.). With regards to the increase in the log size, current CT log growth is already being managed with schemes like Chrome's Log Policy , which allow Operators to define their log life cycle, as well as allowing the CAs, User Agents, Monitors, and any other interested entities to build in support for that life cycle ahead of time.
HTTP Caching and Dependability When using authenticated POST-as-GET, the HTTPS endpoint from where the STAR certificate is fetched can't be easily replicated by an on-path HTTP cache. Reducing the caching properties of the protocol makes STAR clients increasingly dependent on the ACME server availability. This might be problematic given the relatively high rate of client-server interactions in a STAR ecosystem, especially when multiple endpoints (e.g., a high number of CDN edge nodes) end up requesting the same certificate. Clients and servers should consider using the mechanism described in to mitigate the risk. When using unauthenticated GET to fetch the STAR certificate, the server SHALL use the appropriate cache directives to set the freshness lifetime of the response () such that on-path caches will consider it stale before or at the time its effective lifetime is due to expire.
IANA Considerations
New Registries Per this document, IANA has created the following new registries:
  • ACME Order Auto-Renewal Fields ()
  • ACME Directory Metadata Auto-Renewal Fields ()
These registries are administered under a Specification Required policy .
New Error Types Per this document, IANA has added the following entries to the "ACME Error Types" registry:
Type Description Reference
autoRenewalCanceled The short-term certificate is no longer available because the auto-renewal Order has been explicitly canceled by the IdO RFC 8739
autoRenewalExpired The short-term certificate is no longer available because the auto-renewal Order has expired RFC 8739
autoRenewalCancellationInvalid A request to cancel an auto-renewal Order that is not in state "valid" has been received RFC 8739
autoRenewalRevocationNotSupported A request to revoke an auto-renewal Order has been received RFC 8739
New Fields in Order Objects Per this document, IANA has added the following entries to the "ACME Order Object Fields" registry:
Field Name Field Type Configurable Reference
auto-renewal object true RFC 8739
star-certificate string false RFC 8739
Fields in the "auto-renewal" Object within an Order Object The "ACME Order Auto-Renewal Fields" registry lists field names that are defined for use in the JSON object included in the "auto-renewal" field of an ACME order object. Template:
  • Field name: The string to be used as a field name in the JSON object
  • Field type: The type of value to be provided, e.g., string, boolean, array of string
  • Configurable: Boolean indicating whether the server should accept values provided by the client
  • Reference: Where this field is defined
Initial contents: The fields and descriptions defined in .
Field Name Field Type Configurable Reference
start-date string true RFC 8739
end-date string true RFC 8739
lifetime integer true RFC 8739
lifetime-adjust integer true RFC 8739
allow-certificate-get boolean true RFC 8739
New Fields in the "meta" Object within a Directory Object Per this document, IANA has added the following entry to the "ACME Directory Metadata Fields":
Field Name Field Type Reference
auto-renewal object RFC 8739
Fields in the "auto-renewal" Object within a Directory Metadata Object The "ACME Directory Metadata Auto-Renewal Fields" registry lists field names that are defined for use in the JSON object included in the "auto-renewal" field of an ACME directory "meta" object. Template:
  • Field name: The string to be used as a field name in the JSON object
  • Field type: The type of value to be provided, e.g., string, boolean, array of string
  • Reference: Where this field is defined
Initial contents: The fields and descriptions defined in .
Field Name Field Type Reference
min-lifetime integer RFC 8739
max-duration integer RFC 8739
allow-certificate-get boolean RFC 8739
Cert-Not-Before and Cert-Not-After HTTP Headers The "Message Headers" registry has been updated with the following additional values:
Header Field Name Protocol Status Reference
Cert-Not-Before http standard RFC 8739,
Cert-Not-After http standard RFC 8739,
Security Considerations
No Revocation STAR certificates eliminate an important security feature of PKI, which is the ability to revoke certificates. Revocation allows the administrator to limit the damage done by a rogue node or an adversary who has control of the private key. With STAR certificates, expiration replaces revocation so there is potential for lack of timeliness in the revocation taking effect. To that end, see also the discussion on clock skew in . It should be noted that revocation also has timeliness issues because both Certificate Revocation Lists (CRLs) and OCSP responses have nextUpdate fields that tell relying parties (RPs) how long they should trust this revocation data. These fields are typically set to hours, days, or even weeks in the future. Any revocation that happens before the time in nextUpdate goes unnoticed by the RP. One situation where the lack of explicit revocation could create a security risk to the IdO is when the Order is created with a start-date of some appreciable amount of time in the future. Recall that when authorizations have been fulfilled, the Order moves to the "valid" state and the star-certificate endpoint is populated with the first cert (). So, if an attacker manages to get hold of the private key as well as the first (post-dated) certificate, there is a time window in the future when they will be able to successfully impersonate the IdO. Note that cancellation is pointless in this case. In order to mitigate the described threat, it is RECOMMENDED that IdO place their Orders at a time that is close to the Order's start-date. More discussion of the security of STAR certificates is available in .
Denial-of-Service Considerations STAR adds a new attack vector that increases the threat of denial-of-service attacks, caused by the change to the CA's behavior. Each STAR request amplifies the resource demands upon the CA, where one Order produces not one but potentially dozens or hundreds of certificates, depending on the auto-renewal "lifetime" parameter. An attacker can use this property to aggressively reduce the auto-renewal "lifetime" (e.g., 1 second) jointly with other ACME attack vectors identified in . Other collateral impact is related to the certificate endpoint resource where the client can retrieve the certificates periodically. If this resource is external to the CA (e.g., a hosted web server), the previous attack will be reflected to that resource. Mitigation recommendations from ACME still apply, but some of them need to be adjusted. For example, applying rate limiting to the initial request, due to the nature of the auto-renewal behavior, cannot solve the above problem. The CA server needs complementary mitigation, and specifically, it SHOULD enforce a minimum value on auto-renewal "lifetime". Alternatively, the CA can set a rate limit for internal certificate generation processes. Note that this limit has to take account of already scheduled renewal issuances as well as new incoming requests.
Privacy Considerations In order to avoid correlation of certificates by account, if unauthenticated GET is negotiated (), the recommendation in regarding the choice of URL structure applies, i.e., servers SHOULD choose URLs of certificate resources in a non-guessable way, for example, using capability URLs .
References Normative References Key words for use in RFCs to Indicate Requirement Levels In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements. Date and Time on the Internet: Timestamps This document defines a date and time format for use in Internet protocols that is a profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar. Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content The Hypertext Transfer Protocol (HTTP) is a stateless \%application- level protocol for distributed, collaborative, hypertext information systems. This document defines the semantics of HTTP/1.1 messages, as expressed by request methods, request header fields, response status codes, and response header fields, along with the payload of messages (metadata and body content) and mechanisms for content negotiation. Hypertext Transfer Protocol (HTTP/1.1): Caching The Hypertext Transfer Protocol (HTTP) is a stateless \%application- level protocol for distributed, collaborative, hypertext information systems. This document defines HTTP caches and the associated header fields that control cache behavior or indicate cacheable response messages. Problem Details for HTTP APIs This document defines a "problem detail" as a way to carry machine- readable details of errors in a HTTP response to avoid the need to define new error response formats for HTTP APIs. Guidelines for Writing an IANA Considerations Section in RFCs Many protocols make use of points of extensibility that use constants to identify various protocol parameters. To ensure that the values in these fields do not have conflicting uses and to promote interoperability, their allocations are often coordinated by a central record keeper. For IETF protocols, that role is filled by the Internet Assigned Numbers Authority (IANA). To make assignments in a given registry prudently, guidance describing the conditions under which new values should be assigned, as well as when and how modifications to existing values can be made, is needed. This document defines a framework for the documentation of these guidelines by specification authors, in order to assure that the provided guidance for the IANA Considerations is clear and addresses the various issues that are likely in the operation of a registry. This is the third edition of this document; it obsoletes RFC 5226. Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings. Automatic Certificate Management Environment (ACME) Public Key Infrastructure using X.509 (PKIX) certificates are used for a number of purposes, the most significant of which is the authentication of domain names. Thus, certification authorities (CAs) in the Web PKI are trusted to verify that an applicant for a certificate legitimately represents the domain name(s) in the certificate. As of this writing, this verification is done through a collection of ad hoc mechanisms. This document describes a protocol that a CA and an applicant can use to automate the process of verification and certificate issuance. The protocol also provides facilities for other certificate management functions, such as certificate revocation. Informative References Where the Wild Warnings Are: Root Causes of Chrome HTTPS Certificate Errors Google Google Google Leibniz University Hannover Purdue University International Institute of Information Technology Hyderabad Google Google Google Chromium Certificate Transparency Policy Google Google Transport Layer Security (TLS) Extensions: Extension Definitions This document provides specifications for existing TLS extensions. It is a companion document for RFC 5246, "The Transport Layer Security (TLS) Protocol Version 1.2". The extensions specified are server_name, max_fragment_length, client_certificate_url, trusted_ca_keys, truncated_hmac, and status_request. [STANDARDS-TRACK] X.509v3 Transport Layer Security (TLS) Feature Extension The purpose of the TLS feature extension is to prevent downgrade attacks that are not otherwise prevented by the TLS protocol. In particular, the TLS feature extension may be used to mandate support for revocation checking features in the TLS protocol such as Online Certificate Status Protocol (OCSP) stapling. Informing clients that an OCSP status response will always be stapled permits an immediate failure in the case that the response is not stapled. This in turn prevents a denial-of-service attack that might otherwise be possible. Considerations For Using Short Term Certificates Recently there has been renewed interest in an old idea: Issue certificates with short validity periods and forego revocation processing, reasoning that expiration is a sufficient replacement for revocation as long as that expiration is not too far off. This document covers considerations, both security and operational, for using such Short Term Auto Renewed (STAR) certificates for various scenarios where Using a revocation protocol is considered inappropriate. Work in Progress An ACME Profile for Generating Delegated STAR Certificates This memo proposes a profile of the ACME protocol that allows the owner of an identifier (e.g., a domain name) to delegate to a third party access to a certificate associated with said identifier. A primary use case is that of a CDN (the third party) terminating TLS sessions on behalf of a content provider (the owner of a domain name). The presented mechanism allows the owner of the identifier to retain control over the delegation and revoke it at any time by cancelling the associated STAR certificate renewal with the ACME CA. Another key property of this mechanism is it does not require any modification to the deployed TLS ecosystem. Work in Progress The case for prefetching and prevalidating TLS server certificates Google Carnegie Mellon University Carnegie Mellon University Carnegie Mellon University Stanford University Towards Short-Lived Certificates Stanford University Stanford University Carnegie Mellon University Carnegie Mellon University Stanford University Good Practices for Capability URLs W3C First Public Working Draft Latest version available at <https://www.w3.org/TR/capability-urls/>
Acknowledgments This work is partially supported by the European Commission under Horizon 2020 grant agreement no. 688421 Measurement and Architecture for a Middleboxed Internet (MAMI). This support does not imply endorsement. Thanks to , , , , , , , , , , and for helpful comments and discussions that have shaped this document.
Authors' Addresses Intuit
yaronf.ietf@gmail.com
Telefonica I+D
diego.r.lopez@telefonica.com
Telefonica I+D
oscar.gonzalezdedios@telefonica.com
Telefonica I+D
antonio.pastorperales@telefonica.com
ARM
thomas.fossati@arm.com