<?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.6.37 (Ruby 2.6.10) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-mahy-mls-room-policy-ext-00" category="info" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.17.4 -->
  <front>
    <title abbrev="MLS Extension for MIMI Room Policy">A Messaging Layer Security (MLS) extension for More Instant Messaging Interoperability (MIMI) room policies</title>
    <seriesInfo name="Internet-Draft" value="draft-mahy-mls-room-policy-ext-00"/>
    <author initials="R." surname="Mahy" fullname="Rohan Mahy">
      <organization>Wire</organization>
      <address>
        <email>rohan.mahy@wire.com</email>
      </address>
    </author>
    <date year="2023" month="July" day="10"/>
    <area>sec</area>
    <workgroup>MLS</workgroup>
    <keyword>room policy</keyword>
    <keyword>MIMI</keyword>
    <keyword>room_policy</keyword>
    <keyword>group chat</keyword>
    <abstract>
      <?line 37?>

<t>This document describes a Message Layer Security (MLS) GroupContext extension
to include More Instant Messaging Interoperability (MIMI) group chat (room)
policy inside an MLS group. This allows all users in a group to agree on the
current policy and make authorization decisions accordingly.</t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-mahy-mls-room-policy-ext/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        MLS Working Group mailing list (<eref target="mailto:mls@ietf.org"/>),
        which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/mls/"/>.
        Subscribe at <eref target="https://www.ietf.org/mailman/listinfo/mls/"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/rohan-wire/mls-room-policy-ext/"/>.</t>
    </note>
  </front>
  <middle>
    <?line 44?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>The More Instant Messaging Interoperability (MIMI) group chat framework
<xref target="I-D.mahy-mimi-group-chat"/> defines a room policy format. This document
describes a Message Layer Security (MLS) <xref target="I-D.ietf-mls-protocol"/>
GroupContext extension that allows all users in a group to agree on the
current policy and make authorization decisions accordingly.</t>
    </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>The terms MLS client, MLS group, GroupContext, Commit, Proposal,
GroupContextExtensions Proposal, and<tt>required_capabilities</tt>
have the same meanings as in the MLS protocol [@!I-D.ietf-mls-protocol].</t>
    </section>
    <section anchor="extension-description">
      <name>Extension Description</name>
      <t>This document specifies a GroupContext MLS extension <tt>room_policy</tt>
of type RoomPolicy (defined in Section 8 of <xref target="I-D.mahy-mimi-group-chat"/>).
The syntax is described using the TLS Presentation Language [@!RFC8446].</t>
      <sourcecode type="tls-presentation"><![CDATA[
RoomPolicy room_policy;
]]></sourcecode>
      <t>An MLS client which implements this specification <bcp14>SHOULD</bcp14> include the
<tt>room_policy</tt> extension in the <tt>extensions</tt> field in the
GroupContext of groups it creates which have an associated room policy.
It includes a machine readable description of the room policy sufficient
for all clients in the group to authorize MLS primitives (like a Commit
with an Add Proposal). As new members of the group are added or removed, the member
which Commits these membership changes is expected to maintain the <tt>room_policy</tt>
up-to-date, and consistent with the membership of the group by also including an appropriate
GroupContextExtensions Proposal any time the policy changes. It also allows
a client to inspect the <tt>room_policy</tt> before joining to determine if the policies
are consistent with its own.</t>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>The Security Considerations of MLS apply.
The authorization rules for the RoomPolicy object are described in
detail in <xref target="I-D.mahy-mimi-group-chat"/>.</t>
      <t>Improper use of the extension in this document could allow the creator of an
MLS group or the sender of a GroupContextExtensions Proposal to maliciously
modify or subvert the policies of a group chat which could result in viewing
private information about the participants of the room, loss of confidentiality
of the contents of the room (after subverting the policies and until the policies
are corrected), and injecting potentially unwanted messages into the room
(spam, abuse, phishing, and attempted impersonation).</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>This document proposes registration of a new MLS Extension Type.</t>
      <t>RFC EDITOR: Please replace XXXX throughout with the RFC number assigned to this document</t>
      <section anchor="roompolicy-mls-extension-type">
        <name>room_policy MLS Extension Type</name>
        <t>The <tt>room_policy</tt> MLS Extension Type is used inside GroupContext objects. It
contains a RoomPolicy object as defined in Section 8 of <xref target="I-D.mahy-mimi-group-chat"/>,
representing the room policy for the MLS group corresponding with the room.</t>
        <artwork><![CDATA[
  Template:
  Value: 0x000B
  Name: room_policy
  Message(s): This extension may appear in GroupContext objects
  Recommended: Y
  Reference: RFC XXXX
]]></artwork>
      </section>
    </section>
  </middle>
  <back>
    <references>
      <name>Normative References</name>
      <reference anchor="I-D.mahy-mimi-group-chat">
        <front>
          <title>Group Chat Framework for More Instant Messaging Interoperability (MIMI)</title>
          <author fullname="Rohan Mahy" initials="R." surname="Mahy">
            <organization>Wire</organization>
          </author>
          <date day="10" month="July" year="2023"/>
          <abstract>
            <t>   This document describes a group instant messaging ("group chat")
   semantic framework for the More Instant Messaging Interoperability
   (MIMI) Working Group.  It describes several properties and policy
   options which can be combined to model a wide range of chat and
   multimedia conference types.  It also describes how to build these
   options as an overlay to Messaging Layer Security (MLS) groups and to
   authorize MLS primitives.

            </t>
          </abstract>
        </front>
        <seriesInfo name="Internet-Draft" value="draft-mahy-mimi-group-chat-00"/>
      </reference>
      <reference anchor="I-D.ietf-mls-protocol">
        <front>
          <title>The Messaging Layer Security (MLS) Protocol</title>
          <author fullname="Richard Barnes" initials="R." surname="Barnes">
            <organization>Cisco</organization>
          </author>
          <author fullname="Benjamin Beurdouche" initials="B." surname="Beurdouche">
            <organization>Inria &amp; Mozilla</organization>
          </author>
          <author fullname="Raphael Robert" initials="R." surname="Robert">
            <organization>Phoenix R&amp;D</organization>
          </author>
          <author fullname="Jon Millican" initials="J." surname="Millican">
            <organization>Meta Platforms</organization>
          </author>
          <author fullname="Emad Omara" initials="E." surname="Omara">
            <organization>Google</organization>
          </author>
          <author fullname="Katriel Cohn-Gordon" initials="K." surname="Cohn-Gordon">
            <organization>University of Oxford</organization>
          </author>
          <date day="27" month="March" year="2023"/>
          <abstract>
            <t>   Messaging applications are increasingly making use of end-to-end
   security mechanisms to ensure that messages are only accessible to
   the communicating endpoints, and not to any servers involved in
   delivering messages.  Establishing keys to provide such protections
   is challenging for group chat settings, in which more than two
   clients need to agree on a key but may not be online at the same
   time.  In this document, we specify a key establishment protocol that
   provides efficient asynchronous group key establishment with forward
   secrecy and post-compromise security for groups in size ranging from
   two to thousands.

            </t>
          </abstract>
        </front>
        <seriesInfo name="Internet-Draft" value="draft-ietf-mls-protocol-20"/>
      </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 138?>



  </back>
  <!-- ##markdown-source:
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
WEISAAA=

-->

</rfc>
