Internet-Draft | (D)TLS IANA Registry Updates | October 2022 |
Salowey & Turner | Expires 27 April 2023 | [Page] |
This document describes a number of changes to TLS and DTLS IANA registries that range from adding notes to the registry all the way to changing the registration policy. These changes were mostly motivated by WG review of the TLS- and DTLS-related registries undertaken as part of the TLS 1.3 development process.¶
This document obsoletes RFC 8447 and updates the following RFCs: 3749, 5077, 4680, 5246, 5705, 5878, 6520, and 7301.¶
This note is to be removed before publishing as an RFC.¶
Status information for this document may be found at https://datatracker.ietf.org/doc/draft-ietf-tls-rfc8447bis/.¶
Discussion of this document takes place on the Transport Layer Security Working Group mailing list (mailto:tls@ietf.org), which is archived at https://mailarchive.ietf.org/arch/browse/tls/. Subscribe at https://www.ietf.org/mailman/listinfo/tls/.¶
Source for this draft and an issue tracker can be found at https://github.com/tlswg/rfc8447bis.¶
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 27 April 2023.¶
Copyright (c) 2022 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 instructs IANA to make changes to a number of the IANA registries related to Transport Layer Security (TLS) and Datagram Transport Layer Security (DTLS).¶
Most of the instructions included herein and previously included in [RFC8447], which this document obsoletes, were motivated by the development of TLS 1.3 [RFC8446]. The changes ranged from simple, e.g., adding notes, to complex, e.g., changing a registry's registration policy. Instead of listing the changes and their rationale here in the introduction, each section provides rationale for the proposed change(s). The instructions in this document revise the values of "Recommended" column, applies the new value to the registries, and adds this column as noted in Section 15. There are also instructions to update references, including replacing references to [RFC8446] with [I-D.ietf-tls-rfc8446bis] and [RFC8447] with [I-D.ietf-tls-rfc8447bis].¶
This document proposes no changes to the registration policies for TLS Alerts [I-D.ietf-tls-rfc8446bis], TLS ContentType [I-D.ietf-tls-rfc8446bis], TLS HandshakeType [I-D.ietf-tls-rfc8446bis], and TLS Certificate Status Types [RFC6961] registries; the existing policies (Standards Action for the first three; IETF Review for the last), are appropriate for these one-byte code points because of their scarcity.¶
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.¶
For consistency amongst TLS registries, IANA has prepended "TLS" to the following registries:¶
IANA [SHALL update/has updated] the reference for these four registries to also refer to this document. The remainder of this document will use the registry names with the "TLS" prefix.¶
Many of the TLS-related IANA registries had the registration procedure "IETF Consensus", which was changed to "IETF Review" by [RFC8126]. To align with the new terminology, IANA has updated the following registries to "IETF Review":¶
This is not a universal change, as some registries originally defined with "IETF Consensus" are undergoing other changes either as a result of this document or [RFC8422].¶
IANA [SHALL update/has updated] the reference for these two registries to also refer to this document.¶
The instructions in this document update the Recommended column, originally added in [RFC8447] to add a third value, "D", indicating that a value is "Discouraged". The permitted values are:¶
Setting the Recommended item to "Y" or "D" or changing a item whose current value is "Y" or "D" requires Standards Action [RFC8126]. Not all items defined in Standards Track RFCs need to be marked as Recommended. Changing the Recommended status of an item in a Standards Track RFC requires Standards Action [RFC8126].¶
The nomenclature for the registry entries in the TLS ExtensionType Values registry correspond to the presentation language field name except for entry 35. To ensure that the values in the registry are consistently identified in the registry, IANA:¶
In order to refect the changes in the Recommended column allocation, IANA SHALL update the TLS ExtensionType Values registry as follows:¶
Values with the first byte in the range 0-254 (decimal) are assigned via Specification Required [RFC8126]. Values with the first byte 255 (decimal) are reserved for Private Use [RFC8126]. Adding a value Y to the "Recommended" column requires Standards Action {{RFC8126}}. IESG Approval is REQUIRED for a Y->N, Y->D, and D->Y|N "Recommended" column transitions.¶
Extension | Recommended | |
---|---|---|
4 | truncated_hmac | D |
53 | connection_id (deprecated) | D |
40 | Reserved | D |
46 | Reserved | D |
If "Recommended" column is set to "N", it does not necessarily mean that it is flawed; rather, it indicates that the item either has not been through the IETF consensus process, has limited applicability, or is intended only for specific use cases. If the "Recommended" column is set to "D" the item is discouraged and SHOULD NOT or MUST NOT be used.¶
Experience has shown that the IETF Consensus registry policy for TLS Cipher Suites was too strict. Based on WG consensus, the decision was taken to change the TLS Cipher Suites registry's registration policy to Specification Required while reserving a small part of the code space for Experimental and Private Use [RFC8126]. Therefore, IANA has updated the TLS Cipher Suites registry's policy as follows:¶
Values with the first byte in the range 0-254 (decimal) are assigned via Specification Required [RFC8126]. Values with the first byte 255 (decimal) are reserved for Private Use [RFC8126].¶
See Section 17 for additional information about the designated expert pool.¶
The TLS Cipher Suites registry has grown significantly and will continue to do so. To better guide those not intimately involved in TLS, IANA [SHALL update/has updated] the TLS Cipher Suites registry as follows:¶
Added a "Recommended" column to the TLS Cipher Suites registry. The cipher suites that follow in the two tables are marked as "Y". All other cipher suites are marked as "N". The "Recommended" column is assigned a value of "N" unless explicitly requested, and adding a value with a "Recommended" value of "Y" requires Standards Action [RFC8126]. IESG Approval is REQUIRED for a Y->N transition.¶
The cipher suites that follow are Standards Track server-authenticated (and optionally client-authenticated) cipher suites that are currently available in TLS 1.2.¶
RFC EDITOR: The previous paragraph is for document reviewers and is not meant for the registry.¶
Cipher Suite Name | Value ----------------------------------------------+------------ TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 | {0x00,0x9E} TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 | {0x00,0x9F} TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 | {0xC0,0x2B} TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 | {0xC0,0x2C} TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 | {0xC0,0x2F} TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 | {0xC0,0x30} TLS_DHE_RSA_WITH_AES_128_CCM | {0xC0,0x9E} TLS_DHE_RSA_WITH_AES_256_CCM | {0xC0,0x9F} TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 | {0xCC,0xA8} TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 | {0xCC,0xA9} TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256 | {0xCC,0xAA}¶
The cipher suites that follow are Standards Track ephemeral pre-shared key cipher suites that are available in TLS 1.2.¶
RFC EDITOR: The previous paragraph is for document reviewers and is not meant for the registry.¶
Cipher Suite Name | Value ----------------------------------------------+------------ TLS_DHE_PSK_WITH_AES_128_GCM_SHA256 | {0x00,0xAA} TLS_DHE_PSK_WITH_AES_256_GCM_SHA384 | {0x00,0xAB} TLS_DHE_PSK_WITH_AES_128_CCM | {0xC0,0xA6} TLS_DHE_PSK_WITH_AES_256_CCM | {0xC0,0xA7} TLS_ECDHE_PSK_WITH_AES_128_GCM_SHA256 | {0xD0,0x01} TLS_ECDHE_PSK_WITH_AES_256_GCM_SHA384 | {0xD0,0x02} TLS_ECDHE_PSK_WITH_AES_128_CCM_SHA256 | {0xD0,0x05} TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256 | {0xCC,0xAC} TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256 | {0xCC,0xAD}¶
The TLS 1.3 cipher suites specified by [I-D.ietf-tls-rfc8446bis] are not listed here; that document provides for their "Recommended" status.¶
Despite the following behavior being misguided, experience has shown that some customers use the IANA registry as a checklist against which to measure an implementation's completeness, and some implementers blindly implement cipher suites. Therefore, IANA has added the following warning to the registry:¶
Cryptographic algorithms and parameters will be broken or weakened over time. Blindly implementing cipher suites listed here is not advised. Implementers and users need to check that the cryptographic algorithms listed continue to provide the expected level of security.¶
IANA has added the following note to ensure that those that focus on IANA registries are aware that TLS 1.3 [I-D.ietf-tls-rfc8446bis] uses the same registry but defines ciphers differently:¶
Although TLS 1.3 uses the same cipher suite space as previous versions of TLS, TLS 1.3 cipher suites are defined differently, only specifying the symmetric ciphers and hash functions, and cannot be used for TLS 1.2. Similarly, TLS 1.2 and lower cipher suite values cannot be used with TLS 1.3.¶
IANA [SHALL add/has added] the following notes to document the rules for populating the "Recommended" column:¶
CCM_8 cipher suites are not marked as "Recommended". These cipher suites have a significantly truncated authentication tag that represents a security trade-off that may not be appropriate for general environments.¶
If an item is not marked as "Recommended", it does not necessarily mean that it is flawed; rather, it indicates that the item either has not been through the IETF consensus process, has limited applicability, or is intended only for specific use cases.¶
IANA [SHALL add/has added] the following notes for additional information:¶
The role of the designated expert is described in [I-D.ietf-tls-rfc8447bis]. The designated expert [RFC8126] ensures that the specification is publicly available. It is sufficient to have an Internet-Draft (that is posted and never published as an RFC) or a document from another standards body, industry consortium, university site, etc. The expert may provide more in-depth reviews, but their approval should not be taken as an endorsement of the cipher suite.¶
As specified in [RFC8126], assignments made in the Private Use space are not generally useful for broad interoperability. It is the responsibility of those making use of the Private Use range to ensure that no conflicts occur (within the intended scope of use). For widespread experiments, temporary reservations are available.¶
IANA [SHALL update/has updated] the reference for this registry to refer to this document instead of [RFC8447].¶
Similar to cipher suites, supported groups have proliferated over time, and some use the registry to measure implementations. Therefore, IANA [SHALL add/has added] a "Recommended" column with a "Y" for secp256r1, secp384r1, x25519, and x448, while all others are "N". These "Y" groups are taken from Standards Track RFCs; [RFC8422] elevates secp256r1 and secp384r1 to Standards Track. Not all groups from [RFC8422], which is Standards Track, are marked as "Y"; these groups apply to TLS 1.3 [I-D.ietf-tls-rfc8446bis] and previous versions of TLS. The "Recommended" column is assigned a value of "N" unless explicitly requested, and adding a value with a "Recommended" value of "Y" requires Standards Action [RFC8126]. IESG Approval is REQUIRED for a Y->N transition.¶
IANA [SHALL add/has added] the following notes:¶
If an item is not marked as "Recommended" it does not necessarily mean that it is flawed; rather, it indicates that the item either has not been through the IETF consensus process, has limited applicability, or is intended only for specific use cases.¶
The role of the designated expert is described in [I-D.ietf-tls-rfc8447bis]. The designated expert [RFC8126] ensures that the specification is publicly available. It is sufficient to have an Internet-Draft (that is posted and never published as an RFC) or a document from another standards body, industry consortium, university site, etc. The expert may provide more in-depth reviews, but their approval should not be taken as an endorsement of the supported groups.¶
Despite the following behavior being misguided, experience has shown that some customers use the IANA registry as a checklist against which to measure an implementation's completeness, and some implementers blindly implement supported group. Therefore, IANA has added the following warning to the registry:¶
Cryptographic algorithms and parameters will be broken or weakened over time. Blindly implementing supported groups listed here is not advised. Implementers and users need to check that the cryptographic algorithms listed continue to provide the expected level of security.¶
IANA [SHALL update/has updated] the reference for this registry to refer to this document instead of [RFC8447].¶
The value 0 (0x0000) has been marked as reserved.¶
Experience has shown that the IETF Consensus registry policy for TLS ClientCertificateType Identifiers is too strict. Based on WG consensus, the decision was taken to change the registration policy to Specification Required while reserving some of the code space for Standards Track usage and a small part of the code space for Private Use [RFC8126]. Therefore, IANA has updated the TLS ClientCertificateType Identifiers registry's policy as follows:¶
Values in the range 0-63 are assigned via Standards Action [RFC8126]. Values 64-223 are assigned via Specification Required [RFC8126]. Values 224-255 are reserved for Private Use [RFC8126].¶
See Section 17 for additional information about the designated expert pool.¶
IANA [SHALL add/has added] the following notes:¶
The role of the designated expert is described in [I-D.ietf-tls-rfc8447bis]. The designated expert [RFC8126] ensures that the specification is publicly available. It is sufficient to have an Internet-Draft (that is posted and never published as an RFC) or a document from another standards body, industry consortium, university site, etc. The expert may provide more in-depth reviews, but their approval should not be taken as an endorsement of the identifier.¶
As specified in [RFC8126], assignments made in the Private Use space are not generally useful for broad interoperability. It is the responsibility of those making use of the Private Use range to ensure that no conflicts occur (within the intended scope of use). For widespread experiments, temporary reservations are available.¶
To align with TLS implementations and to align the naming nomenclature with other Handshake message types, IANA:¶
To aid those reviewers who start with the IANA registry, IANA [SHALL add/has added]:¶
The following note to the TLS Exporter Labels registry:¶
[RFC5705] defines keying material exporters for TLS in terms of the TLS PRF. [I-D.ietf-tls-rfc8446bis] replaced the PRF with HKDF, thus requiring a new construction. The exporter interface remains the same; however, the value is computed differently.¶
Exporter Value | Recommended |
---|---|
client finished | Y |
server finished | Y |
master secret | Y |
key expansion | Y |
client EAP encryption | Y |
ttls keying material | N |
ttls challenge | N |
EXTRACTOR-dtls_srtp | Y |
EXPORTER_DTLS_OVER_SCTP | Y |
EXPORTER: teap session key seed | Y |
To provide additional information for the designated experts, IANA [SHALL add/has added] the following notes:¶
The role of the designated expert is described in [I-D.ietf-tls-rfc8447bis]. The designated expert [RFC8126] ensures that the specification is publicly available. It is sufficient to have an Internet-Draft (that is posted and never published as an RFC) or a document from another standards body, industry consortium, university site, etc. The expert may provide more in-depth reviews, but their approval should not be taken as an endorsement of the exporter label. The expert also verifies that the label is a string consisting of printable ASCII characters beginning with "EXPORTER". IANA MUST also verify that one label is not a prefix of any other label. For example, labels "key" or "master secretary" are forbidden.¶
If an item is not marked as "Recommended", it does not necessarily mean that it is flawed; rather, it indicates that the item either has not been through the IETF consensus process, has limited applicability, or is intended only for specific use cases.¶
IANA [SHALL update/has updated] the reference for this registry to refer to refer to this document instead of [RFC8447].¶
IANA has added the following entry to the TLS Alerts registry; the entry was omitted from the IANA instructions in [RFC7301]:¶
120 no_application_protocol Y [RFC7301][This-document]¶
Experience has shown that the IETF Consensus registry policy for TLS Certificate Types is too strict. Based on WG consensus, the decision was taken to change registration policy to Specification Required while reserving a small part of the code space for Private Use [RFC8126]. Therefore, IANA has changed the TLS Certificate Types registry as follows:¶
Values in the range 0-223 (decimal) are assigned via Specification Required [RFC8126]. Values in the range 224-255 (decimal) are reserved for Private Use [RFC8126].¶
See Section 17 for additional information about the designated expert pool.¶
IANA [SHALL add/has added] the following note:¶
The role of the designated expert is described in [I-D.ietf-tls-rfc8447bis]. The designated expert [RFC8126] ensures that the specification is publicly available. It is sufficient to have an Internet-Draft (that is posted and never published as an RFC) or a document from another standards body, industry consortium, university site, etc. The expert may provide more in-depth reviews, but their approval should not be taken as an endorsement of the certificate type.¶
If an item is not marked as "Recommended", it does not necessarily mean that it is flawed; rather, it indicates that the item either has not been through the IETF consensus process, has limited applicability, or is intended only for specific use cases.¶
IANA [SHALL update/has updated] the reference for this registry to refer this document instead of [RFC8447].¶
To make it clear that (D)TLS 1.3 has orphaned certain registries (i.e., they are only applicable to version of (D)TLS protocol versions prior to 1.3), IANA:¶
has added the following to the TLS Compression Method Identifiers registry [RFC3749]:¶
Value 0 (NULL) is the only value in this registry applicable to (D)TLS protocol version 1.3 or later.¶
has added the following to the TLS HashAlgorithm [RFC5246] and TLS SignatureAlgorithm registries [RFC5246]:¶
The values in this registry are only applicable to (D)TLS protocol versions prior to 1.3. (D)TLS 1.3 and later versions' values are registered in the TLS SignatureScheme registry.¶
has added the following to the TLS ClientCertificateType Identifiers registry [RFC5246]:¶
The values in this registry are only applicable to (D)TLS protocol versions prior to 1.3.¶
Despite the fact that the TLS HashAlgorithm and SignatureAlgorithm registries are orphaned, it is still important to warn implementers of pre-TLS1.3 implementations about the dangers of blindly implementing cryptographic algorithms. Therefore, IANA has added the following warning to the TLS HashAlgorithm and SignatureAlgorithm registries:¶
Cryptographic algorithms and parameters will be broken or weakened over time. Blindly implementing the cryptographic algorithms listed here is not advised. Implementers and users need to check that the cryptographic algorithms listed continue to provide the expected level of security.¶
Though TLS 1.0 and TLS 1.1 were deprecated [RFC8996], TLS 1.2 will be in use for some time. IANA [SHALL update/has updated] the TLS HashAlgorithm, TLS SignatureAlgorithm, and TLS ClientCertificateTypes registries to add a "Recommended" column as follows:¶
TLS HashAlgorithm registry:¶
Descsription | Recommended |
---|---|
none | Y |
md5 | D |
sha1 | D |
sha224 | D |
sha256 | Y |
sha384 | Y |
sha512 | Y |
Intrinsic | Y |
TLS SignatureAlgorithm registry:¶
Descsription | Recommended |
---|---|
anonymous | N |
rsa | Y |
dsa | N |
ecdsa | Y |
ed25519 | Y |
ed448 | Y |
gostr34102012_256 | N |
gostr34102012_512 | N |
TLS ClientCertificateTypes registry:¶
Descsription | Recommended |
---|---|
rsa_sign | Y |
dss_sign | N |
rsa_fixed_dh | N |
dss_fixed_dh | N |
rsa_ephemeral_dh_RESERVED | D |
dss_ephemeral_dh_RESERVED | D |
fortezza_dms_RESERVED | D |
ecdsa_sign | Y |
rsa_fixed_ecdh | N |
ecdsa_fixed_ecdh | N |
gost_sign256 | N |
gost_sign512 | N |
In the TLS HashAlgorithm, TLS SignatureAlgorithm, and TLS ClientCertificateTypes registries, all unassigned and reserved values have a "Recommended" that is blank.¶
IANA has added the following warning and note to the TLS SignatureScheme registry:¶
Cryptographic algorithms and parameters will be broken or weakened over time. Blindly implementing signature schemes listed here is not advised. Implementers and users need to check that the cryptographic algorithms listed continue to provide the expected level of security.¶
As specified in [RFC8126], assignments made in the Private Use space are not generally useful for broad interoperability. It is the responsibility of those making use of the Private Use range to ensure that no conflicts occur (within the intended scope of use). For widespread experiments, temporary reservations are available.¶
IANA [SHALL update/has updated] added the following notes to the TLS PskKeyExchangeMode registry:¶
If an item is not marked as "Recommended", it does not necessarily mean that it is flawed; rather, it indicates that the item either has not been through the IETF consensus process, has limited applicability, or is intended only for specific use cases.¶
The role of the designated expert is described in [I-D.ietf-tls-rfc8447bis]. The designated expert [RFC8126] ensures that the specification is publicly available. It is sufficient to have an Internet-Draft (that is posted and never published as an RFC) or a document from another standards body, industry consortium, university site, etc. The expert may provide more in depth reviews, but their approval should not be taken as an endorsement of the key exchange mode.¶
Specification Required [RFC8126] registry requests are registered after a three-week review period on the tls-reg-review@ietf.org mailing list, on the advice of one or more designated experts. However, to allow for the allocation of values prior to publication, the designated experts may approve registration once they are satisfied that such a specification will be published.¶
Registration requests sent to the mailing list for review SHOULD use an appropriate subject (e.g., "Request to register value in TLS bar registry").¶
Within the review period, the designated experts will either approve or deny the registration request, communicating this decision to the review list and IANA. Denials SHOULD include an explanation and, if applicable, suggestions as to how to make the request successful. Registration requests that are undetermined for a period longer than 21 days can be brought to the IESG's attention (using the iesg@ietf.org mailing list) for resolution.¶
Criteria that SHOULD be applied by the designated experts includes determining whether the proposed registration duplicates existing functionality, whether it is likely to be of general applicability or useful only for a single application, and whether the registration description is clear.¶
IANA MUST only accept registry updates from the designated experts and SHOULD direct all requests for registration to the review mailing list.¶
It is suggested that multiple designated experts be appointed who are able to represent the perspectives of different applications using this specification, in order to enable broadly informed review of registration decisions. In cases where a registration decision could be perceived as creating a conflict of interest for a particular Expert, that Expert SHOULD defer to the judgment of the other Experts.¶
The change to Specification Required from IETF Review lowers the amount of review provided by the WG for cipher suites and supported groups. This change reflects reality in that the WG essentially provided no cryptographic review of the cipher suites or supported groups. This was especially true of national cipher suites.¶
Recommended algorithms are regarded as secure for general use at the time of registration; however, cryptographic algorithms and parameters will be broken or weakened over time. It is possible that the "Recommended" status in the registry lags behind the most recent advances in cryptanalysis. Implementers and users need to check that the cryptographic algorithms listed continue to provide the expected level of security.¶
Designated experts ensure the specification is publicly available. They may provide more in-depth reviews. Their review should not be taken as an endorsement of the cipher suite, extension, supported group, etc.¶
This document is entirely about changes to TLS-related IANA registries.¶