annotate xmpp/xep-0355.xml @ 41:21d0d0ab7aa0

xeps: renamed published proto-xeps, and updated them according to published version
author Goffi <goffi@goffi.org>
date Fri, 20 Mar 2015 16:13:10 +0100
parents xmpp/xep-proto-namespace-delegation.xml@db9316a75306
children bbb900a768ea
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
1 <?xml version='1.0' encoding='UTF-8'?>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
2 <!DOCTYPE xep SYSTEM 'xep.dtd' [
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
3 <!ENTITY % ents SYSTEM 'xep.ent'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
4 %ents;
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
5 ]>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
6 <?xml-stylesheet type='text/xsl' href='xep.xsl'?>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
7 <xep>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
8 <header>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
9 <title>Namespace Delegation</title>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
10 <abstract>This specification provides a way for XMPP server to delegate treatments for a namespace to an other entity</abstract>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
11 &LEGALNOTICE;
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
12 <number>0355</number>
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
13 <status>Experimental</status>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
14 <type>Standards Track</type>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
15 <sig>Standards</sig>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
16 <approver>Council</approver>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
17 <dependencies>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
18 <spec>XMPP Core</spec>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
19 <spec>XEP-0004</spec>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
20 <spec>XEP-0297</spec>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
21 </dependencies>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
22 <supersedes/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
23 <supersededby/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
24 <shortname>NOT_YET_ASSIGNED</shortname>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
25 <author>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
26 <firstname>Jérôme</firstname>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
27 <surname>Poisson</surname>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
28 <email>goffi@goffi.org</email>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
29 <jid>goffi@jabber.fr</jid>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
30 </author>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
31 <revision>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
32 <version>0.1</version>
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
33 <date>2014-12-18</date>
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
34 <initials>XEP Editor (mam)</initials>
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
35 <remark><p>Initial published version approved by the XMPP Council.</p></remark>
34
db9316a75306 XEP: updated privileged entity according to discussions following the council's veto (see http://mail.jabber.org/pipermail/standards/2014-December/029378.html):
Goffi <goffi@goffi.org>
parents: 33
diff changeset
36 </revision>
db9316a75306 XEP: updated privileged entity according to discussions following the council's veto (see http://mail.jabber.org/pipermail/standards/2014-December/029378.html):
Goffi <goffi@goffi.org>
parents: 33
diff changeset
37 <revision>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
38 <version>0.0.1</version>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
39 <date>2014-11-13</date>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
40 <initials>jp</initials>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
41 <remark><p>First draft.</p></remark>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
42 </revision>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
43 </header>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
44 <section1 topic='Introduction' anchor='intro'>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
45 <p>Some XMPP features must be offered by the server itself, or can't be available, that's the case of &xep0163; which is used in several places (e.g. bookmarks storage). But it can be desirable to use an external entity to manage some of these features, because it implements things that the server don't, or because it uses a special implementation useful in a particular case. Some people may also want to decentralize a feature on an entity under their control. This XEP try to solve these cases.<br/>Additionaly, a method to do generic treatments (independent of server) on stanza is also provided.</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
46 <p>This XEP is complementary to priviliged entity XEP (and works in a similar way), although they can be used together or separately.</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
47 <p>Here are some use cases of namespace delegation:</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
48 <ul>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
49 <li>use an external component for a PEP service because the server doesn't implement it or lacks some features</li>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
50 <li>decentralize a server feature to an entity under client control</li>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
51 <li>make a component which react on new user registration, independent of server implementation</li>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
52 <li>server agnostic roster filtering</li>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
53 </ul>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
54 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
55 <section1 topic='Requirements' anchor='reqs'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
56 <p>Namespace delegation can be used in two modes:</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
57 <ul>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
58 <li><strong>admin</strong> mode, where delegation is specified by the server administrator.</li>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
59 <li><strong>client</strong> mode, where it can be requested by any user.</li>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
60 </ul>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
61 <p>In <em>admin</em> mode, the managing entity manages stanza of the delegated namespace for all users registered on the server. The namespace delegation MUST be totally transparent for the managed entities.</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
62 <p>In <em>client</em> mode, a managing entity MUST have an explicit authorization for any namespace he wants to use. Client SHOULD be able to check and revoke granted permissions, and if it's not possible, permissions MUST be revoked after a disconnection.</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
63 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
64 <section1 topic='Glossary' anchor='glossary'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
65 <ul>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
66 <li><strong>Delegated namespace</strong> the namespace being managed by an external entity.</li>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
67 <li><strong>Managing entity</strong> the entity which actualy manages the delegated namespace.</li>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
68 <li><strong>Managed entity</strong> an entity which wants to have a namespace of its server delegated to a managing entity.</li>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
69 </ul>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
70 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
71 <section1 topic='Admin Mode Use Cases' anchor='admin_usecases'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
72
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
73 <section2 topic='Delegation Request Use Case' anchor='admin_perm'>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
74 <section3 topic='Entity Requests Namespace Delegation' anchor='req_delegation'>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
75 <p>Once the managing entity is authenticated and stream is started, the entity can request to manage a namespace. It does it by sending an &IQ; stanza with <strong>'urn:xmpp:delegation:0'</strong> namespace. The &QUERY; element MUST have a type of value "request" and MAY have a 'delegation' attribute with the value "admin".</p>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
76 <p>Namespace delegations are asked with a &lt;delegate/&gt; element, which MUST contain a 'namespace' attribute set to the requested namespace.</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
77 <p>Only &lt;iq/&gt; stanza namespaces can be delegated.</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
78 <example caption='entity asks for delegation in admin mode'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
79 <iq from='pubsub.capulet.lit' type='get' id='delegation1'>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
80 <query xmlns='urn:xmpp:delegation:0' type='request' delegation='admin'>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
81 <delegate namespace='jabber:iq:roster'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
82 <delegate namespace='http://jabber.org/protocol/pubsub'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
83 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
84 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
85 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
86 </section3>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
87 <section3 topic='Server Accepts Namespace Delegation' anchor='accept_delegation'>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
88 <p>If the server accepts the delegation (e.g.: namespace mapping specified in configuration), it MUST return an &IQ; result stanza, with allowed delegations in &lt;delegate&gt; elements:</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
89 <example caption='server accept namespace delegations'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
90 <iq from='capulet.lit' to='pubsub.capulet.lit' type='result' id='delegation1'>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
91 <query xmlns='urn:xmpp:delegation:0' type='allowed'>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
92 <delegate namespace='jabber:iq:roster'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
93 <delegate namespace='http://jabber.org/protocol/pubsub'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
94 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
95 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
96 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
97 <p>Note: the granted delegations MAY be different from the requested ones, according to server's configuration.</p>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
98 <p>The server MUST then forward all requests made to itself on this namespace to the managing entity, except the requests made by the managing entity itself (see below).<br/>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
99 The server MUST NOT forward any request made to an other entity than itself or to a bare JID within its domain.</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
100 </section3>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
101 <section3 topic='Server Rejects Namespace Delegation' anchor='reject_delegation'>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
102 <p>If the server rejects the delegation, it MUST return a &forbidden; error:</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
103 <example caption='server reject delegation'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
104 <iq from='capulet.lit' to='pubsub.capulet.lit' type='error' id='delegation1'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
105 <error type='cancel'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
106 <forbidden xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
107 </error>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
108 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
109 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
110 </section3>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
111 </section2>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
112
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
113 <section2 topic='Server Forwards Delegated &IQ; Stanza' anchor='stanza_forward'>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
114 <p>When a server receives a stanza for a delegated namespace which is either directed to him (no 'to' attribute, or 'to' attribute with its own JID), or directed to the bare JID of the sender (e.g. if 'from' attribute is "<em>juliet@capulet.lit/balcony</em>" and 'to' attribute is "<em>juliet@capulet.lit</em>"), it MUST forward it to the managing entity by replacing the 'to' attribute with the JID of the managing entity:</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
115 <example caption='Juliet sends her mood to her server via PEP'><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
116 <iq from='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
117 id='pep1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
118 type='set'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
119 <pubsub xmlns='http://jabber.org/protocol/pubsub'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
120 <publish node='http://jabber.org/protocol/mood'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
121 <item>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
122 <mood xmlns='http://jabber.org/protocol/mood'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
123 <annoyed/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
124 <text>curse my nurse!</text>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
125 </mood>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
126 </item>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
127 </publish>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
128 </pubsub>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
129 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
130 ]]></example>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
131 <p>The server gets this stanza, sees that this namespace is delegated to <em>pubsub.capulet.lit</em>, so it forwards it:</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
132
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
133 <example caption='server delegate the stanza to pubsub.capulet.lit'><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
134 <iq from='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
135 to='pubsub.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
136 id='delegate1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
137 type='set'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
138 <pubsub xmlns='http://jabber.org/protocol/pubsub'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
139 <publish node='http://jabber.org/protocol/mood'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
140 <item>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
141 <mood xmlns='http://jabber.org/protocol/mood'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
142 <annoyed/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
143 <text>curse my nurse!</text>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
144 </mood>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
145 </item>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
146 </publish>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
147 </pubsub>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
148 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
149 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
150
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
151 <p>The managing entity replies normally to the stanza:</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
152 <example caption='pubsub.capulet.lit replies to Juliet'><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
153 <iq from='pubsub.capulet.lit'
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
154 to='juliet@capulet.lit/balcony'
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
155 id='delegate1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
156 type='result'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
157 <pubsub xmlns='http://jabber.org/protocol/pubsub' />
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
158 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
159 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
160
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
161 <p>Then the server MUST change the from field of managing entity to its own JID, and send the answer back to Juliet with the original &IQ; id.</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
162
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
163 <example caption='capulet.lit replies to Juliet'><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
164 <iq from='capulet.lit'
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
165 to='juliet@capulet.lit/balcony'
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
166 id='pep1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
167 type='result'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
168 <pubsub xmlns='http://jabber.org/protocol/pubsub' />
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
169 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
170 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
171
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
172 <p>The workflow is fully transparent for Juliet.</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
173 <section3 topic='Stanzas from managing entity' anchor='managing_entity_stanzas'>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
174 <p>If a stanza is sent by the managing entity on a managed namespace, the server MUST NOT forward it. This way, the managing entity can use privileged entity to do special treatments.</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
175 <p>In the following examples, <em>juliet@capulet.lit</em> has its "<em>jabber:iq:roster</em>" namespace delegated to <em>filter.capulet.lit</em>. <em>filter.capulet.lit</em> is a server agnostic component which filters allowed entities (which can be added to a roster), and sort them in enforced groups.</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
176
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
177 <example caption='Juliet adds Romeo to her roster'><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
178 <iq from='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
179 id='roster1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
180 type='set'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
181 <query xmlns='jabber:iq:roster'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
182 <item jid='romeo@montaigu.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
183 name='My Romeo'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
184 </item>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
185 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
186 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
187 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
188
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
189 <example caption='server forwards stanza to managing entity'><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
190 <iq from='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
191 to='filter.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
192 id='delegate1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
193 type='set'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
194 <query xmlns='jabber:iq:roster'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
195 <item jid='romeo@montaigu.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
196 name='My Romeo'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
197 </item>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
198 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
199 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
200 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
201
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
202 <p><em>filter.capulet.lit</em> accepts to add Romeo, but all JIDs with a <em>montaigu.lit</em> must be in a "Rivals" group, so it first returns a success result (Romeo is accepted).</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
203 <example caption='filtering component accept Romeo'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
204 <iq from='filter.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
205 to='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
206 id='delegate1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
207 type='result' />
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
208 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
209 <example caption='server forward the result with the initial id'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
210 <iq to='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
211 id='roster1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
212 type='result' />
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
213 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
214
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
215 <p>At this stade, the entity is accepted, but not added to the roster. <em>filter.capulet.lit</em> is also a privileged entity which can manage "<em>jabber:iq:roster</em>", so it uses this ability to add Romeo in the enforced group:</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
216 <example caption='filter.capulet.lit uses privileged entity to add Romeo'><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
217 <iq to='juliet@capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
218 from='filter.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
219 id='roster2'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
220 type='set'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
221 <query xmlns='jabber:iq:roster'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
222 <item jid='romeo@montaigu.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
223 name='My Romeo'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
224 <group>Rivals</group>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
225 </item>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
226 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
227 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
228 ]]></example>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
229 <p>The namespace is delegated, but as the stanza is from the managing entity, the server manages it normally. The entity is also privileged, so it can change the stanza of Juliet, the server accepts:</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
230
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
231 <example caption='server accept new entity in roster'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
232 <iq to='filter.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
233 from='juliet@capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
234 id='roster2'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
235 type='result'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
236 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
237
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
238 <p>The server will then send the roster pushes (with the enforced group) normally.</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
239
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
240 </section3>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
241
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
242 </section2>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
243
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
244
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
245 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
246
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
247 <section1 topic='Client Mode Use Cases' anchor='client_usecases'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
248 <section2 topic='Client Delegation Request Use Case' anchor='client_delegation'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
249 <p>In <em>client</em> mode, the managing entity is not certified by the server administrator, so the delegation MUST be <strong>explicitly</strong> allowed by the managed entity. This is initiated by the managing entity (it can be after an interaction with a managed entity, like a subscription). It's done in the same way as for <em>admin</em> mode with the following exceptions:</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
250 <ol>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
251 <li>the delegation type is <em>client</em> instead of <em>admin</em></li>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
252 <li>the delegation is done per entity, so the managed entity MUST be specified in a 'to' attribute</li>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
253 </ol>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
254 <p>If an entity want to manage PEP service for Juliet, it can ask the delegation like this:
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
255 </p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
256 <example caption='managing entity asks for namespace delegation for one particular entity'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
257 <iq from='pubsub.montaigu.lit' to='capulet.lit' type='get' id='delegation1'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
258 <query xmlns='urn:xmpp:delegation:0'
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
259 type='request'
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
260 delegation='client'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
261 to='juliet@capulet.lit'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
262 <delegate namespace='http://jabber.org/protocol/pubsub'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
263 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
264 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
265 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
266 <p>Once received the delegation request, the server ask to the client if it grant access to the requested namespace using &xep0004;. The server use a challenge which it MUST have generated itself.
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
267 </p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
268 <example caption='server asks user for the namespace delegation'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
269 <message from='capulet.lit' to='juliet@capulet.lit'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
270 <body>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
271 pubsub.montaigu.lit wants to manage a feature normally managed by the server.
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
272 Do you allow it to manage the following features?
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
273
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
274 Be careful! According management to an entity is a serious thing,
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
275 think twice that you can trust the entity before doing this.
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
276 </body>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
277 <x xmlns='jabber:x:data' type='form'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
278 <title>Delegation request</title>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
279 <instructions>pubsub.montaigu.lit wants to manage the following features:
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
280 Do you allow it?</instructions>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
281 <field type='hidden' var='challenge'><value>5439123</value></field>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
282 <field type='hidden' var='FORM_TYPE'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
283 <value>urn:xmpp:delegation:0</value>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
284 </field>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
285 <field type='list-single'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
286 label='Manage PubSub (http://jabber.org/protocol/pubsub)'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
287 var='http://jabber.org/protocol/pubsub'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
288 <value>0</value>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
289 <option label='No'><value>0</value></option>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
290 <option label='Yes'><value>1</value></option>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
291 </field>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
292 </x>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
293 </message>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
294 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
295 <p>The server SHOULD include a warning message, SHOULD translate the namespace to human friendly names (and MAY keep the original namespace in addition) and MUST set the default value to '<strong>0</strong>' (permission refused). The server SHOULD use namespace as field var, so a client can use it to have a customized display.</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
296 <p>The client can then answer to the form:</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
297 <example caption='client answer to the form'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
298 <message from='juliet@capulet.lit' to='capulet.lit'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
299 <x xmlns='jabber:x:data' type='submit'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
300 <field var='FORM_TYPE'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
301 <value></value>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
302 </field>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
303 <field var='challenge'><value>5439123</value></field>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
304 <field var='http://jabber.org/protocol/pubsub'><value>1</value></field>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
305 </x>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
306 </message>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
307 ]]></example>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
308 <p>Here Juliet allows <em>pubsub.montaigu.lit</em> to manage the PubSub (and then PEP) service.</p>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
309 <p>Finaly, the server notifies the entity of the granted delegation. For this it uses a &QUERY; element with the 'allowed' type, and puts the client JID in a 'from' attribute:</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
310 <example caption='server notify accepted delegations'><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
311 <iq from='capulet.lit' to='pubsub.montaigu.lit' type='set' id='delegation2'>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
312 <query xmlns='urn:xmpp:delegation:0'
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
313 type='allowed'
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
314 from='juliet@capulet.lit'>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
315 <delegate namespace='http://jabber.org/protocol/pubsub'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
316 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
317 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
318 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
319 <p>The managing entity can now manage the namespace the same way as in <link url='#stanza_forward'>admin mode</link>.</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
320 </section2>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
321
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
322 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
323
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
324 <section1 topic='Configuration' anchor='configuration'>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
325 <p>Server SHOULD provide a way for clients to check already delegated namespaces, and revoke them by using &xep0050; on the well-defined command node <strong>'urn:xmpp:delegation:0#configure'</strong>.</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
326 <p>If present, the configuration commands MUST allow at least to check delegations granted to a managing entity, and to revoke them. A server MAY offer an option to keep delegations from one session to an other (see <link url='#rules'>business rules</link>).</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
327 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
328
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
329 <section1 topic='Discovering Support' anchor='disco'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
330 <section2 topic='Announce' anchor='disco_announce'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
331 <p>If a server or an entity supports the namespace delegation protocol, it MUST report that fact by including a service discovery feature of "<em>urn:xmpp:delegation:0</em>" in response to a &xep0030; information request:</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
332 <example caption="service discovery information request"><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
333 <iq from='pubsub.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
334 id='disco1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
335 to='capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
336 type='get'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
337 <query xmlns='http://jabber.org/protocol/disco#info'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
338 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
339 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
340 <example caption="service discovery information response"><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
341 <iq from='capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
342 id='disco1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
343 to='pubsub.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
344 type='result'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
345 <query xmlns='http://jabber.org/protocol/disco#info'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
346 ...
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
347 <feature var='urn:xmpp:delegation:0'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
348 ...
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
349 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
350 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
351 ]]></example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
352 </section2>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
353 <section2 topic='Nesting' anchor='disco_nesting'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
354 <section3 topic='General Case'>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
355 <p>When a server delegates a namespace to a managing entity, the later can have particular features which must be advertised by the former with disco protocol.</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
356 <p>This is done by using a disco node, which is done the following way: if pubsub.capulet.int manages pubsub namespace, it MUST report that fact in discovery feature, and have a '<strong>urn:xmpp:delegation:0::http://jabber.org/protocol/pubsub</strong>' node which reports the managed features.</p><p>The node name is obtained by concatenating this XEP namespace (<strong>urn:xmpp:delegation:0</strong>), a '<strong>::</strong>' separator, and the delegated namespace (here <strong>http://jabber.org/protocol/pubsub</strong>).<br/>The server MUST advertise the result in its own discovery answer, and MUST ignore features of its internal component (here internal PubSub service).</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
357 <p>In the following example, the capulet.int server delegates its internal PEP component to pubsub.capulet.int. capulet.int only supports REQUIRED PubSub features and auto-create, while pubsub.capulet.int supports REQUIRED PubSub features and publish-options, but not auto-create. <br/>juliet@capulet.int asks its server what it is capable of, she is specially interested in PubSub capabilities.</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
358 <example caption="Juliet asks her server its available features"><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
359 <iq from='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
360 id='disco1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
361 to='capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
362 type='get'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
363 <query xmlns='http://jabber.org/protocol/disco#info'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
364 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
365 ]]>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
366 </example>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
367 <p>Server delegates its PubSub namespace to <em>pubsub.capulet.lit</em>, so it asks its available features for this namespace like this:</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
368 <example caption="capulet.lit requests disco infos for pubsub namespace to pubsub.capulet.lit"><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
369 <iq from='capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
370 id='disco2'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
371 to='pubsub.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
372 type='get'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
373 <query xmlns='http://jabber.org/protocol/disco#info'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
374 node='urn:xmpp:delegation:0::http://jabber.org/protocol/pubsub'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
375 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
376 ]]>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
377 </example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
378 <p>Note that in real situation, server has probably this information already in cache (see <link url='#impl'>Implementation Notes</link>).<br/>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
379 <em>pubsub.capulet.lit</em> returns its available features:</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
380 <example caption="pubsub.capulet.lit returns features to nest"><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
381 <iq from='pubsub.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
382 id='disco2'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
383 to='capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
384 type='result'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
385 <query xmlns='http://jabber.org/protocol/disco#info'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
386 node='urn:xmpp:delegation:0::http://jabber.org/protocol/pubsub'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
387 <feature var='http://jabber.org/protocol/pubsub'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
388 <feature var='http://jabber.org/protocol/pubsub#publish'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
389 <feature var='http://jabber.org/protocol/pubsub#subscribe'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
390 <feature var='http://jabber.org/protocol/pubsub#publish-options'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
391 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
392 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
393 ]]>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
394 </example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
395 <p>Server include the results in its own discovery info results:</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
396 <example caption="capulet.lit return disco info including features from pubsub.capulet.lit"><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
397 <iq from='capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
398 id='disco1'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
399 to='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
400 type='result'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
401 <query xmlns='http://jabber.org/protocol/disco#info'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
402 node='urn:xmpp:delegation:0::http://jabber.org/protocol/pubsub'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
403 <feature var='urn:xmpp:delegation:0'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
404 ...
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
405 <feature var='http://jabber.org/protocol/pubsub'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
406 <feature var='http://jabber.org/protocol/pubsub#publish'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
407 <feature var='http://jabber.org/protocol/pubsub#subscribe'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
408 <feature var='http://jabber.org/protocol/pubsub#publish-options'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
409 ...
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
410 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
411 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
412 ]]>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
413 </example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
414 <p>Note that '<em>http://jabber.org/protocol/pubsub#auto-create</em>' is not available.</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
415 </section3>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
416 <section3 topic='Rediction Of Bare JID Disco Info'>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
417 <p>As an entity may ask for discovery information on bare JID, which the server would answer, the managing entity must be able to send this kind of information.</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
418 <p>To do so, the mechanism is the same as for server features, but the separator is '<strong>:bare:</strong>' instead of '<strong>::</strong>':</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
419
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
420 <example caption="Juliet asks features for its own bare JID"><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
421 <iq from='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
422 id='disco3'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
423 to='juliet@capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
424 type='get'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
425 <query xmlns='http://jabber.org/protocol/disco#info'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
426 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
427 ]]>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
428 </example>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
429 <p>Server delegate its PubSub namespace to <em>pubsub.capulet.lit</em>, so it ask its available features for this namespace like this:</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
430 <example caption="capulet.lit requests disco infos for pubsub namespace to pubsub.capulet.lit"><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
431 <iq from='capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
432 id='disco4'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
433 to='pubsub.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
434 type='get'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
435 <query xmlns='http://jabber.org/protocol/disco#info'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
436 node='urn:xmpp:delegation:0:bare:http://jabber.org/protocol/pubsub'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
437 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
438 ]]>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
439 </example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
440 <p>As for general case, server has probably <link url='#impl'>this information already in cache</link>.<br/>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
441 <em>pubsub.capulet.lit</em> returns its available features:</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
442 <example caption="pubsub.capulet.lit returns features to nest"><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
443 <iq from='pubsub.capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
444 id='disco4'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
445 to='capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
446 type='result'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
447 <query xmlns='http://jabber.org/protocol/disco#info'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
448 node='urn:xmpp:delegation:0:bare:http://jabber.org/protocol/pubsub'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
449 <identity category='pubsub' type='pep'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
450 <feature var='http://jabber.org/protocol/pubsub#access-presence'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
451 <feature var='http://jabber.org/protocol/pubsub#auto-create'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
452 <feature var='http://jabber.org/protocol/pubsub#auto-subscribe'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
453 <feature var='http://jabber.org/protocol/pubsub#config-node'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
454 <feature var='http://jabber.org/protocol/pubsub#create-and-configure'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
455 <feature var='http://jabber.org/protocol/pubsub#create-nodes'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
456 <feature var='http://jabber.org/protocol/pubsub#filtered-notifications'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
457 <feature var='http://jabber.org/protocol/pubsub#persistent-items'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
458 <feature var='http://jabber.org/protocol/pubsub#publish'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
459 <feature var='http://jabber.org/protocol/pubsub#retrieve-items'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
460 <feature var='http://jabber.org/protocol/pubsub#subscribe'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
461 ...
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
462 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
463 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
464 ]]>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
465 </example>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
466 <p>Then the server returns the answer to Juliet, as in general case, with requested bare JID in 'from' field.</p>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
467 <example caption="capulet.lit returns disco info to Juliet"><![CDATA[
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
468 <iq from='juliet@capulet.lit'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
469 id='disco3'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
470 to='juliet@capulet.lit/balcony'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
471 type='result'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
472 <query xmlns='http://jabber.org/protocol/disco#info'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
473 <identity category='account' type='registered'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
474 <identity category='pubsub' type='pep'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
475 <feature var='http://jabber.org/protocol/pubsub#access-presence'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
476 <feature var='http://jabber.org/protocol/pubsub#auto-create'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
477 <feature var='http://jabber.org/protocol/pubsub#auto-subscribe'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
478 <feature var='http://jabber.org/protocol/pubsub#config-node'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
479 <feature var='http://jabber.org/protocol/pubsub#create-and-configure'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
480 <feature var='http://jabber.org/protocol/pubsub#create-nodes'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
481 <feature var='http://jabber.org/protocol/pubsub#filtered-notifications'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
482 <feature var='http://jabber.org/protocol/pubsub#persistent-items'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
483 <feature var='http://jabber.org/protocol/pubsub#publish'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
484 <feature var='http://jabber.org/protocol/pubsub#retrieve-items'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
485 <feature var='http://jabber.org/protocol/pubsub#subscribe'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
486 ...
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
487 </query>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
488 </iq>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
489 ]]>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
490 </example>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
491
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
492 </section3>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
493 </section2>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
494 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
495
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
496 <section1 topic='Business Rules' anchor='rules'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
497 <ol>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
498 <li>In client mode, server MAY keep delegations granted to an entity by a client from one session to an other, but if it does so, it MUST provide configuration like explained in the <link url='#configuration'>suitable section</link>. If server offers this feature, it SHOULD add a field directly in configuration commands.</li>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
499 <li>If a client can't check or revoke delegations (i.e. it doesn't support &xep0050;) when granting them, the server MUST NOT keep granted delegations from one session to an other, and delegations will be asked on each new session.</li>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
500 <li>If delegations are changed during a session, server MUST notify managing entity of the new delegations, like in <link url='#client_delegation'>client delegation request use case</link>.</li>
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
501 <li>The namespace of this XEP (<strong>urn:xmpp:delegation:0</strong>) MUST NOT be delegated. If an entity requests it, the server MUST return a &forbidden; error.</li>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
502 </ol>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
503 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
504 <section1 topic='Implementation Notes' anchor='impl'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
505 <ol>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
506 <li>As admin mode is far more easy to implement than client mode, and client mode may impact performances, a server MAY choose to only implement the former.</li>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
507 <li>Because of the performance impact, a server SHOULD ask for <link url='#disco_nesting'>disco features to nest</link> to managing entity when delegation is accepted, and keep them in cache.</li>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
508 </ol>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
509 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
510 <section1 topic='Security Considerations' anchor='security'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
511 <ol>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
512 <li>Managing entity can manage sensitive data, <em>admin</em> delegation should be granted carefuly, only if you absolutely trust the entity.</li>
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
513 <li>A server MAY choose to filter allowed namespaces. In this case, it MUST always set the allowed type of filtered namespaces to <strong>0</strong>.</li>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
514
32
a3f262d5b594 xeps: typos/style fixes
souliane <souliane@mailoo.org>
parents: 30
diff changeset
515 <li>In case of filtering, a whitelist system is more secure and SHOULD be prefered to a blacklist (idealy, configuration would allow no filtering, whitelist filtering and blacklist filtering).</li>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
516 </ol>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
517 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
518 <section1 topic='IANA Considerations' anchor='iana'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
519 <p>This document requires no interaction with &IANA;.</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
520 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
521 <section1 topic='XMPP Registrar Considerations' anchor='registrar'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
522 <section2 topic='Protocol Namespaces' anchor='ns'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
523 <p>The &REGISTRAR; includes 'urn:xmpp:delegation:0' in its registry of protocol namespaces (see &NAMESPACES;).</p>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
524 <ul>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
525 <li>urn:xmpp:delegation:0</li>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
526 </ul>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
527 </section2>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
528 <section2 topic='Protocol Versioning' anchor='registrar-versioning'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
529 &NSVER;
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
530 </section2>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
531 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
532 <section1 topic='XML Schema' anchor='schema'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
533 <code><![CDATA[
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
534 <?xml version='1.0' encoding='UTF-8'?>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
535
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
536 <xs:schema
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
537 xmlns:xs='http://www.w3.org/2001/XMLSchema'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
538 targetNamespace='urn:xmpp:delegation:0'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
539 xmlns='urn:xmpp:delegation:0'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
540 elementFormDefault='qualified'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
541
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
542 <xs:element name='query'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
543 <xs:complexType>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
544 <xs:attribute name='type' use='required'>
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
545 <xs:simpleType base='xs:NMTOKEN'>
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
546 <xs:enumeration value='request'/>
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
547 <xs:enumeration value='allowed'/>
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
548 </xs:simpleType>
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
549 </xs:attribute>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
550 <xs:attribute name='delegation' use='optional'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
551 <xs:simpleType base='xs:NMTOKEN'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
552 <xs:enumeration value='admin'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
553 <xs:enumeration value='client'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
554 </xs:simpleType>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
555 </xs:attribute>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
556 <xs:attribute name='to' use='optional' type='xs:string'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
557 </xs:attribute>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
558 <xs:element name='delegation'
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
559 maxOccurs='unbounded'>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
560 <xs:complexType>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
561 <xs:attribute name='namespace' use='required' type='xs:string'/>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
562 </xs:complexType>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
563 </xs:element>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
564 </xs:complexType>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
565 </xs:element>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
566
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
567 </xs:schema>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
568 ]]></code>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
569 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
570 <section1 topic='Acknowledgements' anchor='acks'>
41
21d0d0ab7aa0 xeps: renamed published proto-xeps, and updated them according to published version
Goffi <goffi@goffi.org>
parents: 34
diff changeset
571 <p>This XEP is linked with &xep0356; and works in a similar way.</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
572 <p>The client mode delegation mechanism is inspired from &xep0321; permission request.</p>
33
b70084aa0af7 xeps: added thanks to souliane for his corrections
Goffi <goffi@goffi.org>
parents: 32
diff changeset
573 <p>Thanks to Adrien Cossa for his typos/style corrections</p>
30
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
574 </section1>
b04be960ebdf xep: namespace delegation first draft:
Goffi <goffi@goffi.org>
parents:
diff changeset
575 </xep>