1
0
mirror of https://github.com/moparisthebest/xeps synced 2024-08-13 16:53:48 -04:00
xeps/xep-0238.xml

3784 lines
156 KiB
XML
Raw Normal View History

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE xep SYSTEM 'xep.dtd' [
<!ENTITY % ents SYSTEM 'xep.ent'>
%ents;
]>
<?xml-stylesheet type='text/xsl' href='xep.xsl'?>
<xep>
<header>
<title>XMPP Protocol Flows for Inter-Domain Federation</title>
<abstract>This specification provides detailed protocol flows for the establishment of communication between domains that provide XMPP services, including permutations for a wide variety of possible federation policies.</abstract>
&LEGALNOTICE;
<number>0238</number>
<status>Deferred</status>
<type>Informational</type>
<sig>Standards</sig>
<approver>Council</approver>
<dependencies>
<spec>XMPP Core</spec>
<spec>XEP-0220</spec>
</dependencies>
<supersedes/>
<supersededby/>
<shortname>N/A</shortname>
&stpeter;
<revision>
<version>0.1</version>
<date>2008-03-31</date>
<initials>psa</initials>
<remark><p>Initial published version.</p></remark>
</revision>
<revision>
<version>0.0.1</version>
<date>2008-01-23</date>
<initials>psa</initials>
<remark><p>First draft.</p></remark>
</revision>
</header>
<section1 topic='Introduction' anchor='intro'>
<p>&xmppcore; describes the client-server architecture upon which Jabber/XMPP communication is based. One aspect of such communication is "federation", i.e., the ability for two XMPP servers in different domains to exchange XML stanzas. There are at least four levels of federation:</p>
<ol start='1'>
<li><p>Permissive Federation -- a server accepts a connection from any other peer on the network, even without verifiying the identity of the peer based on DNS lookups. The lack of peer verification or authentication means that domains can be spoofed. Permissive federation was effectively outlawed on the Jabber network in October 2000 with the release of the jabberd 1.2 server, which included support for the newly-developed &xep0220; protocol.</p></li>
<li><p>Verified Federation -- a server accepts a connection from a peer only after the identity of the peer has been weakly verified via Server Dialback, based on information obtained via the Domain Name System (DNS) and verification keys exchanged in-band over XMPP. However, the connection is not encrypted. The use of identity verification effectively prevents domain spoofing, but federation requires proper DNS setup and is still subject to DNS poisoning attacks. Verified federation has been the default service policy followed by servers on the open XMPP network from October 2000 until now.</p></li>
2011-04-12 10:37:30 -04:00
<li><p>Encrypted Federation -- a server accepts a connection from a peer only if the peer supports Transport Layer Security (TLS) as defined for XMPP in &xmppcore; and the peer presents a digital certificate. However, the certificate may be self-signed, in which case mutual authentication is typically not possible. Therefore, after STARTTLS negotiation the parties proceed to weakly verify identity using Server Dialback. This combination results in an encrypted connection with weak identity verification.</p></li>
<li><p>Trusted Federation -- a server accepts a connection from a peer only if the peer supports Transport Layer Security (TLS) and the peer presents a digital certificate issued by a trusted root certification authority (CA). The list of trusted root CAs is determined by local service policy, as is the level of trust accorded to various types of certificates (i.e., Class 1, Class 2, or Class 3). The use of trusted domain certificates effectively prevents DNS poisoning attacks but makes federation more difficult since typically such certificates are not easy to obtain.</p></li>
</ol>
<p>The remainder of this document describes in more detail the protocol flows that make it possible to deploy verified federation, encrypted federation, and trusted federation. Protocol flows are shown for federation attempts between various combinations to illustrate the interaction between different federation policies.</p>
</section1>
<section1 topic='Terminology' anchor='terminology'>
<p>To simplify the text, this document uses the following terminology. For each service type, the domain "example.lit" is used to illustrate connections to that same service type.</p>
<table caption='Example Servers'>
<tr>
<th>Service Type</th>
<th>Federation Policy</th>
<th>Certificate</th>
<th>Protocols Supported</th>
<th>Example Domain</th>
<th>Example User</th>
</tr>
<tr>
<td>Type 1</td>
<td>Verified Only</td>
<td>None</td>
2011-04-12 10:37:30 -04:00
<td>XMPP 0.9 <note>"XMPP 0.9" is the core XML streaming protocol used in the Jabber community before the formalization of XMPP 1.0 by the IETF in &rfc3920;, including STARTTLS and SASL.</note> and Server Dialback</td>
<td>type1.lit</td>
<td>citizen@type1.lit</td>
</tr>
<tr>
<td>Type 2</td>
<td>Verified Acceptable</td>
<td>Self-signed</td>
<td>XMPP 1.0 <note>"XMPP 1.0" is defined in <cite>RFC 3920</cite> and includes STARTTLS and SASL negotiation.</note> and Server Dialback</td>
<td>type2.lit</td>
<td>juliet@type2.lit</td>
</tr>
<tr>
<td>Type 3</td>
<td>Verified Acceptable</td>
<td>CA-issued</td>
<td>XMPP 1.0 and Server Dialback</td>
<td>type3.lit</td>
<td>romeo@type3.lit</td>
</tr>
<tr>
<td>Type 4</td>
<td>Encrypted Required</td>
<td>Self-signed</td>
<td>XMPP 1.0 and Server Dialback</td>
<td>type4.lit</td>
<td>hamlet@type4.lit</td>
</tr>
<tr>
<td>Type 5</td>
<td>Encrypted Required</td>
<td>CA-issued</td>
<td>XMPP 1.0 and Server Dialback</td>
<td>type5.lit</td>
<td>bill@type5.lit</td>
</tr>
<tr>
<td>Type 6</td>
<td>Trusted Required</td>
<td>CA-issued</td>
<td>XMPP 1.0</td>
<td>type6.lit</td>
<td>chris@type6.lit</td>
</tr>
</table>
</section1>
<section1 topic='Connection Success' anchor='success'>
<p>The following table summarizes the results of connection attempts between the various services, where "U" stands for "Unsuccessful", "V" stands for "Verified", "E" stands for "Encrypted", and "T" stands for "Trusted". The rows indicate the initiating service and the columns indicate the receiving service.</p>
<table caption='Connection Success'>
<tr>
<th></th>
<th>Type 1</th>
<th>Type 2</th>
<th>Type 3</th>
<th>Type 4</th>
<th>Type 5</th>
<th>Type 6</th>
</tr>
<tr>
<td>Type 1</td>
<td>V</td>
<td>V</td>
<td>V</td>
<td>U</td>
<td>U</td>
<td>U</td>
</tr>
<tr>
<td>Type 2</td>
<td>V</td>
<td>V</td>
<td>E</td>
<td>E</td>
<td>U</td>
<td>U</td>
</tr>
<tr>
<td>Type 3</td>
<td>V</td>
<td>V</td>
<td>E</td>
<td>E</td>
<td>E</td>
<td>T</td>
</tr>
<tr>
<td>Type 4</td>
<td>U</td>
<td>E</td>
<td>E</td>
<td>E</td>
<td>E</td>
<td>U</td>
</tr>
<tr>
<td>Type 5</td>
<td>U</td>
<td>E</td>
<td>T</td>
<td>E</td>
<td>T</td>
<td>T</td>
</tr>
<tr>
<td>Type 6</td>
<td>U</td>
<td>U</td>
<td>T</td>
<td>U</td>
<td>T</td>
<td>T</td>
</tr>
</table>
</section1>
<section1 topic='Connections from Type 1 Services' anchor='type1'>
<section2 topic='Type 1 to Type 1' anchor='type1-type1'>
<p>In this scenario, an XMPP user citizen@type1.lit attempts to send an XML stanza to user@example.lit.</p>
<example caption="Test Stanza"><![CDATA[
<iq from='citizen@type1.lit/foo'
id='t1_t1'
to='user@example.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type1.lit service attempts to initiate a server-to-server connection with example.lit (both of which support verified connections only and neither of which has a certificate).</p>
<p>First, the type1.lit service sends an initial stream header to example.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
to='example.lit'>
]]></example>
<p>Next the example.lit service sends a response stream header to type1.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='example.lit'
id='idt1_t1o'
to='type1.lit'>
]]></example>
<p>Because neither service supports XMPP 1.0, the type1.lit service attempts to complete a server dialback negotiation with the example.lit service. Therefore it sends a dialback key to example.lit over the existing connection.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type1.lit'
to='example.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The example.lit service then performs a DNS lookup on the type1.lit domain, opens a TCP connection at the discovered IP address and port, and establishes a stream with the authoritative server for the type1.lit service.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='example.lit'
to='type1.lit'>
]]></example>
<p>The authoritative server for the type1.lit service then returns a response stream header.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
id='idt1_t1r'
to='example.lit'>
]]></example>
<p>The example.lit service then sends a dialback verification request to the authoritative server for the type1.lit domain.</p>
<example caption="Verification Request"><![CDATA[
<db:verify
from='example.lit'
id='idt1_t1o'
to='type1.lit'>
some-long-dialback-key
</db:verify>
]]></example>
<p>Here we assume that the authoritative server for the type1.lit domain notifies the example.lit service that the key is valid.</p>
<example caption="Key is Valid"><![CDATA[
<db:verify
from='type1.lit'
id='idt1_t1o'
to='example.lit'
type='valid'>
some-long-dialback-key
</db:verify>
]]></example>
<p>The example.lit service then returns a positive server dialback result to the originating server.</p>
<example caption="Server Dialback Result"><![CDATA[
<db:result
from='example.lit'
to='type1.lit'
type='valid'>
some-long-dialback-key
</db:result>
]]></example>
<p>Because the connection is successful, the type1.lit service routes the XML stanza from citizen@type1.lit to the example.lit service.</p>
</section2>
<section2 topic='Type 1 to Type 2' anchor='type1-type2'>
<p>In this scenario, an XMPP user citizen@type1.lit attempts to send an XML stanza to juliet@type2.lit:</p>
<example caption="Test Stanza"><![CDATA[
<iq from='citizen@type1.lit/foo'
id='t1_t2'
to='juliet@type2.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type1.lit service (which supports verified connections only and does not have a certificate) attempts to initiate a server-to-server connection with the type2.lit service (which accepts verified connections and has a self-signed certificate).</p>
<p>First, the type1.lit service sends an initial stream header to type2.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
to='type2.lit'>
]]></example>
<p>Next the type2.lit service sends a response stream header to type1.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
id='idt1_t2o'
to='type1.lit'
version='1.0'>
]]></example>
<p>The type2.lit service also sends stream features.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>
<dialback xmlns='urn:xmpp:features:dialback'/>
</stream:features>
]]></example>
<p>Because the type1.lit service does not support XMPP 1.0, it ignores the stream features and attempts to complete a server dialback negotiation with the type2.lit service. Therefore it sends a dialback key to type2.lit over the existing connection.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type1.lit'
to='type2.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The type2.lit service then performs a DNS lookup on the type1.lit domain, opens a TCP connection at the discovered IP address and port, and establishes a stream with the authoritative server for the type1.lit service.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
to='type1.lit'
version='1.0'>
]]></example>
<p>The authoritative server for the type1.lit service then returns a response stream header.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
id='idt1_t2r'
to='type2.lit'>
]]></example>
<p>The type2.lit service then sends a dialback verification request to the authoritative server for the type1.lit domain.</p>
<example caption="Verification Request"><![CDATA[
<db:verify
from='type2.lit'
id='idt1_t2o'
to='type1.lit'>
some-long-dialback-key
</db:verify>
]]></example>
<p>Here we assume that the authoritative server for the type1.lit domain notifies the type2.lit service that the key is valid.</p>
<example caption="Key is Valid"><![CDATA[
<db:verify
from='type1.lit'
id='idt1_t2o'
to='type2.lit'
type='valid'>
some-long-dialback-key
</db:verify>
]]></example>
<p>The type2.lit service then returns a positive server dialback result to the originating server.</p>
<example caption="Server Dialback Result"><![CDATA[
<db:result
from='type2.lit'
to='type1.lit'
type='valid'>
some-long-dialback-key
</db:result>
]]></example>
<p>Because the connection is successful, the type1.lit service routes the XML stanza from citizen@type1.lit to the type2.lit service.</p>
</section2>
<section2 topic='Type 1 to Type 3' anchor='type1-type3'>
<p>In this scenario, an XMPP user citizen@type1.lit attempts to send an XML stanza to romeo@type3.lit.</p>
<example caption="Test Stanza"><![CDATA[
<iq from='citizen@type1.lit/foo'
id='t1_t3'
to='romeo@type3.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type1.lit service (which supports verified connections only and does not have a certificate) attempts to initiate a server-to-server connection with the type3.lit service (which accepts verified connections and has a CA-issued certificate).</p>
<p>First, the type1.lit service sends an initial stream header to type3.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
to='type3.lit'>
]]></example>
<p>Next the type3.lit service sends a response stream header to type1.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type3.lit'
id='idt1_t3o'
to='type1.lit'
version='1.0'>
]]></example>
<p>The type3.lit service also sends stream features.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>
<dialback xmlns='urn:xmpp:features:dialback'/>
</stream:features>
]]></example>
<p>Because the type1.lit service does not support XMPP 1.0, it ignores the stream features and attempts to complete a server dialback negotiation with the type3.lit service. Therefore it sends a dialback key to the authoritative server for the type3.lit service.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type1.lit'
to='type3.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The type3.lit service then performs a DNS lookup on the type1.lit domain, opens a TCP connection at the discovered IP address and port, and establishes a stream with the authoritative server.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type3.lit'
to='type1.lit'
version='1.0'>
]]></example>
<p>The authoritative server for the type1.lit service then returns a response stream header.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
id='idt1_t3r'
to='type3.lit'>
]]></example>
<p>The type3.lit service then sends a dialback verification request to the authoritative server for the type1.lit domain.</p>
<example caption="Verification Request"><![CDATA[
<db:verify
from='type3.lit'
id='idt1_t3o'
to='type1.lit'>
some-long-dialback-key
</db:verify>
]]></example>
<p>Here we assume that the authoritative server for the type1.lit domain notifies the type3.lit service that the key is valid.</p>
<example caption="Key is Valid"><![CDATA[
<db:verify
from='type1.lit'
id='idt1_t3o'
to='type2.lit'
type='valid'>
some-long-dialback-key
</db:verify>
]]></example>
<p>The type3.lit service then returns a positive server dialback result to the originating server.</p>
<example caption="Server Dialback Result"><![CDATA[
<db:result
from='type3.lit'
to='type1.lit'
type='valid'>
some-long-dialback-key
</db:result>
]]></example>
<p>Because the connection is successful, the type1.lit service routes the XML stanza from citizen@type1.lit to the type3.lit service.</p>
</section2>
<section2 topic='Type 1 to Type 4' anchor='type1-type4'>
<p>In this scenario, an XMPP user citizen@type1.lit attempts to send an XML stanza to hamlet@type4.lit.</p>
<example caption="Test Stanza"><![CDATA[
<iq from='citizen@type1.lit/foo'
id='t1_t4'
to='hamlet@type4.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type1.lit service (which supports verified connections only and does not have a certificate) attempts to initiate a server-to-server connection with type4.lit (which does not accept verified connections and has a self-signed certificate).</p>
<p>First, the type1.lit service sends an initial stream header to type4.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
to='type4.lit'>
]]></example>
<p>Next the type4.lit service sends a response stream header to type1.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type4.lit'
id='idt1_t4o'
to='type1.lit'
version='1.0'>
]]></example>
<p>The type4.lit service also sends stream features. Because the type4.lit service does not accept verified connections, it returns stream features with a notation that STARTTLS is required.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'>
<required/>
</starttls>
</stream:features>
]]></example>
<p>Because the type1.lit service does not support XMPP 1.0, it ignores the stream features and attempts to complete a server dialback negotiation with the type4.lit service. Therefore it sends a dialback key to the authoritative server for the type4.lit service.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type1.lit'
to='type4.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The type4.lit service understands the server dialback protocol but since it requires STARTTLS at this point in the stream negotiation it returns a stream error to the type1.lit service, which should be &lt;not-authorized/&gt;.</p>
<example caption="Stream Error"><![CDATA[
<stream:error>
<not-authorized
xmlns='urn:ietf:params:xml:ns:xmpp-streams'/>
</stream:error>
</stream:stream>
]]></example>
<p>Because the connection is unsuccessful, the type1.lit service returns a stanza error to citizen@type1.lit, which should be &timeout;.</p>
<example caption="Error Stanza"><![CDATA[
<iq from='romeo@type4.lit'
id='t1_t4'
to='citizen@type1.lit/foo'
type='error'>
<error type='cancel'>
<remote-server-timeout
xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
</error>
</iq>
]]></example>
</section2>
<section2 topic='Type 1 to Type 5' anchor='type1-type5'>
<p>In this scenario, an XMPP user citizen@type1.lit attempts to send an XML stanza to bill@type5.lit.</p>
<example caption="Test Stanza"><![CDATA[
<iq from='citizen@type1.lit/foo'
id='t1_t5'
to='bill@type5.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type1.lit service (which supports verified connections only and does not have a certificate) attempts to initiate a server-to-server connection with type5.lit (which does not accept verified connections and has a CA-issued signed certificate).</p>
<p>First, the type1.lit service sends an initial stream header to type5.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
to='type5.lit'>
]]></example>
<p>Next the type5.lit service sends a response stream header to type1.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type5.lit'
id='idt1_t5o'
to='type1.lit'
version='1.0'>
]]></example>
<p>The type5.lit service also sends stream features. Because the type5.lit service does not accept verified connections, it returns stream features with a notation that STARTTLS is required.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'>
<required/>
</starttls>
</stream:features>
]]></example>
<p>Because the type1.lit service does not support XMPP 1.0, it ignores the stream features and attempts to complete a server dialback negotiation with the type5.lit service. Therefore it sends a dialback key to the authoritative server for the type5.lit service.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type1.lit'
to='type5.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The type5.lit service understands the server dialback protocol but since it requires STARTTLS at this point in the stream negotiation it returns a stream error to the type1.lit service, which should be &lt;not-authorized/&gt;.</p>
<example caption="Stream Error"><![CDATA[
<stream:error>
<not-authorized
xmlns='urn:ietf:params:xml:ns:xmpp-streams'/>
</stream:error>
</stream:stream>
]]></example>
<p>Because the connection is unsuccessful, the type1.lit service returns a stanza error to citizen@type1.lit, which should be &timeout;.</p>
<example caption="Error Stanza"><![CDATA[
<iq from='bill@type5.lit'
id='t1_t5'
to='citizen@type1.lit/foo'
type='error'>
<error type='cancel'>
<remote-server-timeout
xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
</error>
</iq>
]]></example>
</section2>
<section2 topic='Type 1 to Type 6' anchor='type1-type6'>
<p>In this scenario, an XMPP user citizen@type1.lit attempts to send an XML stanza to chris@type6.lit.</p>
<example caption="Test Stanza"><![CDATA[
<iq from='citizen@type1.lit/foo'
id='t1_t6'
to='chris@type6.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type1.lit service (which supports verified connections only and does not have a certificate) attempts to initiate a server-to-server connection with the type6.lit service (which accepts only trusted connections, has a CA-issued certificate, and does not support Server Dialback).</p>
<p>First, the type1.lit service sends an initial stream header to type6.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
to='type6.lit'>
]]></example>
<p>Next the type6.lit service sends a response stream header to type1.lit. Notice that the response stream header does not include the dialback namespace, since the type6.lit service does not support Server Dialback.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type6.lit'
id='idt1_t6o'
to='type1.lit'
version='1.0'>
]]></example>
<p>The type6.lit service also sends stream features. Because the type6.lit service does not accept untrusted connections, it returns stream features with a notation that STARTTLS is required.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'>
<required/>
</starttls>
</stream:features>
]]></example>
<p>The type1.lit service does not detect support for server dialback by the type6.lit service but in any case attempts to complete server dialback.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type1.lit'
to='type6.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The type6.lit service does not accept dialback negotiations so it returns a &notauthorized; stream error and closes the stream.</p>
<example caption="Stream Error"><![CDATA[
<stream:error>
<not-authorized
xmlns='urn:ietf:params:xml:ns:xmpp-streams'/>
</stream:error>
</stream:stream>
]]></example>
<p>The type1.lit service closes the stream as well.</p>
<example caption="Stream Close"><![CDATA[
</stream:stream>
]]></example>
<p>Because the connection is unsuccessful, the type1.lit service returns a stanza error to citizen@type1.lit, which should be &timeout;.</p>
<example caption="Error Stanza"><![CDATA[
<iq from='chris@type6.lit'
id='t1_t6'
to='citizen@type1.lit/foo'
type='error'>
<error type='cancel'>
<remote-server-timeout
xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
</error>
</iq>
]]></example>
</section2>
</section1>
<section1 topic='Connections from Type 2 Services' anchor='type2'>
<section2 topic='Type 2 to Type 1' anchor='type2-type1'>
<p>In this scenario, an XMPP user juliet@type2.lit attempts to send an XML stanza to citizen@type1.lit:</p>
<example caption="Test Stanza"><![CDATA[
<iq from='juliet@type2.lit/foo'
id='t2_t1'
to='citizen@type1.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type2.lit service (which accepts verified connections and has a self-signed certificate) attempts to initiate a server-to-server connection with the type1.lit service (which supports verified connections only and does not have a certificate).</p>
<p>First, the type2.lit service sends an initial stream header to type1.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
to='type1.lit'
version='1.0'>
]]></example>
<p>Next the type1.lit service sends a response stream header to type2.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
id='idt1_t2o'
to='type2.lit'>
]]></example>
<p>Because the type1.lit service does not support XMPP 1.0, it does not send stream features. Because the type2.lit service accepts verified connections, it attempts to verify the identity of type1.lit using server dialback. Therefore it sends a dialback key to type1.lit over the existing connection.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type2.lit'
to='type1.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The type1.lit service then performs a DNS lookup on the type2.lit domain, opens a TCP connection at the discovered IP address and port, and establishes a stream with the authoritative server for the type2.lit service.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type1.lit'
to='type2.lit'>
]]></example>
<p>The authoritative server for the type2.lit service then returns a response stream header.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
id='idt1_t2r'
to='type1.lit'
version='1.0'>
]]></example>
<p>The type1.lit service then sends a dialback verification request to the authoritative server for the type2.lit domain.</p>
<example caption="Verification Request"><![CDATA[
<db:verify
from='type1.lit'
id='idt2_t1o'
to='type2.lit'>
some-long-dialback-key
</db:verify>
]]></example>
<p>Here we assume that the authoritative server for the type2.lit domain notifies the type1.lit service that the key is valid.</p>
<example caption="Key is Valid"><![CDATA[
<db:verify
from='type2.lit'
id='idt1_t1o'
to='type1.lit'
type='valid'>
some-long-dialback-key
</db:verify>
]]></example>
<p>The type1.lit service then returns a positive server dialback result to the originating server (i.e., type2.lit).</p>
<example caption="Server Dialback Result"><![CDATA[
<db:result
from='type1.lit'
to='type2.lit'
type='valid'>
some-long-dialback-key
</db:result>
]]></example>
<p>Because the connection is successful, the type2.lit service routes the XML stanza from juliet@type2.lit to the type1.lit service.</p>
</section2>
<section2 topic='Type 2 to Type 2' anchor='type2-type2'>
<p>In this scenario, an XMPP user juliet@type2.lit attempts to send an XML stanza to user@example.lit:</p>
<example caption="Test Stanza"><![CDATA[
<iq from='juliet@type2.lit/foo'
id='t2_t2'
to='user@example.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type2.lit service (which accepts verified connections and has a self-signed certificate) attempts to initiate a server-to-server connection with the example.lit service (which also supports verified connections and has a self-signed certificate).</p>
<p>First, the type2.lit service sends an initial stream header to example.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
to='example.lit'
version='1.0'>
]]></example>
<p>Next the example.lit service sends a response stream header to type2.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='example.lit'
id='idt2_t2o'
to='type2.lit'>
]]></example>
<p>Because the example.lit service supports XMPP 1.0, it also sends stream features.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>
<dialback xmlns='urn:xmpp:features:dialback'/>
</stream:features>
]]></example>
<p>We assume that type2.lit does not attempt STARTTLS negotiation but instead attempts server dialback for weak identity verification.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type2.lit'
to='example.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The example.lit service then performs a DNS lookup on the type2.lit domain, opens a TCP connection at the discovered IP address and port, and establishes a stream with the authoritative server for the type2.lit service.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='example.lit'
to='type2.lit'>
]]></example>
<p>The authoritative server for the type2.lit service then returns a response stream header.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
id='idt2_t2r'
to='example.lit'
version='1.0'>
]]></example>
<p>The example.lit service then sends a dialback verification request to the authoritative server for the type2.lit domain.</p>
<example caption="Verification Request"><![CDATA[
<db:verify
from='example.lit'
id='idt2_t2o'
to='type2.lit'>
some-long-dialback-key
</db:verify>
]]></example>
<p>Here we assume that the authoritative server for the type2.lit domain notifies the example.lit service that the key is valid.</p>
<example caption="Key is Valid"><![CDATA[
<db:verify
from='type2.lit'
id='idt2_t2o'
to='example.lit'
type='valid'>
some-long-dialback-key
</db:verify>
]]></example>
<p>The example.lit service then returns a positive server dialback result to the originating server (i.e., type2.lit).</p>
<example caption="Server Dialback Result"><![CDATA[
<db:result
from='example.lit'
to='type2.lit'
type='valid'>
some-long-dialback-key
</db:result>
]]></example>
<p>Because the connection is successful, the type2.lit service routes the XML stanza from juliet@type2.lit to the example.lit service.</p>
</section2>
<section2 topic='Type 2 to Type 3' anchor='type2-type3'>
<p>In this scenario, an XMPP user juliet@type2.lit attempts to send an XML stanza to romeo@type3.lit:</p>
<example caption="Test Stanza"><![CDATA[
<iq from='juliet@type2.lit/foo'
id='t2_t3'
to='romeo@type3.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type2.lit service (which accepts verified connections and has a self-signed certificate) attempts to initiate a server-to-server connection with the type3.lit service (which also supports verified connections and has a CA-issued certificate).</p>
<p>First, the type2.lit service sends an initial stream header to type3.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
to='type3.lit'
version='1.0'>
]]></example>
<p>Next the type3.lit service sends a response stream header to type2.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type3.lit'
id='idt2_t3o'
to='type2.lit'>
]]></example>
<p>Because the type3.lit service supports XMPP 1.0, it also sends stream features.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>
<dialback xmlns='urn:xmpp:features:dialback'/>
</stream:features>
]]></example>
<p>We assume that type2.lit does not attempt STARTTLS negotiation but instead attempts server dialback for weak identity verification.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type2.lit'
to='type3.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The type3.lit service then performs a DNS lookup on the type2.lit domain, opens a TCP connection at the discovered IP address and port, and establishes a stream with the authoritative server for the type2.lit service.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type3.lit'
to='type2.lit'>
]]></example>
<p>The authoritative server for the type2.lit service then returns a response stream header.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
id='idt2_t3r'
to='type3.lit'
version='1.0'>
]]></example>
<p>The type3.lit service then sends a dialback verification request to the authoritative server for the type2.lit domain.</p>
<example caption="Verification Request"><![CDATA[
<db:verify
from='type3.lit'
id='idt2_t3o'
to='type2.lit'>
some-long-dialback-key
</db:verify>
]]></example>
<p>Here we assume that the authoritative server for the type2.lit domain notifies the type3.lit service that the key is valid.</p>
<example caption="Key is Valid"><![CDATA[
<db:verify
from='type2.lit'
id='idt2_t3o'
to='type3.lit'
type='valid'>
some-long-dialback-key
</db:verify>
]]></example>
<p>The type3.lit service then returns a positive server dialback result to the originating server (i.e., type2.lit).</p>
<example caption="Server Dialback Result"><![CDATA[
<db:result
from='type3.lit'
to='type2.lit'
type='valid'>
some-long-dialback-key
</db:result>
]]></example>
<p>Because the connection is successful, the type2.lit service routes the XML stanza from juliet@type2.lit to the type3.lit service.</p>
</section2>
<section2 topic='Type 2 to Type 4' anchor='type2-type4'>
<p>In this scenario, an XMPP user juliet@type2.lit attempts to send an XML stanza to hamlet@type4.lit:</p>
<example caption="Test Stanza"><![CDATA[
<iq from='juliet@type2.lit/foo'
id='t2_t4'
to='hamlet@type4.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type2.lit service (which accepts verified connections and has a self-signed certificate) attempts to initiate a server-to-server connection with the type4.lit service (which also supports verified connections and has a CA-issued certificate).</p>
<p>First, the type2.lit service sends an initial stream header to type4.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
to='type4.lit'
version='1.0'>
]]></example>
<p>Next the type4.lit service sends a response stream header to type2.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type4.lit'
id='idt2_t4o'
to='type2.lit'>
]]></example>
<p>Because the type4.lit service supports XMPP 1.0, it also sends stream features.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'>
<required/>
</starttls>
<dialback xmlns='urn:xmpp:features:dialback'/>
</stream:features>
]]></example>
<p>Because type4.lit requires encryption, type2.lit attempts to negotiate a STARTTLS upgrade to the stream.</p>
<example caption="STARTTLS Request"><![CDATA[
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>
]]></example>
<example caption="STARTTLS Response"><![CDATA[
<proceed xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>
]]></example>
<p>The servers then negotiate TLS. We assume the negotiation is successful.</p>
<p>The type2.lit service then opens a new stream over the encrypted connection.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
to='type4.lit'
version='1.0'>
]]></example>
<p>Next the type4.lit service sends a response stream header to type2.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type4.lit'
id='idt2_t4o2'
to='type2.lit'>
]]></example>
<p>Because the type4.lit service supports XMPP 1.0, it also sends stream features.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<dialback xmlns='urn:xmpp:features:dialback'>
<required/>
</dialback>
</stream:features>
]]></example>
<p>Notice that type4.lit requires dialback here (perhaps because of some local service policy). Therefore type2.lit sends a dialback key to type4.lit.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type2.lit'
to='type4.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The type4.lit service then performs a DNS lookup on the type2.lit domain, opens a TCP connection at the discovered IP address and port, and establishes a stream with the authoritative server for the type2.lit service.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type4.lit'
to='type2.lit'>
]]></example>
<p>The authoritative server for the type2.lit service then returns a response stream header.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
id='idt2_t4r'
to='type4.lit'
version='1.0'>
]]></example>
<p>The type4.lit service then sends a dialback verification request to the authoritative server for the type2.lit domain.</p>
<example caption="Verification Request"><![CDATA[
<db:verify
from='type4.lit'
id='idt2_t4o'
to='type2.lit'>
some-long-dialback-key
</db:verify>
]]></example>
<p>Here we assume that the authoritative server for the type2.lit domain notifies the type4.lit service that the key is valid.</p>
<example caption="Key is Valid"><![CDATA[
<db:verify
from='type2.lit'
id='idt2_t4o'
to='type4.lit'
type='valid'>
some-long-dialback-key
</db:verify>
]]></example>
<p>The type4.lit service then returns a positive server dialback result to the originating server (i.e., type2.lit).</p>
<example caption="Server Dialback Result"><![CDATA[
<db:result
from='type4.lit'
to='type2.lit'
type='valid'>
some-long-dialback-key
</db:result>
]]></example>
<p>Because the connection is successful, the type2.lit service routes the XML stanza from juliet@type2.lit to the type4.lit service.</p>
</section2>
<section2 topic='Type 2 to Type 5' anchor='type2-type5'>
<p>In this scenario, an XMPP user juliet@type2.lit attempts to send an XML stanza to bill@type5.lit:</p>
<example caption="Test Stanza"><![CDATA[
<iq from='juliet@type2.lit/foo'
id='t2_t5'
to='bill@type5.lit'
type='get'>
<ping xmlns='urn:xmpp:ping'/>
</iq>
]]></example>
<p>Therefore the type2.lit service (which accepts verified connections and has a self-signed certificate) attempts to initiate a server-to-server connection with the type5.lit service (which also supports verified connections and has a CA-issued certificate).</p>
<p>First, the type2.lit service sends an initial stream header to type5.lit.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
to='type5.lit'
version='1.0'>
]]></example>
<p>Next the type5.lit service sends a response stream header to type2.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type5.lit'
id='idt2_t5o'
to='type2.lit'>
]]></example>
<p>Because the type5.lit service supports XMPP 1.0, it also sends stream features.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'>
<required/>
</starttls>
<dialback xmlns='urn:xmpp:features:dialback'/>
</stream:features>
]]></example>
<p>Because type5.lit requires encryption, type2.lit attempts to negotiate a STARTTLS upgrade to the stream.</p>
<example caption="STARTTLS Request"><![CDATA[
<starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>
]]></example>
<example caption="STARTTLS Response"><![CDATA[
<proceed xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>
]]></example>
<p>The servers then negotiate TLS. We assume the negotiation is successful.</p>
<p>The type2.lit service then opens a new stream over the encrypted connection.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
to='type5.lit'
version='1.0'>
]]></example>
<p>Next the type5.lit service sends a response stream header to type2.lit.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type5.lit'
id='idt2_t5o2'
to='type2.lit'>
]]></example>
<p>Because the type5.lit service supports XMPP 1.0, it also sends stream features.</p>
<example caption="Stream Features"><![CDATA[
<stream:features>
<dialback xmlns='urn:xmpp:features:dialback'>
<required/>
</dialback>
</stream:features>
]]></example>
<p>Notice that type5.lit requires dialback here (perhaps because of some local service policy). Therefore type2.lit sends a dialback key to type5.lit.</p>
<example caption="Dialback Key"><![CDATA[
<db:result
from='type2.lit'
to='type5.lit'>
some-long-dialback-key
</db:result>
]]></example>
<p>The type5.lit service then performs a DNS lookup on the type2.lit domain, opens a TCP connection at the discovered IP address and port, and establishes a stream with the authoritative server for the type2.lit service.</p>
<example caption="Initial Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type5.lit'
to='type2.lit'>
]]></example>
<p>The authoritative server for the type2.lit service then returns a response stream header.</p>
<example caption="Response Stream Header"><![CDATA[
<stream:stream
xmlns='jabber:server'
xmlns:db='jabber:server:dialback'
xmlns:stream='http://etherx.jabber.lit/streams'
from='type2.lit'
id='idt2_t5r'
to='type5.lit'
version='1.0'>
]]></example>
<p>The type5.lit service then sends a dialback verification request to the authoritative server for the type2.lit domain.</p>
<example caption="Verification Request"><![CDATA[
<db:verify
from='type5.lit'
id='idt2_t5o'
to='type2.lit'>
some-long-dialback-key