diff --git a/xep-0389.xml b/xep-0389.xml index 236d67a2..502eb949 100644 --- a/xep-0389.xml +++ b/xep-0389.xml @@ -31,6 +31,21 @@ ibr2 &sam; + + 0.4.0 + 2020-04-22 + ssw + +
    +
  • Add OOB challenge type.
  • +
  • Add IQ query for flows.
  • +
  • Add a glossary.
  • +
  • Make challenge listings more consistent.
  • +
  • Cleanup and expand the registrar considerations section.
  • +
  • Clarifications and typo fixes throughout the text.
  • +
+
+
0.3.0 2020-04-19 @@ -216,14 +231,14 @@ registration or recovery flow. Each <challenge/> element contains a "type" attribute that uniquely identifies the challenge for the purpose of determining if it is supported. - If a flow would offer the same challenge twice (eg. two dataforms asking for - different data), the challenge SHOULD only be listed once in the flow + If a flow would offer the same challenge twice (eg. two data forms asking + for different data), the challenge SHOULD only be listed once in the flow element.

For example, a server may advertise a "Verify with SMS" flow and a "Verify - by Phone Call" flow that both show a dataform asking for a phone number - and then a second dataform asking for a token provided to the user in a + by Phone Call" flow that both show a data form asking for a phone number + and then a second data form asking for a token provided to the user in a text message or phone call depending on which flow the user selects.

+

@@ -347,14 +362,28 @@ 'urn:xmpp:register:0' namespace with a 'type' attribute that uniquely identifies the type of payload a client might expect the element to contain.

+ + Payload +]]>

- This document defines a type of 'jabber:x:data' which MUST always contain a - data form (an 'x' element with type 'form') as defined by &xep0004;. - Other types may be defined in the future. - For example, a challenge containing a data form might look like the - following: + After a challenge is received, the client replies to the challenge by + sending a <response/> element qualified by the 'urn:xmpp:register:0' + namespace or a cancellation as defined later in this document. + If the client sends a response, it MUST also include the payload + corresponding to the challenges 'type' element (which may be empty).

- + Example Response +]]> + +

+ This document defines a type of 'jabber:x:data' which MUST always contain a + data form (an 'x' element with type 'form') as defined by &xep0004;. +

+ @@ -375,20 +404,14 @@ - -]]> +]]>

- After a challenge is received, the client replies to the challenge by - sending a <response/> element qualified by the 'urn:xmpp:register:0' - namespace or a cancellation as defined later in this document. - If the client sends a response, it MUST also include a payload defined by - the challenges 'type' element. - In the case of a "jabber:x:data" challenge, the payload should be a form - submission as defined by &xep0004; (an 'x' element of type 'submit'). + The response to a "jabber:x:data" challenge MUST be a form submission (an + 'x' element of type 'submit'). For instance, to reply to the data form challenge from the previous example a client might send:

- @@ -407,8 +430,26 @@ juliet@capulet.com - -]]> +]]>
+ + +

+ Challenges of the type "jabber:x:oob" MUST contain an <x/> element + qualified by the "jabber:x:oob" namespace as defined in &xep0066;. +

+ + + http://example.net/login?token=foo + +]]> +

+ If the client sends a response to the OOB challenge it MUST be empty. +

+ ]]> +

@@ -528,7 +569,7 @@ A name that uniquely identifies the challenge. A natural-language summary of the challenge. - The doucment (or documents) in which the IBR challenge and its paylaod are + The document (or documents) in which the IBR challenge and its payload are defined. ]]> @@ -540,17 +581,24 @@

This specification defines the following IBR challenge:

  • jabber:x:data
  • +
  • jabber:x:oob

Upon advancement of this specification from a status of Experimental to a - status of Draft, the ®ISTRAR; shall add the following definition to the - IBR challenges registry, as described in this document: + status of Draft, the ®ISTRAR; shall add the following definitions to + the IBR challenges registry, as described in this document:

jabber:x:data Requests that the client fill out an XEP-0004 data form. &xep0389;, &xep0004; +]]> + + jabber:x:oob + Requests that the client execute a URI. + &xep0066; ]]>