<?xmlversion='1.0' encoding='utf-8'?> <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?> <!-- generated by https://github.com/cabo/kramdown-rfc2629 version 1.3.18 --> <!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent"> <?rfc toc="yes"?> <?rfc sortrefs="yes"?> <?rfc symrefs="yes"?> <?rfc docmapping="yes"?>version="1.0" encoding="UTF-8"?> <rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-ietf-quic-tls-34" category="std" consensus="true" number="9001" obsoletes="" updates="" submissionType="IETF" xml:lang="en" tocInclude="true" sortRefs="true" symRefs="true" version="3"><!-- xml2rfc v2v3 conversion 3.5.0 --><link href="https://datatracker.ietf.org/doc/draft-ietf-quic-tls-34" rel="prev"/> <front> <title>Using TLS to Secure QUIC</title> <seriesInfoname="Internet-Draft" value="draft-ietf-quic-tls-34"/>name="RFC" value="9001"/> <author initials="M." surname="Thomson" fullname="Martin Thomson" role="editor"> <organization>Mozilla</organization> <address> <email>mt@lowentropy.net</email> </address> </author> <author initials="S." surname="Turner" fullname="Sean Turner" role="editor"> <organization>sn3rd</organization> <address> <email>sean@sn3rd.com</email> </address> </author> <date year="2021"month="January" day="15"/>month="May"/> <area>Transport</area> <workgroup>QUIC</workgroup> <keyword>crypto</keyword> <keyword>opportunistic encryption</keyword> <keyword>plaintext quic</keyword> <abstract> <t>This document describes how Transport Layer Security (TLS) is used to secure QUIC.</t> </abstract><note> <name>Note to Readers</name> <t>Discussion of this draft takes place on the QUIC working group mailing list (quic@ietf.org), which is archived at <eref target="https://mailarchive.ietf.org/arch/search/?email_list=quic"/>.</t> <t>Working Group information can be found at <eref target="https://github.com/quicwg"/>; source code and issues list for this draft can be found at <eref target="https://github.com/quicwg/base-drafts/labels/-tls"/>.</t> </note></front> <middle> <section anchor="introduction" numbered="true" toc="default"> <name>Introduction</name> <t>This document describes how QUIC <xref target="QUIC-TRANSPORT" format="default"/> is secured using TLS <xref target="TLS13" format="default"/>.</t> <t>TLS 1.3 provides critical latency improvements for connection establishment over previous versions. Absent packet loss, most new connections can be established and secured within a single round trip; on subsequent connections between the same client and server, the client can often send application data immediately, that is, using a zeroround tripround-trip setup.</t> <t>This document describes how TLS acts as a security component of QUIC.</t> </section> <section anchor="notational-conventions" numbered="true" toc="default"> <name>Notational Conventions</name> <t>The key words"MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY","<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>", "<bcp14>MAY</bcp14>", and"OPTIONAL""<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as described inBCP 14BCP 14 <xref target="RFC2119" format="default"/> <xref target="RFC8174" format="default"/> when, and only when, they appear in all capitals, as shown here.</t> <t>This document uses the terminology established in <xref target="QUIC-TRANSPORT" format="default"/>.</t> <t>For brevity, the acronym TLS is used to refer to TLS 1.3, though a newer version could be used; see <xref target="tls-version" format="default"/>.</t> <section anchor="tls-overview" numbered="true" toc="default"> <name>TLS Overview</name> <t>TLS provides two endpoints with a way to establish a means of communication over an untrusted medium (for example, the Internet). TLS enables authentication of peers and provides confidentiality and integrity protection for messages that endpoints exchange.</t> <t>Internally, TLS is a layered protocol, with the structure shown in <xref target="tls-layers" format="default"/>.</t> <figure anchor="tls-layers"> <name>TLS Layers</name> <artwork name="" type="" align="left" alt=""><![CDATA[ +-------------+------------+--------------+---------+ Content | | | Application | | Layer | Handshake | Alerts | Data | ... | | | | | | +-------------+------------+--------------+---------+ Record | | Layer | Records | | | +---------------------------------------------------+ ]]></artwork> </figure> <t>EachContent layercontent-layer message (e.g.,Handshake, Alerts,handshake, alerts, andApplication Data)application data) is carried as a series of typed TLS records by theRecordrecord layer. Records are individually cryptographically protected and then transmitted over a reliable transport (typically TCP), which provides sequencing and guaranteed delivery.</t> <t>The TLS authenticated key exchange occurs between two endpoints: client and server. The client initiates the exchange and the server responds. If the key exchange completes successfully, both client and server will agree on a secret. TLS supports both pre-shared key (PSK) and Diffie-Hellman over either finite fields or elliptic curves ((EC)DHE) key exchanges. PSK is the basis for Early Data (0-RTT); the latter provides forward secrecy (FS) when the (EC)DHE keys are destroyed. The two modes can also becombined,combined to provide forward secrecy while using the PSK for authentication.</t> <t>After completing the TLS handshake, the client will have learned and authenticated an identity for theserverserver, and the server is optionally able to learn and authenticate an identity for the client. TLS supports X.509 <xref target="RFC5280" format="default"/> certificate-based authentication for both server and client. When PSK key exchange is used (as in resumption), knowledge of the PSK serves to authenticate the peer.</t> <t>The TLS key exchange is resistant to tampering byattackersattackers, and it produces shared secrets that cannot be controlled by either participating peer.</t> <t>TLS provides two basic handshake modes of interest to QUIC:</t> <ul spacing="normal"> <li>A full 1-RTT handshake, in which the client is able to sendApplication Dataapplication data after one round trip and the server immediately responds after receiving the first handshake message from the client.</li> <li>A 0-RTT handshake, in which the client uses information it has previously learned about the server to sendApplication Dataapplication data immediately. ThisApplication Dataapplication data can be replayed by anattackerattacker, so 0-RTT is not suitable for carrying instructions that might initiate any action that could cause unwanted effects if replayed.</li> </ul> <t>A simplified TLS handshake with 0-RTT application data is shown in <xref target="tls-full" format="default"/>.</t> <figure anchor="tls-full"> <name>TLS Handshake with 0-RTT</name> <artwork name="" type="" align="left" alt=""><![CDATA[ Client Server ClientHello (0-RTT Application Data) --------> ServerHello {EncryptedExtensions} {Finished} <-------- [Application Data] {Finished} --------> [Application Data] <-------> [Application Data] () Indicates messages protected by Early Data (0-RTT) Keys {} Indicates messages protected using Handshake Keys [] Indicates messages protected using Application Data (1-RTT) Keys ]]></artwork> </figure> <t><xref target="tls-full" format="default"/> omits the EndOfEarlyData message, which is not used in QUIC; see <xref target="remove-eoed" format="default"/>. Likewise, neither ChangeCipherSpec nor KeyUpdate messages are used by QUIC. ChangeCipherSpec is redundant in TLS 1.3; see <xref target="compat-mode" format="default"/>. QUIC has its own key update mechanism; see <xref target="key-update" format="default"/>.</t> <t>Data is protected using a number of encryption levels:</t> <ul spacing="normal"> <li>InitialKeys</li>keys</li> <li>EarlyDatadata (0-RTT)Keys</li>keys</li> <li>HandshakeKeys</li>keys</li> <li>ApplicationDatadata (1-RTT)Keys</li>keys</li> </ul> <t>ApplicationData may appeardata can only appear in theEarly Dataearly data andApplication Dataapplication data levels. Handshake andAlertalert messages may appear in any level.</t> <t>The 0-RTT handshake can be used if the client and server have previously communicated. In the 1-RTT handshake, the client is unable to send protectedApplication Dataapplication data until it has received all of theHandshakehandshake messages sent by the server.</t> </section> </section> <section anchor="protocol-overview" numbered="true" toc="default"> <name>Protocol Overview</name> <t>QUIC <xref target="QUIC-TRANSPORT" format="default"/> assumes responsibility for the confidentiality and integrity protection of packets. For this it uses keys derived from a TLS handshake <xref target="TLS13" format="default"/>, but instead of carrying TLS records over QUIC (as with TCP), TLSHandshakehandshake andAlertalert messages are carried directly over the QUIC transport, which takes over the responsibilities of the TLS record layer, as shown in <xref target="quic-layers" format="default"/>.</t> <figure anchor="quic-layers"> <name>QUIC Layers</name> <artwork name="" type="" align="left" alt=""><![CDATA[ +--------------+--------------+ +-------------+ | TLS | TLS | | QUIC | | Handshake | Alerts | | Applications| | | | | (h3, etc.) | +--------------+--------------+-+-------------+ | | | QUIC Transport | | (streams, reliability, congestion, etc.) | | | +---------------------------------------------+ | | | QUIC Packet Protection | | | +---------------------------------------------+ ]]></artwork> </figure> <t>QUIC also relies on TLS for authentication and negotiation of parameters that are critical to security and performance.</t> <t>Rather than a strict layering, these two protocols cooperate: QUIC uses the TLS handshake; TLS uses the reliability, ordered delivery, and record layer provided by QUIC.</t> <t>At a high level, there are two main interactions between the TLS and QUIC components:</t> <ul spacing="normal"> <li>The TLS component sends and receives messages via the QUIC component, with QUIC providing a reliable stream abstraction to TLS.</li> <li>The TLS component provides a series of updates to the QUIC component, including (a) new packet protection keys to install and (b) state changes such as handshake completion, the server certificate, etc.</li> </ul> <t><xref target="schematic" format="default"/> shows these interactions in more detail, with the QUIC packet protection being called out specially.</t> <figure anchor="schematic"> <name>QUIC and TLS Interactions</name> <artwork name="" type="" align="left" alt=""><![CDATA[ +------------+ +------------+ | |<---- Handshake Messages ----->| | | |<- Validate 0-RTTparametersParameters ->| | | |<--------- 0-RTT Keys ---------| | | QUIC |<------- Handshake Keys -------| TLS | | |<--------- 1-RTT Keys ---------| | | |<------- Handshake Done -------| | +------------+ +------------+ | ^ | Protect | Protected v | Packet +------------+ | QUIC | | Packet | | Protection | +------------+ ]]></artwork> </figure> <t>Unlike TLS over TCP, QUIC applications that want to send data do not send itthroughusing TLS"application_data"Application Data records. Rather, they send it as QUIC STREAM frames or other frame types, which are then carried in QUIC packets.</t> </section> <section anchor="carrying-tls" numbered="true" toc="default"> <name>Carrying TLS Messages</name> <t>QUIC carries TLS handshake data in CRYPTO frames, each of which consists of a contiguous block of handshake data identified by an offset and length. Those frames are packaged into QUIC packets and encrypted under the current encryption level. As with TLS over TCP, once TLS handshake data has been delivered to QUIC, it is QUIC's responsibility to deliver it reliably. Each chunk of data that is produced by TLS is associated with the set of keys that TLS is currently using. If QUIC needs to retransmit that data, itMUST<bcp14>MUST</bcp14> use the same keys even if TLS has already updated to newer keys.</t> <t>Each encryption level corresponds to a packet number space. The packet number space that is used determines the semantics of frames. Some frames are prohibited in different packet number spaces; seeSection 12.5 of<xref section="12.5" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>.</t> <t>Because packets could be reordered on the wire, QUIC uses the packet type to indicate which keys were used to protect a given packet, as shown in <xref target="packet-types-keys" format="default"/>. When packets of different types need to be sent, endpointsSHOULD<bcp14>SHOULD</bcp14> use coalesced packets to send them in the same UDP datagram.</t> <table anchor="packet-types-keys" align="center"> <name>Encryption Keys by Packet Type</name> <thead> <tr><th align="left">Packet<th>Packet Type</th><th align="left">Encryption<th>Encryption Keys</th><th align="left">PN<th>PN Space</th> </tr> </thead> <tbody> <tr><td align="left">Initial</td> <td align="left">Initial<th>Initial</th> <td>Initial secrets</td><td align="left">Initial</td><td>Initial</td> </tr> <tr><td align="left">0-RTT Protected</td> <td align="left">0-RTT</td> <td align="left">Application<th>0-RTT Protected</th> <td>0-RTT</td> <td>Application data</td> </tr> <tr><td align="left">Handshake</td> <td align="left">Handshake</td> <td align="left">Handshake</td><th>Handshake</th> <td>Handshake</td> <td>Handshake</td> </tr> <tr><td align="left">Retry</td> <td align="left">Retry</td> <td align="left">N/A</td><th>Retry</th> <td>Retry</td> <td>N/A</td> </tr> <tr><td align="left">Version Negotiation</td> <td align="left">N/A</td> <td align="left">N/A</td><th>Version Negotiation</th> <td>N/A</td> <td>N/A</td> </tr> <tr><td align="left">Short Header</td> <td align="left">1-RTT</td> <td align="left">Application<th>Short Header</th> <td>1-RTT</td> <td>Application data</td> </tr> </tbody> </table><t>Section 17 of <xref<t><xref section="17" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/> shows how packets at the various encryption levels fit into the handshake process.</t> <section anchor="interface-to-tls" numbered="true" toc="default"> <name>Interface to TLS</name> <t>As shown in <xref target="schematic" format="default"/>, the interface from QUIC to TLS consists of four primary functions:</t> <ul spacing="normal"> <li>Sending and receiving handshake messages</li> <li>Processing stored transport and application state from a resumed session and determining if it is valid to generate or acceptearly0-RTT data</li> <li>Rekeying (both transmit and receive)</li><li>Handshake state updates</li><li>Updating handshake state</li> </ul> <t>Additional functions might be needed to configure TLS. In particular, QUIC and TLS need to agree on which is responsible for validation of peer credentials, such as certificate validation(<xref<xref target="RFC5280"format="default"/>).</t>format="default"/>.</t> <section anchor="handshake-complete" numbered="true" toc="default"> <name>Handshake Complete</name> <t>In this document, the TLS handshake is considered complete when the TLS stack has reported that the handshake is complete. This happens when the TLS stack has both sent a Finished message and verified the peer's Finished message. Verifying the peer's Finished message provides the endpoints with an assurance that previous handshake messages have not been modified. Note that the handshake does not complete at both endpoints simultaneously. Consequently, any requirement that is based on the completion of the handshake depends on the perspective of the endpoint in question.</t> </section> <section anchor="handshake-confirmed" numbered="true" toc="default"> <name>Handshake Confirmed</name> <t>In this document, the TLS handshake is considered confirmed at the server when the handshake completes. The serverMUST<bcp14>MUST</bcp14> send a HANDSHAKE_DONE frame as soon as the handshake is complete. At the client, the handshake is considered confirmed when a HANDSHAKE_DONE frame is received.</t> <t>Additionally, a clientMAY<bcp14>MAY</bcp14> consider the handshake to be confirmed when it receives an acknowledgment for a 1-RTT packet. This can be implemented by recording the lowest packet number sent with 1-RTTkeys,keys and comparing it to the Largest Acknowledged field in any received 1-RTT ACK frame: once the latter is greater than or equal to the former, the handshake is confirmed.</t> </section> <section anchor="sending-and-receiving-handshake-messages" numbered="true" toc="default"> <name>Sending and Receiving Handshake Messages</name> <t>In order to drive the handshake, TLS depends on being able to send and receive handshake messages. There are two basic functions on this interface: one where QUIC requests handshake messages and one where QUIC provides bytes that comprise handshake messages.</t> <t>Before starting thehandshakehandshake, QUIC provides TLS with the transport parameters (see <xref target="quic_parameters" format="default"/>) that it wishes to carry.</t> <t>A QUIC client starts TLS by requesting TLS handshake bytes from TLS. The client acquires handshake bytes before sending its first packet. A QUIC server starts the process by providing TLS with the client's handshake bytes.</t> <t>At any time, the TLS stack at an endpoint will have a current sending encryption level and a receiving encryption level. TLS encryption levels determine the QUIC packet type and keys that are used for protecting data.</t> <t>Each encryption level is associated with a different sequence of bytes, which is reliably transmitted to the peer in CRYPTO frames. When TLS provides handshake bytes to be sent, they are appended to the handshake bytes for the current encryption level. The encryption level then determines the type of packet that the resulting CRYPTO frame is carried in; see <xref target="packet-types-keys" format="default"/>.</t> <t>Four encryption levels are used, producing keys for Initial, 0-RTT, Handshake, and 1-RTT packets. CRYPTO frames are carried in just three of these levels, omitting the 0-RTT level. These four levels correspond to three packet number spaces: Initial and Handshake encrypted packets use their own separate spaces; 0-RTT and 1-RTT packets use the application data packet number space.</t> <t>QUIC takes the unprotected content of TLS handshake records as the content of CRYPTO frames. TLS record protection is not used by QUIC. QUIC assembles CRYPTO frames into QUIC packets, which are protected using QUIC packet protection.</t> <t>QUIC CRYPTO frames only carry TLS handshake messages. TLS alerts are turned into QUIC CONNECTION_CLOSE error codes; see <xref target="tls-errors" format="default"/>. TLS application data and other content types cannot be carried by QUIC at any encryption level; it is an error if they are received from the TLS stack.</t> <t>When an endpoint receives a QUIC packet containing a CRYPTO frame from the network, it proceeds as follows:</t> <ul spacing="normal"> <li>If the packet uses the current TLS receiving encryption level, sequence the data into the input flow as usual. As with STREAM frames, the offset is used to find the proper location in the data sequence. If the result of this process is that new data is available, then it is delivered to TLS in order.</li> <li>If the packet is from a previously installed encryption level, itMUST NOT<bcp14>MUST NOT</bcp14> contain data that extends past the end of previously received data in that flow. ImplementationsMUST<bcp14>MUST</bcp14> treat any violations of this requirement as a connection error of type PROTOCOL_VIOLATION.</li> <li>If the packet is from a new encryption level, it is saved for later processing by TLS. Once TLS moves to receiving from this encryption level, saved data can be provided to TLS. When TLS provides keys for a higher encryption level, if there is data from a previous encryption level that TLS has not consumed, thisMUST<bcp14>MUST</bcp14> be treated as a connection error of type PROTOCOL_VIOLATION.</li> </ul> <t>Each time that TLS is provided with new data, new handshake bytes are requested from TLS. TLS might not provide any bytes if the handshake messages it has received are incomplete or it has no data to send.</t> <t>The content of CRYPTO frames might either be processed incrementally by TLS or buffered until complete messages or flights are available. TLS is responsible for buffering handshake bytes that have arrived in order. QUIC is responsible for buffering handshake bytes that arrive out of order or for encryption levels that are not yet ready. QUIC does not provide any means of flow control for CRYPTO frames; seeSection 7.5 of<xref section="7.5" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>.</t> <t>Once the TLS handshake is complete, this is indicated to QUIC along with any final handshake bytes that TLS needs to send. At this stage, the transport parameters that the peer advertised during the handshake are authenticated; see <xref target="quic_parameters" format="default"/>.</t> <t>Once the handshake is complete, TLS becomes passive. TLS can still receive data from its peer and respond in kind, but it will not need to send more data unless specifically requested--- either by an application or QUIC. One reason to send data is that the server might wish to provide additional or updated session tickets to a client.</t> <t>When the handshake is complete, QUIC only needs to provide TLS with any data that arrives in CRYPTO streams. In the same manner that is used during the handshake, new data is requested from TLS after providing received data.</t> </section> <section anchor="encryption-level-changes" numbered="true" toc="default"> <name>Encryption Level Changes</name> <t>As keys at a given encryption level become available to TLS, TLS indicates to QUIC that reading or writing keys at that encryption level are available.</t> <t>The availability of new keys is always a result of providing inputs to TLS. TLS only provides new keys after being initialized (by a client) or when provided with new handshake data.</t> <t>However, a TLS implementation could perform some of its processing asynchronously. In particular, the process of validating a certificate can take some time. While waiting for TLS processing to complete, an endpointSHOULD<bcp14>SHOULD</bcp14> buffer received packets if they might be processed using keys thataren'tare not yet available. These packets can be processed once keys are provided by TLS. An endpointSHOULD<bcp14>SHOULD</bcp14> continue to respond to packets that can be processed during this time.</t> <t>After processing inputs, TLS might produce handshake bytes, keys for new encryption levels, or both.</t> <t>TLS provides QUIC with three items as a new encryption level becomes available:</t> <ul spacing="normal"> <li>A secret</li> <li>An Authenticated Encryption with Associated Data (AEAD) function</li> <li>A Key Derivation Function (KDF)</li> </ul> <t>These values are based on the values that TLS negotiates and are used by QUIC to generate packet and header protection keys; see <xref target="packet-protection" format="default"/> and <xref target="header-protect" format="default"/>.</t> <t>If 0-RTT is possible, it is ready after the client sends a TLS ClientHello message or the server receives that message. After providing a QUIC client with the first handshake bytes, the TLS stack might signal the change to 0-RTT keys. On the server, after receiving handshake bytes that contain a ClientHello message, a TLS server might signal that 0-RTT keys are available.</t> <t>Although TLS only uses one encryption level at a time, QUIC may use more than one level. For instance, after sending its Finished message (using a CRYPTO frame at the Handshake encryption level) an endpoint can send STREAM data (in 1-RTT encryption). If the Finished message is lost, the endpoint uses the Handshake encryption level to retransmit the lost message. Reordering or loss of packets can mean that QUIC will need to handle packets at multiple encryption levels. During the handshake, this means potentially handling packets at higher and lower encryption levels than the current encryption level used by TLS.</t> <t>In particular, server implementations need to be able to read packets at the Handshake encryption level at the same time as the 0-RTT encryption level. A client could interleave ACK frames that are protected with Handshake keys with 0-RTTdatadata, and the server needs to process those acknowledgments in order to detect lost Handshake packets.</t> <t>QUIC also needs access to keys that might not ordinarily be available to a TLS implementation. For instance, a client might need to acknowledge Handshake packets before it is ready to send CRYPTO frames at that encryption level. TLS therefore needs to provide keys to QUIC before it might produce them for its own use.</t> </section> <section anchor="tls-interface-summary" numbered="true" toc="default"> <name>TLS Interface Summary</name> <t><xref target="exchange-summary" format="default"/> summarizes the exchange between QUIC and TLS for both client and server. Solid arrows indicate packets that carry handshake data; dashed arrows show where application data can be sent. Each arrow is tagged with the encryption level used for that transmission.</t> <figure anchor="exchange-summary"> <name>Interaction Summary between QUIC and TLS</name> <artwork name="" type="" align="left" alt=""><![CDATA[ Client Server ====== ====== Get Handshake Initial -------------> Install tx 0-RTTKeyskeys 0-RTT - - - - - - - -> Handshake Received Get Handshake <------------- Initial Install rx 0-RTT keys Install Handshake keys Get Handshake <----------- Handshake Install tx 1-RTT keys <- - - - - - - - 1-RTT Handshake Received (Initial) Install Handshake keys Handshake Received (Handshake) Get Handshake Handshake -----------> Handshake Complete Install 1-RTT keys 1-RTT - - - - - - - -> Handshake Received Handshake Complete Handshake Confirmed Install rx 1-RTT keys <--------------- 1-RTT (HANDSHAKE_DONE) Handshake Confirmed ]]></artwork> </figure> <t><xref target="exchange-summary" format="default"/> shows the multiple packets that form a single "flight" of messages being processed individually, to show what incoming messages trigger different actions. This shows multiple "Get Handshake" invocations to retrieve handshake messages at different encryption levels. New handshake messages are requested after incoming packets have been processed.</t> <t><xref target="exchange-summary" format="default"/> shows one possible structure for a simple handshake exchange. The exact process varies based on the structure of endpoint implementations and the order in which packets arrive. Implementations could use a different number of operations or execute them in other orders.</t> </section> </section> <section anchor="tls-version" numbered="true" toc="default"> <name>TLS Version</name> <t>This document describes how TLS 1.3 <xref target="TLS13" format="default"/> is used with QUIC.</t> <t>In practice, the TLS handshake will negotiate a version of TLS to use. This could result in anewerversion of TLS newer than 1.3 being negotiated if both endpoints support that version. This is acceptable provided that the features of TLS 1.3 that are used by QUIC are supported by the newer version.</t> <t>ClientsMUST NOT<bcp14>MUST NOT</bcp14> offer TLS versions older than 1.3. A badly configured TLS implementation could negotiate TLS 1.2 or another older version of TLS. An endpointMUST<bcp14>MUST</bcp14> terminate the connection if a version of TLS older than 1.3 is negotiated.</t> </section> <section anchor="clienthello-size" numbered="true" toc="default"> <name>ClientHello Size</name> <t>The first Initial packet from a client contains the start or all of its first cryptographic handshake message, which for TLS is the ClientHello. Servers might need to parse the entire ClientHello (e.g., to access extensions such as Server Name Identification (SNI) orApplication LayerApplication-Layer Protocol Negotiation (ALPN)) in order to decide whether to accept the new incoming QUIC connection. If the ClientHello spans multiple Initial packets, such servers would need to buffer the first received fragments, which could consume excessive resources if the client's address has not yet been validated. To avoid this, serversMAY<bcp14>MAY</bcp14> use the Retry feature (seeSection 8.1 of<xref section="8.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>) to only buffer partial ClientHello messages from clients with a validated address.</t> <t>QUIC packet and framing add at least 36 bytes of overhead to the ClientHello message. That overhead increases if the client chooses asource connectionSource Connection ID field longer than zero bytes. Overheads also do not include the token or adestination connectionDestination Connection ID longer than 8 bytes, both of which might be required if a server sends a Retry packet.</t> <t>A typical TLS ClientHello can easily fit into a 1200-byte packet. However, in addition to the overheads added by QUIC, there are several variables that could cause this limit to be exceeded. Large session tickets, multiple or large key shares, and long lists of supported ciphers, signature algorithms, versions, QUIC transport parameters, and other negotiable parameters and extensions could cause this message to grow.</t> <t>For servers, in addition to connection IDs and tokens, the size of TLS session tickets can have an effect on a client's ability to connect efficiently. Minimizing the size of these values increases the probability that clients can use them and still fit their entire ClientHello message in their first Initial packet.</t> <t>The TLS implementation does not need to ensure that the ClientHello is large enough to meettheQUIC's requirements for datagrams that carry Initial packets; see <xref section="14.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>. QUICpackets. QUICimplementations use PADDING framesare added to increase the size of theor packetas necessary; see Section 14.1 of <xref target="QUIC-TRANSPORT" format="default"/>.</t>coalescing to ensure that datagrams are large enough.</t> </section> <section anchor="peer-authentication" numbered="true" toc="default"> <name>Peer Authentication</name> <t>The requirements for authentication depend on the application protocol that is in use. TLS provides server authentication and permits the server to request client authentication.</t> <t>A clientMUST<bcp14>MUST</bcp14> authenticate the identity of the server. This typically involves verification that the identity of the server is included in a certificate and that the certificate is issued by a trusted entity (see for example <xref target="RFC2818" format="default"/>).</t><dl> <dt> Note: </dt> <dd> <t>Where<aside> <t>Note: Where servers provide certificates for authentication, the size of the certificate chain can consume a large number of bytes. Controlling the size of certificate chains is critical to performance in QUIC as servers are limited to sending 3 bytes for every byte received prior to validating the client address; seeSection 8.1 of<xref section="8.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>. The size of a certificate chain can be managed by limiting the number of names or extensions; using keys with small public key representations, like ECDSA; or by using certificate compression <xref target="COMPRESS" format="default"/>.</t></dd> </dl></aside> <t>A serverMAY<bcp14>MAY</bcp14> request that the client authenticate during the handshake. A serverMAY<bcp14>MAY</bcp14> refuse a connection if the client is unable to authenticate when requested. The requirements for client authentication vary based on application protocol and deployment.</t> <t>A serverMUST NOT<bcp14>MUST NOT</bcp14> use post-handshake client authentication (as defined inSection 4.6.2 of<xref section="4.6.2" sectionFormat="of" target="TLS13"format="default"/>),format="default"/>) because the multiplexing offered by QUIC prevents clients from correlating the certificate request with the application-level event that triggered it (see <xref target="HTTP2-TLS13" format="default"/>). More specifically, serversMUST NOT<bcp14>MUST NOT</bcp14> send post-handshake TLS CertificateRequestmessagesmessages, and clientsMUST<bcp14>MUST</bcp14> treat receipt of such messages as a connection error of type PROTOCOL_VIOLATION.</t> </section> <section anchor="resumption" numbered="true" toc="default"> <name>Session Resumption</name> <t>QUIC can use the session resumption feature of TLS 1.3. It does this by carrying NewSessionTicket messages in CRYPTO frames after the handshake is complete. Session resumption can be used to provide0-RTT,0-RTT and can also be used when 0-RTT is disabled.</t> <t>Endpoints that use session resumption might need to remember some information about the current connection when creating a resumed connection. TLS requires that some information be retained; seeSection 4.6.1 of<xref section="4.6.1" sectionFormat="of" target="TLS13" format="default"/>. QUIC itself does not depend on any state being retained when resuming aconnection,connection unless 0-RTT is also used; seeSection 7.4.1 of<xref section="7.4.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/> and <xref target="enable-0rtt" format="default"/>. Application protocols could depend on state that is retained between resumed connections.</t> <t>Clients can store any state required for resumption along with the session ticket. Servers can use the session ticket to help carry state.</t> <t>Session resumption allows servers to link activity on the original connection with the resumed connection, which might be a privacy issue for clients. Clients can choose not to enable resumption to avoid creating this correlation. ClientsSHOULD NOT<bcp14>SHOULD NOT</bcp14> reuse tickets as that allows entities other than the server to correlate connections; seeSection C.4 of<xref section="C.4" sectionFormat="of" target="TLS13" format="default"/>.</t> </section> <section anchor="rtt" numbered="true" toc="default"> <name>0-RTT</name> <t>The 0-RTT feature in QUIC allows a client to send application data before the handshake is complete. This is made possible by reusing negotiated parameters from a previous connection. To enable this, 0-RTT depends on the client remembering critical parameters and providing the server with a TLS session ticket that allows the server to recover the same information.</t> <t>This information includes parameters that determine TLS state, as governed by <xref target="TLS13" format="default"/>, QUIC transport parameters, the chosen application protocol, and any information the application protocol might need; see <xref target="app-0rtt" format="default"/>. This information determines how 0-RTT packets and their contents are formed.</t> <t>To ensure that the same information is available to both endpoints, all information used to establish 0-RTT comes from the same connection. Endpoints cannot selectively disregard information that might alter the sending or processing of 0-RTT.</t> <t><xref target="TLS13" format="default"/> sets a limit of7seven days on the time between the original connection and any attempt to use 0-RTT. There are other constraints on 0-RTT usage, notably those caused by the potential exposure to replay attack; see <xref target="replay" format="default"/>.</t> <section anchor="enable-0rtt" numbered="true" toc="default"> <name>Enabling 0-RTT</name> <t>The TLS"early_data"early_data extension in the NewSessionTicket message is defined to convey (in the"max_early_data_size"max_early_data_size parameter) the amount of TLS 0-RTT data the server is willing to accept. QUIC does not use TLS0-RTTearly data. QUIC uses 0-RTT packets to carry early data. Accordingly, the"max_early_data_size"max_early_data_size parameter is repurposed to hold a sentinel value 0xffffffff to indicate that the server is willing to accept QUIC 0-RTTdata; todata. To indicate that the server does not accept 0-RTT data, the"early_data"early_data extension is omitted from the NewSessionTicket. The amount of data that the client can send in QUIC 0-RTT is controlled by the initial_max_data transport parameter supplied by the server.</t> <t>ServersMUST NOT<bcp14>MUST NOT</bcp14> send the early_data extension with a max_early_data_size field set to any value other than 0xffffffff. A clientMUST<bcp14>MUST</bcp14> treat receipt of a NewSessionTicket that contains an early_data extension with any other value as a connection error of type PROTOCOL_VIOLATION.</t> <t>A client that wishes to send 0-RTT packets uses the early_data extension in the ClientHello message of a subsequent handshake; seeSection 4.2.10 of<xref section="4.2.10" sectionFormat="of" target="TLS13" format="default"/>. It then sends application data in 0-RTT packets.</t> <t>A client that attempts 0-RTT might also provide an address validation token if the server has sent a NEW_TOKEN frame; seeSection 8.1 of<xref section="8.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>.</t> </section> <section anchor="accepting-and-rejecting-0-rtt" numbered="true" toc="default"> <name>Accepting and Rejecting 0-RTT</name> <t>A server accepts 0-RTT by sending an early_data extension in the EncryptedExtensions; seeSection 4.2.10 of<xref section="4.2.10" sectionFormat="of" target="TLS13" format="default"/>. The server then processes and acknowledges the 0-RTT packets that it receives.</t> <t>A server rejects 0-RTT by sending the EncryptedExtensions without an early_data extension. A server will always reject 0-RTT if it sends a TLS HelloRetryRequest. When rejecting 0-RTT, a serverMUST NOT<bcp14>MUST NOT</bcp14> process any 0-RTT packets, even if it could. When 0-RTT was rejected, a clientSHOULD<bcp14>SHOULD</bcp14> treat receipt of an acknowledgment for a 0-RTT packet as a connection error of type PROTOCOL_VIOLATION, if it is able to detect the condition.</t> <t>When 0-RTT is rejected, all connection characteristics that the client assumed might be incorrect. This includes the choice of application protocol, transport parameters, and any application configuration. The client thereforeMUST<bcp14>MUST</bcp14> reset the state of all streams, including application state bound to those streams.</t> <t>A clientMAY<bcp14>MAY</bcp14> reattempt 0-RTT if it receives a Retry or Version Negotiation packet. These packets do not signify rejection of 0-RTT.</t> </section> <section anchor="app-0rtt" numbered="true" toc="default"> <name>Validating 0-RTT Configuration</name> <t>When a server receives a ClientHello with the early_data extension, it has to decide whether to accept or rejectearly0-RTT data from the client. Some of this decision is made by the TLS stack (e.g., checking that the cipher suite being resumed was included in the ClientHello; seeSection 4.2.10 of<xref section="4.2.10" sectionFormat="of" target="TLS13" format="default"/>). Even when the TLS stack has no reason to rejectearly0-RTT data, the QUIC stack or the application protocol using QUIC might rejectearly0-RTT data because the configuration of the transport or application associated with the resumed session is not compatible with the server's current configuration.</t> <t>QUIC requires additional transport state to be associated with a 0-RTT session ticket. One common way to implement this is using stateless session tickets and storing this state in the session ticket. Application protocols that use QUIC might have similar requirements regarding associating or storing state. This associated state is used for deciding whetherearly0-RTT data must be rejected. For example, HTTP/3(<xref target="QUIC-HTTP" format="default"/>)settings <xref target="QUIC-HTTP" format="default"/> determine howearly0-RTT data from the client is interpreted. Other applications using QUIC could have different requirements for determining whether to accept or rejectearly0-RTT data.</t> </section> </section> <section anchor="helloretryrequest" numbered="true" toc="default"> <name>HelloRetryRequest</name> <t>The HelloRetryRequest message (seeSection 4.1.4 of<xref section="4.1.4" sectionFormat="of" target="TLS13" format="default"/>) can be used to request that a client provide new information, such as a key share, or to validate some characteristic of the client. From the perspective of QUIC, HelloRetryRequest is not differentiated from other cryptographic handshake messages that are carried in Initial packets. Although it is in principle possible to use this feature for address verification, QUIC implementationsSHOULD<bcp14>SHOULD</bcp14> instead use the Retry feature; seeSection 8.1 of<xref section="8.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>.</t> </section> <section anchor="tls-errors" numbered="true" toc="default"> <name>TLS Errors</name> <t>If TLS experiences an error, it generates an appropriate alert as defined inSection 6 of<xref section="6" sectionFormat="of" target="TLS13" format="default"/>.</t> <t>A TLS alert is converted into a QUIC connection error. The AlertDescription value is added to0x1000x0100 to produce a QUIC error code from the range reserved forCRYPTO_ERROR.CRYPTO_ERROR; see <xref section="20.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>. The resulting value is sent in a QUIC CONNECTION_CLOSE frame of type 0x1c.</t> <t>QUIC is only able to convey an alert level of "fatal". In TLS 1.3, the only existing uses for the "warning" level are to signal connection close; seeSection 6.1 of<xref section="6.1" sectionFormat="of" target="TLS13" format="default"/>. As QUIC provides alternative mechanisms for connection termination and the TLS connection is only closed if an error is encountered, a QUIC endpointMUST<bcp14>MUST</bcp14> treat any alert from TLS as if it were at the "fatal" level.</t> <t>QUIC permits the use of a generic code in place of a specific error code; seeSection 11 of<xref section="11" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>. For TLS alerts, this includes replacing any alert with a generic alert, such as handshake_failure(0x128(0x0128 in QUIC). EndpointsMAY<bcp14>MAY</bcp14> use a generic error code to avoid possibly exposing confidential information.</t> </section> <section anchor="discarding-unused-keys" numbered="true" toc="default"> <name>Discarding Unused Keys</name> <t>After QUIC has completed a move to a new encryption level, packet protection keys for previous encryption levels can be discarded. This occurs several times during the handshake, as well as when keys are updated; see <xref target="key-update" format="default"/>.</t> <t>Packet protection keys are not discarded immediately when new keys are available. If packets from a lower encryption level contain CRYPTO frames, frames that retransmit that dataMUST<bcp14>MUST</bcp14> be sent at the same encryption level. Similarly, an endpoint generates acknowledgments for packets at the same encryption level as the packet being acknowledged. Thus, it is possible that keys for a lower encryption level are needed for a short time after keys for a newer encryption level are available.</t> <t>An endpoint cannot discard keys for a given encryption level unless it has received all the cryptographic handshake messages from its peer at that encryption level and its peer has done the same. Different methods for determining this are provided for Initial keys (<xref target="discard-initial" format="default"/>) and Handshake keys (<xref target="discard-handshake" format="default"/>). These methods do not prevent packets from being received or sent at that encryption level because a peer might not have received all the acknowledgments necessary.</t> <t>Though an endpoint might retain older keys, new dataMUST<bcp14>MUST</bcp14> be sent at the highestcurrently-availablecurrently available encryption level. Only ACK frames and retransmissions of data in CRYPTO frames are sent at a previous encryption level. These packetsMAY<bcp14>MAY</bcp14> also include PADDING frames.</t> <section anchor="discard-initial" numbered="true" toc="default"> <name>Discarding Initial Keys</name> <t>Packets protected with Initial secrets (<xref target="initial-secrets" format="default"/>) are not authenticated, meaning that an attacker could spoof packets with the intent to disrupt a connection. To limit these attacks, Initial packet protection keys are discarded more aggressively than other keys.</t> <t>The successful use of Handshake packets indicates that no more Initial packets need to be exchanged, as these keys can only be produced after receiving all CRYPTO frames from Initial packets. Thus, a clientMUST<bcp14>MUST</bcp14> discard Initial keys when it first sends a Handshake packet and a serverMUST<bcp14>MUST</bcp14> discard Initial keys when it first successfully processes a Handshake packet. EndpointsMUST NOT<bcp14>MUST NOT</bcp14> send Initial packets after this point.</t> <t>This results in abandoning loss recovery state for the Initial encryption level and ignoring any outstanding Initial packets.</t> </section> <section anchor="discard-handshake" numbered="true" toc="default"> <name>Discarding Handshake Keys</name> <t>An endpointMUST<bcp14>MUST</bcp14> discard itshandshakeHandshake keys when the TLS handshake is confirmed (<xref target="handshake-confirmed" format="default"/>).</t> </section> <section anchor="discarding-0-rtt-keys" numbered="true" toc="default"> <name>Discarding 0-RTT Keys</name> <t>0-RTT and 1-RTT packets share the same packet number space, and clients do not send 0-RTT packets after sending a 1-RTT packet (<xref target="using-early-data" format="default"/>).</t> <t>Therefore, a clientSHOULD<bcp14>SHOULD</bcp14> discard 0-RTT keys as soon as it installs 1-RTTkeys, sincekeys as they have no use after that moment.</t> <t>Additionally, a serverMAY<bcp14>MAY</bcp14> discard 0-RTT keys as soon as it receives a 1-RTT packet. However, due to packet reordering, a 0-RTT packet could arrive after a 1-RTT packet. ServersMAY<bcp14>MAY</bcp14> temporarily retain 0-RTT keys to allow decrypting reordered packets without requiring their contents to be retransmitted with 1-RTT keys. After receiving a 1-RTT packet, serversMUST<bcp14>MUST</bcp14> discard 0-RTT keys within a short time; theRECOMMENDED<bcp14>RECOMMENDED</bcp14> time period is three times the Probe Timeout (PTO, see <xref target="QUIC-RECOVERY" format="default"/>). A serverMAY<bcp14>MAY</bcp14> discard 0-RTT keys earlier if it determines that it has received all 0-RTT packets, which can be done by keeping track of missing packet numbers.</t> </section> </section> </section> <section anchor="packet-protection" numbered="true" toc="default"> <name>Packet Protection</name> <t>As with TLS over TCP, QUIC protects packets with keys derived from the TLS handshake, using the AEAD algorithm <xref target="AEAD" format="default"/> negotiated by TLS.</t> <t>QUIC packets have varying protections depending on their type:</t> <ul spacing="normal"> <li>Version Negotiation packets have no cryptographic protection.</li> <li>Retry packets use AEAD_AES_128_GCM to provide protection against accidental modification and to limit the entities that can produce a valid Retry; see <xref target="retry-integrity" format="default"/>.</li> <li>Initial packets use AEAD_AES_128_GCM with keys derived from the Destination Connection ID field of the first Initial packet sent by the client; see <xref target="initial-secrets" format="default"/>.</li> <li>All other packets have strong cryptographic protections for confidentiality and integrity, using keys and algorithms negotiated by TLS.</li> </ul> <t>This section describes how packet protection is applied to Handshake packets, 0-RTT packets, and 1-RTT packets. The same packet protection process is applied to Initial packets. However, as it is trivial to determine the keys used for Initial packets, these packets are not considered to have confidentiality or integrity protection. Retry packets use a fixed key and so similarly lack confidentiality and integrity protection.</t> <section anchor="protection-keys" numbered="true" toc="default"> <name>Packet Protection Keys</name> <t>QUIC derives packet protection keys in the same way that TLS derives record protection keys.</t> <t>Each encryption level has separate secret values for protection of packets sent in each direction. These traffic secrets are derived by TLS (seeSection 7.1 of<xref section="7.1" sectionFormat="of" target="TLS13" format="default"/>) and are used by QUIC for all encryption levels except the Initial encryption level. The secrets for the Initial encryption level are computed based on the client's initial Destination Connection ID, as described in <xref target="initial-secrets" format="default"/>.</t> <t>The keys used for packet protection are computed from the TLS secrets using the KDF provided by TLS. In TLS 1.3, the HKDF-Expand-Label function described inSection 7.1 of<xref section="7.1" sectionFormat="of" target="TLS13" format="default"/> isused, usingused with the hash function from the negotiated cipher suite. All uses of HKDF-Expand-Label in QUIC use a zero-length Context.</t> <t>Note that labels, which are described using strings, are encoded as bytes using ASCII <xref target="ASCII" format="default"/> without quotes or any trailing NUL byte.</t> <t>Other versions of TLSMUST<bcp14>MUST</bcp14> provide a similar function in order to be used with QUIC.</t> <t>The current encryption level secret and the label "quic key" are input to the KDF to produce the AEAD key; the label "quic iv" is used to derive the Initialization Vector (IV); see <xref target="aead" format="default"/>. The header protection key uses the "quic hp" label; see <xref target="header-protect" format="default"/>. Using these labels provides key separation between QUIC and TLS; see <xref target="key-diversity" format="default"/>.</t> <t>Both "quic key" and "quic hp" are used to produce keys, so the Length provided to HKDF-Expand-Label along with these labels is determined by the size of keys in the AEAD or header protection algorithm. The Length provided with "quic iv" is the minimum length of the AEADnonce,nonce or 8 bytes if that is larger; see <xref target="AEAD" format="default"/>.</t> <t>The KDF used for initial secrets is always the HKDF-Expand-Label function from TLS 1.3; see <xref target="initial-secrets" format="default"/>.</t> </section> <section anchor="initial-secrets" numbered="true" toc="default"> <name>Initial Secrets</name> <t>Initial packets apply the packet protection process, but use a secret derived from the Destination Connection ID field from the client's first Initial packet.</t> <t>This secret is determined by using HKDF-Extract (seeSection 2.2 of<xref section="2.2" sectionFormat="of" target="HKDF" format="default"/>) with a salt of 0x38762cf7f55934b34d179ae6a4c80cadccbb7f0a anda IKMthe input keying material (IKM) of the Destination Connection ID field. This produces an intermediate pseudorandom key (PRK) that is used to derive two separate secrets for sending and receiving.</t> <t>The secret used by clients to construct Initial packets uses the PRK and the label "client in" as input to the HKDF-Expand-Label function from TLS <xref target="TLS13" format="default"/> to produce a 32-byte secret. Packets constructed by the server use the same process with the label "server in". The hash function for HKDF when deriving initial secrets and keys is SHA-256 <xref target="SHA" format="default"/>.</t> <t>This process in pseudocode is:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ initial_salt = 0x38762cf7f55934b34d179ae6a4c80cadccbb7f0a initial_secret = HKDF-Extract(initial_salt, client_dst_connection_id) client_initial_secret = HKDF-Expand-Label(initial_secret, "client in", "", Hash.length) server_initial_secret = HKDF-Expand-Label(initial_secret, "server in", "", Hash.length) ]]></artwork> <t>The connection ID used with HKDF-Expand-Label is the Destination Connection ID in the Initial packet sent by the client. This will be arandomly-selectedrandomly selected value unless the client creates the Initial packet after receiving a Retry packet, where the Destination Connection ID is selected by the server.</t> <t>Future versions of QUICSHOULD<bcp14>SHOULD</bcp14> generate a new salt value, thus ensuring that the keys are different for each version of QUIC. This prevents a middlebox that recognizes only one version of QUIC from seeing or modifying the contents of packets from future versions.</t> <t>The HKDF-Expand-Label function defined in TLS 1.3MUST<bcp14>MUST</bcp14> be used for Initial packets even where the TLS versions offered do not include TLS 1.3.</t> <t>The secrets used for constructing subsequent Initial packets change when a server sends a Retrypacket,packet to use the connection ID value selected by the server. The secrets do not change when a client changes the Destination Connection ID it uses in response to an Initial packet from the server.</t><dl> <dt> Note: </dt> <dd> <t>The<aside> <t>Note: The Destination Connection ID field could be any length up to 20 bytes, including zero length if the server sends a Retry packet with a zero-length Source Connection ID field. After a Retry, the Initial keys provide the client no assurance that the server received its packet, so the client has to rely on the exchange that included the Retry packet to validate the server address; seeSection 8.1 of<xref section="8.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>.</t></dd> </dl></aside> <t><xref target="test-vectors" format="default"/> contains sample Initial packets.</t> </section> <section anchor="aead" numbered="true" toc="default"> <name>AEAD Usage</name> <t>The Authenticated Encryption with Associated Data(AEAD; see(AEAD) function (see <xref target="AEAD" format="default"/>)functionused for QUIC packet protection is the AEAD that is negotiated for use with the TLS connection. For example, if TLS is using the TLS_AES_128_GCM_SHA256 cipher suite, the AEAD_AES_128_GCM function is used.</t> <t>QUIC can use any of the cipher suites defined in <xref target="TLS13" format="default"/> with the exception of TLS_AES_128_CCM_8_SHA256. A cipher suiteMUST NOT<bcp14>MUST NOT</bcp14> be negotiated unless a header protection scheme is defined for the cipher suite. This document defines a header protection scheme for all cipher suites defined in <xref target="TLS13" format="default"/> aside from TLS_AES_128_CCM_8_SHA256. These cipher suites have a 16-byte authentication tag and produce an output 16 bytes larger than their input.</t><dl> <dt> Note: </dt> <dd><t>An endpointMUST NOT<bcp14>MUST NOT</bcp14> reject a ClientHello that offers a cipher suite that it does not support, or it would be impossible to deploy a new cipher suite. This also applies to TLS_AES_128_CCM_8_SHA256.</t></dd> </dl><t>When constructing packets, the AEAD function is applied prior to applying header protection; see <xref target="header-protect" format="default"/>. The unprotected packet header is part of the associated data (A). When processing packets, an endpoint first removes the header protection.</t> <t>The key and IV for the packet are computed as described in <xref target="protection-keys" format="default"/>. The nonce, N, is formed by combining the packet protection IV with the packet number. The 62 bits of the reconstructed QUIC packet number in network byte order are left-padded with zeros to the size of the IV. The exclusive OR of the padded packet number and the IV forms the AEAD nonce.</t> <t>The associated data, A, for the AEAD is the contents of the QUIC header, starting from the first byte of either the short or long header, up to and including the unprotected packet number.</t> <t>The input plaintext, P, for the AEAD is the payload of the QUIC packet, as described in <xref target="QUIC-TRANSPORT" format="default"/>.</t> <t>The output ciphertext, C, of the AEAD is transmitted in place of P.</t> <t>Some AEAD functions have limits for how many packets can be encrypted under the same key and IV; see <xref target="aead-limits" format="default"/>. This might be lower than the packet number limit. An endpointMUST<bcp14>MUST</bcp14> initiate a key update (<xref target="key-update" format="default"/>) prior to exceeding any limit set for the AEAD that is in use.</t> </section> <section anchor="header-protect" numbered="true" toc="default"> <name>Header Protection</name> <t>Parts of QUIC packet headers, in particular the Packet Number field, are protected using a key that is derived separately from the packet protection key and IV. The key derived using the "quic hp" label is used to provide confidentiality protection for those fields that are not exposed to on-path elements.</t> <t>This protection applies to theleast-significantleast significant bits of the first byte, plus the Packet Number field. The fourleast-significantleast significant bits of the first byte are protected for packets with long headers; the five least significant bits of the first byte are protected for packets with short headers. For both header forms, this covers the reserved bits and the Packet Number Length field; the Key Phase bit is also protected for packets with a short header.</t> <t>The same header protection key is used for the duration of the connection, with the value not changing after a key update (see <xref target="key-update" format="default"/>). This allows header protection to be used to protect the key phase.</t> <t>This process does not apply to Retry or Version Negotiation packets, which do not contain a protected payload or any of the fields that are protected by this process.</t> <section anchor="header-protection-application" numbered="true" toc="default"> <name>Header Protection Application</name> <t>Header protection is applied after packet protection is applied (see <xref target="aead" format="default"/>). The ciphertext of the packet is sampled and used as input to an encryption algorithm. The algorithm used depends on the negotiated AEAD.</t> <t>The output of this algorithm is a 5-byte mask that is applied to the protected header fields using exclusive OR. The least significant bits of the first byte of the packet are masked by the least significant bits of the first mask byte, and the packet number is masked with the remaining bytes. Any unused bytes of mask that might result from a shorter packet number encoding are unused.</t> <t><xref target="pseudo-hp" format="default"/> shows a sample algorithm for applying header protection. Removing header protection only differs in the order in which the packet number length (pn_length) is determined (here "^" is used to represent exclusiveor).</t>OR).</t> <figure anchor="pseudo-hp"> <name>Header Protection Pseudocode</name><artwork name="" type="" align="left" alt=""><![CDATA[<sourcecode type="pseudocode"><![CDATA[ mask = header_protection(hp_key, sample) pn_length = (packet[0] & 0x03) + 1 if (packet[0] & 0x80) == 0x80: # Long header: 4 bits masked packet[0] ^= mask[0] & 0x0f else: # Short header: 5 bits masked packet[0] ^= mask[0] & 0x1f # pn_offset is the start of the Packet Number field. packet[pn_offset:pn_offset+pn_length] ^= mask[1:1+pn_length]]]></artwork>]]></sourcecode> </figure> <t>Specific header protection functions are defined based on the selected cipher suite; see <xref target="hp-aes" format="default"/> and <xref target="hp-chacha" format="default"/>.</t> <t><xref target="fig-sample" format="default"/> shows an example long header packet (Initial) and a short header packet (1-RTT). <xref target="fig-sample" format="default"/> shows the fields in each header that are covered by header protection and the portion of the protected packet payload that is sampled.</t> <figure anchor="fig-sample"> <name>Header Protection and Ciphertext Sample</name> <artwork name="" type="" align="left" alt=""><![CDATA[ Initial Packet { Header Form (1) = 1, Fixed Bit (1) = 1, Long Packet Type (2) = 0, Reserved Bits (2), # Protected Packet Number Length (2), # Protected Version (32), DCID Len (8), Destination Connection ID (0..160), SCID Len (8), Source Connection ID (0..160), Token Length (i), Token (..), Length (i), Packet Number (8..32), # Protected Protected Payload (0..24), # Skipped Part Protected Payload (128), # Sampled Part Protected Payload (..) # Remainder } 1-RTT Packet { Header Form (1) = 0, Fixed Bit (1) = 1, Spin Bit (1), Reserved Bits (2), # Protected Key Phase (1), # Protected Packet Number Length (2), # Protected Destination Connection ID (0..160), Packet Number (8..32), # Protected Protected Payload (0..24), # Skipped Part Protected Payload (128), # Sampled Part Protected Payload (..), # Remainder } ]]></artwork> </figure> <t>Before a TLS cipher suite can be used with QUIC, a header protection algorithmMUST<bcp14>MUST</bcp14> be specified for the AEAD used with that cipher suite. This document defines algorithms for AEAD_AES_128_GCM, AEAD_AES_128_CCM, AEAD_AES_256_GCM (all these AES AEADs are defined in <xref target="AEAD" format="default"/>), and AEAD_CHACHA20_POLY1305 (defined in <xref target="CHACHA" format="default"/>). Prior to TLS selecting a cipher suite, AES header protection is used (<xref target="hp-aes" format="default"/>), matching the AEAD_AES_128_GCM packet protection.</t> </section> <section anchor="hp-sample" numbered="true" toc="default"> <name>Header Protection Sample</name> <t>The header protection algorithm uses both the header protection key and a sample of the ciphertext from the packet Payload field.</t> <t>The same number of bytes are always sampled, but an allowance needs to be made for theendpoint removing protection,removal of protection by a receiving endpoint, which will not know the length of the Packet Number field. The sample of ciphertext is taken starting from an offset of 4 bytes after the start of the Packet Number field. That is, in sampling packet ciphertext for header protection, the Packet Number field is assumed to be 4 bytes long (its maximum possible encoded length).</t> <t>An endpointMUST<bcp14>MUST</bcp14> discard packets that are not long enough to contain a complete sample.</t> <t>To ensure that sufficient data is available for sampling, packets are padded so that the combined lengths of the encoded packet number and protected payload is at least 4 bytes longer than the sample required for header protection. The cipher suites defined in <xref target="TLS13" format="default"/>--- other than TLS_AES_128_CCM_8_SHA256, for which a header protection scheme is not defined in this document--- have 16-byte expansions and 16-byte header protection samples. This results in needing at least 3 bytes of frames in the unprotected payload if the packet number is encoded on a single byte, or 2 bytes of frames for a 2-byte packet number encoding.</t> <t>The sampled ciphertext can be determined by the following pseudocode:</t><artwork name="" type="" align="left" alt=""><![CDATA[<sourcecode type="pseudocode"><![CDATA[ # pn_offset is the start of the Packet Number field. sample_offset = pn_offset + 4 sample = packet[sample_offset..sample_offset+sample_length]]]></artwork> <t>where]]></sourcecode> <t>Where the packet number offset of a short header packet can be calculated as:</t><artwork name="" type="" align="left" alt=""><![CDATA[<sourcecode type="pseudocode"><![CDATA[ pn_offset = 1 + len(connection_id)]]></artwork> <t>and]]></sourcecode> <t>And the packet number offset of a long header packet can be calculated as:</t><artwork name="" type="" align="left" alt=""><![CDATA[<sourcecode type="pseudocode"><![CDATA[ pn_offset = 7 + len(destination_connection_id) + len(source_connection_id) + len(payload_length) if packet_type == Initial: pn_offset += len(token_length) + len(token)]]></artwork>]]></sourcecode> <t>For example, for a packet with a short header, an 8-byte connection ID, and protected with AEAD_AES_128_GCM, the sample takes bytes 13 to 28 inclusive (using zero-based indexing).</t> <t>Multiple QUIC packets might be included in the same UDP datagram. Each packet is handled separately.</t> </section> <section anchor="hp-aes" numbered="true" toc="default"> <name>AES-Based Header Protection</name> <t>This section defines the packet protection algorithm for AEAD_AES_128_GCM, AEAD_AES_128_CCM, and AEAD_AES_256_GCM. AEAD_AES_128_GCM and AEAD_AES_128_CCM use 128-bit AES inelectronic code-bookElectronic Codebook (ECB) mode. AEAD_AES_256_GCM uses 256-bit AES in ECB mode. AES is defined in <xref target="AES" format="default"/>.</t> <t>This algorithm samples 16 bytes from the packet ciphertext. This value is used as the input to AES-ECB. In pseudocode, the header protection function is defined as:</t><artwork name="" type="" align="left" alt=""><![CDATA[<sourcecode type="pseudocode"><![CDATA[ header_protection(hp_key, sample): mask = AES-ECB(hp_key, sample)]]></artwork>]]></sourcecode> </section> <section anchor="hp-chacha" numbered="true" toc="default"> <name>ChaCha20-Based Header Protection</name> <t>When AEAD_CHACHA20_POLY1305 is in use, header protection uses the raw ChaCha20 function as defined inSection 2.4 of<xref section="2.4" sectionFormat="of" target="CHACHA" format="default"/>. This uses a 256-bit key and 16 bytes sampled from the packet protection output.</t> <t>The first 4 bytes of the sampled ciphertext are the block counter. A ChaCha20 implementation could take a 32-bit integer in place of a byte sequence, in whichcasecase, the byte sequence is interpreted as a little-endian value.</t> <t>The remaining 12 bytes are used as the nonce. A ChaCha20 implementation might take an array of three 32-bit integers in place of a byte sequence, in whichcasecase, the nonce bytes are interpreted as a sequence of 32-bit little-endian integers.</t> <t>The encryption mask is produced by invoking ChaCha20 to protect 5 zero bytes. In pseudocode, the header protection function is defined as:</t><artwork name="" type="" align="left" alt=""><![CDATA[<sourcecode type="pseudocode"><![CDATA[ header_protection(hp_key, sample): counter = sample[0..3] nonce = sample[4..15] mask = ChaCha20(hp_key, counter, nonce, {0,0,0,0,0})]]></artwork>]]></sourcecode> </section> </section> <section anchor="receiving-protected-packets" numbered="true" toc="default"> <name>Receiving Protected Packets</name> <t>Once an endpoint successfully receives a packet with a given packet number, itMUST<bcp14>MUST</bcp14> discard all packets in the same packet number space with higher packet numbers if they cannot be successfully unprotected with either the same key, or--- if there is a key update--- a subsequent packet protection key; see <xref target="key-update" format="default"/>. Similarly, a packet that appears to trigger a keyupdate,update but cannot be unprotected successfullyMUST<bcp14>MUST</bcp14> be discarded.</t> <t>Failure to unprotect a packet does not necessarily indicate the existence of a protocol error in a peer or an attack. The truncated packet number encoding used in QUIC can cause packet numbers to be decoded incorrectly if they are delayed significantly.</t> </section> <section anchor="using-early-data" numbered="true" toc="default"> <name>Use of 0-RTT Keys</name> <t>If 0-RTT keys are available (see <xref target="enable-0rtt" format="default"/>), the lack of replay protection means that restrictions on their use are necessary to avoid replay attacks on the protocol.</t> <t>Of the frames defined in <xref target="QUIC-TRANSPORT" format="default"/>, the STREAM, RESET_STREAM, STOP_SENDING, and CONNECTION_CLOSE frames are potentially unsafe for use with 0-RTT as they carry application data. Application data that is received in 0-RTT could cause an application at the server to process the data multiple times rather than just once. Additional actions taken by a server as a result of processing replayed application data could have unwanted consequences. A client thereforeMUST NOT<bcp14>MUST NOT</bcp14> use 0-RTT for application data unless specifically requested by the application that is in use.</t> <t>An application protocol that uses QUICMUST<bcp14>MUST</bcp14> include a profile that defines acceptable use of 0-RTT; otherwise, 0-RTT can only be used to carry QUIC frames that do not carry application data. For example, a profile for HTTP is described in <xref target="HTTP-REPLAY" format="default"/> and used for HTTP/3; seeSection 10.9 of<xref section="10.9" sectionFormat="of" target="QUIC-HTTP" format="default"/>.</t> <t>Though replaying packets might result in additional connection attempts, the effect of processing replayed frames that do not carry application data is limited to changing the state of the affected connection. A TLS handshake cannot be successfully completed using replayed packets.</t> <t>A clientMAY<bcp14>MAY</bcp14> wish to apply additional restrictions on what data it sends prior to the completion of the TLS handshake.</t> <t>A client otherwise treats 0-RTT keys as equivalent to 1-RTT keys, except that it cannot send certain frames with 0-RTT keys; seeSection 12.5 of<xref section="12.5" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>.</t> <t>A client that receives an indication that its 0-RTT data has been accepted by a server can send 0-RTT data until it receives all of the server's handshake messages. A clientSHOULD<bcp14>SHOULD</bcp14> stop sending 0-RTT data if it receives an indication that 0-RTT data has been rejected.</t> <t>A serverMUST NOT<bcp14>MUST NOT</bcp14> use 0-RTT keys to protect packets; it uses 1-RTT keys to protect acknowledgments of 0-RTT packets. A clientMUST NOT<bcp14>MUST NOT</bcp14> attempt to decrypt 0-RTT packets it receives and insteadMUST<bcp14>MUST</bcp14> discard them.</t> <t>Once a client has installed 1-RTT keys, itMUST NOT<bcp14>MUST NOT</bcp14> send any more 0-RTT packets.</t><dl> <dt> Note: </dt> <dd> <t>0-RTT<aside> <t>Note: 0-RTT data can be acknowledged by the server as it receives it, but any packets containing acknowledgments of 0-RTT data cannot have packet protection removed by the client until the TLS handshake is complete. The 1-RTT keys necessary to remove packet protection cannot be derived until the client receives all server handshake messages.</t></dd> </dl></aside> </section> <section anchor="pre-hs-protected" numbered="true" toc="default"> <name>Receiving Out-of-Order Protected Packets</name> <t>Due to reordering and loss, protected packets might be received by an endpoint before the final TLS handshake messages are received. A client will be unable to decrypt 1-RTT packets from the server, whereas a server will be able to decrypt 1-RTT packets from the client. Endpoints in either roleMUST NOT<bcp14>MUST NOT</bcp14> decrypt 1-RTT packets from their peer prior to completing the handshake.</t> <t>Even though 1-RTT keys are available to a server after receiving the first handshake messages from a client, it is missing assurances on the client state:</t> <ul spacing="normal"> <li>The client is not authenticated, unless the server has chosen to use a pre-shared key and validated the client's pre-shared key binder; seeSection 4.2.11 of<xref section="4.2.11" sectionFormat="of" target="TLS13" format="default"/>.</li> <li>The client has not demonstrated liveness, unless the server has validated the client's address with a Retry packet or other means; seeSection 8.1 of<xref section="8.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>.</li> <li>Any received 0-RTT data that the server responds to might be due to a replay attack.</li> </ul> <t>Therefore, the server's use of 1-RTT keys before the handshake is complete is limited to sending data. A serverMUST NOT<bcp14>MUST NOT</bcp14> process incoming 1-RTT protected packets before the TLS handshake is complete. Because sending acknowledgments indicates that all frames in a packet have been processed, a server cannot send acknowledgments for 1-RTT packets until the TLS handshake is complete. Received packets protected with 1-RTT keysMAY<bcp14>MAY</bcp14> be stored and later decrypted and used once the handshake is complete.</t><dl> <dt> Note: </dt> <dd> <t>TLS<aside> <t>Note: TLS implementations might provide all 1-RTT secrets prior to handshake completion. Even where QUIC implementations have 1-RTT read keys, those keys are not to be used prior to completing the handshake.</t></dd> </dl></aside> <t>The requirement for the server to wait for the client Finished message creates a dependency on that message being delivered. A client can avoid the potential for head-of-line blocking that this implies by sending its 1-RTT packets coalesced with a Handshake packet containing a copy of the CRYPTO frame that carries the Finished message, until one of the Handshake packets is acknowledged. This enables immediate server processing for those packets.</t> <t>A server could receive packets protected with 0-RTT keys prior to receiving a TLS ClientHello. The serverMAY<bcp14>MAY</bcp14> retain these packets for later decryption in anticipation of receiving a ClientHello.</t> <t>A client generally receives 1-RTT keys at the same time as the handshake completes. Even if it has 1-RTT secrets, a clientMUST NOT<bcp14>MUST NOT</bcp14> process incoming 1-RTT protected packets before the TLS handshake is complete.</t> </section> <section anchor="retry-integrity" numbered="true" toc="default"> <name>Retry Packet Integrity</name> <t>Retry packets (seethe Retry Packet section of<xref section="17.2.5" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>) carry a Retry Integrity Tag that provides two properties: it allows the discarding of packets that have accidentally been corrupted by thenetwork;network, and only an entity that observes an Initial packet can send a valid Retry packet.</t> <t>The Retry Integrity Tag is a 128-bit field that is computed as the output of AEAD_AES_128_GCM(<xref<xref target="AEAD"format="default"/>)format="default"/> used with the following inputs:</t> <ul spacing="normal"> <li>The secret key, K, is 128 bits equal to 0xbe0c690b9f66575a1d766b54e368c84e.</li> <li>The nonce, N, is 96 bits equal to 0x461599d35d632bf2239825bb.</li> <li>The plaintext, P, is empty.</li> <li>The associated data, A, is the contents of the Retry Pseudo-Packet, as illustrated in <xref target="retry-pseudo" format="default"/>:</li> </ul> <t>The secret key and the nonce are values derived by calling HKDF-Expand-Label using 0xd9c9943e6101fd200021506bcc02814c73030f25c79d71ce876eca876e6fca8e as the secret, with labels being "quic key" and "quic iv" (<xref target="protection-keys" format="default"/>).</t> <figure anchor="retry-pseudo"> <name>Retry Pseudo-Packet</name> <artwork name="" type="" align="left" alt=""><![CDATA[ Retry Pseudo-Packet { ODCID Length (8), Original Destination Connection ID (0..160), Header Form (1) = 1, Fixed Bit (1) = 1, Long Packet Type (2) = 3, Unused (4), Version (32), DCID Len (8), Destination Connection ID (0..160), SCID Len (8), Source Connection ID (0..160), Retry Token (..), } ]]></artwork> </figure> <t>The Retry Pseudo-Packet is not sent over the wire. It is computed by taking the transmitted Retry packet, removing the Retry IntegrityTagTag, and prepending the two following fields:</t> <dl><dt> ODCID Length: </dt><dt>ODCID Length:</dt> <dd> <t>The ODCID Length field contains the length in bytes of the Original Destination Connection ID field that follows it, encoded as an 8-bit unsigned integer.</t> </dd><dt> Original<dt>Original Destination ConnectionID: </dt>ID:</dt> <dd> <t>The Original Destination Connection ID contains the value of the Destination Connection ID from the Initial packet that this Retry is in response to. The length of this field is given in ODCID Length. The presence of this field ensures that a valid Retry packet can only be sent by an entity that observes the Initial packet.</t> </dd> </dl> </section> </section> <section anchor="key-update" numbered="true" toc="default"> <name>Key Update</name> <t>Once the handshake is confirmed (see <xref target="handshake-confirmed" format="default"/>), an endpointMAY<bcp14>MAY</bcp14> initiate a key update.</t> <t>The Key Phase bit indicates which packet protection keys are used to protect the packet. The Key Phase bit is initially set to 0 for the first set of 1-RTT packets and toggled to signal each subsequent key update.</t> <t>The Key Phase bit allows a recipient to detect a change in keying material without needing to receive the first packet that triggered the change. An endpoint that notices a changed Key Phase bit updates keys and decrypts the packet that contains the changed value.</t> <t>Initiating a key update results in both endpoints updating keys. This differs from TLS where endpoints can update keys independently.</t> <t>This mechanism replaces the key update mechanism of TLS, which relies on KeyUpdate messages sent using 1-RTT encryption keys. EndpointsMUST NOT<bcp14>MUST NOT</bcp14> send a TLS KeyUpdate message. EndpointsMUST<bcp14>MUST</bcp14> treat the receipt of a TLS KeyUpdate message as a connection error of type0x10a,0x010a, equivalent to a fatal TLS alert of unexpected_message; see <xref target="tls-errors" format="default"/>.</t> <t><xref target="ex-key-update" format="default"/> shows a key update process, where the initial set of keys used (identified with @M) are replaced by updated keys (identified with @N). The value of the Key Phase bit is indicated in brackets [].</t> <figure anchor="ex-key-update"> <name>Key Update</name> <artwork name="" type="" align="left" alt=""><![CDATA[ Initiating Peer Responding Peer @M [0] QUIC Packets ... Update to @N @N [1] QUIC Packets --------> Update to @N ... QUIC Packets [1] @N <-------- QUIC Packets [1] @N containing ACK <-------- ... Key Update Permitted @N [1] QUIC Packets containing ACK for @N packets --------> Key Update Permitted ... ]]></artwork> </figure> <section anchor="key-update-initiate" numbered="true" toc="default"> <name>Initiating a Key Update</name> <t>Endpoints maintain separate read and write secrets for packet protection. An endpoint initiates a key update by updating its packet protection write secret and using that to protect new packets. The endpoint creates a new write secret from the existing write secret as performed inSection 7.2 of<xref section="7.2" sectionFormat="of" target="TLS13" format="default"/>. This uses the KDF function provided by TLS with a label of "quic ku". The corresponding key and IV are created from that secret as defined in <xref target="protection-keys" format="default"/>. The header protection key is not updated.</t> <t>For example, to update write keys with TLS 1.3, HKDF-Expand-Label is used as:</t><artwork name="" type="" align="left" alt=""><![CDATA[<sourcecode type="pseudocode"><![CDATA[ secret_<n+1> = HKDF-Expand-Label(secret_<n>, "quic ku", "", Hash.length)]]></artwork>]]></sourcecode> <t>The endpoint toggles the value of the Key Phase bit and uses the updated key and IV to protect all subsequent packets.</t> <t>An endpointMUST NOT<bcp14>MUST NOT</bcp14> initiate a key update prior to having confirmed the handshake (<xref target="handshake-confirmed" format="default"/>). An endpointMUST NOT<bcp14>MUST NOT</bcp14> initiate a subsequent key update unless it has received an acknowledgment for a packet that was sent protected with keys from the current key phase. This ensures that keys are available to both peers before another key update can be initiated. This can be implemented by tracking the lowest packet number sent with each keyphase,phase and the highest acknowledged packet number in the 1-RTT space: once the latter is higher than or equal to the former, another key update can be initiated.</t><dl> <dt> Note: </dt> <dd> <t>Keys<aside> <t>Note: Keys of packets other than the 1-RTT packets are never updated; their keys are derived solely from the TLS handshake state.</t></dd> </dl></aside> <t>The endpoint that initiates a key update also updates the keys that it uses for receiving packets. These keys will be needed to process packets the peer sends after updating.</t> <t>An endpointMUST<bcp14>MUST</bcp14> retain old keys until it has successfully unprotected a packet sent using the new keys. An endpointSHOULD<bcp14>SHOULD</bcp14> retain old keys for some time after unprotecting a packet sent using the new keys. Discarding old keys too early can cause delayed packets to be discarded. Discarding packets will be interpreted as packet loss by the peer and could adversely affect performance.</t> </section> <section anchor="responding-to-a-key-update" numbered="true" toc="default"> <name>Responding to a Key Update</name> <t>A peer is permitted to initiate a key update after receiving an acknowledgment of a packet in the current key phase. An endpoint detects a key update when processing a packet with a key phase that differs from the value used to protect the last packet it sent. To process this packet, the endpoint uses the next packet protection key and IV. See <xref target="receive-key-generation" format="default"/> for considerations about generating these keys.</t> <t>If a packet is successfully processed using the next key and IV, then the peer has initiated a key update. The endpointMUST<bcp14>MUST</bcp14> update its send keys to the corresponding key phase in response, as described in <xref target="key-update-initiate" format="default"/>. Sending keysMUST<bcp14>MUST</bcp14> be updated before sending an acknowledgment for the packet that was received with updated keys. By acknowledging the packet that triggered the key update in a packet protected with the updated keys, the endpoint signals that the key update is complete.</t> <t>An endpoint can defer sending the packet or acknowledgment according to its normal packet sendingbehaviour;behavior; it is not necessary to immediately generate a packet in response to a key update. The next packet sent by the endpoint will use the updated keys. The next packet that contains an acknowledgment will cause the key update to be completed. If an endpoint detects a second update before it has sent any packets with updated keys containing an acknowledgment for the packet that initiated the key update, it indicates that its peer has updated keys twice without awaiting confirmation. An endpointMAY<bcp14>MAY</bcp14> treat such consecutive key updates as a connection error of type KEY_UPDATE_ERROR.</t> <t>An endpoint that receives an acknowledgment that is carried in a packet protected with old keys where any acknowledged packet was protected with newer keysMAY<bcp14>MAY</bcp14> treat that as a connection error of type KEY_UPDATE_ERROR. This indicates that a peer has received and acknowledged a packet that initiates a key update, but has not updated keys in response.</t> </section> <section anchor="receive-key-generation" numbered="true" toc="default"> <name>Timing of Receive Key Generation</name> <t>Endpoints responding to an apparent key updateMUST NOT<bcp14>MUST NOT</bcp14> generate a timing side-channel signal that might indicate that the Key Phase bit was invalid (see <xreftarget="header-protect-analysis"target="hp-side-channel" format="default"/>). Endpoints can usedummyrandomized packet protection keys in place of discarded keys when key updates are not yet permitted. Usingdummyrandomized keyswill generate no variation in the timing signal produced byensures that attempting to remove packetprotection,protection does not result in timing variations, and results inallpackets with an invalid Key Phase bit being rejected.</t> <t>The process of creating new packet protection keys for receiving packets could reveal that a key update has occurred. An endpointMAY<bcp14>MAY</bcp14> generate new keys as part of packet processing, but this creates a timing signal that could be used by an attacker to learn when key updates happen and thus leak the value of the Key Phase bit.</t> <t>Endpoints are generally expected to have current and next receive packet protection keys available. For a short period after a key update completes, up to the PTO, endpointsMAY<bcp14>MAY</bcp14> defer generation of the next set of receive packet protection keys. This allows endpoints to retain only two sets of receive keys; see <xref target="old-keys-recv" format="default"/>.</t> <t>Once generated, the next set of packet protection keysSHOULD<bcp14>SHOULD</bcp14> be retained, even if the packet that was received was subsequently discarded. Packets containing apparent key updates are easy toforgeforge, and-while the process of key update does not require significanteffort -effort, triggering this process could be used by an attacker for DoS.</t> <t>For this reason, endpointsMUST<bcp14>MUST</bcp14> be able to retain two sets of packet protection keys for receiving packets: the current and the next. Retaining the previous keys in addition to these might improve performance, but this is not essential.</t> </section> <section anchor="old-keys-send" numbered="true" toc="default"> <name>Sending with Updated Keys</name> <t>An endpoint never sends packets that are protected with old keys. Only the current keys are used. Keys used for protecting packets can be discarded immediately after switching to newer keys.</t> <t>Packets with higher packet numbersMUST<bcp14>MUST</bcp14> be protected with either the same or newer packet protection keys than packets with lower packet numbers. An endpoint that successfully removes protection with old keys when newer keys were used for packets with lower packet numbersMUST<bcp14>MUST</bcp14> treat this as a connection error of type KEY_UPDATE_ERROR.</t> </section> <section anchor="old-keys-recv" numbered="true" toc="default"> <name>Receiving with Different Keys</name> <t>For receiving packets during a key update, packets protected with older keys might arrive if they were delayed by the network. Retaining old packet protection keys allows these packets to be successfully processed.</t> <t>As packets protected with keys from the next key phase use the same Key Phase value as those protected with keys from the previous key phase, it is necessary to distinguish between thetwo,two if packets protected with old keys are to be processed. This can be done using packet numbers. A recovered packet number that is lower than any packet number from the current key phase uses the previous packet protection keys; a recovered packet number that is higher than any packet number from the current key phase requires the use of the next packet protection keys.</t> <t>Some care is necessary to ensure that any process for selecting between previous, current, and next packet protection keys does not expose a timing side channel that might reveal which keys were used to remove packet protection. See <xref target="hp-side-channel" format="default"/> for more information.</t> <t>Alternatively, endpoints can retain only two sets of packet protection keys, swapping previous for next after enough time has passed to allow for reordering in the network. In this case, the Key Phase bit alone can be used to select keys.</t> <t>An endpointMAY<bcp14>MAY</bcp14> allow a period of approximately the Probe Timeout (PTO; see <xref target="QUIC-RECOVERY" format="default"/>) after promoting the next set of receive keys to be current before it creates the subsequent set of packet protection keys. These updated keysMAY<bcp14>MAY</bcp14> replace the previous keys at that time. With the caveat that PTO is a subjective measure--- that is, a peer could have a different view of the RTT--- this time is expected to be long enough that any reordered packets would be declared lost by a peer even if they were acknowledged and short enough to allow a peer to initiate further key updates.</t> <t>Endpoints need to allow for the possibility that a peer might not be able to decrypt packets that initiate a key update during the period when the peer retains old keys. EndpointsSHOULD<bcp14>SHOULD</bcp14> wait three times the PTO before initiating a key update after receiving an acknowledgment that confirms that the previous key update was received. Failing to allow sufficient time could lead to packets being discarded.</t> <t>An endpointSHOULD<bcp14>SHOULD</bcp14> retain old read keys for no more than three times the PTO after having received a packet protected using the new keys. After this period, old read keys and their corresponding secretsSHOULD<bcp14>SHOULD</bcp14> be discarded.</t> </section> <section anchor="aead-limits" numbered="true" toc="default"> <name>Limits on AEAD Usage</name> <t>This document sets usage limits for AEAD algorithms to ensure that overuse does not give an adversary a disproportionate advantage in attacking the confidentiality and integrity of communications when using QUIC.</t> <t>The usage limits defined in TLS 1.3 exist for protection against attacks on confidentiality and apply to successful applications of AEAD protection. The integrity protections in authenticated encryption also depend on limiting the number of attempts to forge packets. TLS achieves this by closing connections after any record fails an authentication check. In comparison, QUIC ignores any packet that cannot be authenticated, allowing multiple forgery attempts.</t> <t>QUIC accounts for AEAD confidentiality and integrity limits separately. The confidentiality limit applies to the number of packets encrypted with a given key. The integrity limit applies to the number of packets decrypted within a given connection. Details on enforcing these limits for each AEAD algorithm follow below.</t> <t>EndpointsMUST<bcp14>MUST</bcp14> count the number of encrypted packets for each set of keys. If the total number of encrypted packets with the same key exceeds the confidentiality limit for the selected AEAD, the endpointMUST<bcp14>MUST</bcp14> stop using those keys. EndpointsMUST<bcp14>MUST</bcp14> initiate a key update before sending more protected packets than the confidentiality limit for the selected AEAD permits. If a key update is not possible or integrity limits are reached, the endpointMUST<bcp14>MUST</bcp14> stop using the connection and only send stateless resets in response to receiving packets. It isRECOMMENDED<bcp14>RECOMMENDED</bcp14> that endpoints immediately close the connection with a connection error of type AEAD_LIMIT_REACHED before reaching a state where key updates are not possible.</t> <t>For AEAD_AES_128_GCM and AEAD_AES_256_GCM, the confidentiality limit is2^232<sup>23</sup> encrypted packets; see <xref target="gcm-bounds" format="default"/>. For AEAD_CHACHA20_POLY1305, the confidentiality limit is greater than the number of possible packets(2^62)(2<sup>62</sup>) and so can be disregarded. For AEAD_AES_128_CCM, the confidentiality limit is2^21.52<sup>21.5</sup> encrypted packets; see <xref target="ccm-bounds" format="default"/>. Applying a limit reduces the probability that an attacker can distinguish the AEAD in use from a random permutation; see <xref target="AEBounds" format="default"/>, <xref target="ROBUST" format="default"/>, and <xref target="GCM-MU" format="default"/>.</t> <t>In addition to counting packets sent, endpointsMUST<bcp14>MUST</bcp14> count the number of received packets that fail authentication during the lifetime of a connection. If the total number of received packets that fail authentication within the connection, across all keys, exceeds the integrity limit for the selected AEAD, the endpointMUST<bcp14>MUST</bcp14> immediately close the connection with a connection error of type AEAD_LIMIT_REACHED and not process any more packets.</t> <t>For AEAD_AES_128_GCM and AEAD_AES_256_GCM, the integrity limit is2^522<sup>52</sup> invalid packets; see <xref target="gcm-bounds" format="default"/>. For AEAD_CHACHA20_POLY1305, the integrity limit is2^362<sup>36</sup> invalid packets; see <xref target="AEBounds" format="default"/>. For AEAD_AES_128_CCM, the integrity limit is2^21.52<sup>21.5</sup> invalid packets; see <xref target="ccm-bounds" format="default"/>. Applying this limit reduces the probability that an attacker can successfully forge a packet; see <xref target="AEBounds" format="default"/>, <xref target="ROBUST" format="default"/>, and <xref target="GCM-MU" format="default"/>.</t> <t>Endpoints that limit the size of packetsMAY<bcp14>MAY</bcp14> use higher confidentiality and integrity limits; see <xref target="aead-analysis" format="default"/> for details.</t> <t>Future analyses and specificationsMAY<bcp14>MAY</bcp14> relax confidentiality or integrity limits for an AEAD.</t> <t>Any TLS cipher suite that is specified for use with QUICMUST<bcp14>MUST</bcp14> define limits on the use of the associated AEAD function that preserves margins for confidentiality and integrity. That is, limitsMUST<bcp14>MUST</bcp14> be specified for the number of packets that can be authenticated and for the number of packets that can fail authentication. Providing a reference to any analysis upon which values are based--- and any assumptions used in that analysis--- allows limits to be adapted to varying usage conditions.</t> </section> <section anchor="key-update-error" numbered="true" toc="default"> <name>Key Update Error Code</name> <t>The KEY_UPDATE_ERROR error code(0xe)(0x0e) is used to signal errors related to key updates.</t> </section> </section> <section anchor="security-of-initial-messages" numbered="true" toc="default"> <name>Security of Initial Messages</name> <t>Initial packets are not protected with a secret key, so they are subject to potential tampering by an attacker. QUIC provides protection against attackers that cannot readpackets,packets but does not attempt to provide additional protection against attacks where the attacker can observe and inject packets. Some forms of tampering -- such as modifying the TLS messages themselves -- are detectable, but some -- such as modifying ACKs -- are not.</t> <t>For example, an attacker could inject a packet containing an ACK framethat makesto make it appear that a packet had not been received or to create a false impression of the state of the connection (e.g., by modifying the ACK Delay). Note that such a packet could cause a legitimate packet to be dropped as a duplicate. ImplementationsSHOULD<bcp14>SHOULD</bcp14> use caution in relying on any data that is contained in Initial packets that is not otherwise authenticated.</t> <t>It is also possible for the attacker to tamper with data that is carried in Handshake packets, but because that sort of tampering requires modifying TLS handshake messages,thatany such tampering will cause the TLS handshake to fail.</t> </section> <section anchor="quic-specific-adjustments-to-the-tls-handshake" numbered="true" toc="default"> <name>QUIC-Specific Adjustments to the TLS Handshake</name> <t>Certain aspects of the TLS handshake are different when used with QUIC.</t> <t>QUIC also requires additional features from TLS. In addition to negotiation of cryptographic parameters, the TLS handshake carries and authenticates values for QUIC transport parameters.</t> <section anchor="protocol-negotiation" numbered="true" toc="default"> <name>Protocol Negotiation</name> <t>QUIC requires that the cryptographic handshake provide authenticated protocol negotiation. TLS usesApplication LayerApplication-Layer Protocol Negotiation(<xref<xref target="ALPN"format="default"/>)format="default"/> to select an application protocol. Unless another mechanism is used for agreeing on an application protocol, endpointsMUST<bcp14>MUST</bcp14> use ALPN for this purpose.</t> <t>When using ALPN, endpointsMUST<bcp14>MUST</bcp14> immediately close a connection (seeSection 10.2 of<xref section="10.2" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>) with a no_application_protocol TLS alert (QUIC error code0x178;0x0178; see <xref target="tls-errors" format="default"/>) if an application protocol is not negotiated. While <xref target="ALPN" format="default"/> only specifies that servers use this alert, QUIC clientsMUST<bcp14>MUST</bcp14> use error0x1780x0178 to terminate a connection when ALPN negotiation fails.</t> <t>An application protocolMAY<bcp14>MAY</bcp14> restrict the QUIC versions that it can operate over. ServersMUST<bcp14>MUST</bcp14> select an application protocol compatible with the QUIC version that the client has selected. The serverMUST<bcp14>MUST</bcp14> treat the inability to select a compatible application protocol as a connection error of type0x1780x0178 (no_application_protocol). Similarly, a clientMUST<bcp14>MUST</bcp14> treat the selection of an incompatible application protocol by a server as a connection error of type0x178.</t>0x0178.</t> </section> <section anchor="quic_parameters" numbered="true" toc="default"> <name>QUIC Transport Parameters Extension</name> <t>QUIC transport parameters are carried in a TLS extension. Different versions of QUIC might define a different method for negotiating transport configuration.</t> <t>Including transport parameters in the TLS handshake provides integrity protection for these values.</t><artwork name="" type="" align="left" alt=""><![CDATA[<sourcecode type="tls-presentation"><![CDATA[ enum { quic_transport_parameters(0x39), (65535) } ExtensionType;]]></artwork>]]></sourcecode> <t>The extension_data field of the quic_transport_parameters extension contains a value that is defined by the version of QUIC that is in use.</t> <t>The quic_transport_parameters extension is carried in the ClientHello and the EncryptedExtensions messages during the handshake. EndpointsMUST<bcp14>MUST</bcp14> send the quic_transport_parameters extension; endpoints that receive ClientHello or EncryptedExtensions messages without the quic_transport_parameters extensionMUST<bcp14>MUST</bcp14> close the connection with an error of type0x16d0x016d (equivalent to a fatal TLS missing_extension alert, see <xref target="tls-errors" format="default"/>).</t> <t>Transport parameters become available prior to the completion of the handshake. A server might use these values earlier than handshake completion. However, the value of transport parameters is not authenticated until the handshake completes, so any use of these parameters cannot depend on their authenticity. Any tampering with transport parameters will cause the handshake to fail.</t> <t>EndpointsMUST NOT<bcp14>MUST NOT</bcp14> send this extension in a TLS connection that does not use QUIC (such as the use of TLS with TCP defined in <xref target="TLS13" format="default"/>). A fatal unsupported_extension alertMUST<bcp14>MUST</bcp14> be sent by an implementation that supports this extension if the extension is received when the transport is not QUIC.</t> <t>Negotiating the quic_transport_parameters extension causes the EndOfEarlyData to be removed; see <xref target="remove-eoed" format="default"/>.</t> </section> <section anchor="remove-eoed" numbered="true" toc="default"> <name>Removing the EndOfEarlyData Message</name> <t>The TLS EndOfEarlyData message is not used with QUIC. QUIC does not rely on this message to mark the end of 0-RTT data or to signal the change to Handshake keys.</t> <t>ClientsMUST NOT<bcp14>MUST NOT</bcp14> send the EndOfEarlyData message. A serverMUST<bcp14>MUST</bcp14> treat receipt of a CRYPTO frame in a 0-RTT packet as a connection error of type PROTOCOL_VIOLATION.</t> <t>As a result, EndOfEarlyData does not appear in the TLS handshake transcript.</t> </section> <section anchor="compat-mode" numbered="true" toc="default"> <name>Prohibit TLS Middlebox Compatibility Mode</name> <t>Appendix D.4 of <xref target="TLS13" format="default"/> describes an alteration to the TLS 1.3 handshake as a workaround for bugs in some middleboxes. The TLS 1.3 middlebox compatibility mode involves setting the legacy_session_id field to a 32-byte value in the ClientHello and ServerHello, then sending a change_cipher_spec record. Both field and record carry no semantic content and are ignored.</t> <t>This mode has no use in QUIC as it only applies to middleboxes that interfere with TLS over TCP. QUIC also provides no means to carry a change_cipher_spec record. A clientMUST NOT<bcp14>MUST NOT</bcp14> request the use of the TLS 1.3 compatibility mode. A serverSHOULD<bcp14>SHOULD</bcp14> treat the receipt of a TLS ClientHello with a non-empty legacy_session_id field as a connection error of type PROTOCOL_VIOLATION.</t> </section> </section> <section anchor="security-considerations" numbered="true" toc="default"> <name>Security Considerations</name> <t>All of the security considerations that apply to TLS also apply to the use of TLS in QUIC. Reading all of <xref target="TLS13" format="default"/> and its appendices is the best way to gain an understanding of the security properties of QUIC.</t> <t>This section summarizes some of the more important security aspects specific to the TLS integration, though there are many security-relevant details in the remainder of the document.</t> <section anchor="session-linkability" numbered="true" toc="default"> <name>Session Linkability</name> <t>Use of TLS session tickets allows servers and possibly other entities to correlate connections made by the same client; see <xref target="resumption" format="default"/> for details.</t> </section> <section anchor="replay" numbered="true" toc="default"> <name>Replay Attacks with 0-RTT</name> <t>As described inSection 8 of<xref section="8" sectionFormat="of" target="TLS13" format="default"/>, use of TLS early data comes with an exposure to replay attack. The use of 0-RTT in QUIC is similarly vulnerable to replay attack.</t> <t>EndpointsMUST<bcp14>MUST</bcp14> implement and use the replay protections described in <xref target="TLS13" format="default"/>, however it is recognized that these protections are imperfect. Therefore, additional consideration of the risk of replay is needed.</t> <t>QUIC is not vulnerable to replay attack, except via the application protocol information it might carry. The management of QUIC protocol state based on the frame types defined in <xref target="QUIC-TRANSPORT" format="default"/> is not vulnerable to replay. Processing of QUIC frames is idempotent and cannot result in invalid connection states if frames are replayed,reorderedreordered, or lost. QUIC connections do not produce effects that last beyond the lifetime of the connection, except for those produced by the application protocol that QUIC serves.</t><dl> <dt> Note: </dt> <dd><t>TLS session tickets and address validation tokens are used to carry QUIC configuration information betweenconnections. Specifically,connections, specifically, to enable a server to efficiently recover state that is used in connection establishment and address validation. TheseMUST NOT<bcp14>MUST NOT</bcp14> be used to communicate application semantics between endpoints; clientsMUST<bcp14>MUST</bcp14> treat them as opaque values. The potential for reuse of these tokens means that they require stronger protections against replay.</t></dd> </dl><t>A server that accepts 0-RTT on a connection incurs a higher cost than accepting a connection without 0-RTT. This includes higher processing and computation costs. Servers need to consider the probability of replay and all associated costs when accepting 0-RTT.</t> <t>Ultimately, the responsibility for managing the risks of replay attacks with 0-RTT lies with an application protocol. An application protocol that uses QUICMUST<bcp14>MUST</bcp14> describe how the protocol uses 0-RTT and the measures that are employed to protect against replay attack. An analysis of replay risk needs to consider all QUIC protocol features that carry application semantics.</t> <t>Disabling 0-RTT entirely is the most effective defense against replay attack.</t> <t>QUIC extensionsMUST<bcp14>MUST</bcp14> either describe how replay attacks affect theiroperation,operation or prohibittheirthe use of the extension in 0-RTT. Application protocolsMUST<bcp14>MUST</bcp14> either prohibit the use of extensions that carry application semantics in 0-RTT or provide replay mitigation strategies.</t> </section> <section anchor="reflection" numbered="true" toc="default"> <name>Packet Reflection Attack Mitigation</name> <t>A small ClientHello that results in a large block of handshake messages from a server can be used in packet reflection attacks to amplify the traffic generated by an attacker.</t> <t>QUIC includes three defenses against this attack. First, the packet containing a ClientHelloMUST<bcp14>MUST</bcp14> be padded to a minimum size. Second, if responding to an unverified source address, the server is forbidden to send more than three times as many bytes as the number of bytes it has received (seeSection 8.1 of<xref section="8.1" sectionFormat="of" target="QUIC-TRANSPORT" format="default"/>). Finally, because acknowledgments of Handshake packets are authenticated, a blind attacker cannot forge them. Put together, these defenses limit the level of amplification.</t> </section> <section anchor="header-protect-analysis" numbered="true" toc="default"> <name>Header Protection Analysis</name> <t><xref target="NAN" format="default"/> analyzes authenticated encryption algorithms that provide nonce privacy, referred to as "Hide Nonce" (HN) transforms. The general header protection construction in this document is one of those algorithms (HN1). Header protection is applied after the packet protection AEAD, sampling a set of bytes (<tt>sample</tt>) from the AEAD output and encrypting the header field using a pseudorandom function (PRF) as follows:</t><artwork name="" type="" align="left" alt=""><![CDATA[<sourcecode type="pseudocode"><![CDATA[ protected_field = field XOR PRF(hp_key, sample)]]></artwork>]]></sourcecode> <t>The header protection variants in this document use a pseudorandom permutation (PRP) in place of a generic PRF. However, since all PRPs are also PRFs <xref target="IMC" format="default"/>, these variants do not deviate from the HN1 construction.</t> <t>As <tt>hp_key</tt> is distinct from the packet protection key, it follows that header protection achieves AE2 security as defined in <xref target="NAN" format="default"/> and therefore guarantees privacy of <tt>field</tt>, the protected packet header. Future header protection variants based on this constructionMUST<bcp14>MUST</bcp14> use a PRF to ensure equivalent security guarantees.</t> <t>Use of the same key and ciphertext sample more than once risks compromising header protection. Protecting two different headers with the same key and ciphertext sample reveals the exclusive OR of the protected fields. Assuming that the AEAD acts as a PRF, if L bits are sampled, the odds of two ciphertext samples being identical approach2^(-L/2),2<sup>-L/2</sup>, that is, the birthday bound. For the algorithms described in this document, that probability is one in2^64.</t>2<sup>64</sup>.</t> <t>To prevent an attacker from modifying packet headers, the header is transitively authenticated using packet protection; the entire packet header is part of the authenticated additional data. Protected fields that are falsified or modified can only be detected once the packet protection is removed.</t> </section> <section anchor="hp-side-channel" numbered="true" toc="default"> <name>Header Protection TimingSide-Channels</name>Side Channels</name> <t>An attacker could guess values for packet numbers or Key Phase and have an endpoint confirm guesses through timing side channels. Similarly, guesses for the packet number length can be tried and exposed. If the recipient of a packet discards packets with duplicate packet numbers without attempting to remove packetprotectionprotection, they could reveal through timingside-channelsside channels that the packet number matches a received packet. For authentication to be free fromside-channels,side channels, the entire process of header protection removal, packet number recovery, and packet protection removalMUST<bcp14>MUST</bcp14> be applied together without timing and otherside-channels.</t>side channels.</t> <t>For the sending of packets, construction and protection of packet payloads and packet numbersMUST<bcp14>MUST</bcp14> be free fromside-channelsside channels that would reveal the packet number or its encoded size.</t> <t>During a key update, the time taken to generate new keys could reveal through timingside-channelsside channels that a key update has occurred. Alternatively, where an attacker injectspacketspackets, thisside-channelside channel could reveal the value of the Key Phase on injected packets. After receiving a key update, an endpointSHOULD<bcp14>SHOULD</bcp14> generate and save the next set of receive packet protection keys, as described in <xref target="receive-key-generation" format="default"/>. By generating new keys before a key update is received, receipt of packets will not create timing signals that leak the value of the Key Phase.</t> <t>This depends on not doing this key generation during packetprocessingprocessing, and it can require that endpoints maintain three sets of packet protection keys for receiving: for the previous key phase, for the current key phase, and for the next key phase. Endpoints can instead choose to defer generation of the next receive packet protection keys until they discard old keys so that only two sets of receive keys need to be retained at any point in time.</t> </section> <section anchor="key-diversity" numbered="true" toc="default"> <name>Key Diversity</name> <t>In using TLS, the central key schedule of TLS is used. As a result of the TLS handshake messages being integrated into the calculation of secrets, the inclusion of the QUIC transport parameters extension ensures that the handshake and 1-RTT keys are not the same as those that might be produced by a server running TLS over TCP. To avoid the possibility of cross-protocol key synchronization, additional measures are provided to improve key separation.</t> <t>The QUIC packet protection keys and IVs are derived using a different label than the equivalent keys in TLS.</t> <t>To preserve this separation, a new version of QUICSHOULD<bcp14>SHOULD</bcp14> define new labels for key derivation for packet protection key and IV, plus the header protection keys. This version of QUIC uses the string "quic". Other versions can use a version-specific label in place of that string.</t> <t>The initial secrets use a key that is specific to the negotiated QUIC version. New QUIC versionsSHOULD<bcp14>SHOULD</bcp14> define a new salt value used in calculating initial secrets.</t> </section> <section anchor="randomness" numbered="true" toc="default"> <name>Randomness</name> <t>QUIC depends on endpoints being able to generate secure random numbers, both directly for protocol values such as the connection ID, and transitively via TLS. See <xref target="RFC4086" format="default"/> for guidance on secure random number generation.</t> </section> </section> <section anchor="iana-considerations" numbered="true" toc="default"> <name>IANA Considerations</name> <t>IANA has registered a codepoint of 57 (or 0x39) for the quic_transport_parameters extension (defined in <xref target="quic_parameters" format="default"/>) in theTLS"TLS ExtensionTypeValues RegistryValues" registry <xref target="TLS-REGISTRIES" format="default"/>.</t> <t>The Recommended column for this extension is marked Yes. The TLS 1.3 Column includes CH (ClientHello) andEE.</t> </section> </middle> <back> <references> <name>References</name> <references> <name>Normative References</name> <reference anchor="QUIC-TRANSPORT"> <front> <title>QUIC: A UDP-Based MultiplexedEE (EncryptedExtensions).</t> <table anchor="iana-tls-ext" align="center"> <name>TLS ExtensionType Values Registry Entry</name> <thead> <tr> <th align="right">Value</th> <th align="left">Extension Name</th> <th align="left">TLS 1.3</th> <th align="left">Recommended</th> <th align="left">Reference</th> </tr> </thead> <tbody> <tr> <td align="right">57</td> <td align="left">quic_transport_parameters</td> <td align="left">CH, EE</td> <td align="left">Y</td> <td align="left">This document</td> </tr> </tbody> </table> </section> </middle> <back> <references> <name>References</name> <references> <name>Normative References</name> <reference anchor="QUIC-TRANSPORT" target="https://www.rfc-editor.org/info/rfc9000"> <front> <title>QUIC: A UDP-Based Multiplexed and Secure Transport</title> <author initials="J." surname="Iyengar" fullname="Jana Iyengar" role="editor"> <organization>Fastly</organization> </author> <author initials="M." surname="Thomson" fullname="Martin Thomson" role="editor"> <organization>Mozilla</organization> </author> <date year="2021"month="January" day="15"/>month="May"/> </front> <seriesInfoname="Internet-Draft" value="draft-ietf-quic-transport-34"/>name="RFC" value="9000"/> <seriesInfo name="DOI" value="10.17487/RFC9000"/> </reference> <referenceanchor="QUIC-RECOVERY">anchor="QUIC-RECOVERY" target="https://www.rfc-editor.org/info/rfc9002"> <front> <title>QUIC Loss Detection and Congestion Control</title> <author initials="J." surname="Iyengar" fullname="Jana Iyengar" role="editor"> <organization>Fastly</organization> </author> <author initials="I." surname="Swett" fullname="Ian Swett" role="editor"> <organization>Google</organization> </author> <date year="2021"month="January" day="15"/>month="May"/> </front> <seriesInfoname="Internet-Draft" value="draft-ietf-quic-recovery-34"/>name="RFC" value="9002"/> <seriesInfo name="DOI" value="10.17487/RFC9002"/> </reference> <reference anchor="HKDF" target="https://www.rfc-editor.org/info/rfc5869"> <front> <title>HMAC-based Extract-and-Expand Key Derivation Function (HKDF)</title> <author fullname="H. Krawczyk" initials="H." surname="Krawczyk"> <organization/> </author> <author fullname="P. Eronen" initials="P." surname="Eronen"> <organization/> </author> <date month="May" year="2010"/> <abstract> <t>This document specifies a simple Hashed Message Authentication Code (HMAC)-based key derivation function (HKDF), which can be used as a building block in various protocols and applications. The key derivation function (KDF) is intended to support a wide range of applications and requirements, and is conservative in its use of cryptographic hash functions. This document is not an Internet Standards Track specification; it is published for informational purposes.</t> </abstract> </front> <seriesInfo name="RFC" value="5869"/> <seriesInfo name="DOI" value="10.17487/RFC5869"/> </reference> <reference anchor="TLS13" target="https://www.rfc-editor.org/info/rfc8446"> <front> <title>The Transport Layer Security (TLS) Protocol Version 1.3</title> <authorinitials="E." surname="Rescorla"fullname="E.Rescorla">Rescorla" initials="E." surname="Rescorla"> <organization/> </author> <dateyear="2018" month="August"/>month="August" year="2018"/> <abstract> <t>This document specifies version 1.3 of the Transport Layer Security (TLS) protocol. TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.</t> <t>This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961. This document also specifies new requirements for TLS 1.2 implementations.</t> </abstract> </front> <seriesInfo name="RFC" value="8446"/> <seriesInfo name="DOI" value="10.17487/RFC8446"/> </reference> <reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119"> <front> <title>Key words for use in RFCs to Indicate Requirement Levels</title> <authorinitials="S." surname="Bradner"fullname="S.Bradner">Bradner" initials="S." surname="Bradner"> <organization/> </author> <dateyear="1997" month="March"/>month="March" year="1997"/> <abstract> <t>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.</t> </abstract> </front> <seriesInfo name="BCP" value="14"/> <seriesInfo name="RFC" value="2119"/> <seriesInfo name="DOI" value="10.17487/RFC2119"/> </reference> <reference anchor="RFC8174" target="https://www.rfc-editor.org/info/rfc8174"> <front> <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title> <authorinitials="B." surname="Leiba"fullname="B.Leiba">Leiba" initials="B." surname="Leiba"> <organization/> </author> <dateyear="2017" month="May"/>month="May" year="2017"/> <abstract> <t>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.</t> </abstract> </front> <seriesInfo name="BCP" value="14"/> <seriesInfo name="RFC" value="8174"/> <seriesInfo name="DOI" value="10.17487/RFC8174"/> </reference> <reference anchor="AEAD" target="https://www.rfc-editor.org/info/rfc5116"> <front> <title>An Interface and Algorithms for Authenticated Encryption</title> <authorinitials="D." surname="McGrew"fullname="D.McGrew">McGrew" initials="D." surname="McGrew"> <organization/> </author> <dateyear="2008" month="January"/>month="January" year="2008"/> <abstract> <t>This document defines algorithms for Authenticated Encryption with Associated Data (AEAD), and defines a uniform interface and a registry for such algorithms. The interface and registry can be used as an application-independent set of cryptoalgorithm suites. This approach provides advantages in efficiency and security, and promotes the reuse of crypto implementations. [STANDARDS-TRACK]</t> </abstract> </front> <seriesInfo name="RFC" value="5116"/> <seriesInfo name="DOI" value="10.17487/RFC5116"/> </reference> <referenceanchor="HKDF" target="https://www.rfc-editor.org/info/rfc5869">anchor="SHA"> <front><title>HMAC-based Extract-and-Expand Key Derivation Function (HKDF)</title><title>Secure Hash Standard</title> <authorinitials="H." surname="Krawczyk" fullname="H. Krawczyk">fullname="Quynh H. Dang" initials="Q." surname="Dang"> <organization/> </author> <date month="July" year="2015"/> </front> <seriesInfo name="National Institute of Standards and Technology" value="report"/> <seriesInfo name="DOI" value="10.6028/nist.fips.180-4"/> </reference> <reference anchor="CHACHA" target="https://www.rfc-editor.org/info/rfc8439"> <front> <title>ChaCha20 and Poly1305 for IETF Protocols</title> <author fullname="Y. Nir" initials="Y." surname="Nir"> <organization/> </author> <authorinitials="P." surname="Eronen" fullname="P. Eronen">fullname="A. Langley" initials="A." surname="Langley"> <organization/> </author> <dateyear="2010" month="May"/>month="June" year="2018"/> <abstract> <t>This documentspecifies a simple Hashed Message Authentication Code (HMAC)-based key derivation function (HKDF), which can be useddefines the ChaCha20 stream cipher asa building block in various protocols and applications. The key derivation function (KDF) is intended to support a wide range of applications and requirements, and is conservative in its use of cryptographic hash functions. This document is not an Internet Standards Track specification; it is published for informational purposes.</t> </abstract> </front> <seriesInfo name="RFC" value="5869"/> <seriesInfo name="DOI" value="10.17487/RFC5869"/> </reference> <reference anchor="SHA"> <front> <title>Secure Hash Standard</title> <author initials="Q." surname="Dang" fullname="Quynh H. Dang"> <organization/> </author> <date year="2015" month="July"/> </front> <seriesInfo name="National Institute of Standards and Technology" value="report"/> <seriesInfo name="DOI" value="10.6028/nist.fips.180-4"/> </reference> <reference anchor="CHACHA" target="https://www.rfc-editor.org/info/rfc8439"> <front> <title>ChaCha20 and Poly1305 for IETF Protocols</title> <author initials="Y." surname="Nir" fullname="Y. Nir"> <organization/> </author> <author initials="A." surname="Langley" fullname="A. Langley"> <organization/> </author> <date year="2018" month="June"/> <abstract> <t>This document defines the ChaCha20 stream cipher as well as the use of the Poly1305 authenticator, both as stand-alone algorithmswell as the use of the Poly1305 authenticator, both as stand-alone algorithms and as a "combined mode", or Authenticated Encryption with Associated Data (AEAD) algorithm.</t> <t>RFC 7539, the predecessor of this document, was meant to serve as a stable reference and an implementation guide. It was a product of the Crypto Forum Research Group (CFRG). This document merges the errata filed against RFC 7539 and adds a little text to the Security Considerations section.</t> </abstract> </front> <seriesInfo name="RFC" value="8439"/> <seriesInfo name="DOI" value="10.17487/RFC8439"/> </reference> <reference anchor="AES"> <front> <title>Advanced encryption standard (AES)</title> <author> <organization/> </author> <dateyear="2001" month="November"/>month="November" year="2001"/> </front> <seriesInfo name="National Institute of Standards and Technology" value="report"/> <seriesInfo name="DOI" value="10.6028/nist.fips.197"/> </reference> <reference anchor="ALPN" target="https://www.rfc-editor.org/info/rfc7301"> <front> <title>Transport Layer Security (TLS) Application-Layer Protocol Negotiation Extension</title> <authorinitials="S." surname="Friedl"fullname="S.Friedl">Friedl" initials="S." surname="Friedl"> <organization/> </author> <authorinitials="A." surname="Popov"fullname="A.Popov">Popov" initials="A." surname="Popov"> <organization/> </author> <authorinitials="A." surname="Langley"fullname="A.Langley">Langley" initials="A." surname="Langley"> <organization/> </author> <authorinitials="E." surname="Stephan"fullname="E.Stephan">Stephan" initials="E." surname="Stephan"> <organization/> </author> <dateyear="2014" month="July"/>month="July" year="2014"/> <abstract> <t>This document describes a Transport Layer Security (TLS) extension for application-layer protocol negotiation within the TLS handshake. For instances in which multiple application protocols are supported on the same TCP or UDP port, this extension allows the application layer to negotiate which protocol will be used within the TLS connection.</t> </abstract> </front> <seriesInfo name="RFC" value="7301"/> <seriesInfo name="DOI" value="10.17487/RFC7301"/> </reference> <reference anchor="RFC4086" target="https://www.rfc-editor.org/info/rfc4086"> <front> <title>Randomness Requirements for Security</title> <authorinitials="D." surname="Eastlake 3rd"fullname="D. Eastlake 3rd" initials="D." surname="Eastlake 3rd"> <organization/> </author> <authorinitials="J." surname="Schiller"fullname="J.Schiller">Schiller" initials="J." surname="Schiller"> <organization/> </author> <authorinitials="S." surname="Crocker"fullname="S.Crocker">Crocker" initials="S." surname="Crocker"> <organization/> </author> <dateyear="2005" month="June"/>month="June" year="2005"/> <abstract> <t>Security systems are built on strong cryptographic algorithms that foil pattern analysis attempts. However, the security of these systems is dependent on generating secret quantities for passwords, cryptographic keys, and similar quantities. The use of pseudo-random processes to generate secret quantities can result in pseudo-security. A sophisticated attacker may find it easier to reproduce the environment that produced the secret quantities and to search the resulting small set of possibilities than to locate the quantities in the whole of the potential number space.</t> <t>Choosing random quantities to foil a resourceful and motivated adversary is surprisingly difficult. This document points out many pitfalls in using poor entropy sources or traditional pseudo-random number generation techniques for generating such quantities. It recommends the use of truly random hardware techniques and shows that the existing hardware on many systems can be used for this purpose. It provides suggestions to ameliorate the problem when a hardware solution is not available, and it gives examples of how large such quantities need to be for some applications. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t> </abstract> </front> <seriesInfo name="BCP" value="106"/> <seriesInfo name="RFC" value="4086"/> <seriesInfo name="DOI" value="10.17487/RFC4086"/> </reference> <reference anchor="TLS-REGISTRIES" target="https://www.rfc-editor.org/info/rfc8447"> <front> <title>IANA Registry Updates for TLS and DTLS</title> <authorinitials="J." surname="Salowey"fullname="J.Salowey">Salowey" initials="J." surname="Salowey"> <organization/> </author> <authorinitials="S." surname="Turner"fullname="S.Turner">Turner" initials="S." surname="Turner"> <organization/> </author> <dateyear="2018" month="August"/>month="August" year="2018"/> <abstract> <t>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.</t> <t>This document updates the following RFCs: 3749, 5077, 4680, 5246, 5705, 5878, 6520, and 7301.</t> </abstract> </front> <seriesInfo name="RFC" value="8447"/> <seriesInfo name="DOI" value="10.17487/RFC8447"/> </reference> </references> <references> <name>Informative References</name> <reference anchor="AEBounds"target="http://www.isg.rhul.ac.uk/~kp/TLS-AEbounds.pdf">target="https://www.isg.rhul.ac.uk/~kp/TLS-AEbounds.pdf"> <front> <title>Limits on Authenticated Encryption Use in TLS</title> <author initials="A." surname="Luykx"> <organization/> </author> <author initials="K." surname="Paterson"> <organization/> </author> <dateyear="2016" month="March" day="08"/>year="2017" month="August" day="28"/> </front> </reference> <reference anchor="IMC"> <front> <title>Introduction to Modern Cryptography, Second Edition</title> <author initials="J." surname="Katz"> <organization/> </author> <author initials="Y." surname="Lindell"> <organization/> </author> <date year="2014" month="November" day="06"/> </front> <seriesInfo name="ISBN" value="978-1466570269"/> </reference> <reference anchor="QUIC-HTTP"> <front> <title>Hypertext Transfer Protocol Version 3 (HTTP/3)</title> <author initials="M." surname="Bishop" fullname="Mike Bishop" role="editor"> <organization>Akamai Technologies</organization> </author> <date year="2021"month="January" day="15"/>month="February" day="2"/> </front> <seriesInfo name="Internet-Draft"value="draft-ietf-quic-http-33"/>value="draft-ietf-quic-http"/> </reference> <reference anchor="ROBUST" target="https://eprint.iacr.org/2020/718"> <front> <title>Robust Channels: Handling Unreliable Networks in the Record Layers of QUIC and DTLS 1.3</title> <author initials="M." surname="Fischlin"> <organization/> </author> <author initials="F." surname="Günther"> <organization/> </author> <author initials="C." surname="Janson"> <organization/> </author> <date year="2020" month="May" day="16"/> </front> </reference> <referenceanchor="RFC5280" target="https://www.rfc-editor.org/info/rfc5280">anchor="CCM-ANALYSIS"> <front><title>Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile</title><title>On the Security of CTR + CBC-MAC</title> <authorinitials="D." surname="Cooper" fullname="D. Cooper">initials="J." surname="Jonsson" fullname="Jakob Jonsson"> <organization/> </author> <date year="2003"/> </front> <seriesInfo name="DOI" value="10.1007/3-540-36492-7_7"/> <refcontent>Selected Areas in Cryptography</refcontent> <refcontent>SAC 2002</refcontent> <refcontent>Lecture Notes in Computer Science, vol 2595</refcontent> <refcontent>pp. 76-93</refcontent> </reference> <reference anchor="NAN"> <front> <title>Nonces Are Noticed: AEAD Revisited</title> <authorinitials="S." surname="Santesson" fullname="S. Santesson">initials="M." surname="Bellare" fullname="Mihir Bellare"> <organization/> </author> <authorinitials="S." surname="Farrell" fullname="S. Farrell">initials="R." surname="Ng" fullname="Ruth Ng"> <organization/> </author> <authorinitials="S." surname="Boeyen" fullname="S. Boeyen">initials="B." surname="Tackmann" fullname="Björn Tackmann"> <organization/> </author> <date year="2019"/> </front> <seriesInfo name="DOI" value="10.1007/978-3-030-26948-7_9"/> <refcontent>Advances in Cryptology - CRYPTO 2019</refcontent> <refcontent>Lecture Notes in Computer Science, vol 11692</refcontent> <refcontent>pp. 235-265</refcontent> </reference> <reference anchor="GCM-MU"> <front> <title>The Multi-user Security of GCM, Revisited: Tight Bounds for Nonce Randomization</title> <authorinitials="R." surname="Housley" fullname="R. Housley">initials="V." surname="Hoang" fullname="Viet Tung Hoang"> <organization/> </author> <authorinitials="W." surname="Polk" fullname="W. Polk">initials="S." surname="Tessaro" fullname="Stefano Tessaro"> <organization/> </author><date year="2008" month="May"/> <abstract> <t>This<author initials="A." surname="Thiruvengadam" fullname="Aishwarya Thiruvengadam"> <organization/> </author> <date year="2018"/> </front> <seriesInfo name="DOI" value="10.1145/3243734.3243816"/> <refcontent>CCS '18: Proceedings of the 2018 ACM SIGSAC Conference on Computer and Communications Security</refcontent> <refcontent>pp. 1429-1440</refcontent> </reference> <reference anchor="RFC5280" target="https://www.rfc-editor.org/info/rfc5280"> <front> <title>Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile</title> <author fullname="D. Cooper" initials="D." surname="Cooper"> <organization/> </author> <author fullname="S. Santesson" initials="S." surname="Santesson"> <organization/> </author> <author fullname="S. Farrell" initials="S." surname="Farrell"> <organization/> </author> <author fullname="S. Boeyen" initials="S." surname="Boeyen"> <organization/> </author> <author fullname="R. Housley" initials="R." surname="Housley"> <organization/> </author> <author fullname="W. Polk" initials="W." surname="Polk"> <organization/> </author> <date month="May" year="2008"/> <abstract> <t>This memo profiles the X.509 v3 certificate and X.509 v2 certificate revocation list (CRL) for use in the Internet. An overview of this approach and model is provided as an introduction. The X.509 v3 certificate format is described in detail, with additional information regarding the format and semantics of Internet name forms. Standard certificate extensions are described and two Internet-specific extensions are defined. A set of required certificate extensions is specified. The X.509 v2 CRL format is described in detail along with standard and Internet-specific extensions. An algorithm for X.509 certification path validation is described. An ASN.1 module and examples are provided in the appendices. [STANDARDS-TRACK]</t> </abstract> </front> <seriesInfo name="RFC" value="5280"/> <seriesInfo name="DOI" value="10.17487/RFC5280"/> </reference> <reference anchor="RFC2818" target="https://www.rfc-editor.org/info/rfc2818"> <front> <title>HTTP Over TLS</title> <authorinitials="E." surname="Rescorla"fullname="E.Rescorla">Rescorla" initials="E." surname="Rescorla"> <organization/> </author> <dateyear="2000" month="May"/>month="May" year="2000"/> <abstract> <t>This memo describes how to use Transport Layer Security (TLS) to secure Hypertext Transfer Protocol (HTTP) connections over the Internet. This memo provides information for the Internet community.</t> </abstract> </front> <seriesInfo name="RFC" value="2818"/> <seriesInfo name="DOI" value="10.17487/RFC2818"/> </reference> <reference anchor="COMPRESS"target="http://www.ietf.org/internet-drafts/draft-ietf-tls-certificate-compression-10.txt">target="https://www.rfc-editor.org/info/rfc8879"> <front> <title>TLS Certificate Compression</title> <authorinitials="A" surname="Ghedini" fullname="Alessandro Ghedini">fullname="A. Ghedini" initials="A." surname="Ghedini"> <organization/> </author> <authorinitials="V" surname="Vasiliev" fullname="Victor Vasiliev">fullname="V. Vasiliev" initials="V." surname="Vasiliev"> <organization/> </author> <datemonth="January" day="6"month="December" year="2020"/> <abstract> <t>In TLS handshakes, certificate chains often take up the majority of the bytestransmitted. Thistransmitted.</t> <t>This document describes how certificate chains can be compressed to reduce the amount of data transmitted and avoid some round trips.</t> </abstract> </front> <seriesInfoname="Internet-Draft" value="draft-ietf-tls-certificate-compression-10"/>name="RFC" value="8879"/> <seriesInfo name="DOI" value="10.17487/RFC8879"/> </reference> <reference anchor="HTTP2-TLS13" target="https://www.rfc-editor.org/info/rfc8740"> <front> <title>Using TLS 1.3 with HTTP/2</title> <authorinitials="D." surname="Benjamin"fullname="D.Benjamin">Benjamin" initials="D." surname="Benjamin"> <organization/> </author> <dateyear="2020" month="February"/>month="February" year="2020"/> <abstract> <t>This document updates RFC 7540 by forbidding TLS 1.3 post-handshake authentication, as an analog to the existing TLS 1.2 renegotiation restriction.</t> </abstract> </front> <seriesInfo name="RFC" value="8740"/> <seriesInfo name="DOI" value="10.17487/RFC8740"/> </reference> <reference anchor="ASCII" target="https://www.rfc-editor.org/info/rfc20"> <front> <title>ASCII format for network interchange</title> <authorinitials="V.G." surname="Cerf"fullname="V.G.Cerf">Cerf" initials="V.G." surname="Cerf"> <organization/> </author> <dateyear="1969" month="October"/>month="October" year="1969"/> </front> <seriesInfo name="STD" value="80"/> <seriesInfo name="RFC" value="20"/> <seriesInfo name="DOI" value="10.17487/RFC0020"/> </reference> <reference anchor="HTTP-REPLAY" target="https://www.rfc-editor.org/info/rfc8470"> <front> <title>Using Early Data in HTTP</title> <authorinitials="M." surname="Thomson"fullname="M.Thomson">Thomson" initials="M." surname="Thomson"> <organization/> </author> <authorinitials="M." surname="Nottingham"fullname="M.Nottingham">Nottingham" initials="M." surname="Nottingham"> <organization/> </author> <authorinitials="W." surname="Tarreau"fullname="W.Tarreau">Tarreau" initials="W." surname="Tarreau"> <organization/> </author> <dateyear="2018" month="September"/>month="September" year="2018"/> <abstract> <t>Using TLS early data creates an exposure to the possibility of a replay attack. This document defines mechanisms that allow clients to communicate with servers about HTTP requests that are sent in early data. Techniques are described that use these mechanisms to mitigate the risk of replay.</t> </abstract> </front> <seriesInfo name="RFC" value="8470"/> <seriesInfo name="DOI" value="10.17487/RFC8470"/> </reference><reference anchor="GCM-MU"> <front> <title>The Multi-user Security of GCM, Revisited: Tight Bounds for Nonce Randomization</title> <author initials="V." surname="Hoang" fullname="Viet Tung Hoang"> <organization/> </author> <author initials="S." surname="Tessaro" fullname="Stefano Tessaro"> <organization/> </author> <author initials="A." surname="Thiruvengadam" fullname="Aishwarya Thiruvengadam"> <organization/> </author> <date year="2018" month="January"/> </front> <seriesInfo name="Proceedings of the 2018 ACM SIGSAC Conference on Computer and Communications" value="Security"/> <seriesInfo name="DOI" value="10.1145/3243734.3243816"/> </reference> <reference anchor="NAN"> <front> <title>Nonces Are Noticed: AEAD Revisited</title> <author initials="M." surname="Bellare" fullname="Mihir Bellare"> <organization/> </author> <author initials="R." surname="Ng" fullname="Ruth Ng"> <organization/> </author> <author initials="B." surname="Tackmann" fullname="Björn Tackmann"> <organization/> </author> <date year="2019"/> </front> <seriesInfo name="Advances in Cryptology - CRYPTO 2019" value="pp. 235-265"/> <seriesInfo name="DOI" value="10.1007/978-3-030-26948-7_9"/> </reference> <reference anchor="CCM-ANALYSIS"> <front> <title>On the Security of CTR + CBC-MAC</title> <author initials="J." surname="Jonsson" fullname="Jakob Jonsson"> <organization/> </author> <date year="2003"/> </front> <seriesInfo name="Selected Areas in Cryptography" value="pp. 76-93"/> <seriesInfo name="DOI" value="10.1007/3-540-36492-7_7"/> </reference></references> </references> <section anchor="test-vectors" numbered="true" toc="default"> <name>Sample Packet Protection</name> <t>This section shows examples of packet protection so that implementations can be verified incrementally. Samples of Initial packets from both client andserver,server plus a Retry packet are defined. These packets use an 8-byte client-chosen Destination Connection ID of 0x8394c8f03e515708. Some intermediate values are included. All values are shown in hexadecimal.</t> <section anchor="keys" numbered="true" toc="default"> <name>Keys</name> <t>The labels generated during the execution of the HKDF-Expand-Label function (that is, HkdfLabel.label) and part of the value given to the HKDF-Expand function in order to produce its output are:</t> <dl><dt> client in: </dt><dt>client in:</dt> <dd> <t>00200f746c73313320636c69656e7420696e00</t> </dd><dt> server in: </dt><dt>server in:</dt> <dd> <t>00200f746c7331332073657276657220696e00</t> </dd><dt> quic key: </dt><dt>quic key:</dt> <dd> <t>00100e746c7331332071756963206b657900</t> </dd><dt> quic iv: </dt><dt>quic iv:</dt> <dd> <t>000c0d746c733133207175696320697600</t> </dd><dt> quic hp: </dt><dt>quic hp:</dt> <dd> <t>00100d746c733133207175696320687000</t> </dd> </dl> <t>The initial secret is common:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ initial_secret = HKDF-Extract(initial_salt, cid) = 7db5df06e7a69e432496adedb0085192 3595221596ae2ae9fb8115c1e9ed0a44 ]]></artwork> <t>The secrets for protecting client packets are:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ client_initial_secret = HKDF-Expand-Label(initial_secret, "client in", "", 32) = c00cf151ca5be075ed0ebfb5c80323c4 2d6b7db67881289af4008f1f6c357aea key = HKDF-Expand-Label(client_initial_secret, "quic key", "", 16) = 1f369613dd76d5467730efcbe3b1a22d iv = HKDF-Expand-Label(client_initial_secret, "quic iv", "", 12) = fa044b2f42a3fd3b46fb255c hp = HKDF-Expand-Label(client_initial_secret, "quic hp", "", 16) = 9f50449e04a0e810283a1e9933adedd2 ]]></artwork> <t>The secrets for protecting server packets are:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ server_initial_secret = HKDF-Expand-Label(initial_secret, "server in", "", 32) = 3c199828fd139efd216c155ad844cc81 fb82fa8d7446fa7d78be803acdda951b key = HKDF-Expand-Label(server_initial_secret, "quic key", "", 16) = cf3a5331653c364c88f0f379b6067e37 iv = HKDF-Expand-Label(server_initial_secret, "quic iv", "", 12) = 0ac1493ca1905853b0bba03e hp = HKDF-Expand-Label(server_initial_secret, "quic hp", "", 16) = c206b8d9b9f0f37644430b490eeaa314 ]]></artwork> </section> <section anchor="sample-client-initial" numbered="true" toc="default"> <name>Client Initial</name> <t>The client sends an Initial packet. The unprotected payload of this packet contains the following CRYPTO frame, plus enough PADDING frames to make a 1162-byte payload:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ 060040f1010000ed0303ebf8fa56f129 39b9584a3896472ec40bb863cfd3e868 04fe3a47f06a2b69484c000004130113 02010000c000000010000e00000b6578 616d706c652e636f6dff01000100000a 00080006001d00170018001000070005 04616c706e0005000501000000000033 00260024001d00209370b2c9caa47fba baf4559fedba753de171fa71f50f1ce1 5d43e994ec74d748002b000302030400 0d0010000e0403050306030203080408 050806002d00020101001c0002400100 3900320408ffffffffffffffff050480 00ffff07048000ffff08011001048000 75300901100f088394c8f03e51570806 048000ffff ]]></artwork> <t>The unprotected header indicates a length of 1182 bytes: the 4-byte packet number, 1162 bytes of frames, and the 16-byte authentication tag. The header includes the connection ID and a packet number of 2:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ c300000001088394c8f03e5157080000449e00000002 ]]></artwork> <t>Protecting the payload produces output that is sampled for header protection. Because the header uses a 4-byte packet number encoding, the first 16 bytes of the protected payload issampled,sampled and then applied to theheader:</t>header as follows:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ sample = d1b1c98dd7689fb8ec11d242b123dc9b mask = AES-ECB(hp, sample)[0..4] = 437b9aec36 header[0] ^= mask[0] & 0x0f = c0 header[18..21] ^= mask[1..4] = 7b9aec34 header = c000000001088394c8f03e5157080000449e7b9aec34 ]]></artwork> <t>The resulting protected packet is:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ c000000001088394c8f03e5157080000 449e7b9aec34d1b1c98dd7689fb8ec11 d242b123dc9bd8bab936b47d92ec356c 0bab7df5976d27cd449f63300099f399 1c260ec4c60d17b31f8429157bb35a12 82a643a8d2262cad67500cadb8e7378c 8eb7539ec4d4905fed1bee1fc8aafba1 7c750e2c7ace01e6005f80fcb7df6212 30c83711b39343fa028cea7f7fb5ff89 eac2308249a02252155e2347b63d58c5 457afd84d05dfffdb20392844ae81215 4682e9cf012f9021a6f0be17ddd0c208 4dce25ff9b06cde535d0f920a2db1bf3 62c23e596d11a4f5a6cf3948838a3aec 4e15daf8500a6ef69ec4e3feb6b1d98e 610ac8b7ec3faf6ad760b7bad1db4ba3 485e8a94dc250ae3fdb41ed15fb6a8e5 eba0fc3dd60bc8e30c5c4287e53805db 059ae0648db2f64264ed5e39be2e20d8 2df566da8dd5998ccabdae053060ae6c 7b4378e846d29f37ed7b4ea9ec5d82e7 961b7f25a9323851f681d582363aa5f8 9937f5a67258bf63ad6f1a0b1d96dbd4 faddfcefc5266ba6611722395c906556 be52afe3f565636ad1b17d508b73d874 3eeb524be22b3dcbc2c7468d54119c74 68449a13d8e3b95811a198f3491de3e7 fe942b330407abf82a4ed7c1b311663a c69890f4157015853d91e923037c227a 33cdd5ec281ca3f79c44546b9d90ca00 f064c99e3dd97911d39fe9c5d0b23a22 9a234cb36186c4819e8b9c5927726632 291d6a418211cc2962e20fe47feb3edf 330f2c603a9d48c0fcb5699dbfe58964 25c5bac4aee82e57a85aaf4e2513e4f0 5796b07ba2ee47d80506f8d2c25e50fd 14de71e6c418559302f939b0e1abd576 f279c4b2e0feb85c1f28ff18f58891ff ef132eef2fa09346aee33c28eb130ff2 8f5b766953334113211996d20011a198 e3fc433f9f2541010ae17c1bf202580f 6047472fb36857fe843b19f5984009dd c324044e847a4f4a0ab34f719595de37 252d6235365e9b84392b061085349d73 203a4a13e96f5432ec0fd4a1ee65accd d5e3904df54c1da510b0ff20dcc0c77f cb2c0e0eb605cb0504db87632cf3d8b4 dae6e705769d1de354270123cb11450e fc60ac47683d7b8d0f811365565fd98c 4c8eb936bcab8d069fc33bd801b03ade a2e1fbc5aa463d08ca19896d2bf59a07 1b851e6c239052172f296bfb5e724047 90a2181014f3b94a4e97d117b4381303 68cc39dbb2d198065ae3986547926cd2 162f40a29f0c3c8745c0f50fba3852e5 66d44575c29d39a03f0cda721984b6f4 40591f355e12d439ff150aab7613499d bd49adabc8676eef023b15b65bfc5ca0 6948109f23f350db82123535eb8a7433 bdabcb909271a6ecbcb58b936a88cd4e 8f2e6ff5800175f113253d8fa9ca8885 c2f552e657dc603f252e1a8e308f76f0 be79e2fb8f5d5fbbe2e30ecadd220723 c8c0aea8078cdfcb3868263ff8f09400 54da48781893a7e49ad5aff4af300cd8 04a6b6279ab3ff3afb64491c85194aab 760d58a606654f9f4400e8b38591356f bf6425aca26dc85244259ff2b19c41b9 f96f3ca9ec1dde434da7d2d392b905dd f3d1f9af93d1af5950bd493f5aa731b4 056df31bd267b6b90a079831aaf579be 0a39013137aac6d404f518cfd4684064 7e78bfe706ca4cf5e9c5453e9f7cfd2b 8b4c8d169a44e55c88d4a9a7f9474241 e221af44860018ab0856972e194cd934 ]]></artwork> </section> <section anchor="server-initial" numbered="true" toc="default"> <name>Server Initial</name> <t>The server sends the following payload in response, including an ACK frame, a CRYPTO frame, and no PADDING frames:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ 02000000000600405a020000560303ee fce7f7b37ba1d1632e96677825ddf739 88cfc79825df566dc5430b9a045a1200 130100002e00330024001d00209d3c94 0d89690b84d08a60993c144eca684d10 81287c834d5311bcf32bb9da1a002b00 020304 ]]></artwork> <t>The header from the server includes a new connection ID and a 2-byte packet number encoding for a packet number of 1:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ c1000000010008f067a5502a4262b50040750001 ]]></artwork> <t>As a result, after protection, the header protection sample is taken starting from the third protected byte:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ sample = 2cd0991cd25b0aac406a5816b6394100 mask = 2ec0d8356a header = cf000000010008f067a5502a4262b5004075c0d9 ]]></artwork> <t>The final protected packet is then:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ cf000000010008f067a5502a4262b500 4075c0d95a482cd0991cd25b0aac406a 5816b6394100f37a1c69797554780bb3 8cc5a99f5ede4cf73c3ec2493a1839b3 dbcba3f6ea46c5b7684df3548e7ddeb9 c3bf9c73cc3f3bded74b562bfb19fb84 022f8ef4cdd93795d77d06edbb7aaf2f 58891850abbdca3d20398c276456cbc4 2158407dd074ee ]]></artwork> </section> <section anchor="retry" numbered="true" toc="default"> <name>Retry</name> <t>This shows a Retry packet that might be sent in response to the Initial packet in <xref target="sample-client-initial" format="default"/>. The integrity check includes the client-chosen connection ID value of 0x8394c8f03e515708, but that value is not included in the final Retry packet:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ ff000000010008f067a5502a4262b574 6f6b656e04a265ba2eff4d829058fb3f 0f2496ba ]]></artwork> </section> <section anchor="chacha20-poly1305-short-header-packet" numbered="true" toc="default"> <name>ChaCha20-Poly1305 Short Header Packet</name> <t>This example shows some of the steps required to protect a packet with a short header. This example uses AEAD_CHACHA20_POLY1305.</t> <t>In this example, TLS produces an application write secret from which a server uses HKDF-Expand-Label to produce four values: a key, an IV, a header protection key, and the secret that will be used after keys are updated (this last value is not used further in this example).</t> <artwork name="" type="" align="left" alt=""><![CDATA[ secret = 9ac312a7f877468ebe69422748ad00a1 5443f18203a07d6060f688f30f21632b key = HKDF-Expand-Label(secret, "quic key", "", 32) = c6d98ff3441c3fe1b2182094f69caa2e d4b716b65488960a7a984979fb23e1c8 iv = HKDF-Expand-Label(secret, "quic iv", "", 12) = e0459b3474bdd0e44a41c144 hp = HKDF-Expand-Label(secret, "quic hp", "", 32) = 25a282b9e82f06f21f488917a4fc8f1b 73573685608597d0efcb076b0ab7a7a4 ku = HKDF-Expand-Label(secret, "quic ku", "", 32) = 1223504755036d556342ee9361d25342 1a826c9ecdf3c7148684b36b714881f9 ]]></artwork> <t>The following shows the steps involved in protecting a minimal packet with an empty Destination Connection ID. This packet contains a single PING frame (that is, a payload of just 0x01) and has a packet number of 654360564. In this example, using a packet number of length 3 (that is, 49140 is encoded) avoids having to pad the payload of the packet; PADDING frames would be needed if the packet number is encoded on fewer bytes.</t> <artwork name="" type="" align="left" alt=""><![CDATA[ pn = 654360564 (decimal) nonce = e0459b3474bdd0e46d417eb0 unprotected header = 4200bff4 payload plaintext = 01 payload ciphertext = 655e5cd55c41f69080575d7999c25a5bfb ]]></artwork> <t>The resulting ciphertext is the minimum size possible. One byte is skipped to produce the sample for header protection.</t> <artwork name="" type="" align="left" alt=""><![CDATA[ sample = 5e5cd55c41f69080575d7999c25a5bfb mask = aefefe7d03 header = 4cfe4189 ]]></artwork> <t>The protected packet is the smallest possible packet size of 21 bytes.</t> <artwork name="" type="" align="left" alt=""><![CDATA[ packet = 4cfe4189655e5cd55c41f69080575d7999c25a5bfb ]]></artwork> </section> </section> <section anchor="aead-analysis" numbered="true" toc="default"> <name>AEAD Algorithm Analysis</name> <t>This section documents analyses used in deriving AEAD algorithm limits for AEAD_AES_128_GCM, AEAD_AES_128_CCM, and AEAD_AES_256_GCM. The analyses that follow use symbols for multiplication (*), division (/), and exponentiation (^), plus parentheses for establishing precedence. The following symbols are also used:</t> <dl><dt> t: </dt><dt>t:</dt> <dd> <t>The size of the authentication tag in bits. For these ciphers, t is 128.</t> </dd><dt> n: </dt><dt>n:</dt> <dd> <t>The size of the block function in bits. For these ciphers, n is 128.</t> </dd><dt> k: </dt><dt>k:</dt> <dd> <t>The size of the key in bits. This is 128 for AEAD_AES_128_GCM and AEAD_AES_128_CCM; 256 for AEAD_AES_256_GCM.</t> </dd><dt> l: </dt><dt>l:</dt> <dd> <t>The number of blocks in each packet (see below).</t> </dd><dt> q: </dt><dt>q:</dt> <dd> <t>The number of genuine packets created and protected by endpoints. This value is the bound on the number of packets that can be protected before updating keys.</t> </dd><dt> v: </dt><dt>v:</dt> <dd> <t>The number of forged packets that endpoints will accept. This value is the bound on the number of forged packets that an endpoint can reject before updating keys.</t> </dd><dt> o: </dt><dt>o:</dt> <dd> <t>The amount of offline ideal cipher queries made by an adversary.</t> </dd> </dl> <t>The analyses that follow rely on a count of the number of block operations involved in producing each message. This analysis is performed for packets of size up to2^112<sup>11</sup> (l =2^7)2<sup>7</sup>) and2^162<sup>16</sup> (l =2^12).2<sup>12</sup>). A size of2^112<sup>11</sup> is expected to be a limit that matches common deployment patterns, whereas the2^162<sup>16</sup> is the maximum possible size of a QUIC packet. Only endpoints that strictly limit packet size can use the larger confidentiality and integrity limits that are derived using the smaller packet size.</t> <t>For AEAD_AES_128_GCM and AEAD_AES_256_GCM, the message length (l) is the length of the associated data in blocks plus the length of the plaintext in blocks.</t> <t>For AEAD_AES_128_CCM, the total number of block cipher operations is the sumof:of the following: the length of the associated data in blocks, the length of the ciphertext in blocks, the length of the plaintext in blocks, plus 1. In this analysis, this is simplified to a value of twice the length of the packet in blocks (that is, <tt>2l =2^8</tt>2<sup>8</sup></tt> for packets that are limited to2^112<sup>11</sup> bytes, or <tt>2l =2^13</tt>2<sup>13</sup></tt> otherwise). This simplification is based on the packet containing all of the associated data and ciphertext. This results in a1one to3three block overestimation of the number of operations per packet.</t> <section anchor="gcm-bounds" numbered="true" toc="default"> <name>Analysis of AEAD_AES_128_GCM and AEAD_AES_256_GCM Usage Limits</name> <t><xref target="GCM-MU" format="default"/>specifyspecifies concrete bounds for AEAD_AES_128_GCM and AEAD_AES_256_GCM as used in TLS 1.3 and QUIC. This section documents this analysis using several simplifying assumptions:</t> <ul spacing="normal"> <li>The number of ciphertext blocks an attacker uses in forgery attempts is bounded by v * l, which is the number of forgery attemptsandmultiplied by the size of each packet (in blocks).</li> <li>The amount of offline work done by an attacker does not dominate other factors in the analysis.</li> </ul> <t>The bounds in <xref target="GCM-MU" format="default"/> are tighter and more complete than those used in <xref target="AEBounds" format="default"/>, which allows for larger limits than those described in <xref target="TLS13" format="default"/>.</t> <section anchor="confidentiality-limit" numbered="true" toc="default"> <name>Confidentiality Limit</name> <t>For confidentiality,TheorumTheorem (4.3) in <xref target="GCM-MU" format="default"/> establishesthat -that, for a single user that does not repeatnonces -nonces, the dominant term in determining the distinguishing advantage between a real and random AEAD algorithm gained by an attacker is:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ 2 * (q * l)^2 / 2^n ]]></artwork> <t>For a target advantage of2^-57,2<sup>-57</sup>, this results in the relation:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ q <= 2^35 / l ]]></artwork> <t>Thus, endpoints that do not send packets larger than2^112<sup>11</sup> bytes cannot protect more than2^282<sup>28</sup> packets in a single connection without causing an attacker to gainan largera more significant advantage than the target of2^-57.2<sup>-57</sup>. The limit for endpoints that allow for the packet size to be as large as2^162<sup>16</sup> is instead2^23.</t>2<sup>23</sup>.</t> </section> <section anchor="integrity-limit" numbered="true" toc="default"> <name>Integrity Limit</name> <t>For integrity, Theorem (4.3) in <xref target="GCM-MU" format="default"/> establishes that an attacker gains an advantage in successfully forging a packet of no morethan:</t>than the following:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ (1 / 2^(8 * n)) + ((2 * v) / 2^(2 * n)) + ((2 * o * v) / 2^(k + n)) + (n * (v + (v * l)) / 2^k) ]]></artwork> <t>The goal is to limit this advantage to2^-57.2<sup>-57</sup>. For AEAD_AES_128_GCM, the fourth term in this inequality dominates the rest, so the others can be removed without significant effect on the result. This produces the following approximation:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ v <= 2^64 / l ]]></artwork> <t>Endpoints that do not attempt to remove protection from packets larger than2^112<sup>11</sup> bytes can attempt to remove protection from at most2^572<sup>57</sup> packets. Endpoints that do not restrict the size of processed packets can attempt to remove protection from at most2^522<sup>52</sup> packets.</t> <t>For AEAD_AES_256_GCM, the same term dominates, but the larger value of k produces the following approximation:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ v <= 2^192 / l ]]></artwork> <t>This is substantially larger than the limit for AEAD_AES_128_GCM. However, this document recommends that the same limit be applied to both functions as either limit is acceptably large.</t> </section> </section> <section anchor="ccm-bounds" numbered="true" toc="default"> <name>Analysis of AEAD_AES_128_CCM Usage Limits</name> <t>TLS <xref target="TLS13" format="default"/> and <xref target="AEBounds" format="default"/> do not specify limits on usage for AEAD_AES_128_CCM. However, any AEAD that is used with QUIC requires limits on use that ensure that both confidentiality and integrity are preserved. This section documents that analysis.</t> <t><xref target="CCM-ANALYSIS" format="default"/> is used as the basis of this analysis. The results of that analysis are used to derive usage limits that are based on those chosen in <xref target="TLS13" format="default"/>.</t> <t>For confidentiality, Theorem 2 in <xref target="CCM-ANALYSIS" format="default"/> establishes that an attacker gains a distinguishing advantage over an ideal pseudorandom permutation (PRP) of no morethan:</t> <artworkthan the following:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ (2l * q)^2 / 2^n ]]></artwork> <t>The integrity limit in Theorem 1 in <xref target="CCM-ANALYSIS" format="default"/> provides an attacker a strictly higher advantage for the same number of messages. As the targets for the confidentiality advantage and the integrity advantage are the same, only Theorem 1 needs to be considered.</t> <t>Theorem 1 establishes that an attacker gains an advantage over an ideal PRP of no morethan:</t>than the following:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ v / 2^t + (2l * (v + q))^2 / 2^n ]]></artwork> <t>As <tt>t</tt> and <tt>n</tt> are both 128, the first term is negligible relative to the second, so that term can be removed without a significant effect on the result.</t> <t>This produces a relation that combines both encryption and decryption attempts with the same limit as that produced by the theorem for confidentiality alone. For a target advantage of2^-57,2<sup>-57</sup>, this resultsin:</t>in the following:</t> <artwork name="" type="" align="left" alt=""><![CDATA[ v + q <= 2^34.5 / l ]]></artwork> <t>By setting <tt>q = v</tt>, values for both confidentiality and integrity limits can be produced. Endpoints that limit packets to2^112<sup>11</sup> bytes therefore have both confidentiality and integrity limits of2^26.52<sup>26.5</sup> packets. Endpoints that do not restrict packet size have a limit of2^21.5.</t>2<sup>21.5</sup>.</t> </section> </section> <sectionanchor="change-log" numbered="true" toc="default"> <name>Change Log</name> <ul empty="true" spacing="normal"> <li> <strong>RFC Editor's Note:</strong> Please remove this section prior to publication of a final version of this document.</li> </ul> <t>Issue and pull request numbers are listed with a leading octothorp.</t> <section anchor="since-draft-ietf-quic-tls-32" numbered="true"numbered="false" anchor="contributors" toc="default"><name>Since draft-ietf-quic-tls-32</name> <ul spacing="normal"> <li>Added final values for Initial key derivation, Retry authentication, and TLS extension type for the<name>Contributors</name> <t>The IETF QUICTransport Parameters extension (#4431) (#4431)</li> <li>Corrected rules for handling of 0-RTT (#4393, #4394)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-31" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-31</name> <ul spacing="normal"> <li>Packet protection limits are based on maximum-sized packets; improved analysis (#3701, #4175)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-30" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-30</name> <ul spacing="normal"> <li>Add a new error code for AEAD_LIMIT_REACHED code to avoid conflict (#4087, #4088)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-29" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-29</name> <ul spacing="normal"> <li>Updated limits on packet protection (#3788, #3789)</li> <li>Allow for packet processing to continue while waiting for TLS to provide keys (#3821, #3874)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-28" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-28</name> <ul spacing="normal"> <li>Defined limits on the number of packets that can be protected with a single key and limits on the number of packets that can fail authentication (#3619, #3620)</li> <li>Update Initial salt, Retry keys, and samples (#3711)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-27" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-27</name> <ul spacing="normal"> <li>Allowed CONNECTION_CLOSE in any packet number space, with restrictions on use of the application-specific variant (#3430, #3435, #3440)</li> <li>Prohibit the useWorking Group received an enormous amount ofthe compatibility modesupport fromTLS 1.3 (#3594, #3595)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-26" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-26</name> <ul spacing="normal"> <li>No changes</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-25" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-25</name> <ul spacing="normal"> <li>No changes</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-24" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-24</name>many people. The following people provided substantive contributions to this document:</t> <ulspacing="normal">spacing="compact"> <li><t>Rewrite key updates (#3050) </t> <ul spacing="normal"> <li>Allow but don't recommend deferring key updates (#2792, #3263)</li> <li>More completely define received behavior (#2791)</li> <li>Define the label used with HKDF-Expand-Label (#3054)</li> </ul><t><contact fullname="Adam Langley"/></t> </li></ul> </section> <section anchor="since-draft-ietf-quic-tls-23" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-23</name> <ul spacing="normal"><li><t>Key update text update (#3050): </t> <ul spacing="normal"> <li>Recommend constant-time key replacement (#2792)</li> <li>Provide explicit labels for key update key derivation (#3054)</li> </ul><t><contact fullname="Alessandro Ghedini"/></t> </li><li>Allow first Initial from a client to span multiple packets (#2928, #3045)</li> <li>PING can be sent at any encryption level (#3034, #3035)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-22" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-22</name> <ul spacing="normal"> <li>Update the salt used for Initial secrets (#2887, #2980)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-21" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-21</name> <ul spacing="normal"> <li>No changes</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-20" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-20</name> <ul spacing="normal"> <li>Mandate the use of the QUIC transport parameters extension (#2528, #2560)</li> <li>Define handshake completion and confirmation; define clearer rules when it encryption keys should be discarded (#2214, #2267, #2673)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-18" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-18</name> <ul spacing="normal"> <li>Increased the set of permissible frames in 0-RTT (#2344, #2355)</li> <li>Transport parameter extension is mandatory (#2528, #2560)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-17" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-17</name> <ul spacing="normal"> <li>Endpoints discard initial keys as soon as handshake keys are available (#1951, #2045)</li> <li>Use of ALPN or equivalent is mandatory (#2263, #2284)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-14" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-14</name> <ul spacing="normal"> <li>Update the salt used for Initial secrets (#1970)</li> <li>Clarify that TLS_AES_128_CCM_8_SHA256 isn't supported (#2019)</li><li><t>Change header protection </t> <ul spacing="normal"> <li>Sample from a fixed offset (#1575, #2030)</li> <li>Cover part of the first byte, including the key phase (#1322, #2006)</li> </ul><t><contact fullname="Christian Huitema"/></t> </li> <li><t>TLS provides an AEAD and KDF function (#2046) </t> <ul spacing="normal"> <li>Clarify that the TLS KDF is used with TLS (#1997)</li> <li>Change the labels for calculation of QUIC keys (#1845, #1971, #1991)</li> </ul><t><contact fullname="Christopher Wood"/></t> </li><li>Initial keys are discarded once Handshake keys are available (#1951, #2045)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-13" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-13</name> <ul spacing="normal"> <li>Updated to TLS 1.3 final (#1660)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-12" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-12</name> <ul spacing="normal"><li><t>Changes to integration of the TLS handshake (#829, #1018, #1094, #1165, #1190, #1233, #1242, #1252, #1450) </t> <ul spacing="normal"> <li>The cryptographic handshake uses CRYPTO frames, not stream 0</li> <li>QUIC packet protection is used in place of TLS record protection</li> <li>Separate QUIC packet number spaces are used for the handshake</li> <li>Changed Retry to be independent of the cryptographic handshake</li> <li>Limit the use of HelloRetryRequest to address TLS needs (like key shares)</li> </ul><t><contact fullname="David Schinazi"/></t> </li> <li> <t><contact fullname="Dragana Damjanovic"/></t> </li><li>Changed codepoint of TLS extension (#1395, #1402)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-11" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-11</name> <ul spacing="normal"> <li>Encrypted packet numbers.</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-10" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-10</name> <ul spacing="normal"> <li>No significant changes.</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-09" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-09</name> <ul spacing="normal"> <li>Cleaned up key schedule and updated the salt used for handshake packet protection (#1077)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-08" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-08</name> <ul spacing="normal"> <li>Specify value for max_early_data_size to enable 0-RTT (#942)</li> <li>Update key derivation function (#1003, #1004)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-07" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-07</name> <ul spacing="normal"> <li>Handshake errors can be reported with CONNECTION_CLOSE (#608, #891)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-05" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-05</name> <t>No significant changes.</t> </section> <section anchor="since-draft-ietf-quic-tls-04" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-04</name> <ul spacing="normal"> <li>Update labels used in HKDF-Expand-Label to match TLS 1.3 (#642)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-03" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-03</name> <t>No significant changes.</t> </section> <section anchor="since-draft-ietf-quic-tls-02" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-02</name> <ul spacing="normal"> <li>Updates to match changes in transport draft</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-01" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-01</name> <ul spacing="normal"> <li>Use TLS alerts to signal TLS errors (#272, #374)</li> <li>Require ClientHello to fit in a single packet (#338)</li> <li>The second client handshake flight is now sent in the clear (#262, #337)</li> <li>The QUIC header is included as AEAD Associated Data (#226, #243, #302)</li> <li>Add interface necessary for client address validation (#275)</li> <li>Define peer authentication (#140)</li> <li>Require at least TLS 1.3 (#138)</li> <li>Define transport parameters as a TLS extension (#122)</li> <li>Define handling for protected packets before the handshake completes (#39)</li> <li>Decouple QUIC version and ALPN (#12)</li> </ul> </section> <section anchor="since-draft-ietf-quic-tls-00" numbered="true" toc="default"> <name>Since draft-ietf-quic-tls-00</name> <ul spacing="normal"> <li>Changed bit used to signal key phase</li> <li>Updated key phase markings during the handshake</li> <li>Added TLS interface requirements section</li> <li>Moved to use of TLS exporters for key derivation</li> <li>Moved TLS error code definitions into this document</li> </ul> </section> <section anchor="since-draft-thomson-quic-tls-01" numbered="true" toc="default"> <name>Since draft-thomson-quic-tls-01</name> <ul spacing="normal"> <li>Adopted as base for draft-ietf-quic-tls</li> <li>Updated authors/editors list</li> <li>Added status note</li> </ul> </section> </section> <section numbered="false" anchor="contributors" toc="default"> <name>Contributors</name> <t>The IETF QUIC Working Group received an enormous amount of support from many people. The following people provided substantive contributions to this document:</t> <ul spacing="normal"> <li>Adam Langley</li> <li>Alessandro Ghedini</li> <li>Christian Huitema</li> <li>Christopher Wood</li> <li>David Schinazi</li> <li>Dragana Damjanovic</li> <li>Eric Rescorla</li> <li>Felix Guenther</li> <li>Ian Swett</li> <li>Jana Iyengar</li><li><t> <contact<t><contact fullname="Eric Rescorla"/></t> </li> <li> <t><contact fullname="Felix Günther"/></t> </li> <li> <t><contact fullname="Ian Swett"/></t> </li> <li> <t><contact fullname="Jana Iyengar"/></t> </li> <li> <t><contact asciiFullname="Kazuho Oku" fullname="奥一穂"/> </t>一穂"/></t> </li> <li> <t><contact fullname="Marten Seemann"/></t> </li><li>Marten Seemann</li> <li>Martin Duke</li> <li>Mike Bishop</li><li><t> <contact<t><contact fullname="Martin Duke"/></t> </li> <li> <t><contact fullname="Mike Bishop"/></t> </li> <li> <t><contact fullname="Mikkel FahnøeJørgensen"/> </t>Jørgensen"/></t> </li> <li> <t><contact fullname="Nick Banks"/></t> </li> <li> <t><contact fullname="Nick Harper"/></t> </li> <li> <t><contact fullname="Roberto Peon"/></t> </li> <li> <t><contact fullname="Rui Paulo"/></t> </li> <li> <t><contact fullname="Ryan Hamilton"/></t> </li> <li> <t><contact fullname="Victor Vasiliev"/></t> </li><li>Nick Banks</li> <li>Nick Harper</li> <li>Roberto Peon</li> <li>Rui Paulo</li> <li>Ryan Hamilton</li> <li>Victor Vasiliev</li></ul> </section> </back><!-- ##markdown-source: H4sIAMUHAWAAA8y963Yb2ZUm+P88RZRyrTFZBpC8SNQlK11mkkxLnbqwSSqr c3lsOggEyLAABCoCEEXL6mfpB5lfMy82+372iQiQSlf1TKlcNgFEnPvZ9/3t 4XAYVuVqVrzI3jfl4jq7eH2erarsvBiv6yL77+9fHYVJNV7kc3hiUufT1bAs VtPhv6/L8XA1a4b7j8MkX8GPezt7u8Od3eHukzCGL66r+u5F1qwmoVzWL7JV vW5Wezs7z3f2Ql4X+Yvsos4XzbKqV+G2qj9c19V6+YL7C80qX0wu81m1gHbv iiYsyxfZH1fVeJA18EJdTBv4627Of8Dw5vlyCYP/Uwj5enVT1S9Clg3h/7Os XDQvsjej7OKmmjfVgr7jybzJ61W5SH6o6mv4vvpbOZvl9EUxz8vZi2y++v2s ui0Wq7pa3o0WxYp+rCtctWJSrqo67e8c+lvXi6J23Z0X+cJ/S301i/164ntq 4Knf07ejcTXvdhMWVT3PV+XH4kWAX3G5hhdnh2/PT9+dXbyg52U3H+FvL7LD 7P3x6fCHvCkm2Zv1bFUuZ8Un+BsWWPfYNuIRvd/ZTfyyKeqygPMxrbiTLHu1 WBUwmdXwGA9Fz9nQVvGE4AtxZ/DfUP5XVuy/jbJXd8XiOq/te162/5Yv8s5P tHY/5s1qdmfftXajp4/WKbj3JPSehu5uyA6cnRy9+/nk7JfuBmSvq6bJjotV MV6V1YKW/ahaXBcNfYQ/4UzN/lMXvi7G1ceivvsvs+6vRtn5bbFatXp4Bfch /Z6a/0NVXc+KDeuN6+DP/+HJD9V6MWnShX9dzstVk8H6HsLc4dqWSJAm2cli XN8taeHfN0WGW/76/FHfIvHAD0fZ6/Xdh0/ptz+NslNortajotu2ezDc2R/u POOh5PV1AZvz6Ga1Wr749tvb29tR2VyP6pv1bJSPR+sP3/7PD8tvof/h4ckV zWG0nEwf4aRevTlK5/MKD8lkzScIaPObagInIDvCyVTXdb68uRvgZa7gcJ3A SsFj98wKtvynfPW39MtfYKrlYlLMZumcHg934TQebDqK5z+8fZE9f/psuPv4 4ODJ0529g+d2KV5eXJym83h5tyzqVfFpxSRnWtTZaV0BWa9m2c+woDi9/WwL X/x2f/s/9VLgNgz39x++EEAkfiibm2rZphHlh6L9C53Xww85kO7sohjfLKpZ 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 K5hnoHQhz8qUQQUghZk9OrRYi6KYNOzOVwcXd4rd0zQo3mLdFDHchJqHFVug WsnrAsOZAcecqCpPK8FhAPj0SDyB7SWHQ1Kb+RbN5soARZ9v4GMhvpLkl0C/ 2PKQjjspONRBpJgG7jxKYnQA+cRAS+fVvMji+UGWdQP7suK7Mimn06J2oT1+ HA1bJc6F3OzujZ5gHEBvEMUPBdlI7SxaDERdqEAlsWa3oJwNWsKZdI5XG90l pRim5GLR8t+iOKWhGMJ3YfmuS9wWft+FiFAgAH87JIIxxEbQMkSeDx0lnjpb AXqOzocEuDQktcRABQmowWmOq3xWNHg+tSklijCdudpA6PC8Pz6ls3UNewAL pXQ/u8DJRm7gYnaJvcFzb7Nz2nTP2150RPlh1vm2+82QXlajUML07Fv1q/Q8 hy8zyzdeJi/zt765w7Z1G1/2qmp8tP1tz3P48hnc1LsW8+1++/fs7beHrYfg ZY23feu0ku6jG14+v0FV9CWFVMZHd79mzsiHOwdQ+XF7s4HIuVOBTNku3VM8 pD0WHhZcMfjMyD97XD7mNUXvRdIjtrZsijR6IcJ5JO1wmdCbLTFJJB1MidaQ /A+qTeKdcMIzS9qlvUAWILrYEiTlOeK0WmNoYTnPYdem6wXLH2SrPId7o/EB 0ZnV8V+hcfKUx4q/N6uKGJBZDPJWrB8rDWKWIl8mOQ8pJBZ0B3xcKSi5hqbC wz6ifIxTuC4WpEqiBJKPx8VyBRwfrZq4xTCYswL2lJQZcrMaO3Gq2XZiYeUR iZYECzvhGHa4abYg4o8C6oOEiEkRWeuuKYMF9DGyUbJfcz3L64GFRBPvU/Jl gQdmOTeezG4xnmbU0gvUlmBB2SjYDIJoWV6F8u9seWf0Nh+eb9xcjyRaAuQs 28mhhlB8wVCvNLBw0HXTEyPHITP/0JdjuAG5yNEFGNi6iscAp38jV6HVEr8u bkb4cbksYME3tCaeczQeZ+oLMk8q7jBIMyy7qbcb5J72g6PwMz51p1EI7cei FxrDUlrhfguy4tZoC2HZxgJzu1eDzdrsCS9Qc53Q2GCuGBfesyJhUhXsTbFl hUdo0nEcTTlfz1b5oiBTOTR2BLvB8bkzsovchRo+AkOnCEwVTjgaQdh9VMzV nOqEymJJtgx+NCyBVC+R7n20IAMdC9Ie6LeREI/OWYMLUuP1Tg+bfPsPnjZt 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 --></rfc>