Internet-Draft | SUIT Algorithm Recommendations | June 2025 |
Moran, et al. | Expires 11 December 2025 | [Page] |
This document specifies cryptographic algorithm profiles to be used with the Software Updates for Internet of Things (suit) manifest. These profiles define mandatory-to-implement algorithms to ensure interoperability.¶
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 11 December 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.¶
This document defines algorithm profiles for SUIT manifest parsers and authors to promote interoperability in constrained node software update scenarios. These profiles specify sets of mandatory-to-implement (MTI) algorithms tailored to the evolving security landscape, acknowledging that cryptographic requirements may change over time. To accommodate this, algorithms are grouped into profiles, which may be updated or deprecated as needed.¶
This document defines the following MTI profiles for constrained environments:¶
One symmetric MTI profile¶
Two "current" constrained asymmetric MTI profiles¶
Two "current" AEAD asymmetric MTI profiles¶
One "future" constrained asymmetric MTI profile¶
The terms "current" and "future" distinguish between traditional cryptographic algorithms and those believed to be secure against both classical and quantum computer-based attacks, respectively.¶
At least one algorithm in each category must be FIPS-validated.¶
Due to the asymmetric nature of SUIT deployments—where manifest authors are typically resource-rich and recipients are resource-constrained—the cryptographic requirements differ for each role.¶
This specification uses AES-CTR in combination with a digest algorithm, as defined in [RFC9459], to support use cases that require out-of-order block reception and decryption-capabilities not offered by AEAD algorithms. For further discussion of these constrained use cases, see Section 5.2. Other SUIT use cases (see [I-D.ietf-suit-manifest]) may define different profiles.¶
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 abbreviation SUIT stands for Software Updates for the Internet of Things and specifically addresses the requirements of constrained devices and networks, as described in [RFC9019].¶
Each profile consist of algorithms from the following categories:¶
Digest Algorithms¶
Authentication Algorithms¶
Key Exchange Algorithms (optional)¶
Encryption Algorithms (optional)¶
Each profile references specific algorithm identifiers, as defined in [IANA-COSE]. Since these algorithm identifiers are used in the context of the IETF SUIT manifest [I-D.ietf-suit-manifest], they are represented using CBOR Object Signing and Encryption (COSE) structures as defined in [RFC9052] and [RFC9053].¶
The use of the profiles by authors and recipients is based on the following assumptions:¶
Recipients MAY choose which MTI profile they wish to implement. It is RECOMMENDED that they implement the "Future" Asymmetric MTI profile. Recipients MAY implement any number of other profiles not defined in this document. Recipients MAY choose not to implement encryption and the corresponding key exchange algorithms if they do not intend to support encrypted payloads.¶
Authors MUST implement all MTI profiles. Authors MAY implement any number of additional profiles.¶
Algorithm Type | Algorithm | COSE Key |
---|---|---|
Digest | SHA-256 | -16 |
Authentication | HMAC-256 | 5 |
Key Exchange | A128KW Key Wrap | -3 |
Encryption | A128CTR | -65534 |
Algorithm Type | Algorithm | COSE Key |
---|---|---|
Digest | SHA-256 | -16 |
Authentication | ESP256 | -9 |
Key Exchange | ECDH-ES + A128KW | -29 |
Encryption | A128CTR | -65534 |
Algorithm Type | Algorithm | COSE Key |
---|---|---|
Digest | SHA-256 | -16 |
Authentication | Ed25519 | -19 |
Key Exchange | ECDH-ES + A128KW | -29 |
Encryption | A128CTR | -65534 |
Algorithm Type | Algorithm | COSE Key |
---|---|---|
Digest | SHA-256 | -16 |
Authentication | ESP256 | -9 |
Key Exchange | ECDH-ES + A128KW | -29 |
Encryption | A128GCM | 1 |
Algorithm Type | Algorithm | COSE Key |
---|---|---|
Digest | SHA-256 | -16 |
Authentication | Ed25519 | -19 |
Key Exchange | ECDH-ES + A128KW | -29 |
Encryption | ChaCha20/Poly1305 | 24 |
Algorithm Type | Algorithm | COSE Key |
---|---|---|
Digest | SHA-256 | -16 |
Authentication | HSS-LMS | -46 |
Key Exchange | A256KW | -5 |
Encryption | A256CTR | -65532 |
A note regarding the use of HSS-LMS: The decision as to how deep the tree is, is a decision that affects authoring tools only (see [RFC8778]). Verification is not affected by the choice of the "W" parameter, but the size of the signature is affected. To support the long lifetimes required by IoT devices, it is RECOMMENDED to use trees with greater height (see Section 2.2 of [RFC8778]).¶
When using Manifest Recipients Response communication, particularly data structures that are designed for reporting of update capabilities, status, progress, or success, the same profile as the is used on the SUIT manifest SHOULD be used. There are cases where this is not possible, such as suit-sha256-hsslms-a256kw-a256ctr. In this case, the closest equivalent profile SHOULD be used, for example suit-sha256-esp256-ecdh-a128ctr.¶
Payload encryption is often used to protect Intellectual Property (IP) and Personally Identifying Information (PII) in transit. The primary function of payload in SUIT is to act as a defense against passive IP and PII snooping. By encrypting payloads, confidential IP and PII can be protected during distribution. However, payload encryption of firmware or software updates of a commodity device is not a cybersecurity defense against targetted attacks on that device.¶
To define the purpose of payload encryption as a defensive cybersecurity tool, it is important to define the capabilities of modern threat actors. A variety of capabilities are possible:¶
find bugs by binary code inspection¶
send unexpected data to communication interfaces, looking for unexpected behavior¶
use fault injection to bypass or manipulate code¶
use communication attacks or fault injection along with gadgets found in the code¶
Given this range of capabilities, it is important to understand which capabilities are impacted by firmware encryption. Threat actors who find bugs by manual inspection or use gadgets found in the code will need to first extract the code from the target. In the IoT context, it is expected that most threat actors will start with sample devices and physical access to test attacks.¶
Due to these factors, payload encryption serves to limit the pool of attackers to those who have the technical capability to extract code from physical devices and those who perform code-free attacks.¶
AES-CTR mode with a digest is specified, see [RFC9459]. All of the AES-CTR security considerations in [RFC9459] apply. A non-AEAD encryption mode is specified in this specification due to the following mitigating circumstances:¶
Out-of-order decryption must be supported. Therefore, we must use a stream cipher that supports random access.¶
Chosen plaintext attacks are extremely difficult to achieve, since the payloads are typically constructed in a relatively secure environment--the developer's computer or build infrastructure--and should be signed in an air-gapped or similarly protected environment. In short, the plaintext is authenticated prior to encryption.¶
Content Encryption Keys must be used to encrypt only once.¶
See [I-D.ietf-suit-firmware-encryption] for additional background information.¶
As a result of these mitigating circumstances, AES-CTR is an acceptable cipher for typical software/firmware delivery scenarios.¶
IANA is requested to create a page for COSE Algorithm Profiles within the category for Software Update for the Internet of Things (SUIT)¶
IANA is also requested to create a registry for COSE Algorithm Profiles within this page. The initial content of the registry is:¶
Profile | Status | Digest | Auth | Key Exchange | Encryption | Descriptor Array | Reference |
---|---|---|---|---|---|---|---|
suit-sha256-hmac-a128kw-a128ctr | MANDATORY | -16 | 5 | -3 | -65534 | [-16, 5, -3, -65534] | Section 3.1 |
suit-sha256-esp256-ecdh-a128ctr | MANDATORY | -16 | -9 | -29 | -65534 | [-16, -9, -29, -65534] | Section 3.2 |
suit-sha256-ed25519-ecdh-a128ctr | MANDATORY | -16 | -19 | -29 | -65534 | [-16, -19, -29, -65534] | Section 3.3 |
suit-sha256-esp256-ecdh-a128gcm | MANDATORY | -16 | -9 | -29 | 1 | [-16, -9, -29, 1] | Section 3.4 |
suit-sha256-ed25519-ecdh-chacha-poly | MANDATORY | -16 | -19 | -29 | 24 | [-16, -19, -29, 24] | Section 3.5 |
suit-sha256-hsslms-a256kw-a256ctr | MANDATORY | -16 | -46 | -5 | -65532 | [-16, -46, -5, -65532] | Section 3.6 |
New entries to this registry require Standards Action.¶
A recipient device that claims conformance to this document will have implemented at least one of the above algorithms.¶
As time progresses, if entries are removed from mandatory status, they will become SHOULD, MAY and then possibly NOT RECOMMENDED for new implementation. However, as it may be impossible to update the SUIT manifest processor in the field, support for all relevant algorithms will almost always be required by authoring tools.¶
When new algorithms are added by subsequent documents, the device and authoring tools will then claim conformance to those new documents.¶
The following CDDL creates a subset of COSE for use with SUIT. Both tagged and untagged messages are defined. SUIT only uses tagged COSE messages, but untagged messages are also defined for use in protocols that share a ciphersuite with SUIT.¶
To be valid, the following CDDL MUST have the COSE CDDL appended to it. The COSE CDDL can be obtained by following the directions in [RFC9052], Section 1.4.¶
SUIT_COSE_tool_tweak /= suit-sha256-hmac-a128kw-a128ctr SUIT_COSE_tool_tweak /= suit-sha256-esp256-ecdh-a128ctr SUIT_COSE_tool_tweak /= suit-sha256-ed25519-ecdh-a128ctr SUIT_COSE_tool_tweak /= suit-sha256-esp256-ecdh-a128gcm SUIT_COSE_tool_tweak /= suit-sha256-ed25519-ecdh-chacha-poly SUIT_COSE_tool_tweak /= suit-sha256-hsslms-a256kw-a256ctr SUIT_COSE_tool_tweak /= SUIT_COSE_Profiles SUIT_COSE_Profiles /= SUIT_COSE_Profile_HMAC_A128KW_A128CTR SUIT_COSE_Profiles /= SUIT_COSE_Profile_ESP256_ECDH_A128CTR SUIT_COSE_Profiles /= SUIT_COSE_Profile_ED25519_ECDH_A128CTR SUIT_COSE_Profiles /= SUIT_COSE_Profile_ESP256_ECDH_A128GCM SUIT_COSE_Profiles /= SUIT_COSE_Profile_ED25519_ECDH_CHACHA20_POLY1304 SUIT_COSE_Profiles /= SUIT_COSE_Profile_HSSLMS_A256KW_A256CTR suit-sha256-hmac-a128kw-a128ctr = [-16, 5, -3, -65534] suit-sha256-esp256-ecdh-a128ctr = [-16, -9, -29, -65534] suit-sha256-ed25519-ecdh-a128ctr = [-16, -19, -29, -65534] suit-sha256-esp256-ecdh-a128gcm = [-16, -9, -29, 1] suit-sha256-ed25519-ecdh-chacha-poly = [-16, -19, -29, 24] suit-sha256-hsslms-a256kw-a256ctr = [-16, -46, -5, -65532] SUIT_COSE_Profile_HMAC_A128KW_A128CTR = SUIT_COSE_Profile<5,-65534> .and COSE_Messages SUIT_COSE_Profile_ESP256_ECDH_A128CTR = SUIT_COSE_Profile<-9,-65534> .and COSE_Messages SUIT_COSE_Profile_ED25519_ECDH_A128CTR = SUIT_COSE_Profile<-19,-65534> .and COSE_Messages SUIT_COSE_Profile_ESP256_ECDH_A128GCM = SUIT_COSE_Profile<-9,1> .and COSE_Messages SUIT_COSE_Profile_ED25519_ECDH_CHACHA20_POLY1304 = SUIT_COSE_Profile<-19,24> .and COSE_Messages SUIT_COSE_Profile_HSSLMS_A256KW_A256CTR = SUIT_COSE_Profile<-46,-65532> .and COSE_Messages SUIT_COSE_Profile<authid, encid> = SUIT_COSE_Messages<authid,encid> SUIT_COSE_Messages<authid, encid> = SUIT_COSE_Untagged_Message<authid, encid> / SUIT_COSE_Tagged_Message<authid, encid> SUIT_COSE_Untagged_Message<authid, encid> = SUIT_COSE_Sign<authid> / SUIT_COSE_Sign1<authid> / SUIT_COSE_Encrypt<encid> / SUIT_COSE_Encrypt0<encid> / SUIT_COSE_Mac<authid> / SUIT_COSE_Mac0<authid> SUIT_COSE_Tagged_Message<authid, encid> = SUIT_COSE_Sign_Tagged<authid> / SUIT_COSE_Sign1_Tagged<authid> / SUIT_COSE_Encrypt_Tagged<encid> / SUIT_COSE_Encrypt0_Tagged<encid> / SUIT_COSE_Mac_Tagged<authid> / SUIT_COSE_Mac0_Tagged<authid> ; Note: This is not the same definition as is used in COSE. ; It restricts a COSE header definition further without ; repeating the COSE definition. It should be merged ; with COSE by using the CDDL .and operator. SUIT_COSE_Profile_Headers<algid> = ( protected : bstr .cbor SUIT_COSE_alg_map<algid>, unprotected : SUIT_COSE_header_map ) SUIT_COSE_alg_map<algid> = { 1 => algid, * int => any } SUIT_COSE_header_map = { * int => any } SUIT_COSE_Sign_Tagged<authid> = #6.98(SUIT_COSE_Sign<authid>) SUIT_COSE_Sign<authid> = [ SUIT_COSE_Profile_Headers<authid>, payload : bstr / nil, signatures : [+ SUIT_COSE_Signature<authid>] ] SUIT_COSE_Signature<authid> = [ SUIT_COSE_Profile_Headers<authid>, signature : bstr ] SUIT_COSE_Sign1_Tagged<authid> = #6.18(SUIT_COSE_Sign1<authid>) SUIT_COSE_Sign1<authid> = [ SUIT_COSE_Profile_Headers<authid>, payload : bstr / nil, signature : bstr ] SUIT_COSE_Encrypt_Tagged<encid> = #6.96(SUIT_COSE_Encrypt<encid>) SUIT_COSE_Encrypt<encid> = [ SUIT_COSE_Profile_Headers<encid>, ciphertext : bstr / nil, recipients : [+SUIT_COSE_recipient<encid>] ] SUIT_COSE_recipient<encid> = [ SUIT_COSE_Profile_Headers<encid>, ciphertext : bstr / nil, ? recipients : [+SUIT_COSE_recipient<encid>] ] SUIT_COSE_Encrypt0_Tagged<encid> = #6.16(SUIT_COSE_Encrypt0<encid>) SUIT_COSE_Encrypt0<encid> = [ SUIT_COSE_Profile_Headers<encid>, ciphertext : bstr / nil, ] SUIT_COSE_Mac_Tagged<authid> = #6.97(SUIT_COSE_Mac<authid>) SUIT_COSE_Mac<authid> = [ SUIT_COSE_Profile_Headers<authid>, payload : bstr / nil, tag : bstr, recipients :[+SUIT_COSE_recipient<authid>] ] SUIT_COSE_Mac0_Tagged<authid> = #6.17(SUIT_COSE_Mac0<authid>) SUIT_COSE_Mac0<authid> = [ SUIT_COSE_Profile_Headers<authid>, payload : bstr / nil, tag : bstr, ]¶
We would like to specifically thank Magnus Nyström, Deb Cooley, Michael Richardson, Russ Housley, Mike Jones, Henk Birkholz, and Hannes Tschofenig for their review comments.¶