<?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-rfc version 1.7.23 (Ruby 3.3.6) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-ietf-lake-edhoc-psk-02" category="info" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.26.0 -->
  <front>
    <title abbrev="TODO - Abbreviation">EDHOC PSK authentication</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-lake-edhoc-psk-02"/>
    <author fullname="Elsa Lopez-Perez">
      <organization>Inria</organization>
      <address>
        <email>elsa.lopez-perez@inria.fr</email>
      </address>
    </author>
    <author fullname="Göran Selander">
      <organization>Ericsson</organization>
      <address>
        <email>goran.selander@ericsson.com</email>
      </address>
    </author>
    <author fullname="John Preuß Mattsson">
      <organization>Ericsson</organization>
      <address>
        <email>john.mattsson@ericsson.com</email>
      </address>
    </author>
    <author fullname="Rafael Marin-Lopez">
      <organization>University of Murcia</organization>
      <address>
        <email>rafa@um.es</email>
      </address>
    </author>
    <date year="2025" month="February" day="03"/>
    <area>Security</area>
    <workgroup>LAKE Working Group</workgroup>
    <abstract>
      <?line 53?>

<t>This document specifies the Pre-Shared Key (PSK) authentication method for the Ephemeral Diffie-Hellman Over COSE (EDHOC) key exchange protocol. It describes the authentication processes, message flows, and security considerations of this authentication method.</t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
        The latest revision of this draft can be found at <eref target="https://elsalopez133.github.io/draft-lopez-lake-edhoc-psk/#go.draft-lopez-lake-edhoc-psk.html"/>.
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-ietf-lake-edhoc-psk/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        LAKE Working Group mailing list (<eref target="mailto:lake@ietf.org"/>),
        which is archived at <eref target="https://example.com/WG"/>.
        Subscribe at <eref target="https://www.ietf.org/mailman/listinfo/lake/"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/ElsaLopez133/draft-lopez-lake-psk"/>.</t>
    </note>
  </front>
  <middle>
    <?line 57?>

<section anchor="introduction">
      <name>Introduction</name>
      <section anchor="motivation">
        <name>Motivation</name>
        <t>Pre-shared key (PSK) authentication method provides a balance between security and computational efficiency.
This authentication method was proposed in the first I-Ds of Ephemeral Diffie-Hellman Over COSE (EDHOC) <xref target="RFC9528"/>, and was ruled out to speed out the development process.
However, there is now a renewed effort to reintroduce PSK authentication, making this draft an update to the <xref target="RFC9528"/>.</t>
        <t>EDHOC with PSK authentication could be beneficial for existing systems where two nodes have been provided with a PSK from other parties out of band.
This allows the nodes to perform ephemeral Diffie-Hellman to achieve Perfect Forward Secrecy (PFS), ensuring that past communications remain secure even if the PSK is compromised.
The authentication provided by EDHOC prevents eavesdropping by on-path attackers, as they would need to be active participants in the communication to intercept and potentially tamper with the session.
Examples could be Generic Bootstrapping Architecture (GBA) and Authenticated Key Management Architecture (AKMA) in mobile systems, or Peer and Authenticator in EAP.</t>
        <t>Another prominent use case of PSK authentication in the EDHOC protocol is session resumption.
This allows previously connected parties to quickly reestablish secure communication using pre-shared keys from their earlier session, reducing the overhead of full key exchange.
This efficiency is beneficial in scenarios where frequent key updates are needed, such in resource-constrained environments or applications requiring high-frequency secure communications.
The use of PSK authentication in EDHOC ensures that session key can be refreshed without heavy computational overhead, typically associated with public key operations, thus optimizing both performance and security.</t>
      </section>
    </section>
    <section anchor="conventions-and-definitions">
      <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>
      <?line -18?>

<t>Readers are expected to be familiar with the terms and concepts described in CBOR <xref target="RFC8949"/>, CBOR Sequences <xref target="RFC8742"/>, COSE Structures and Processing <xref target="RFC9052"/>, COSE Algorithms <xref target="RFC9053"/>, CWT and CCS <xref target="RFC8392"/>, and the Concise Data Definition Language (CDDL) <xref target="RFC8610"/>, which is used to express CBOR data structures.</t>
    </section>
    <section anchor="protocol">
      <name>Protocol</name>
      <t>In this method, the Pre-Shared Key identifier (ID_CRED_PSK) is sent in message_3. The ID_CRED_PSK allows retrieval of CRED_PSK, a COSE_Key compatible authentication credential that contains the PSK. Through this document we will refer to the Pre-Shared Key authentication method as EDHOC-PSK.</t>
      <section anchor="credentials">
        <name>Credentials</name>
        <t>Initiator and Responder are assumed to have a PSK with good amount of randomness and the requirements that:</t>
        <ul spacing="normal">
          <li>
            <t>Only the Initiator and the Responder have access to the PSK.</t>
          </li>
          <li>
            <t>The Responder is able to retrieve the PSK using ID_CRED_PSK.</t>
          </li>
        </ul>
        <t>where:</t>
        <ul spacing="normal">
          <li>
            <t>ID_CRED_PSK is a COSE header map containing header parameters that can identify a pre-shared key. For example:</t>
          </li>
        </ul>
        <artwork><![CDATA[
ID_CRED_PSK = {4 : h'lf' }
]]></artwork>
        <ul spacing="normal">
          <li>
            <t>CRED_PSK is a COSE_Key compatible authentication credential, i.e., a CBOR Web Token (CWT) or CWT Claims Set (CCS) <xref target="RFC8392"/> whose 'cnf' claim uses the confirmation method 'COSE_Key' encoding the PSK. For example:</t>
          </li>
        </ul>
        <artwork><![CDATA[
{                                               /CCS/
  2 : "mydotbot",                               /sub/
  8 : {                                         /cnf/
    1 : {                                       /COSE_Key/
       1 : 4,                                   /kty/
       2 : h'32',                               /kid/
      -1 : h'50930FF462A77A3540CF546325DEA214'  /k/
    }
  }
}
]]></artwork>
        <t>The purpose of ID_CRED_PSK is to facilitate the retrieval of the PSK.
It is <bcp14>RECOMMENDED</bcp14> that it uniquely identifies the CRED_PSK as the recipient might otherwise have to try several keys.
If ID_CRED_PSK contains a single 'kid' parameter, then the compact encoding is applied; see <eref target="https://www.rfc-editor.org/rfc/rfc9528.html#section-3.5.3.2">Section 3.5.3.2 of RFC9528</eref>.
The authentication credential CRED_PSK substitutes CRED_I and CRED_R specified in <xref target="RFC9528"/>, and, when applicable, <bcp14>MUST</bcp14> follow the same guidelines described in  <eref target="https://www.rfc-editor.org/rfc/rfc9528.html#section-3.5.2">Section 3.5.2</eref> and <eref target="https://www.rfc-editor.org/rfc/rfc9528.html#section-3.5.3">Section 3.5.3 of RFC9528</eref>.</t>
      </section>
      <section anchor="message-flow-of-psk">
        <name>Message flow of PSK</name>
        <t>The ID_CRED_PSK is sent in message_3, encrypted using a key derived from the ephemeral shared secret, G_XY. The Responder authenticates the Initiator first.
<xref target="fig-variant2"/> shows the message flow of PSK authentication method.</t>
        <figure anchor="fig-variant2">
          <name>Overview of message flow of PSK.</name>
          <artset>
            <artwork type="svg" align="center"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" height="288" width="560" viewBox="0 0 560 288" class="diagram" text-anchor="middle" font-family="monospace" font-size="13px" stroke-linecap="round">
                <path d="M 8,48 L 8,272" fill="none" stroke="black"/>
                <path d="M 552,48 L 552,272" fill="none" stroke="black"/>
                <path d="M 8,64 L 544,64" fill="none" stroke="black"/>
                <path d="M 16,128 L 552,128" fill="none" stroke="black"/>
                <path d="M 8,192 L 544,192" fill="none" stroke="black"/>
                <path d="M 16,256 L 552,256" fill="none" stroke="black"/>
                <polygon class="arrowhead" points="552,192 540,186.4 540,197.6" fill="black" transform="rotate(0,544,192)"/>
                <polygon class="arrowhead" points="552,64 540,58.4 540,69.6" fill="black" transform="rotate(0,544,64)"/>
                <polygon class="arrowhead" points="24,256 12,250.4 12,261.6" fill="black" transform="rotate(180,16,256)"/>
                <polygon class="arrowhead" points="24,128 12,122.4 12,133.6" fill="black" transform="rotate(180,16,128)"/>
                <g class="text">
                  <text x="40" y="36">Initiator</text>
                  <text x="520" y="36">Responder</text>
                  <text x="184" y="52">METHOD,</text>
                  <text x="256" y="52">SUITES_I,</text>
                  <text x="316" y="52">G_X,</text>
                  <text x="356" y="52">C_I,</text>
                  <text x="400" y="52">EAD_1</text>
                  <text x="280" y="84">message_1</text>
                  <text x="204" y="116">G_Y,</text>
                  <text x="244" y="116">Enc(</text>
                  <text x="284" y="116">C_R,</text>
                  <text x="328" y="116">EAD_2</text>
                  <text x="360" y="116">)</text>
                  <text x="280" y="148">message_2</text>
                  <text x="180" y="180">Enc(</text>
                  <text x="248" y="180">ID_CRED_PSK</text>
                  <text x="308" y="180">),</text>
                  <text x="344" y="180">AEAD(</text>
                  <text x="392" y="180">EAD_3</text>
                  <text x="424" y="180">)</text>
                  <text x="280" y="212">message_3</text>
                  <text x="248" y="244">AEAD(</text>
                  <text x="296" y="244">EAD_4</text>
                  <text x="328" y="244">)</text>
                  <text x="280" y="276">message_4</text>
                </g>
              </svg>
            </artwork>
            <artwork type="ascii-art" align="center"><![CDATA[
Initiator                                                   Responder
|                  METHOD, SUITES_I, G_X, C_I, EAD_1                |
+------------------------------------------------------------------>|
|                             message_1                             |
|                                                                   |
|                      G_Y, Enc( C_R, EAD_2 )                       |
|<------------------------------------------------------------------+
|                             message_2                             |
|                                                                   |
|                   Enc( ID_CRED_PSK ), AEAD( EAD_3 )               |
+------------------------------------------------------------------>|
|                             message_3                             |
|                                                                   |
|                           AEAD( EAD_4 )                           |
|<------------------------------------------------------------------+
|                             message_4                             |
]]></artwork>
          </artset>
        </figure>
        <t>This approach provides protection against passive attackers for both Initiator and Responder.
message_4 remains optional, but is needed to authenticate the Responder and achieve mutual authentication in EDHOC if not relaying on external applications, such as OSCORE. With this fourth message, the protocol achieves both explicit key confirmation and mutual authentication.</t>
      </section>
    </section>
    <section anchor="key-derivation">
      <name>Key derivation</name>
      <t>The pseudorandom keys (PRKs) used for PSK authentication method in EDHOC are derived using EDHOC_Extract, as done in <xref target="RFC9528"/>.</t>
      <artwork><![CDATA[
PRK  = EDHOC_Extract( salt, IKM )
]]></artwork>
      <t>where the salt and input keying material (IKM) are defined for each key.
The definition of EDHOC_Extract depends on the EDHOC hash algorithm selected in the cipher suite.</t>
      <t><xref target="fig-variant2key"/> lists the key derivations that differ from those specified in <eref target="https://www.rfc-editor.org/rfc/rfc9528.html#section-4.1.2">Section 4.1.2 of RFC9528</eref>.</t>
      <figure anchor="fig-variant2key">
        <name>Key derivation of EDHOC PSK authentication method.</name>
        <artwork align="center"><![CDATA[
PRK_3e2m      = PRK_2e
PRK_4e3m      = EDHOC_Extract( SALT_4e3m, CRED_PSK )
KEYSTREAM_3   = EDHOC_KDF( PRK_3e2m,    TBD, TH_3,  ID_CRED_PSK length )
K_3           = EDHOC_KDF( PRK_4e3m,    TBD, TH_3,  key_length )
IV_3          = EDHOC_KDF( PRK_4e3m,    TBD, TH_3,  iv_length  )
]]></artwork>
      </figure>
      <t>where:</t>
      <ul spacing="normal">
        <li>
          <t>KEYSTREAM_3 is used to encrypt the ID_CRED_PSK in message_3.</t>
        </li>
        <li>
          <t>TH_3 = H( TH_2, PLAINTEXT_2, CRED_PSK )</t>
        </li>
      </ul>
      <t>Additionally, the definition of the transcript hash TH_4 is modified as:</t>
      <ul spacing="normal">
        <li>
          <t>TH_4 = H( TH_3, ID_CRED_PSK, ? EAD_3, CRED_PSK )</t>
        </li>
      </ul>
    </section>
    <section anchor="message-formatting-and-processing">
      <name>Message formatting and processing</name>
      <t>This section specifies the differences on the message formatting compared to <xref target="RFC9528"/>.</t>
      <section anchor="message-1">
        <name>Message 1</name>
        <t>Same as message_1 of EDHOC, described in <eref target="https://www.rfc-editor.org/rfc/rfc9528.html#section-5.2.1">Section 5.2.1 of RFC9528</eref>.</t>
      </section>
      <section anchor="message-2">
        <name>Message 2</name>
        <t>message_2 <bcp14>SHALL</bcp14> be a CBOR sequence, defined as:</t>
        <artwork><![CDATA[
message_2 = (
  G_Y_CIPHERTEXT_2 : bstr,
)
]]></artwork>
        <t>where:</t>
        <ul spacing="normal">
          <li>
            <t>G_Y_CIPHERTEXT_2 is the concatenation of G_Y (i.e., the ephemeral public key of the Responder) and CIPHERTEXT_2.</t>
          </li>
          <li>
            <t>CIPHERTEXT_2 is calculated with a binary additive stream cipher, using KEYSTREAM_2 and the following plaintext:  </t>
            <ul spacing="normal">
              <li>
                <t>PLAINTEXT_2 = ( C_R, / bstr / -24..23, ? EAD_2 )</t>
              </li>
              <li>
                <t>CIPHERTEXT_2 = PLAINTEXT_2 XOR KEYSTREAM_2</t>
              </li>
            </ul>
          </li>
        </ul>
        <t>Contrary to <xref target="RFC9528"/>, MAC_2 is not used.</t>
      </section>
      <section anchor="message-3">
        <name>Message 3</name>
        <t>message_3 <bcp14>SHALL</bcp14> be a CBOR sequence, as defined below:</t>
        <artwork><![CDATA[
message_3 = (
  CIPHERTEXT_3A: bstr,
  CIPHERTEXT_3B: bstr,
)
]]></artwork>
        <t>where:</t>
        <ul spacing="normal">
          <li>
            <t>CIPHERTEXT_3A is CBOR byte string, with value calculated by means of a binary additive stream cipher, XORing a KESYSTREAM_3 generated with EDHOC_Expand and the following plaintext:  </t>
            <ul spacing="normal">
              <li>
                <t>PLAINTEXT_3A = ( ID_CRED_PSK )</t>
              </li>
            </ul>
          </li>
          <li>
            <t>CIPHERTEXT_3B is the 'ciphertext' of COSE_Encrypt0 object as defined in <eref target="https://www.rfc-editor.org/rfc/rfc9528.html#section-5.2">Section 5.2</eref> and <eref target="https://www.rfc-editor.org/rfc/rfc9528.html#section-5.3">Section 5.3 of RFC9528</eref>, with the EDHOC AEAD algorithm of the selected cipher suite, using the encryption key K_3, the initialization vector IV_3 (if used by the AEAD algorithm), the parameters described in <eref target="https://www.rfc-editor.org/rfc/rfc9528.html#section-5.2">Section 5.2</eref>, plaintext PLAINTEXT_3B and the following parameters as input:  </t>
            <ul spacing="normal">
              <li>
                <t>protected = h''</t>
              </li>
              <li>
                <t>external_aad = &lt;&lt; Enc(ID_CRED_PSK), TH_3 &gt;&gt;</t>
              </li>
              <li>
                <t>K_3 and IV_3 as defined in <xref target="message-2">Section 5.2</xref></t>
              </li>
              <li>
                <t>PLAINTEXT_3B = ( ? EAD_3 )</t>
              </li>
            </ul>
          </li>
        </ul>
        <t>The Initiator computes TH_4 = H( TH_3, ID_CRED_PSK, PLAINTEXT_3B, CRED_PSK ), defined in <xref target="message-2">Section 5.2</xref>.</t>
      </section>
      <section anchor="message-4">
        <name>Message 4</name>
        <t>message_4 is optional and is a CBOR sequence, defined as:</t>
        <artwork><![CDATA[
message_4 = (
  CIPHERTEXT_4 : bstr,
)
]]></artwork>
        <t>To authenticate the Responder and achieve mutual authentication, a fourth message is mandatory.
The Initiator <bcp14>MUST NOT</bcp14> persistently store PRK_out or application keys until the Initiator has verified message_4 or a message protected with a derived application key, such as an OSCORE message, from the Responder and the application has authenticated the Responder.</t>
      </section>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>When evaluating the security considerations, it is important to differentiate between the initial handshake and session resumption phases.</t>
      <ol spacing="normal" type="1"><li>
          <t><strong>Initial Handshake</strong>: a fresh CRED_PSK is used to establish a secure connection.</t>
        </li>
        <li>
          <t><strong>Session Resumption</strong>: the same PSK identifier (ID_CRED_PSK) is reused each time EDHOC is executed.
    While this enhances efficiency and reduces the overhead of key exchanges, it presents privacy risks if not managed properly.
    Over multiple resumption sessions, initiating a full EDHOC session changes the resumption PSK, resulting in a new ID_CRED_PSK.
    The periodic renewal of the CRED_PSK and ID_CRED_PSK helps mitigate long-term privacy risks associated with static key identifiers.</t>
        </li>
      </ol>
      <section anchor="identity-protection">
        <name>Identity protection</name>
        <t>The current EDHOC methods protect the Initiator’s identity against active attackers and the Responder’s identity against passive attackers (See <eref target="https://www.rfc-editor.org/rfc/rfc9528.html#section-9.1">Section 9.1 of RFC9528</eref>).
With EDHOC-PSK authentication method, both the Initiator's and Responder's identities are protected against passive attackers, but not against active attackers.</t>
      </section>
      <section anchor="number-of-messages">
        <name>Number of messages</name>
        <t>The current EDHOC protocol consists of three mandatory messages and an optional fourth message.
In the case of EDHOC-PSK authentication method, message_4 remains optional, but mutual authentication is not guaranteed without it, or an OSCORE message or any application data that confirms that the Responder owns the PSK. Additionally, with this fourth message the protocol achieves explicit key confirmation in addition to mutual authentication.</t>
      </section>
      <section anchor="external-authorization-data">
        <name>External Authorization Data</name>
        <t>The Initiator and Responder can send information in EAD_3 and EAD_4 or in OSCORE messages in parallel with message_3 and message_4.
This is possible because the Initiator knows that only the Responder with access to the CRED_PSK can decrypt the information.</t>
      </section>
      <section anchor="attacks">
        <name>Attacks</name>
        <t>EDHOC-PSK authentication method offers privacy and resistance to passive attacks but might be vulnerable to certain active attacks due to delayed authentication.</t>
      </section>
    </section>
    <section anchor="privacy-considerations">
      <name>Privacy Considerations</name>
    </section>
    <section anchor="unified-approach-and-recommendations">
      <name>Unified Approach and Recommendations</name>
      <t>For use cases involving the transmission of application data, application data can be sent concurrently with message_3, maintaining the protocol's efficiency.
In applications such as EAP-EDHOC, where application data is not sent, message_4 is mandatory. Thus, EDHOC-PSK authentication method does not include any extra messages.
Other implementations may continue using OSCORE in place of EDHOC message_4, with a required change in the protocol's language to:
      The Initiator <bcp14>SHALL NOT</bcp14> persistently store PRK_out or application keys until the Initiator has verified message_4 or a message protected with a derived application key, such as an OSCORE message.</t>
      <t>This change ensures that key materials are only stored once their integrity and authenticity are confirmed, thereby enhancing privacy by preventing early storage of potentially compromised keys.</t>
      <t>Lastly, whether the Initiator or Responder authenticates first is not relevant when using symmetric keys.
This consideration was important for the privacy properties when using asymmetric authentication but is not significant in the context of symmetric key usage.</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>This document has no IANA actions.</t>
    </section>
  </middle>
  <back>
    <references anchor="sec-normative-references">
      <name>Normative References</name>
      <reference anchor="RFC9528">
        <front>
          <title>Ephemeral Diffie-Hellman Over COSE (EDHOC)</title>
          <author fullname="G. Selander" initials="G." surname="Selander"/>
          <author fullname="J. Preuß Mattsson" initials="J." surname="Preuß Mattsson"/>
          <author fullname="F. Palombini" initials="F." surname="Palombini"/>
          <date month="March" year="2024"/>
          <abstract>
            <t>This document specifies Ephemeral Diffie-Hellman Over COSE (EDHOC), a very compact and lightweight authenticated Diffie-Hellman key exchange with ephemeral keys. EDHOC provides mutual authentication, forward secrecy, and identity protection. EDHOC is intended for usage in constrained scenarios, and a main use case is to establish an Object Security for Constrained RESTful Environments (OSCORE) security context. By reusing CBOR Object Signing and Encryption (COSE) for cryptography, Concise Binary Object Representation (CBOR) for encoding, and Constrained Application Protocol (CoAP) for transport, the additional code size can be kept very low.</t>
          </abstract>
        </front>
        <seriesInfo name="RFC" value="9528"/>
        <seriesInfo name="DOI" value="10.17487/RFC9528"/>
      </reference>
      <reference anchor="RFC9052">
        <front>
          <title>CBOR Object Signing and Encryption (COSE): Structures and Process</title>
          <author fullname="J. Schaad" initials="J." surname="Schaad"/>
          <date month="August" year="2022"/>
          <abstract>
            <t>Concise Binary Object Representation (CBOR) is a data format designed for small code size and small message size. There is a need to be able to define basic security services for this data format. This document defines the CBOR Object Signing and Encryption (COSE) protocol. This specification describes how to create and process signatures, message authentication codes, and encryption using CBOR for serialization. This specification additionally describes how to represent cryptographic keys using CBOR.</t>
            <t>This document, along with RFC 9053, obsoletes RFC 8152.</t>
          </abstract>
        </front>
        <seriesInfo name="STD" value="96"/>
        <seriesInfo name="RFC" value="9052"/>
        <seriesInfo name="DOI" value="10.17487/RFC9052"/>
      </reference>
      <reference anchor="RFC9053">
        <front>
          <title>CBOR Object Signing and Encryption (COSE): Initial Algorithms</title>
          <author fullname="J. Schaad" initials="J." surname="Schaad"/>
          <date month="August" year="2022"/>
          <abstract>
            <t>Concise Binary Object Representation (CBOR) is a data format designed for small code size and small message size. There is a need to be able to define basic security services for this data format. This document defines a set of algorithms that can be used with the CBOR Object Signing and Encryption (COSE) protocol (RFC 9052).</t>
            <t>This document, along with RFC 9052, obsoletes RFC 8152.</t>
          </abstract>
        </front>
        <seriesInfo name="RFC" value="9053"/>
        <seriesInfo name="DOI" value="10.17487/RFC9053"/>
      </reference>
      <reference anchor="RFC8742">
        <front>
          <title>Concise Binary Object Representation (CBOR) Sequences</title>
          <author fullname="C. Bormann" initials="C." surname="Bormann"/>
          <date month="February" year="2020"/>
          <abstract>
            <t>This document describes the Concise Binary Object Representation (CBOR) Sequence format and associated media type "application/cbor-seq". A CBOR Sequence consists of any number of encoded CBOR data items, simply concatenated in sequence.</t>
            <t>Structured syntax suffixes for media types allow other media types to build on them and make it explicit that they are built on an existing media type as their foundation. This specification defines and registers "+cbor-seq" as a structured syntax suffix for CBOR Sequences.</t>
          </abstract>
        </front>
        <seriesInfo name="RFC" value="8742"/>
        <seriesInfo name="DOI" value="10.17487/RFC8742"/>
      </reference>
      <reference anchor="RFC8949">
        <front>
          <title>Concise Binary Object Representation (CBOR)</title>
          <author fullname="C. Bormann" initials="C." surname="Bormann"/>
          <author fullname="P. Hoffman" initials="P." surname="Hoffman"/>
          <date month="December" year="2020"/>
          <abstract>
            <t>The Concise Binary Object Representation (CBOR) is a data format whose design goals include the possibility of extremely small code size, fairly small message size, and extensibility without the need for version negotiation. These design goals make it different from earlier binary serializations such as ASN.1 and MessagePack.</t>
            <t>This document obsoletes RFC 7049, providing editorial improvements, new details, and errata fixes while keeping full compatibility with the interchange format of RFC 7049. It does not create a new version of the format.</t>
          </abstract>
        </front>
        <seriesInfo name="STD" value="94"/>
        <seriesInfo name="RFC" value="8949"/>
        <seriesInfo name="DOI" value="10.17487/RFC8949"/>
      </reference>
      <reference anchor="RFC8610">
        <front>
          <title>Concise Data Definition Language (CDDL): A Notational Convention to Express Concise Binary Object Representation (CBOR) and JSON Data Structures</title>
          <author fullname="H. Birkholz" initials="H." surname="Birkholz"/>
          <author fullname="C. Vigano" initials="C." surname="Vigano"/>
          <author fullname="C. Bormann" initials="C." surname="Bormann"/>
          <date month="June" year="2019"/>
          <abstract>
            <t>This document proposes a notational convention to express Concise Binary Object Representation (CBOR) data structures (RFC 7049). Its main goal is to provide an easy and unambiguous way to express structures for protocol messages and data formats that use CBOR or JSON.</t>
          </abstract>
        </front>
        <seriesInfo name="RFC" value="8610"/>
        <seriesInfo name="DOI" value="10.17487/RFC8610"/>
      </reference>
      <reference anchor="RFC8392">
        <front>
          <title>CBOR Web Token (CWT)</title>
          <author fullname="M. Jones" initials="M." surname="Jones"/>
          <author fullname="E. Wahlstroem" initials="E." surname="Wahlstroem"/>
          <author fullname="S. Erdtman" initials="S." surname="Erdtman"/>
          <author fullname="H. Tschofenig" initials="H." surname="Tschofenig"/>
          <date month="May" year="2018"/>
          <abstract>
            <t>CBOR Web Token (CWT) is a compact means of representing claims to be transferred between two parties. The claims in a CWT are encoded in the Concise Binary Object Representation (CBOR), and CBOR Object Signing and Encryption (COSE) is used for added application-layer security protection. A claim is a piece of information asserted about a subject and is represented as a name/value pair consisting of a claim name and a claim value. CWT is derived from JSON Web Token (JWT) but uses CBOR rather than JSON.</t>
          </abstract>
        </front>
        <seriesInfo name="RFC" value="8392"/>
        <seriesInfo name="DOI" value="10.17487/RFC8392"/>
      </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"/>
          <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"/>
          <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>
    </references>
    <?line 314?>

<section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>TODO acknowledge.</t>
    </section>
  </back>
  <!-- ##markdown-source:
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
FzpCOuvItkVf2fpqmvv//uffjINM47SuJeaGC6uO2NqJ++Z16620vVH9/OvZ
71CrAMY+nP3bMu1qby10W7aV1SB41zR7ebslGdpNvlXObStZtslHSrqNY1ZC
b/i1i1r30mwSUNmBY4dE7RpWphScKz1+CcDGjqgKaM0w0bFDLdUQ5IMseqiV
uaUtaSuGaY7UBDlMbdpOZzy6uebw7c1lw7fzeE4x1UIdRteVakaFeFGfdmn2
CxZbeptbWpvbu5pk7g4yOd2tDc5HYlh0XQf8GkiRXtLU0mre0xyQofkP+LtA
lK8UuP4uJ030rG3i2wnXJvd4uJfywDBUoaW6Kqq4I1uI0Q2B4k8SQ21p4mOs
fEmTlc1AfxfZo0LwOy5mbCpkbWBvTNRUh+MgJFBVH6hGj2XRgM3AuMny7doH
BZ2Qlyh8oA0fZAM8SEnD3g3TM1Yj+VAfdeh9HlIV5gZ6fFRGNKvdMEWkszn/
GlDfnGx6vWV95XZfTR4e0RsonAYNinMEK1CaXFVkmPY5GlQp5o5JTvdxeF8k
G9y5cm9xcbm5ov2tdXtwc6x8yEyNDusraFiyIXWa89flyFFd3XdN4y2I06g5
l1ukZMPBVdv1lmyTew0TZ+SESd1PNDJRRMMc/vAhQQexssB05Id5oNgVKOrl
lhre8S55mFvTxA8NgTl855JNFUE5V67qc7ZBJhFKv/JzFZKtIjN1Q2WBi/pF
57zGq7AYL8zivhuIaVpxOSL6/yi97riupaO6MTRNvq84trAhj+2f6aG5XF+5
UXSqTqflezalYPlGWk50qcC9s4Ja2uaEdsLdGtV4WbzwQHdpuN3uxBFh0ngZ
ofYqhRvK8c6lydjNzxTrRpOX+LNtWsK+y+MUOFUhagCaiaRywKqQWcKGs9Tm
VsY5zUZFwG/xVNVA8ZJWQZhNSzlrqIGVFdwVQyiOBcmg9JQciy/tGInraHIn
ACxpYAawVppI9wZvBms+qvkGGilXFNsnpe/m6vn1rDF8IQEZ+OT2QxVMeczS
e9+3r4aq4PnOBOqg+OyU3mGV5ZPY/v8AwO1FQQU7AAA=

-->

</rfc>
