1
0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-23 01:32:22 -05:00

Bump "XEP-0397: Instant Stream Resumption" to 0.1.1

This commit is contained in:
Florian Schmaus 2018-11-03 16:05:40 +01:00
parent f3b18b969c
commit 08afb06f57

View File

@ -33,6 +33,12 @@
<email>flo@geekplace.eu</email> <email>flo@geekplace.eu</email>
<jid>flo@geekplace.eu</jid> <jid>flo@geekplace.eu</jid>
</author> </author>
<revision>
<version>0.1.1</version>
<date>2018-11-03</date>
<initials>fs</initials>
<remark><p>Minor fixes and clarifications</p></remark>
</revision>
<revision> <revision>
<version>0.1.0</version> <version>0.1.0</version>
<date>2018-01-22</date> <date>2018-01-22</date>
@ -145,7 +151,7 @@
<isr xmlns='https://xmpp.org/extensions/isr/0'> <isr xmlns='https://xmpp.org/extensions/isr/0'>
<mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'> <mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'>
<mechanism>HT-SHA-256-ENDP</mechanism> <mechanism>HT-SHA-256-ENDP</mechanism>
</mechaisms> </mechanisms>
</isr> </isr>
</stream:features> </stream:features>
]]></example> ]]></example>
@ -175,9 +181,9 @@
</enable> </enable>
]]></example> ]]></example>
<p>Next, the &lt;enabled/&gt; Nonza (see &xep0360;) which is send as <p>Next, the &lt;enabled/&gt; Nonza (see &xep0360;) which is sent as
positive reply upon a request to enable Stream Management, MUST positive reply upon a request to enable Stream Management, MUST
contain an 'isr-enabled' element qualified by the 'htpps://xmpp.org/extensions/isr/0' contain an 'isr-enabled' element qualified by the 'https://xmpp.org/extensions/isr/0'
namespace containing a ISR token as value of its 'token' attribute. The namespace containing a ISR token as value of its 'token' attribute. The
token MUST be newly generated by a cryptographically secure random token MUST be newly generated by a cryptographically secure random
number generator and MUST contain at least 128 bit of entropy. The number generator and MUST contain at least 128 bit of entropy. The
@ -220,7 +226,7 @@
<ol> <ol>
<li>The host provided in the optional 'location' attribute <li>The host provided in the optional 'location' attribute
qualified by the 'htpps://xmpp.org/extensions/isr/0' namespace found in the qualified by the 'https://xmpp.org/extensions/isr/0' namespace found in the
&lt;enabled/&gt; element of <cite>XEP-0198</cite> (the &lt;enabled/&gt; element of <cite>XEP-0198</cite> (the
"isr:location"). "isr:location").
</li> </li>
@ -234,7 +240,7 @@
tried by the initiating entity in this order.</p> tried by the initiating entity in this order.</p>
<p>Note that the hosts announced by the 'location' attribute <p>Note that the hosts announced by the 'location' attribute
qualified by the 'htpps://xmpp.org/extensions/isr/0' namespace MUST be connected to qualified by the 'https://xmpp.org/extensions/isr/0' namespace MUST be connected to
using TLS from the beginning, i.e. &lt;starttls/&gt; MUST NOT be using TLS from the beginning, i.e. &lt;starttls/&gt; MUST NOT be
used, instead the TLS handshake is performed right after used, instead the TLS handshake is performed right after
establishing the connection.</p> establishing the connection.</p>
@ -259,14 +265,14 @@
<p>Now the initiating entity sends an XMPP &lt;stream&gt; open <p>Now the initiating entity sends an XMPP &lt;stream&gt; open
element followed by a &lt;authenticate/&gt; Nonza as specified in element followed by a &lt;authenticate/&gt; Nonza as specified in
the &xep0388;. The initiating entity must also provide a the &xep0388;. The initiating entity must also provide a
&lt;inst-resume/&gt; element qualified by the 'htpps://xmpp.org/extensions/isr/0' &lt;inst-resume/&gt; element qualified by the 'https://xmpp.org/extensions/isr/0'
namespace, which must contain a &lt;resume/&gt; element as defined namespace, which must contain a &lt;resume/&gt; element as defined
in &xep0198;.</p> in &xep0198;.</p>
<p>If the with-isr-token' attribute is set to 'false', then the <p>The only defined attributed of the &lt;inst-resume/&gt; element is the 'with-isr-token'
attribute, whose value, if omitted, defaults to 'true'. If is set to 'false', then the
SASL mechanism is performed as when traditionally authenticating SASL mechanism is performed as when traditionally authenticating
the XMPP session. If the value of the attribute is 'true', which is the XMPP session. If the value of the attribute is 'true' then the "password" given to
the default value for this attribute, then the "password" given to
the SASL mechanism is the ISR token. Note that this implies that only the SASL mechanism is the ISR token. Note that this implies that only
SASL mechanisms which take a password/token can be used this SASL mechanisms which take a password/token can be used this
way.</p> way.</p>
@ -316,7 +322,7 @@
<p>On success the server replies with a &lt;success/&gt; nonza as <p>On success the server replies with a &lt;success/&gt; nonza as
specified in the &xep0388;, which must include a specified in the &xep0388;, which must include a
&lt;inst-resumed/&gt; element qualified by the 'htpps://xmpp.org/extensions/isr/0' &lt;inst-resumed/&gt; element qualified by the 'https://xmpp.org/extensions/isr/0'
namespace. This element MUST contain a <em>new</em> ISR Token found in namespace. This element MUST contain a <em>new</em> ISR Token found in
the 'token' attribute. It also MUST include a &lt;resumed/&gt; as the 'token' attribute. It also MUST include a &lt;resumed/&gt; as
specified in &xep0198; containing the sequence number of the last by specified in &xep0198; containing the sequence number of the last by
@ -353,7 +359,7 @@
but is unable to resume the stream instantly it MUST reply with a but is unable to resume the stream instantly it MUST reply with a
&lt;success/&gt; Nonza as defined in the &xep0388; containing &lt;success/&gt; Nonza as defined in the &xep0388; containing
a &lt;inst-resume-failed/&gt; element qualified by the a &lt;inst-resume-failed/&gt; element qualified by the
'htpps://xmpp.org/extensions/isr/0' namespace. This 'https://xmpp.org/extensions/isr/0' namespace. This
&lt;inst-resume-failed/&gt; MUST contain a &lt;failed/&gt; &lt;inst-resume-failed/&gt; MUST contain a &lt;failed/&gt;
element as defined in &xep0198;.</p> element as defined in &xep0198;.</p>
@ -448,7 +454,7 @@
<section1 topic='XMPP Registrar Considerations' anchor='registrar'> <section1 topic='XMPP Registrar Considerations' anchor='registrar'>
<p>The &REGISTRAR; includes 'htpps://xmpp.org/extensions/isr/0' in its registry of protocol namespaces (see &NAMESPACES;).</p> <p>The &REGISTRAR; includes 'https://xmpp.org/extensions/isr/0' in its registry of protocol namespaces (see &NAMESPACES;).</p>
</section1> </section1>
@ -461,7 +467,7 @@
<section1 topic='Acknowledgements' anchor='acknowledgements'> <section1 topic='Acknowledgements' anchor='acknowledgements'>
<p>Thanks to Jonas Wielicki, Thijs Alkemade, Dave Cridland, Maxime <p>Thanks to Jonas Wielicki, Thijs Alkemade, Dave Cridland, Maxime
Buquet, Alexander Würstlein and Sam Whited for their feedback.</p> Buquet, Alexander Würstlein, Sam Whited and Ivan Vučica for their feedback.</p>
</section1> </section1>