<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc2629 version 1.6.5 (Ruby 3.0.3) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-ietf-masque-h3-datagram-09" category="std" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.12.3 -->
  <front>
    <title abbrev="HTTP Datagrams">HTTP Datagrams and the Capsule Protocol</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-masque-h3-datagram-09"/>
    <author initials="D." surname="Schinazi" fullname="David Schinazi">
      <organization>Google LLC</organization>
      <address>
        <postal>
          <street>1600 Amphitheatre Parkway</street>
          <city>Mountain View</city>
          <region>CA</region>
          <code>94043</code>
          <country>United States of America</country>
        </postal>
        <email>dschinazi.ietf@gmail.com</email>
      </address>
    </author>
    <author initials="L." surname="Pardue" fullname="Lucas Pardue">
      <organization>Cloudflare</organization>
      <address>
        <email>lucaspardue.24.7@gmail.com</email>
      </address>
    </author>
    <date year="2022" month="April" day="11"/>
    <area>Transport</area>
    <workgroup>MASQUE</workgroup>
    <keyword>quic</keyword>
    <keyword>http</keyword>
    <keyword>datagram</keyword>
    <keyword>fast</keyword>
    <keyword>tunnels</keyword>
    <keyword>turtles all the way down</keyword>
    <keyword>masque</keyword>
    <keyword>http-ng</keyword>
    <abstract>
      <t>This document describes HTTP Datagrams, a convention for conveying multiplexed,
potentially unreliable datagrams inside an HTTP connection.</t>
      <t>In HTTP/3, HTTP Datagrams can be conveyed natively using the QUIC DATAGRAM
extension. When the QUIC DATAGRAM frame is unavailable or undesirable, they can
be sent using the Capsule Protocol, a more general convention for conveying data
in HTTP connections.</t>
      <t>HTTP Datagrams and the Capsule Protocol are intended for use by HTTP extensions,
not applications.</t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
        The latest revision of this draft can be found at <eref target="https://ietf-wg-masque.github.io/draft-ietf-masque-h3-datagram/draft-ietf-masque-h3-datagram.html"/>.
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-ietf-masque-h3-datagram/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        MASQUE Working Group mailing list (<eref target="mailto:masque@ietf.org"/>),
        which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/masque/"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/ietf-wg-masque/draft-ietf-masque-h3-datagram"/>.</t>
    </note>
  </front>
  <middle>
    <section anchor="intro">
      <name>Introduction</name>
      <t>HTTP extensions sometimes need to access underlying transport protocol features
such as unreliable delivery (as offered by <xref target="DGRAM"/>) to enable
desirable features. For example, this could allow introducing an unreliable
version of the CONNECT method, or adding unreliable delivery to WebSockets
<xref target="RFC6455"/>.</t>
      <t>In <xref target="datagrams"/>, this document describes HTTP Datagrams, a convention that
supports the bidirectional and optionally multiplexed exchange of data inside an
HTTP connection. While HTTP datagrams are associated with HTTP requests, they
are not part of message content; instead, they are intended for use by HTTP
extensions (such as the CONNECT method), and are compatible with all versions of
HTTP.</t>
      <t>When HTTP is running over a transport protocol that supports unreliable
delivery (such as when the QUIC DATAGRAM extension is available to HTTP/3), HTTP
Datagrams can use that capability.</t>
      <t>This document also describes the HTTP Capsule Protocol in <xref target="capsule"/>, to allow
conveyance of HTTP Datagrams using reliable delivery. This addresses HTTP/3
cases where use of the QUIC DATAGRAM frame is unavailable or undesirable, or
where the transport protocol only provides reliable delivery, such as with
HTTP/1 or HTTP/2 over TCP.</t>
      <section anchor="defs">
        <name>Conventions and Definitions</name>
        <t>The key words "<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 "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as
described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.</t>
      </section>
    </section>
    <section anchor="datagrams">
      <name>HTTP Datagrams</name>
      <t>HTTP Datagrams are a convention for conveying bidirectional and potentially
unreliable datagrams inside an HTTP connection, with multiplexing when
possible. All HTTP Datagrams are associated with an HTTP request.</t>
      <t>When HTTP Datagrams are conveyed on an HTTP/3 connection, the QUIC DATAGRAM
frame can be used to achieve these goals, including unreliable delivery; see
<xref target="format"/>. Negotiating the use of QUIC DATAGRAM frames for HTTP Datagrams is
achieved via the exchange of HTTP/3 settings; see <xref target="setting"/>.</t>
      <t>When running over HTTP/2, demultiplexing is provided by the HTTP/2 framing
layer, but unreliable delivery is unavailable. HTTP Datagrams are negotiated
and conveyed using the Capsule Protocol; see <xref target="datagram-capsule"/>.</t>
      <t>When running over HTTP/1, requests are strictly serialized in the connection,
and therefore demultiplexing is not available. Unreliable delivery is likewise
not available. HTTP Datagrams are negotiated and conveyed using the Capsule
Protocol; see <xref target="datagram-capsule"/>.</t>
      <t>HTTP Datagrams <bcp14>MUST</bcp14> only be sent with an association to an HTTP request that
explicitly supports them. For example, existing HTTP methods GET and POST do not
define semantics for associated HTTP Datagrams; therefore, HTTP Datagrams cannot
be sent associated with GET or POST request streams.</t>
      <t>If an HTTP Datagram is received and it is associated with a request that has no
known semantics for HTTP Datagrams, the receiver <bcp14>MUST</bcp14> terminate the request; if
HTTP/3 is in use, the request stream <bcp14>MUST</bcp14> be aborted with H3_DATAGRAM_ERROR
(0x33). HTTP extensions can override these requirements by defining a
negotiation mechanism and semantics for HTTP Datagrams.</t>
      <section anchor="format">
        <name>HTTP/3 Datagrams</name>
        <t>When used with HTTP/3, the Datagram Data field of QUIC DATAGRAM frames uses the
following format (using the notation from the "Notational Conventions" section
of <xref target="QUIC"/>):</t>
        <figure anchor="h3-datagram-format">
          <name>HTTP/3 Datagram Format</name>
          <artwork><![CDATA[
HTTP/3 Datagram {
  Quarter Stream ID (i),
  HTTP Datagram Payload (..),
}
]]></artwork>
        </figure>
        <dl>
          <dt>Quarter Stream ID:</dt>
          <dd>
            <t>A variable-length integer that contains the value of the client-initiated
bidirectional stream that this datagram is associated with, divided by four (the
division by four stems from the fact that HTTP requests are sent on
client-initiated bidirectional streams, and those have stream IDs that are
divisible by four). The largest legal QUIC stream ID value is 2<sup>62</sup>-1,
so the largest legal value of Quarter Stream ID is 2<sup>60</sup>-1. Receipt of
an HTTP/3 Datagram that includes a larger value <bcp14>MUST</bcp14> be treated as an HTTP/3
connection error of type H3_DATAGRAM_ERROR (0x33).</t>
          </dd>
          <dt>HTTP Datagram Payload:</dt>
          <dd>
            <t>The payload of the datagram, whose semantics are defined by the extension that
is using HTTP Datagrams. Note that this field can be empty.</t>
          </dd>
        </dl>
        <t>Receipt of a QUIC DATAGRAM frame whose payload is too short to allow parsing the
Quarter Stream ID field <bcp14>MUST</bcp14> be treated as an HTTP/3 connection error of type
H3_DATAGRAM_ERROR (0x33).</t>
        <t>HTTP/3 Datagrams <bcp14>MUST NOT</bcp14> be sent unless the corresponding stream's send side is
open. If a datagram is received after the corresponding stream's receive side is
closed, the received datagrams <bcp14>MUST</bcp14> be silently dropped.</t>
        <t>If an HTTP/3 datagram is received and its Quarter Stream ID maps to a stream
that has not yet been created, the receiver <bcp14>SHALL</bcp14> either drop that datagram
silently or buffer it temporarily (on the order of a round trip) while awaiting
the creation of the corresponding stream.</t>
        <t>If an HTTP/3 datagram is received and its Quarter Stream ID maps to a stream
that cannot be created due to client-initiated bidirectional stream limits, it
<bcp14>SHOULD</bcp14> be treated as an HTTP/3 connection error of type H3_ID_ERROR. Generating
an error is not mandatory in this case because HTTP/3 implementations might have
practical barriers to determining the active stream concurrency limit that is
applied by the QUIC layer.</t>
        <t>Prioritization of HTTP/3 datagrams is not defined in this document. Future
extensions <bcp14>MAY</bcp14> define how to prioritize datagrams, and <bcp14>MAY</bcp14> define signaling to
allow communicating prioritization preferences.</t>
        <section anchor="setting">
          <name>The SETTINGS_H3_DATAGRAM HTTP/3 Setting</name>
          <t>Endpoints can indicate to their peer that they are willing to receive HTTP/3
Datagrams by sending the SETTINGS_H3_DATAGRAM (0x33) setting with a
value of 1.</t>
          <t>The value of the SETTINGS_H3_DATAGRAM setting <bcp14>MUST</bcp14> be either 0 or 1. A value
of 0 indicates that the implementation is not willing to receive HTTP Datagrams.
If the SETTINGS_H3_DATAGRAM setting is received with a value that is neither 0
or 1, the receiver <bcp14>MUST</bcp14> terminate the connection with error H3_SETTINGS_ERROR.</t>
          <t>QUIC DATAGRAM frames <bcp14>MUST NOT</bcp14> be sent until the SETTINGS_H3_DATAGRAM setting
has been both sent and received with a value of 1.</t>
          <t>When clients use 0-RTT, they <bcp14>MAY</bcp14> store the value of the server's
SETTINGS_H3_DATAGRAM setting. Doing so allows the client to send QUIC DATAGRAM
frames in 0-RTT packets. When servers decide to accept 0-RTT data, they <bcp14>MUST</bcp14>
send a SETTINGS_H3_DATAGRAM setting greater than or equal to the value they sent
to the client in the connection where they sent them the NewSessionTicket
message. If a client stores the value of the SETTINGS_H3_DATAGRAM setting with
their 0-RTT state, they <bcp14>MUST</bcp14> validate that the new value of the
SETTINGS_H3_DATAGRAM setting sent by the server in the handshake is greater than
or equal to the stored value; if not, the client <bcp14>MUST</bcp14> terminate the connection
with error H3_SETTINGS_ERROR. In all cases, the maximum permitted value of the
SETTINGS_H3_DATAGRAM setting parameter is 1.</t>
          <t>It is <bcp14>RECOMMENDED</bcp14> that implementations that support receiving HTTP/3 Datagrams
always send the SETTINGS_H3_DATAGRAM setting with a value of 1,
even if the application does not intend to use HTTP/3 Datagrams. This helps to
avoid "sticking out"; see <xref target="security"/>.</t>
          <section anchor="note-about-draft-versions">
            <name>Note About Draft Versions</name>
            <t>[[RFC editor: please remove this section before publication.]]</t>
            <t>Some revisions of this draft specification use a different value (the Identifier
field of a Setting in the HTTP/3 SETTINGS frame) for the SETTINGS_H3_DATAGRAM
setting. This allows new draft revisions to make incompatible changes. Multiple
draft versions <bcp14>MAY</bcp14> be supported by sending multiple values for
SETTINGS_H3_DATAGRAM. Once SETTINGS have been sent and received, an
implementation that supports multiple drafts <bcp14>MUST</bcp14> compute the intersection of
the values it has sent and received, and then it <bcp14>MUST</bcp14> select and use the most
recent draft version from the intersection set. This ensures that both peers
negotiate the same draft version.</t>
          </section>
        </section>
      </section>
      <section anchor="http-datagrams-using-capsules">
        <name>HTTP Datagrams using Capsules</name>
        <t>When HTTP/3 Datagrams are unavailable or undesirable, HTTP Datagrams can be sent
using the Capsule Protocol, see <xref target="datagram-capsule"/>.</t>
      </section>
    </section>
    <section anchor="capsule">
      <name>Capsules</name>
      <t>One mechanism to extend HTTP is to introduce new HTTP Upgrade Tokens (see
<xref section="16.7" sectionFormat="of" target="HTTP"/>). In HTTP/1.x, these tokens
are used via the Upgrade mechanism (see <xref section="7.8" sectionFormat="of" target="HTTP"/>). In HTTP/2 and
HTTP/3, these tokens are used via the Extended CONNECT mechanism (see
<xref target="EXT-CONNECT2"/> and <xref target="EXT-CONNECT3"/>).</t>
      <t>This specification introduces the Capsule Protocol. The Capsule Protocol is a
sequence of type-length-value tuples that definitions of new HTTP Upgrade Tokens
can choose to use. It allows endpoints to reliably communicate request-related
information end-to-end on HTTP request streams, even in the presence of HTTP
intermediaries. The Capsule Protocol can be used to exchange HTTP Datagrams,
which is necessary when HTTP is running over a transport that does not support
the QUIC DATAGRAM frame. The Capsule Protocol can also be used to communicate
reliable and bidirectional control messages associated with a datagram-based
protocol even when HTTP/3 Datagrams are in use.</t>
      <section anchor="data-stream">
        <name>HTTP Data Streams</name>
        <t>This specification defines the "data stream" of an HTTP request as the
bidirectional stream of bytes that follows the header section of the request
message and the final, successful (i.e., 2xx) response message.</t>
        <t>In HTTP/1.x, the data stream consists of all bytes on the connection that follow
the blank line that concludes either the request header section, or the response
header section. As a result, only a single HTTP request starting the capsule
protocol can be sent on HTTP/1.x connections.</t>
        <t>In HTTP/2 and HTTP/3, the data stream of a given HTTP request consists of all
bytes sent in DATA frames with the corresponding stream ID.</t>
        <t>The concept of a data stream is particularly relevant for methods such as
CONNECT where there is no HTTP message content after the headers.</t>
        <t>Data streams can be prioritized using any means suited to stream or request
prioritization. For example, see <xref section="11" sectionFormat="of" target="PRIORITY"/>.</t>
      </section>
      <section anchor="capsule-protocol">
        <name>The Capsule Protocol</name>
        <t>Definitions of new HTTP Upgrade Tokens can state that their associated request's
data stream uses the Capsule Protocol. If they do so, that means that the
contents of the associated request's data stream uses the following format
(using the notation from the "Notational Conventions" section of <xref target="QUIC"/>):</t>
        <figure anchor="capsule-stream-format">
          <name>Capsule Protocol Stream Format</name>
          <artwork><![CDATA[
Capsule Protocol {
  Capsule (..) ...,
}
]]></artwork>
        </figure>
        <figure anchor="capsule-format">
          <name>Capsule Format</name>
          <artwork><![CDATA[
Capsule {
  Capsule Type (i),
  Capsule Length (i),
  Capsule Value (..),
}
]]></artwork>
        </figure>
        <dl>
          <dt>Capsule Type:</dt>
          <dd>
            <t>A variable-length integer indicating the Type of the capsule.</t>
          </dd>
          <dt>Capsule Length:</dt>
          <dd>
            <t>The length of the Capsule Value field following this field, encoded as a
variable-length integer. Note that this field can have a value of zero.</t>
          </dd>
          <dt>Capsule Value:</dt>
          <dd>
            <t>The payload of this capsule. Its semantics are determined by the value of the
Capsule Type field.</t>
          </dd>
        </dl>
        <t>An intermediary can identify the use of the capsule protocol either through the
presence of the Capsule-Protocol header field (<xref target="hdr"/>) or by understanding the
chosen HTTP Upgrade token.</t>
        <t>Because new protocols or extensions might define new capsule types,
intermediaries that wish to allow for future extensibility <bcp14>SHOULD</bcp14> forward
capsules without modification, unless the definition of the Capsule Type in use
specifies additional intermediary processing. One such Capsule Type is the
DATAGRAM capsule; see <xref target="datagram-capsule"/>. In particular, intermediaries <bcp14>SHOULD</bcp14>
forward Capsules with an unknown Capsule Type without modification.</t>
        <t>Endpoints which receive a Capsule with an unknown Capsule Type <bcp14>MUST</bcp14> silently
drop that Capsule and skip over it to parse the next Capsule.</t>
        <t>By virtue of the definition of the data stream:</t>
        <ul spacing="normal">
          <li>The Capsule Protocol is not in use unless the response includes a 2xx
(Successful) status code.</li>
          <li>When the Capsule Protocol is in use, the associated HTTP request and response
do not carry HTTP content. A future extension <bcp14>MAY</bcp14> define a new capsule type to
carry HTTP content.</li>
        </ul>
        <t>The Capsule Protocol <bcp14>MUST NOT</bcp14> be used with messages that contain Content-Length,
Content-Type, or Transfer-Encoding header fields. Additionally, HTTP status
codes 204 (No Content), 205 (Reset Content), and 206 (Partial Content) <bcp14>MUST NOT</bcp14>
be sent on responses that use the Capsule Protocol. A receiver that observes a
violation of these requirements <bcp14>MUST</bcp14> treat the HTTP message as malformed.</t>
      </section>
      <section anchor="error-handling">
        <name>Error Handling</name>
        <t>When an error occurs in processing the Capsule Protocol, the receiver <bcp14>MUST</bcp14> treat
the message as malformed or incomplete, according to the underlying transport
protocol. For HTTP/3, the handling of malformed messages is described in
<xref section="4.1.3" sectionFormat="of" target="H3"/>. For HTTP/2, the handling of malformed messages is
described in <xref section="8.1.1" sectionFormat="of" target="H2"/>. For HTTP/1.1, the handling of incomplete
messages is described in <xref section="8" sectionFormat="of" target="H1"/>.</t>
        <t>Each capsule's payload <bcp14>MUST</bcp14> contain exactly the fields identified in its
description. A capsule payload that contains additional bytes after the
identified fields or a capsule payload that terminates before the end of the
identified fields <bcp14>MUST</bcp14> be treated as a malformed or incomplete message. In
particular, redundant length encodings <bcp14>MUST</bcp14> be verified to be self-consistent.</t>
        <t>If the receive side of a stream carrying capsules is terminated cleanly (for
example, in HTTP/3 this is defined as receiving a QUIC STREAM frame with the FIN
bit set) and the last capsule on the stream was truncated, this <bcp14>MUST</bcp14> be treated
as a malformed or incomplete message.</t>
      </section>
      <section anchor="hdr">
        <name>The Capsule-Protocol Header Field</name>
        <t>The "Capsule-Protocol" header field is an Item Structured Field, see <xref section="3.3" sectionFormat="of" target="STRUCT-FIELD"/>; its value <bcp14>MUST</bcp14> be a Boolean; any other value
type <bcp14>MUST</bcp14> be handled as if the field were not present by recipients (for
example, if this field is included multiple times, its type will become a List
and the field will therefore be ignored). This document does not define any
parameters for the Capsule-Protocol header field value, but future documents
might define parameters. Receivers <bcp14>MUST</bcp14> ignore unknown parameters.</t>
        <t>Endpoints indicate that the Capsule Protocol is in use on a data stream by
sending a Capsule-Protocol header field with a true value. A Capsule-Protocol
header field with a false value has the same semantics as when the header is not
present.</t>
        <t>Intermediaries <bcp14>MAY</bcp14> use this header field to allow processing of HTTP Datagrams
for unknown HTTP Upgrade Tokens; note that this is only possible for HTTP
Upgrade or Extended CONNECT.</t>
        <t>The Capsule-Protocol header field <bcp14>MUST NOT</bcp14> be used on HTTP responses with a
status code outside the 2xx range.</t>
        <t>When using the Capsule Protocol, HTTP endpoints <bcp14>SHOULD</bcp14> send the Capsule-Protocol
header field to simplify intermediary processing. Definitions of new HTTP
Upgrade Tokens that use the Capsule Protocol <bcp14>MAY</bcp14> alter this recommendation.</t>
      </section>
      <section anchor="datagram-capsule">
        <name>The DATAGRAM Capsule</name>
        <t>This document defines the DATAGRAM (0x00) capsule type. This capsule allows HTTP
Datagrams to be sent on a stream using the Capsule Protocol. This is
particularly useful when HTTP is running over a transport that does not support
the QUIC DATAGRAM frame.</t>
        <figure anchor="datagram-capsule-format">
          <name>DATAGRAM Capsule Format</name>
          <artwork><![CDATA[
Datagram Capsule {
  Type (i) = 0x00,
  Length (i),
  HTTP Datagram Payload (..),
}
]]></artwork>
        </figure>
        <dl>
          <dt>HTTP Datagram Payload:</dt>
          <dd>
            <t>The payload of the datagram, whose semantics are defined by the extension that
is using HTTP Datagrams. Note that this field can be empty.</t>
          </dd>
        </dl>
        <t>HTTP Datagrams sent using the DATAGRAM capsule have the same semantics as
those sent in QUIC DATAGRAM frames. In particular, the restrictions on when
it is allowed to send an HTTP Datagram and how to process them from <xref target="format"/>
also apply to HTTP Datagrams sent and received using the DATAGRAM capsule.</t>
        <t>An intermediary can reencode HTTP Datagrams as it forwards them. In other words,
an intermediary <bcp14>MAY</bcp14> send a DATAGRAM capsule to forward an HTTP Datagram that
was received in a QUIC DATAGRAM frame, and vice versa. Intermediaries <bcp14>MUST NOT</bcp14>
perform this reencoding unless they have identified the use of the Capsule
Protocol on the corresponding request stream; see <xref target="capsule-protocol"/>.</t>
        <t>Note that while DATAGRAM capsules that are sent on a stream are reliably
delivered in order, intermediaries can reencode DATAGRAM capsules into QUIC
DATAGRAM frames when forwarding messages, which could result in loss or
reordering.</t>
        <t>If an intermediary receives an HTTP Datagram in a QUIC DATAGRAM frame and is
forwarding it on a connection that supports QUIC DATAGRAM frames, the
intermediary <bcp14>SHOULD NOT</bcp14> convert that HTTP Datagram to a DATAGRAM capsule. If the
HTTP Datagram is too large to fit in a DATAGRAM frame (for example because the
path MTU of that QUIC connection is too low or if the maximum UDP payload size
advertised on that connection is too low), the intermediary <bcp14>SHOULD</bcp14> drop the HTTP
Datagram instead of converting it to a DATAGRAM capsule. This preserves the
end-to-end unreliability characteristic that methods such as Datagram
Packetization Layer Path MTU Discovery (DPLPMTUD) depend on
<xref target="DPLPMTUD"/>. An intermediary that converts QUIC DATAGRAM frames to
DATAGRAM capsules allows HTTP Datagrams to be arbitrarily large without
suffering any loss; this can misrepresent the true path properties, defeating
methods such as DPLPMTUD.</t>
        <t>While DATAGRAM capsules can theoretically carry a payload of length
2<sup>62</sup>-1, most HTTP extensions that use HTTP Datagrams will have their
own limits on what datagram payload sizes are practical. Implementations <bcp14>SHOULD</bcp14>
take those limits into account when parsing DATAGRAM capsules: if an incoming
DATAGRAM capsule has a length that is known to be so large as to not be usable,
the implementation <bcp14>SHOULD</bcp14> discard the capsule without buffering its contents
into memory.</t>
        <t>Note that it is possible for an HTTP extension to use HTTP Datagrams without
using the Capsule Protocol. For example, if an HTTP extension that uses HTTP
Datagrams is only defined over transports that support QUIC DATAGRAM frames, it
might not need a stream encoding. Additionally, HTTP extensions can use HTTP
Datagrams with their own data stream protocol. However, new HTTP extensions that
wish to use HTTP Datagrams <bcp14>SHOULD</bcp14> use the Capsule Protocol as failing to do so
will make it harder for the HTTP extension to support versions of HTTP other
than HTTP/3 and will prevent interoperability with intermediaries that only
support the Capsule Protocol.</t>
      </section>
    </section>
    <section anchor="security">
      <name>Security Considerations</name>
      <t>Since transmitting HTTP Datagrams using QUIC DATAGRAM frames requires sending
the HTTP/3 SETTINGS_H3_DATAGRAM setting, it "sticks out". In other words,
probing clients can learn whether a server supports HTTP Datagrams over QUIC
DATAGRAM frames. As some servers might wish to obfuscate the fact that they
offer application services that use HTTP datagrams, it's best for all
implementations that support this feature to always send this setting, see
<xref target="setting"/>.</t>
      <t>Since use of the Capsule Protocol is restricted to new HTTP Upgrade Tokens, it
is not accessible from Web Platform APIs (such as those commonly accessed via
JavaScript in web browsers).</t>
    </section>
    <section anchor="iana">
      <name>IANA Considerations</name>
      <section anchor="iana-setting">
        <name>HTTP/3 Setting</name>
        <t>This document will request IANA to register the following entry in the
"HTTP/3 Settings" registry:</t>
        <dl spacing="compact">
          <dt>Value:</dt>
          <dd>
            <t>0x33</t>
          </dd>
          <dt>Setting Name:</dt>
          <dd>
            <t>SETTINGS_H3_DATAGRAM</t>
          </dd>
          <dt>Default:</dt>
          <dd>
            <t>0</t>
          </dd>
          <dt>Status:</dt>
          <dd>
            <t>provisional (permanent if this document is approved)</t>
          </dd>
          <dt>Specification:</dt>
          <dd>
            <t>This Document</t>
          </dd>
          <dt>Change Controller:</dt>
          <dd>
            <t>IETF</t>
          </dd>
          <dt>Contact:</dt>
          <dd>
            <t>HTTP_WG; HTTP working group; ietf-http-wg@w3.org</t>
          </dd>
        </dl>
      </section>
      <section anchor="iana-error">
        <name>HTTP/3 Error Code</name>
        <t>This document will request IANA to register the following entry in the
"HTTP/3 Error Codes" registry:</t>
        <dl spacing="compact">
          <dt>Value:</dt>
          <dd>
            <t>0x33</t>
          </dd>
          <dt>Name:</dt>
          <dd>
            <t>H3_DATAGRAM_ERROR</t>
          </dd>
          <dt>Description:</dt>
          <dd>
            <t>Datagram or capsule protocol parse error</t>
          </dd>
          <dt>Status:</dt>
          <dd>
            <t>provisional (permanent if this document is approved)</t>
          </dd>
          <dt>Specification:</dt>
          <dd>
            <t>This Document</t>
          </dd>
          <dt>Change Controller:</dt>
          <dd>
            <t>IETF</t>
          </dd>
          <dt>Contact:</dt>
          <dd>
            <t>HTTP_WG; HTTP working group; ietf-http-wg@w3.org</t>
          </dd>
        </dl>
      </section>
      <section anchor="iana-hdr">
        <name>HTTP Header Field Name</name>
        <t>This document will request IANA to register the following entry in the "HTTP
Field Name" registry:</t>
        <dl spacing="compact">
          <dt>Field Name:</dt>
          <dd>
            <t>Capsule-Protocol</t>
          </dd>
          <dt>Template:</dt>
          <dd>
            <t>None</t>
          </dd>
          <dt>Status:</dt>
          <dd>
            <t>provisional (permanent if this document is approved)</t>
          </dd>
          <dt>Reference:</dt>
          <dd>
            <t>This document</t>
          </dd>
          <dt>Comments:</dt>
          <dd>
            <t>None</t>
          </dd>
        </dl>
      </section>
      <section anchor="iana-types">
        <name>Capsule Types</name>
        <t>This document establishes a registry for HTTP capsule type codes. The "HTTP
Capsule Types" registry governs a 62-bit space, and operates under the QUIC
registration policy documented in <xref section="22.1" sectionFormat="of" target="QUIC"/>. This new registry
includes the common set of fields listed in <xref section="22.1.1" sectionFormat="of" target="QUIC"/>. In
addition to those common fields, all registrations in this registry <bcp14>MUST</bcp14> include
a "Capsule Type" field which contains a short name or label for the capsule type.</t>
        <t>Permanent registrations in this registry are assigned using the Specification
Required policy (<xref section="4.6" sectionFormat="of" target="IANA-POLICY"/>), except for values
between 0x00 and 0x3f (in hexadecimal; inclusive), which are assigned using
Standards Action or IESG Approval as defined in Sections <xref target="IANA-POLICY" section="4.9" sectionFormat="bare"/> and <xref target="IANA-POLICY" section="4.10" sectionFormat="bare"/> of <xref target="IANA-POLICY"/>.</t>
        <t>Capsule types with a value of the form 0x29 * N + 0x17 for integer values of N
are reserved to exercise the requirement that unknown capsule types be ignored.
These capsules have no semantics and can carry arbitrary values. These values
<bcp14>MUST NOT</bcp14> be assigned by IANA and <bcp14>MUST NOT</bcp14> appear in the listing of assigned
values.</t>
        <t>This registry initially contains the following entry:</t>
        <dl spacing="compact">
          <dt>Value:</dt>
          <dd>
            <t>0x00</t>
          </dd>
          <dt>Capsule Type:</dt>
          <dd>
            <t>DATAGRAM</t>
          </dd>
          <dt>Status:</dt>
          <dd>
            <t>permanent</t>
          </dd>
          <dt>Specification:</dt>
          <dd>
            <t>This document</t>
          </dd>
          <dt>Change Controller:</dt>
          <dd>
            <t>IETF</t>
          </dd>
          <dt>Contact:</dt>
          <dd>
            <t>MASQUE Working Group <eref target="mailto:masque@ietf.org">masque@ietf.org</eref></t>
          </dd>
          <dt>Notes:</dt>
          <dd>
            <t>None</t>
          </dd>
        </dl>
      </section>
    </section>
  </middle>
  <back>
    <displayreference target="H1" to="HTTP/1.1"/>
    <displayreference target="H2" to="HTTP/2"/>
    <displayreference target="H3" to="HTTP/3"/>
    <references>
      <name>References</name>
      <references>
        <name>Normative References</name>
        <reference anchor="H1">
          <front>
            <title>HTTP/1.1</title>
            <author fullname="Roy T. Fielding">
              <organization>Adobe</organization>
            </author>
            <author fullname="Mark Nottingham">
              <organization>Fastly</organization>
            </author>
            <author fullname="Julian Reschke">
              <organization>greenbytes GmbH</organization>
            </author>
            <date day="12" month="September" year="2021"/>
            <abstract>
              <t>   The Hypertext Transfer Protocol (HTTP) is a stateless application-
   level protocol for distributed, collaborative, hypertext information
   systems.  This document specifies the HTTP/1.1 message syntax,
   message parsing, connection management, and related security
   concerns.

   This document obsoletes portions of RFC 7230.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-httpbis-messaging-19"/>
        </reference>
        <reference anchor="H2">
          <front>
            <title>HTTP/2</title>
            <author fullname="Martin Thomson">
              <organization>Mozilla</organization>
            </author>
            <author fullname="Cory Benfield">
              <organization>Apple Inc.</organization>
            </author>
            <date day="24" month="January" year="2022"/>
            <abstract>
              <t>   This specification describes an optimized expression of the semantics
   of the Hypertext Transfer Protocol (HTTP), referred to as HTTP
   version 2 (HTTP/2).  HTTP/2 enables a more efficient use of network
   resources and a reduced latency by introducing field compression and
   allowing multiple concurrent exchanges on the same connection.

   This document obsoletes RFC 7540 and RFC 8740.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-httpbis-http2bis-07"/>
        </reference>
        <reference anchor="H3">
          <front>
            <title>Hypertext Transfer Protocol Version 3 (HTTP/3)</title>
            <author fullname="Mike Bishop">
              <organization>Akamai</organization>
            </author>
            <date day="2" month="February" year="2021"/>
            <abstract>
              <t>The QUIC transport protocol has several features that are desirable
   in a transport for HTTP, such as stream multiplexing, per-stream flow
   control, and low-latency connection establishment.  This document
   describes a mapping of HTTP semantics over QUIC.  This document also
   identifies HTTP/2 features that are subsumed by QUIC, and describes
   how HTTP/2 extensions can be ported to HTTP/3.

DO NOT DEPLOY THIS VERSION OF HTTP

   DO NOT DEPLOY THIS VERSION OF HTTP/3 UNTIL IT IS IN AN RFC.  This
   version is still a work in progress.  For trial deployments, please
   use earlier versions.

Note to Readers

   Discussion of this draft takes place on the QUIC working group
   mailing list (quic@ietf.org), which is archived at
   https://mailarchive.ietf.org/arch/search/?email_list=quic.

   Working Group information can be found at https://github.com/quicwg;
   source code and issues list for this draft can be found at
   https://github.com/quicwg/base-drafts/labels/-http.
              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-quic-http-34"/>
        </reference>
        <reference anchor="DGRAM">
          <front>
            <title>An Unreliable Datagram Extension to QUIC</title>
            <author fullname="T. Pauly" initials="T." surname="Pauly">
              <organization/>
            </author>
            <author fullname="E. Kinnear" initials="E." surname="Kinnear">
              <organization/>
            </author>
            <author fullname="D. Schinazi" initials="D." surname="Schinazi">
              <organization/>
            </author>
            <date month="March" year="2022"/>
            <abstract>
              <t>This document defines an extension to the QUIC transport protocol to add support for sending and receiving unreliable datagrams over a QUIC connection.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9221"/>
          <seriesInfo name="DOI" value="10.17487/RFC9221"/>
        </reference>
        <reference anchor="RFC2119">
          <front>
            <title>Key words for use in RFCs to Indicate Requirement Levels</title>
            <author fullname="S. Bradner" initials="S." surname="Bradner">
              <organization/>
            </author>
            <date 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">
          <front>
            <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
            <author fullname="B. Leiba" initials="B." surname="Leiba">
              <organization/>
            </author>
            <date 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="QUIC">
          <front>
            <title>QUIC: A UDP-Based Multiplexed and Secure Transport</title>
            <author fullname="J. Iyengar" initials="J." role="editor" surname="Iyengar">
              <organization/>
            </author>
            <author fullname="M. Thomson" initials="M." role="editor" surname="Thomson">
              <organization/>
            </author>
            <date month="May" year="2021"/>
            <abstract>
              <t>This document defines the core of the QUIC transport protocol.  QUIC provides applications with flow-controlled streams for structured communication, low-latency connection establishment, and network path migration. QUIC includes security measures that ensure confidentiality, integrity, and availability in a range of deployment circumstances.  Accompanying documents describe the integration of TLS for key negotiation, loss detection, and an exemplary congestion control algorithm.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9000"/>
          <seriesInfo name="DOI" value="10.17487/RFC9000"/>
        </reference>
        <reference anchor="HTTP">
          <front>
            <title>HTTP Semantics</title>
            <author fullname="Roy T. Fielding">
              <organization>Adobe</organization>
            </author>
            <author fullname="Mark Nottingham">
              <organization>Fastly</organization>
            </author>
            <author fullname="Julian Reschke">
              <organization>greenbytes GmbH</organization>
            </author>
            <date day="12" month="September" year="2021"/>
            <abstract>
              <t>   The Hypertext Transfer Protocol (HTTP) is a stateless application-
   level protocol for distributed, collaborative, hypertext information
   systems.  This document describes the overall architecture of HTTP,
   establishes common terminology, and defines aspects of the protocol
   that are shared by all versions.  In this definition are core
   protocol elements, extensibility mechanisms, and the "http" and
   "https" Uniform Resource Identifier (URI) schemes.

   This document updates RFC 3864 and obsoletes RFC 2818, RFC 7231, RFC
   7232, RFC 7233, RFC 7235, RFC 7538, RFC 7615, RFC 7694, and portions
   of RFC 7230.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-httpbis-semantics-19"/>
        </reference>
        <reference anchor="STRUCT-FIELD">
          <front>
            <title>Structured Field Values for HTTP</title>
            <author fullname="M. Nottingham" initials="M." surname="Nottingham">
              <organization/>
            </author>
            <author fullname="P-H. Kamp" initials="P-H." surname="Kamp">
              <organization/>
            </author>
            <date month="February" year="2021"/>
            <abstract>
              <t>This document describes a set of data types and associated algorithms that are intended to make it easier and safer to define and handle HTTP header and trailer fields, known as "Structured Fields", "Structured Headers", or "Structured Trailers". It is intended for use by specifications of new HTTP fields that wish to use a common syntax that is more restrictive than traditional HTTP field values.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8941"/>
          <seriesInfo name="DOI" value="10.17487/RFC8941"/>
        </reference>
        <reference anchor="IANA-POLICY">
          <front>
            <title>Guidelines for Writing an IANA Considerations Section in RFCs</title>
            <author fullname="M. Cotton" initials="M." surname="Cotton">
              <organization/>
            </author>
            <author fullname="B. Leiba" initials="B." surname="Leiba">
              <organization/>
            </author>
            <author fullname="T. Narten" initials="T." surname="Narten">
              <organization/>
            </author>
            <date month="June" year="2017"/>
            <abstract>
              <t>Many protocols make use of points of extensibility that use constants to identify various protocol parameters.  To ensure that the values in these fields do not have conflicting uses and to promote interoperability, their allocations are often coordinated by a central record keeper.  For IETF protocols, that role is filled by the Internet Assigned Numbers Authority (IANA).</t>
              <t>To make assignments in a given registry prudently, guidance describing the conditions under which new values should be assigned, as well as when and how modifications to existing values can be made, is needed.  This document defines a framework for the documentation of these guidelines by specification authors, in order to assure that the provided guidance for the IANA Considerations is clear and addresses the various issues that are likely in the operation of a registry.</t>
              <t>This is the third edition of this document; it obsoletes RFC 5226.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="26"/>
          <seriesInfo name="RFC" value="8126"/>
          <seriesInfo name="DOI" value="10.17487/RFC8126"/>
        </reference>
      </references>
      <references>
        <name>Informative References</name>
        <reference anchor="RFC6455">
          <front>
            <title>The WebSocket Protocol</title>
            <author fullname="I. Fette" initials="I." surname="Fette">
              <organization/>
            </author>
            <author fullname="A. Melnikov" initials="A." surname="Melnikov">
              <organization/>
            </author>
            <date month="December" year="2011"/>
            <abstract>
              <t>The WebSocket Protocol enables two-way communication between a client running untrusted code in a controlled environment to a remote host that has opted-in to communications from that code.  The security model used for this is the origin-based security model commonly used by web browsers.  The protocol consists of an opening handshake followed by basic message framing, layered over TCP.  The goal of this technology is to provide a mechanism for browser-based applications that need two-way communication with servers that does not rely on opening multiple HTTP connections (e.g., using XMLHttpRequest or &lt;iframe&gt;s and long polling).  [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6455"/>
          <seriesInfo name="DOI" value="10.17487/RFC6455"/>
        </reference>
        <reference anchor="EXT-CONNECT2">
          <front>
            <title>Bootstrapping WebSockets with HTTP/2</title>
            <author fullname="P. McManus" initials="P." surname="McManus">
              <organization/>
            </author>
            <date month="September" year="2018"/>
            <abstract>
              <t>This document defines a mechanism for running the WebSocket Protocol (RFC 6455) over a single stream of an HTTP/2 connection.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8441"/>
          <seriesInfo name="DOI" value="10.17487/RFC8441"/>
        </reference>
        <reference anchor="EXT-CONNECT3">
          <front>
            <title>Bootstrapping WebSockets with HTTP/3</title>
            <author fullname="Ryan Hamilton">
              <organization>Google</organization>
            </author>
            <date day="8" month="February" year="2022"/>
            <abstract>
              <t>   The mechanism for running the WebSocket Protocol over a single stream
   of an HTTP/2 connection is equally applicable to HTTP/3, but the HTTP
   version-specific details need to be specified.  This document
   describes how the mechanism is adapted for HTTP/3.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-httpbis-h3-websockets-04"/>
        </reference>
        <reference anchor="PRIORITY">
          <front>
            <title>Extensible Prioritization Scheme for HTTP</title>
            <author fullname="Kazuho Oku">
              <organization>Fastly</organization>
            </author>
            <author fullname="Lucas Pardue">
              <organization>Cloudflare</organization>
            </author>
            <date day="17" month="January" year="2022"/>
            <abstract>
              <t>   This document describes a scheme that allows an HTTP client to
   communicate its preferences for how the upstream server prioritizes
   responses to its requests, and also allows a server to hint to a
   downstream intermediary how its responses should be prioritized when
   they are forwarded.  This document defines the Priority header field
   for communicating the initial priority in an HTTP version-independent
   manner, as well as HTTP/2 and HTTP/3 frames for reprioritizing
   responses.  These share a common format structure that is designed to
   provide future extensibility.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-httpbis-priority-12"/>
        </reference>
        <reference anchor="DPLPMTUD">
          <front>
            <title>Packetization Layer Path MTU Discovery for Datagram Transports</title>
            <author fullname="G. Fairhurst" initials="G." surname="Fairhurst">
              <organization/>
            </author>
            <author fullname="T. Jones" initials="T." surname="Jones">
              <organization/>
            </author>
            <author fullname="M. Tüxen" initials="M." surname="Tüxen">
              <organization/>
            </author>
            <author fullname="I. Rüngeler" initials="I." surname="Rüngeler">
              <organization/>
            </author>
            <author fullname="T. Völker" initials="T." surname="Völker">
              <organization/>
            </author>
            <date month="September" year="2020"/>
            <abstract>
              <t>This document specifies Datagram Packetization Layer Path MTU Discovery (DPLPMTUD). This is a robust method for Path MTU Discovery (PMTUD) for datagram Packetization Layers (PLs). It allows a PL, or a datagram application that uses a PL, to discover whether a network path can support the current size of datagram.  This can be used to detect and reduce the message size when a sender encounters a packet black hole. It can also probe a network path to discover whether the maximum packet size can be increased.  This provides functionality for datagram transports that is equivalent to the PLPMTUD specification for TCP, specified in RFC 4821, which it updates. It also updates the UDP Usage Guidelines to refer to this method for use with UDP datagrams and updates SCTP.</t>
              <t>The document provides implementation notes for incorporating Datagram PMTUD into IETF datagram transports or applications that use datagram transports.</t>
              <t>This specification updates RFC 4960, RFC 4821, RFC 6951, RFC 8085, and RFC 8261.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8899"/>
          <seriesInfo name="DOI" value="10.17487/RFC8899"/>
        </reference>
      </references>
    </references>
    <section numbered="false" anchor="acks">
      <name>Acknowledgments</name>
      <t>Portions of this document were previously part of the QUIC DATAGRAM frame
definition itself, the authors would like to acknowledge the authors of that
document and the members of the IETF MASQUE working group for their suggestions.
Additionally, the authors would like to thank Martin Thomson for suggesting the
use of an HTTP/3 setting. Furthermore, the authors would like to
thank Ben Schwartz for writing the first proposal that used two layers of
indirection. The final design in this document came out of the HTTP Datagrams
Design Team, whose members were Alan Frindell, Alex Chernyakhovsky, Ben
Schwartz, Eric Rescorla, Marcus Ihlar, Martin Thomson, Mike Bishop, Tommy Pauly,
Victor Vasiliev, and the authors of this document. The authors thank Mark
Nottingham and Philipp Tiesel for their helpful comments.</t>
    </section>
  </back>
  <!-- ##markdown-source:
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

-->

</rfc>
