| Internet-Draft | Applying Generate Random Extensions And | July 2026 |
| Amsüss | Expires 7 January 2027 | [Page] |
This document applies the extensibility mechanism GREASE (Generate Random Extensions And Sustain Extensibility), which was pioneered for TLS, to the ecosystem of Ephemeral Diffie-Hellman Over COSE (EDHOC). It reserves a set of External Authorization Data (EAD) labels and unusable cipher suites that may be included in messages to ensure peers correctly handle unknown values.¶
This note is to be removed before publishing as an RFC.¶
Discussion of this document takes place on the Lightweight Authenticated Key Exchange Working Group mailing list (lake@ietf.org), which is archived at https://mailarchive.ietf.org/arch/browse/lake/.¶
Source for this draft and an issue tracker can be found at https://github.com/lake-wg/grease.¶
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 7 January 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.¶
This document applies the extensibility mechanism GREASE (Generate Random Extensions And Sustain Extensibility), which was pioneered for TLS in [RFC8701], to Ephemeral Diffie-Hellman Over COSE (EDHOC, [RFC9528]) ecosystem.¶
The introduction of [RFC8701] and Section 3.3 of [RFC9170] provide comprehensive motivation for adding such extensions; [I-D.iab-protocol-greasing] provides additional background that influenced this document.¶
The extension points of the EDHOC protocol are cipher suites, methods, EAD (External Authorization Data) items and COSE header parameters. This document utilizes the cipher suite and EAD extension points.¶
Unlike in TLS GREASE [RFC8701], EDHOC is operating on tight bandwidth and message size budget, with some messages just barely fitting within relevant networks' fragmentation limits. Thus, more than with TLS GREASE, it is up to implementations to decide whether in their particular use case they can afford to send additional data.¶
If the selected method is unsupported by the Responder, EDHOC does not conclude successfully. While values could be reserved for these for use as GREASE, these failed attempts would not be verified between the EDHOC participants without maintaining state between attempted EDHOC sessions. Such an addition is considered impractical for constrained devices, and thus out of scope for this document.¶
Recommendations for GREASE in Section 4 of [I-D.iab-protocol-greasing] also include varying other aspects of the protocol, such as varying sequences of elements. EDHOC has little known variability, and intentionally limits choice at times (for example, Section 3.3.2 of [RFC9528] allows only the numeric identifier form where that is possible). Where variation is allowed, e.g., in padding or in the ordering of EAD items, applications are encouraged to exercise it.¶
The extension point of COSE header parameters (identifying other ID_CRED_x types) is beyond the scope of this document, and might be addressed orthogonally in the "COSE Header Parameters" registry.¶
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 registers the following EAD labels for use with GREASE EAD items:¶
160, 41120, 43690, 44975¶
These EAD labels can be used in any EDHOC message for non-critical EAD items (see Section 3.8 of [RFC9528]).¶
The numbers cover the different lengths of encoding available in CBOR for the registry's range (except the 23 precious small values). It is expected that future documents register additional values with the same semantics.¶
A sender of an EDHOC message MAY include an arbitrary number of GREASE EAD items, with any or no ead_value (that is, with or without a byte string of any usable length). Both parties (the Initiator and the Responder) can send GREASE EAD items in any EDHOC message, without any need for coordination.¶
Senders SHOULD consider the properties of the network their messages are sent over, and refrain from adding GREASE when its use would be detrimental to the network (for example, they might use it less frequently when the added size causes fragmentation of the message).¶
On networks where the data added by the grease EAD items does not significantly impact the network, senders SHOULD irregularly send arbitrary (possibly random) GREASE EAD items with their messages to ensure that errors resulting from the use of GREASE are detected.¶
The GREASE EAD items MAY be used as an alternative form of padding.¶
A method of applying GREASE is suggested as follows:¶
For every message, use GREASE with a random probability of 1 in 64.¶
Pick a random GREASE label out of the uniform distribution of available options.¶
Pick a random length from the uniformly distributed interval 9 to 40 (inclusive).¶
Add the selected GREASE label with a value of the selected length, filled with random bytes.¶
Running EDHOC already requires the presence of a cryptographically secure random number generator. Implementers can use that same source here to avoid any privacy implications from insufficiently initialized faster sources of randomness.¶
A party receiving a GREASE EAD item MUST NOT alter its behavior in any way that would allow random GREASE EAD items to alter the security context that gets established.¶
It MAY alter its behavior in other ways; in particular, it SHOULD randomly insert GREASE EAD items in later messages of a session in which unprocessed EAD items (including GREASE EAD items) were present.¶
Implementations SHOULD NOT attempt to recognize GREASE EAD items, and SHOULD apply the default processing rules.¶
This document registers the following GREASE cipher suites:¶
160, 41120, -41121, 43690¶
The numbers cover the different lengths of encoding available in CBOR for the registry's range (except the 46 precious small values), and both available signs. It is expected that future documents register additional values with the same semantics.¶
An Initiator may insert a GREASE cipher suite at any position in its sequence of preferred cipher suites.¶
A Responder MUST NOT support any of these GREASE cipher suites, and MUST treat them like any other cipher suite it does not support.¶
Thus, a GREASE cipher suite never occurs as the selected cipher suite, i.e., it is never specified as the last cipher suite in EDHOC message_1. An Initiator whose offer of a GREASE cipher suite is accepted through cipher suite negotiation (Section 6.3 of [RFC9528]) needs to discontinue the protocol.¶
The way in which GREASE is applied can contribute to identifying which implementation of EDHOC is being used. Implementers of EDHOC are encouraged to use the algorithm described in Section 2.1.1, both to reduce the likelihood of their implementation to be identified through the use of GREASE and to increase the anonymity set of other users of the same algorithm.¶
The use of GREASE has no impact on security in a correct EDHOC implementation.¶
As the application of GREASE contributes to an ecosystem that can have security updates deployed in the future, implementers of EDHOC are strongly encouraged to apply GREASE regularly whenever their operational constraints permit it.¶
IANA is requested to register four new entries into the EDHOC External Authorization Data Registry established in [RFC9528]:¶
160, 41120, 43690, 44975¶
All share the name "GREASE", the description "Arbitrary data to ensure extensibility", and this document as a reference.¶
IANA is requested to register four new values into the EDHOC Cipher Suites Registry established in [RFC9528]:¶
160, 41120, -41121, 43690¶
All share the array N/A, the description "Unimplementable GREASE cipher suite to ensure extensibility", and this document as a reference.¶
Some ways of using the extension points, in particular the use of critical GREASE EAD items and placing a GREASE cipher suite in the selected position do not result in the successful continuation of the EDHOC session.¶
They can be useful during testing (e.g., to verify that a peer does indeed implement the correct behavior of not silently tolerating critical EAD items it can not process), particularly when they allow a testing system to provoke an error response from the implementation under test. However, this document is concerned with test performed during successful operation, therefore that application is out of scope.¶
Since draft-ietf-lake-edhoc-grease-01: Address a WGLC comment that was missed.¶
Using EADs by sender: Point out that both parties are senders and can grease any message.¶
Since draft-ietf-lake-edhoc-grease-01: Address WGLC comments.¶
seccons: Strongly encourage use of GREASE¶
Explicit SHOULD on applying default processing rules (not just by exclusion of SHOULD NOT attempt)¶
Point to EDHOC CS-RNG for fingerprint resistance¶
Point to CORECONF as example of how to report¶
Add remark on why numeric values were chosen¶
Elaboration on cipher suite selection¶
Added BCP14 boilerplate Terminology section¶
Updated reference from edm-protocol-greasing-02 to iab-protocol-greasing (currently at -01)¶
Editorial fixes; highlights:¶
Since draft-ietf-lake-edhoc-grease-00: Resolve all open issues.¶
Question on "is this better than padding" removed. (There are currently implementations of EDHOC that can't use all EAD values but can do padding).¶
Question of COSE header extension deferred to COSE maintenance.¶
Use of GREASE values in critical form is out of scope, but appendix illustrates that it can make sense to do, and emphasizes that indeed those options do cause errors when used with negative sign.¶
Since draft-amsuess-lake-edhoc-grease-01:¶
Document was adopted in LAKE.¶
Instead of discouraging GREASE around fragmentation limits wholesale, suggest reduced frequency.¶
Editorial fix to fingerprinting section.¶
Since draft-amsuess-lake-edhoc-grease-00:¶
Expanded introduction section to just point to the abstract any more.¶
Since draft-amsuess-core-edhoc-grease-01:¶
Update references to RFC9528 🎉¶
Change target WG to LAKE, renaming to draft-amsuess-lake-edhoc-grease¶
Process RFC9170¶
Process draft-edm-protocol-greasing-02¶
Since -00:¶
Marco Tiloca pointed out a critical error in the numeric constructions, and provided many general improvements. Göran Selander provided input to reduce mistakable text. Meiling Chen and Shujaatali Badami found places where the text did not provide the right guidance to readers.¶