1
0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-25 02:32:18 -05:00
xeps/inbox/ephemeral-messages-v2.xml
2022-04-25 17:06:19 +02:00

225 lines
14 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE xep SYSTEM 'xep.dtd' [
<!ENTITY % ents SYSTEM 'xep.ent'>
<!ENTITY EPHEMERAL '&lt;ephemeral/&gt;'>
<!ENTITY eph0 'urn:xmpp:ephemeral:0'>
%ents;
]>
<?xml-stylesheet type='text/xsl' href='xep.xsl'?>
<xep>
<header>
<title>Ephemeral Messages</title>
<abstract>This specification encourages a shift in privacy settings wrt. logging policies.</abstract>
&LEGALNOTICE;
<number>xxxx</number>
<status>ProtoXEP</status>
<type>Standards Track</type>
<sig>Standards</sig>
<approver>Council</approver>
<dependencies>
<spec>XEP-0004</spec>
<spec>XEP-0030</spec>
<spec>XEP-0313</spec>
<spec>XEP-0334</spec>
</dependencies>
<supersedes/>
<supersededby/>
<shortname>NOT_YET_ASSIGNED</shortname>
&pep.;
<revision>
<version>0.0.2</version>
<date>2022-04-16</date>
<initials>pep</initials>
<remark><p>Resubmit with some changes.</p></remark>
</revision>
<revision>
<version>0.0.1</version>
<date>2018-04-10</date>
<initials>ak</initials>
<remark><p>First draft.</p></remark>
</revision>
</header>
<section1 anchor="intro" topic="Introduction">
<p>Existing protocols deployed in XMPP networks offer forward secrecy both on the transport (TLS) and message (&xep0384;) levels. Forward secrecy prevents recorded communications from being decrypted even if long term encryption keys are compromised by generating ephemeral keys and securely deleting them when they are no longer needed.</p>
<p>However, even though keys are deleted, message contents is retained client archives. While servers generally impose time limits on archives (messages, stored files, etc.), due to privacy laws (e.g., GDPR) and/or disk-space concerns, most XMPP clients still retain message content almost indefinitely even though it may not benefit a majority of their userbase. A device with an installed XMPP client that can be lost or stolen becomes the weakest link.</p>
<p>Unlike ephemeral keys, which have specified lifetimes, message contents cannot be removed immediately after being read. Users have to decide for how long they want to retain conversation contents. Verbally agreeing on the time interval and manually removing messages from all devices is cumbersome and error-prone.</p>
<p>This XEP defines a way to attach a timer value to messages which in order to specify for how long XMPP clients should store message contents. Besides that, it defines a way to synchronize common timer setting across all users of the conversation.</p>
<p>The specification does not depend on any encryption scheme and does not require encryption at all. Plaintext messages will still be readable by servers in between and will depend on trust placed on these server to apply their privacy policy or to respect a &xep0334; store hint.</p>
<p>Other IM systems, such as <link url="https://signal.org/">Signal</link>, <link url="https://wickr.com/">Wickr</link>, <link url="https://wire.com/">Wire</link> and <link url="https://telegram.org/">Telegram</link>, already offer ephemeral messages. Signal offers timer synchronization feature for user groups and Telegram offers it for secret chats, which are limited to two users.</p>
</section1>
<section1 anchor="reqs" topic="Requirements">
<p>What this specification tries to do:</p>
<ul>
<li>Provide a way to specify a timer value after which message contents must be deleted from user devices.</li>
<li>Clearly define semantics of timer value for XMPP clients.</li>
<li>Provide a way for a group of users to choose common value for ephemeral message timers and synchronize it across all devices.</li>
<li>Allow users to vacate to other activities while still being able to keep track of chats, as before.</li>
</ul>
<p>What this XEP doesnt try to be:</p>
<ul><li>A way to securely ensure that logs wont be kept by parties included in chats.</li></ul>
</section1>
<section1 anchor="usecases" topic="Use Cases">
<section2 anchor="disco" topic="Advertising support">
<p>A client implementing this specification MUST advertise the <tt>&EPHEMERAL;</tt> disco feature (as per &xep0030;). When advertising the feature, a client will honor requests to discard messages after the agreed upon delay.</p>
</section2>
<section2 anchor="sending" topic="Sending an ephemeral message">
<p>An ephemeral message is a <tt>&MESSAGE;</tt> including an <tt>&EPHEMERAL;</tt> tag in the <tt>&eph0;</tt> namespace, with an attribute <tt>timer</tt> (xs:unsignedInt) indicating the delay in seconds, after which a message MUST be discarded.</p>
<p>Ephemeral messages SHOULD be sent as usual on the bare JID of the contact, or as is specified for groupchats (e.g., MUC, MIX). If this includes sending to non-supporting clients, and they can be detected, sending clients SHOULD warn the user in some way. Clients MAY warn users anyway if non-supporting clients cannot be detected (e.g., when they dont get a directed presence).</p>
<p>Sending clients MAY include a <tt>&lt;no-permanent-store/&gt;</tt> &xep0334; when not doing end-to-end encryption, even though this may break receiver clients' expectations regarding archive management, and cause even supporting devices not to see ephemeral information.</p>
</section2>
<section2 anchor="negotiation" topic="Negotiating a delay">
<p>Sending a message with an ephemeral tag is how a delay is negotiated in a chat. A client receiving a message with an ephemeral tag MUST honor the timer for the received messages, and SHOULD include it in turn in following messages.</p>
<p>To change the timer for the following messages, change the value when sending a new message.</p>
</section2>
<section2 anchor="implicit-negotiation" topic="Implicit timer negociation">
<p>A implicit negociation can be done by sending a message with no <tt>&BODY;</tt>, that contains an <tt>&EPHEMERAL;</tt> tag and a timer attribute, specified in <link url='#sending'>Sending an ephemeral message</link>. The message MUST also contain a <tt>&lt;store&gt;</tt> hint as described in &xep0334; so that offline clients see it.</p>
</section2>
<section2 anchor="opt-out" topic="Opting-out of ephemeral messages">
<p><strong>XXX</strong>: Help. How do I ensure the receiving client sees what I am going to send, if its just a single message. Same issue as with negotiating the delay. (That is, if a client doesnt fetch all MAM, it may miss the message). Do I need to send &lt;i-want-out/&gt; forever?</p>
<p>A client that has previously been sending ephemeral messages can choose to stop sending them, and send regular messages instead, in which case it should tell the recipient:</p>
<code><![CDATA[<message from='vladimir@example.com/mobile' to='管野@example.com' type='chat'>
<body>おは</body>
<i-want-out/>
</message>]]></code>
<p>When the recipients sees the (TODO) <tt>&lt;i-want-out/&gt;</tt> element, it will stop including <tt>&EPHEMERAL;</tt>. The original client seeing no ephemeral tag is being included SHOULD stop sending the opt-out element.</p>
<p><strong>TODO</strong>: Negociation within messages is wonky. If a client comes back online and this flag isn't in server archives anymore, it will send ephemeral messages again causing all devices to send them again. This might go on forever.</p>
</section2>
</section1>
<section1 anchor="examples" topic="Example scenarios">
<section2 anchor="example-chat" topic="Initiating chat">
<p>Rosa sends a regular chat message to Peter:</p>
<example><![CDATA[<message from='rosa@example.com/mobile' to='peter@example.com' type='chat'>
<body>I have read the book you sent me, it was very insightful.</body>
</message>]]></example>
<p>Peter had his client previously configured to send ephemeral messages, before a chat with Rosa was opened. He replies:</p>
<example><![CDATA[<message from='peter@example.com/desktop' to='rosa@example.com' type='chat'>
<body>Something</body>
<ephemeral xmlns=']]>&eph0;<![CDATA[' timer='604800' />
</message>]]></example>
<p>Rosas client tells her from now own, messages will disappear in a week (60 * 60 * 24 * 7). Before replying she decides a week is too long and changes her settings so that they now disappear in 5 days. Her client immediately sends an implicit timer negotiation. The message she just received from Peter however will still disappear in 7 days.</p>
<example><![CDATA[<message from='rosa@example.com/mobile' to='peter@example.com' type='chat'>
<ephemeral xmlns=']]>&eph0;<![CDATA[' timer='432000' />
<store xmlns="urn:xmpp:hints" />
</message>]]></example>
<p>Peters client tells him messages will disappear in 5 days. Peter is fine with this and doesnt change his client settings. His client will continue including the ephemeral tag with the same timer value of 5 days.</p>
<example><![CDATA[<message from='peter@example.com/desktop' to='rosa@example.com' type='chat'>
<body>I see you changed the settings slightly. It's just as good to me!</body>
<ephemeral xmlns=']]>&eph0;<![CDATA[' timer='432000' />
</message>]]></example>
</section2>
</section1>
<section1 anchor="rules" topic="Business Rules">
<p>Timers SHOULD be started once a user has seen/read a message, to give them the possibility to read it in case the timer was too low, and/or they were taking a holiday from messaging. <strong>XXX</strong>: Is "read" and/or "seen" defined anywhere? Should we settle on some definition?</p>
<p>Once it has been sent, the timer on a message cannot be changed.</p>
<p>Discarded messages SHOULD be noted as such in the client (e.g., "This message has disappeared"). Not just removed with no indication of the reason.</p>
<p>When using with encryption mechanisms that include an encrypted wrapper such as &xep0373; or &xep0420;, this element SHOULD be placed in the wrapper.</p>
</section1>
<section1 anchor="impl" topic="Implementation Notes">
<p>Discarded messages shall be removed from memory and disk on a best effort basis.</p>
<p>Timers do not have to be exactly exact, the definition of "seen" or "read" not being consistent, and clock issues might also be a thing (use NTP?). This is also a best effort basis.</p>
<p>Ephemeral messages can be used with end-to-end encryption mechanisms. Both mechanisms are orthogonal. Messages are decrypted on the client and stored as plaintext in most cases when using end-to-end encryption.</p>
</section1>
<section1 anchor="access" topic="Accessibility Considerations">
<p>OPTIONAL.</p>
</section1>
<section1 anchor="i18n" topic="Internationalization Considerations">
<p>The message that appears once a message is discarded is a suggestion and should be adapted to the environment locale of the user.</p>
</section1>
<section1 anchor="security" topic="Security Considerations">
<p>Ephemeral messages are not to be considered "secure" in any way.</p>
<p>Even within well-meaning entities, requiring that messages be discarded and made impossible to retrieve, requires a lot more scrutiny in the specification and in implementations, and even then, is a really technically challenging task, to say the least.</p>
<p>In an adversarial context, requiring that sent messages be deleted from every devices receiving it (thus including to an attacker), requires a lot more control over the infrastructure in place and is not in scope for this specification. The author of this specification has no intention to specify DRM.</p>
<p>This specification doesn't prevent an attacker to read messages sent to you after they get control of your device (e.g., stolen, confiscated). In this specific case, the situation is improved nonetheless as the spec helps reduce the overall amount of messages that stay on a given device, compared to the current community standards.</p>
<p>Note that if a message hasn't been fetched by the client yet, using a timestamp instead of a timer doesn't necessarily protect the user entirely. An attacker obtaining access to a device after a long time would have taken an image of the original device, gain access again at time of obtention of the device, replace the client to handle these particular messages differently. To counter this, a user would have to have go through the gymnastics of getting their server not to send any archive to this device, during the interval necessary to open the device.</p>
</section1>
<section1 anchor="iana" topic="IANA Considerations">
<p>This document requires no interaction with the &IANA;</p>
</section1>
<section1 anchor="registrar" topic="XMPP Registrar Considerations">
<section2 topic='Protocol Namespaces' anchor='registrar-ns'>
<p>The &REGISTRAR; includes <tt>&eph0;</tt> in its registery of protocol namespaces (see &NAMESPACES;).</p>
</section2>
</section1>
<section1 anchor="design" topic="Design Considerations">
<p>From the previous ephemeral-messages protoXEP, the requirement that made it incompatible with non-implementing clients has been removed, as well as the one that made clients using e2ee only send only to supporting clients. This is explained by the fact that the goal of this specification is to change privacy defaults in the ecosystem and not to prevent users from getting their messages and break user-experience substantially.</p>
<p>Another use-case mentioned (and alluded to in security considerations) was being able to send time-sensitive messages, or rather, messages that have no purpose after a given time and thus should disappear. This specification doesnt exactly answer it as it might have been necessary to start the timer at the exact same time on both sender and receiver, and as such, a timestamp would have been better. This behaviour can still be observed more or less if sender and receiver are active at the same time, but of course it will differ when the receiver comes back at a later time.</p>
<p>A minimal timer value was originally negociable, but was removed as it complicates the protocol substancially, and can directly be solved between users.</p>
<p><strong>XXX</strong>: Do we want to use a per-“contact” model? How? With PEP? How would a client know which node to pick (of the two in a 1:1 chat, easier in MUC). What to do about the access model? This should also not be limited to contacts but whitelist may be annoying to manage. IQ negociation? This requires simultanous online-ness and also not likely with non-contacts as it would require directed presence.</p>
</section1>
<section1 anchor="schema" topic="XML Schema">
<p>REQUIRED for protocol specifications.</p>
</section1>
</xep>