moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2024-12-21 23:28:51 -05:00
Code Issues Releases Wiki Activity

0.6

Browse Source 
git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@420 4b5297f7-1745-476d-ba37-a9c6900126ab
This commit is contained in:
Peter Saint-Andre 2007-01-25 20:18:55 +00:00
parent 067239b9e8
commit 2ad5076374
1 changed files with 94 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

105
xep-0157.xml
View File

@ -27,6 +27,12 @@
<email>jajcus@jajcus.net</email>
<jid>jajcus@jabber.bnet.pl</jid>
</author>
<revision>
<version>0.6</version>
<date>2007-01-25</date>
<initials>psa</initials>
<remark><p>Per Council feedback, restored service discovery of XMPP contact addresses from version 0.1 of spec.</p></remark>
</revision>
<revision>
<version>0.5</version>
<date>2007-01-06</date>
@ -77,20 +83,64 @@
<section1 topic='Email Address' anchor='email'>
<p>Consistent with <cite>RFC 2142</cite>, a domain that offers a Jabber/XMPP service SHOULD provide an Internet mailbox of "XMPP" for inquiries related to that service.</p>
</section1>
<section1 topic='XMPP Address' anchor='xmpp'>
<p>Many existing Jabber/XMPP server implementations use the bare domain (&DOMAIN;) of the server (e.g., "example.org") as an alias for the server administrators, such that a &MESSAGE; stanza addressed to that domain name is delivered to the JIDs of the server administrators. <note>Currently, this functionality does not apply to &IQ; or &PRESENCE; stanzas.</note> Unfortunately, using the "domain.tld" address as a way to direct messages to the server administrators may result in overloading of the bare domain address (i.e., it may be desirable to send messages to the server's address without having those messages delivered to the server admins, for example if the server doubles as a &xep0060; service). Therefore, it is instead RECOMMENDED to support a reserved address of &lt;xmpp@domain.tld&gt; for this functionality.</p>
<p>In particular, it is RECOMMENDED for a service provider to handle XML stanzas with a 'to' address of &lt;xmpp@domain.tld&gt; as follows:</p>
<ol start='1'>
<li><p>For &MESSAGE; stanzas, deliver them to the administrators of the XMPP service.</p></li>
<li><p>For &PRESENCE; stanzas, ignore them.</p></li>
<li><p>For &IQ; stanzas, respond with a &unavailable; error.</p></li>
</ol>
<p>A service provider MAY aggregate presence from the server administrators so that the presence associated with &lt;xmpp@domain.tld&gt; reflects the presence of the server administrators (e.g., if at least one of the server administrators is online, then the alias &lt;xmpp@domain.tld&gt; will also appear to be online); alternatively, the service provider MAY refuse all requests for presence information about the &lt;xmpp@domain.tld&gt; address.</p>
<section1 topic='XMPP Addresses' anchor='xmpp'>
<p>The administrators of an XMPP service may desire to advertise contact information related to that service.
<note>Many existing Jabber/XMPP server implementations use the bare domain (&DOMAIN;) of the server (e.g., "example.org") as an alias for the server administrators, such that a &MESSAGE; stanza addressed to that domain name is delivered to the JIDs of the server administrators. (Currently, this functionality does not apply to &IQ; or &PRESENCE; stanzas.) Unfortunately, using the "domain.tld" address as a way to direct messages to the server administrators may result in overloading of the bare domain address (i.e., it may be desirable to send messages to the server's address without having those messages delivered to the server admins, for example if the server doubles as a &xep0060; service). Therefore, it is instead RECOMMENDED to support service discovery of contact addresses as specified herein.</note>
This contact information may include email addresses, web URLs, and JabberIDs for specific roles and functions such as the service administrators, abuse reports, customer feedback, sales inquiries, technical support, and security concerns. For this purpose, domains SHOULD support the electronic mailboxes required by <cite>RFC 2142</cite>. However, additional contact mechanisms may be desirable, and it would be helpful if those who want to initiate contact could discover the contact information using standard XMPP extensions, specifically &xep0030;. To make such discovery possible, we specify a &xep0128; mechanism that a server SHOULD return in response to service discovery information ("disco#info") requests sent to the bare domain of the server. This information MUST be scoped using a FORM_TYPE of "http://jabber.org/network/serverinfo" (as already specified in <cite>XEP-0128</cite>) and data form fields registered for this purpose as defined in the <link url='#registrar'>XMPP Registrar Considerations</link> section of this document.</p>
<p>To illustrate this usage, consider the following example of a disco#info request sent to the mythical shakespeare.lit XMPP server:</p>
<example caption='Entity queries server for information'><![CDATA[
<iq from='juliet@capulet.com/chamber'
to='shakespeare.lit'
id='disco1'
type='get'>
<query xmlns='http://jabber.org/protocol/disco#info'/>
</iq>
]]></example>
<example caption='Server communicates information'><![CDATA[
<iq from='shakespeare.lit'
to='juliet@capulet.com/chamber'
id='disco1'
type='result'>
<query xmlns='http://jabber.org/protocol/disco#info'>
<identity category='server' type='im'/>
<feature var='http://jabber.org/protocol/disco'/>
<x xmlns='jabber:x:data' type='result'>
<field var='FORM_TYPE' type='hidden'>
<value>http://jabber.org/network/serverinfo</value>
</field>
<field var='abuse-addresses'>
<value>mailto:abuse@shakespeare.lit</value>
<value>xmpp:abuse@shakespeare.lit</value>
</field>
<field var='admin-addresses'>
<value>mailto:xmpp@shakespeare.lit</value>
<value>xmpp:admins@shakespeare.lit</value>
</field>
<field var='feedback-addresses'>
<value>http://shakespeare.lit/feedback.php</value>
<value>mailto:feedback@shakespeare.lit</value>
<value>xmpp:feedback@shakespeare.lit</value>
</field>
<field var='sales-addresses'>
<value>xmpp:bard@shakespeare.lit</value>
</field>
<field var='security-addresses'>
<value>xmpp:security@shakespeare.lit</value>
</field>
<field var='support-addresses'>
<value>http://shakespeare.lit/support.php</value>
<value>xmpp:support@shakespeare.lit</value>
</field>
</x>
</query>
</iq>
]]></example>
</section1>
<section1 topic='Deployment Notes' anchor='deploy'>
<p>The "domain.tld" at which the XMPP service is hosted need not be the same as the "domain.tld" at which the email service is hosted. For example, it is common for a service provider to host its XMPP service at a hostname such as "jabber.example.org" whereas email related to the service provider is sent to a hostname of "example.org". Thus while the XMPP address and email address may be the same for some service providers (e.g., both "xmpp@example.com"), that similarity is not necessary.</p>
<p>Although some service providers that use the same address for both XMPP and email messaging may integrate delivery of messages sent by those mechanisms (e.g., XMPP messages sent while a user is offline are redirected to email delivery), XMPP and email remain separate messaging systems.</p>
<p>A service provider that supports the functionality specified herein may advertise the service through an XMPP URI (see &rfc4622;) of &lt;xmpp:xmpp@domain.tld&gt; or (per &xep0147;) &lt;xmpp:xmpp@domain.tld?message&gt;, and through a Mailto URI (see &rfc2368;) of &lt;mailto:xmpp@domain.tld&gt;.</p>
<p>A service provider that supports the functionality specified herein may advertise the service through a Mailto URI (see &rfc2368;) of &lt;mailto:xmpp@domain.tld&gt; and through appropriate XMPP URIs (see &rfc4622;) such as &lt;xmpp:admins@domain.tld&gt; or (per &xep0147;) &lt;xmpp:admins@domain.tld?message&gt;.</p>
<p>It is a matter of service policy whether the XMPP addresses provided are dedicated accounts or aliases that redirect communications to the appropriate accounts.</p>
</section1>
<section1 topic='Security Considerations' anchor='security'>
<p>Providing or advertising contact addresses may open those addresses to unwanted communication. Server administrators should balance the need for openness with the desire for control over communication with customers and peers.</p>
@ -99,6 +149,39 @@
<p>This document requires no interaction with &IANA;.</p>
</section1>
<section1 topic='XMPP Registrar Considerations' anchor='registrar'>
<p>This document requires no interaction with the &REGISTRAR;.</p>
<p>The &REGISTRAR; shall include the following information in its registries.</p>
<section2 topic='Field Standardization' anchor='registrar-formtype'>
<p>&xep0068; defines a process for standardizing the fields used within Data Forms qualified by a particular namespace, and <cite>XEP-0128</cite> describes how to use field standardization in the context of service discovery. This section registers fields for server information scoped by the "http://jabber.org/network/serverinfo" FORM_TYPE.</p>
<code caption='Registry Submission'><![CDATA[
<form_type>
<name>http://jabber.org/network/serverinfo</name>
<doc>XEP-0157</doc>
<desc>
Forms enabling the communication of contact addresses
and other server information.
</desc>
<field
var='abuse-addresses'
type='list-multi'
label='One or more addresses for communication related to abusive traffic'/>
<field
var='feedback-addresses'
type='list-multi'
label='One or more addresses for customer feedback'/>
<field
var='sales-addresses'
type='list-multi'
label='One or more addresses for communication related to sales and marketing'/>
<field
var='security-addresses'
type='list-multi'
label='One or more addresses for communication related to security concerns'/>
<field
var='support-addresses'
type='list-multi'
label='One or more addresses for customer support'/>
</form_type>
]]></code>
</section2>
</section1>
</xep>