1
0
mirror of https://github.com/moparisthebest/xeps synced 2024-12-12 02:42:16 -05:00
xeps/xep-0157.xml

230 lines
12 KiB
XML
Raw Permalink 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>Contact Addresses for XMPP Services</title>
<abstract>This document defines a method for specifying contact addresses related to an XMPP service.</abstract>
&LEGALNOTICE;
<number>0157</number>
<status>Active</status>
<type>Informational</type>
<sig>Standards</sig>
<approver>Council</approver>
<dependencies>
<spec>XMPP Core</spec>
<spec>XEP-0128</spec>
</dependencies>
<supersedes/>
<supersededby/>
<shortname>N/A</shortname>
&stpeter;
<author>
<firstname>Jacek</firstname>
<surname>Konieczny</surname>
<email>jajcus@jajcus.net</email>
<jid>jajcus@jabber.bnet.pl</jid>
</author>
<revision>
<version>1.1.1</version>
<date>2021-03-04</date>
<initials>mw</initials>
<remark><p>Cross-document editorial adjustments for inclusive language.</p></remark>
</revision>
<revision>
<version>1.1.0</version>
<date>2020-05-25</date>
<initials>mb, fs</initials>
<remark><p>Add 'status-addresses' value in registrar, with example.</p></remark>
</revision>
2018-07-21 07:55:05 -04:00
<revision>
<version>1.0.1</version>
<date>2018-07-21</date>
<initials>egp</initials>
<remark><p>Add missing dependency metadata.</p></remark>
</revision>
2017-01-01 20:56:24 -05:00
<revision>
<version>1.0</version>
<date>2007-01-31</date>
<initials>psa</initials>
<remark><p>Per a vote of the XMPP Council, advanced specification to Active.</p></remark>
</revision>
<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>
<initials>psa</initials>
<remark><p>Changed XMPP address from domain.tld/admin to xmpp@domain.tld.</p></remark>
</revision>
<revision>
<version>0.4</version>
<date>2007-01-05</date>
<initials>psa</initials>
<remark><p>Changed XMPP address from domain.tld to domain.tld/admin to prevent overloading.</p></remark>
</revision>
<revision>
<version>0.3</version>
<date>2006-07-31</date>
<initials>psa</initials>
<remark><p>Recommended support for RFC2142-style mailbox in addition to XMPP address.</p></remark>
</revision>
<revision>
<version>0.2</version>
<date>2006-07-18</date>
<initials>psa</initials>
<remark><p>Removed extended addressing recommendations pending further review.</p></remark>
</revision>
<revision>
<version>0.1</version>
<date>2005-09-08</date>
<initials>psa</initials>
<remark><p>Initial version.</p></remark>
</revision>
<revision>
<version>0.0.2</version>
<date>2005-09-06</date>
<initials>psa</initials>
<remark><p>Added security considerations and XMPP Registrar considerations.</p></remark>
</revision>
<revision>
<version>0.0.1</version>
<date>2005-08-27</date>
<initials>psa/jk</initials>
<remark><p>First draft.</p></remark>
</revision>
</header>
<section1 topic='Introduction' anchor='intro'>
<p>&rfc2142; specifies conventional electronic mailbox names for common services, roles, and functions related to SMTP, NNTP, and HTTP (such as security@domain.tld, usenet@domain.tld, and abuse@domain.tld). However, no such conventional email address or XMPP address has been specified for XMPP services (e.g., in &rfc3920;). This document remedies that oversight, and the email recommendation specified here has been incorporated into &rfc6120;.</p>
</section1>
<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 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 &DOMAINBARE; 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>Values of 'status-addresses' form field MUST be valid URIs, i.e. comply with the
'xs:anyURI' datatype of &w3xmlschema2;. Values of the 'abuse-addresses',
'admin-addresses', 'feedback-addresses', 'sales-addresses',
'security-addresses' and 'support-addresses' SHOULD be valid URIs.</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='status-addresses'>
<value>https://status.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 a Mailto URI (see &rfc2368;) of &lt;mailto:xmpp@domain.tld&gt; and through appropriate XMPP URIs (see &rfc5122;) 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>
</section1>
<section1 topic='IANA Considerations' anchor='iana'>
<p>This document requires no interaction with &IANA;.</p>
</section1>
<section1 topic='XMPP Registrar Considerations' anchor='registrar'>
<p>The &REGISTRAR; includes 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'/>
2011-08-10 11:49:54 -04:00
<field
var='admin-addresses'
type='list-multi'
label='One or more addresses for communication with the service administrators'/>
<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='status-addresses'
type='list-multi'
label='One or more addresses for service status'>
</field>
<field
var='support-addresses'
type='list-multi'
label='One or more addresses for customer support'/>
</form_type>
]]></code>
</section2>
</section1>
</xep>