Internet-Draft | DTLS Return Routability Check | November 2021 |
Tschofenig & Fossati | Expires 30 May 2022 | [Page] |
This document specifies a return routability check for use in context of the Connection ID (CID) construct for the Datagram Transport Layer Security (DTLS) protocol versions 1.2 and 1.3.¶
This note is to be removed before publishing as an RFC.¶
Discussion of this document takes place on the Transport Layer Security Working Group mailing list (tls@ietf.org), which is archived at https://mailarchive.ietf.org/arch/browse/tls/.¶
Source for this draft and an issue tracker can be found at https://github.com/tlswg/dtls-rrc.¶
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 30 May 2022.¶
Copyright (c) 2021 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 may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English.¶
In "classical" DTLS, selecting a security context of an incoming DTLS record is accomplished with the help of the 5-tuple, i.e. source IP address, source port, transport protocol, destination IP address, and destination port. Changes to this 5 tuple can happen for a variety reasons over the lifetime of the DTLS session. In the IoT context, NAT rebinding is common with sleepy devices. Other examples include end host mobility and multi-homing. Without CID, if the source IP address and/or source port changes during the lifetime of an ongoing DTLS session then the receiver will be unable to locate the correct security context. As a result, the DTLS handshake has to be re-run. Of course, it is not necessary to re-run the full handshake if session resumption is supported and negotiated.¶
A CID is an identifier carried in the record layer header of a DTLS datagram that gives the receiver additional information for selecting the appropriate security context. The CID mechanism has been specified in [I-D.ietf-tls-dtls-connection-id] for DTLS 1.2 and in [I-D.ietf-tls-dtls13] for DTLS 1.3.¶
Section 6 of [I-D.ietf-tls-dtls-connection-id] describes how the use of CID increases the attack surface by providing both on-path and off-path attackers an opportunity for (D)DoS. It then goes on describing the steps a DTLS principal must take when a record with a CID is received that has a source address (and/or port) different from the one currently associated with the DTLS connection. However, the actual mechanism for ensuring that the new peer address is willing to receive and process DTLS records is left open. This document standardizes a return routability check (RRC) as part of the DTLS protocol itself.¶
The return routability check is performed by the receiving peer before the CID-to-IP address/port binding is updated in that peer's session state database. This is done in order to provide more confidence to the receiving peer that the sending peer is reachable at the indicated address and port.¶
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 assumes familiarity with the CID format and protocol defined for DTLS 1.2 [I-D.ietf-tls-dtls-connection-id] and for DTLS 1.3 [I-D.ietf-tls-dtls13]. The presentation language used in this document is described in Section 4 of [RFC8446].¶
The use of RRC is negotiated via the rrc
DTLS-only extension. On connecting,
the client includes the rrc
extension in its ClientHello if it wishes to use
RRC. If the server is capable of meeting this requirement, it responds with a
rrc
extension in its ServerHello. The extension_type
value for this
extension is TBD1 and the extension_data
field of this extension is empty.
The client and server MUST NOT use RRC unless both sides have successfully
exchanged rrc
extensions.¶
Note that the RRC extension applies to both DTLS 1.2 and DTLS 1.3.¶
When a record with CID is received that has the source address of the enclosing UDP datagram different from the one previously associated with that CID, the receiver MUST NOT update its view of the peer's IP address and port number with the source specified in the UDP datagram before cryptographically validating the enclosed record(s) but instead perform a return routability check.¶
enum { invalid(0), change_cipher_spec(20), alert(21), handshake(22), application_data(23), heartbeat(24), /* RFC 6520 */ return_routability_check(TBD2), /* NEW */ (255) } ContentType; uint64 Cookie; enum { path_challenge(0), path_response(1), reserved(2..255) } rrc_msg_type; struct { rrc_msg_type msg_type; select (return_routability_check.msg_type) { case path_challenge: Cookie; case path_response: Cookie; }; } return_routability_check;¶
The newly introduced return_routability_check
message contains a cookie. The
cookie is a 8-byte field containing arbitrary data.¶
The return_routability_check
message MUST be authenticated and encrypted using
the currently active security context.¶
The receiver that observes the peer's address and or port update MUST stop sending any buffered application data (or limit the data sent to a TBD threshold) and initiate the return routability check that proceeds as follows:¶
return_routability_check
message of type
path_challenge;¶
return_routability_check
message echoes the cookie value in a
return_routability_check
message of type path_response;¶
return_routability_check
message contains the sent cookie, it updates the peer address binding;¶
After this point, any pending send operation is resumed to the bound peer address.¶
The example TLS 1.3 handshake shown in Figure 1 shows a client and a server negotiating the support for CID and for the RRC extension.¶
Once a connection has been established the client and the server exchange application payloads protected by DTLS with an unilaterally used CIDs. In our case, the client is requested to use CID 100 for records sent to the server.¶
At some point in the communication interaction the IP address used by the client changes and, thanks to the CID usage, the security context to interpret the record is successfully located by the server. However, the server wants to test the reachability of the client at his new IP address.¶
Note that the return routability checks do not protect against flooding of third-parties if the attacker is on-path, as the attacker can redirect the return routability checks to the real peer (even if those datagrams are cryptographically authenticated). On-path adversaries can, in general, pose a harm to connectivity.¶
IANA is requested to allocate an entry to the TLS ContentType
registry, for the return_routability_check(TBD2)
defined in this document.
The return_routability_check
content type is only applicable to DTLS 1.2 and
1.3.¶
IANA is requested to allocate the extension code point (TBD1) for the rrc
extension to the TLS ExtensionType Values
registry as described in
Table 1.¶
Value | Extension Name | TLS 1.3 | DTLS-Only | Recommended | Reference |
---|---|---|---|---|---|
TBD1 | rrc | CH, SH | Y | N | RFC-THIS |
Issues against this document are tracked at https://github.com/tlswg/dtls-rrc/issues¶
We would like to thank Achim Kraus, Hanno Becker, Hanno Boeck, Manuel Pegourie-Gonnard, Mohit Sahni and Rich Salz for their input to this document.¶
RFC EDITOR: PLEASE REMOVE THIS SECTION¶
draft-ietf-tls-dtls-rrc-02¶
draft-ietf-tls-dtls-rrc-01¶
Revamp message layout:¶
draft-ietf-tls-dtls-rrc-00¶
draft-tschofenig-tls-dtls-rrc-01¶
draft-tschofenig-tls-dtls-rrc-00¶