From 2ad50763747e3439e0abba336b3fa00eed925c77 Mon Sep 17 00:00:00 2001 From: Peter Saint-Andre Date: Thu, 25 Jan 2007 20:18:55 +0000 Subject: [PATCH] 0.6 git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@420 4b5297f7-1745-476d-ba37-a9c6900126ab --- xep-0157.xml | 105 +++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 94 insertions(+), 11 deletions(-) diff --git a/xep-0157.xml b/xep-0157.xml index 1c4ee366..f3dfd370 100644 --- a/xep-0157.xml +++ b/xep-0157.xml @@ -27,6 +27,12 @@ jajcus@jajcus.net jajcus@jabber.bnet.pl + + 0.6 + 2007-01-25 + psa +

Per Council feedback, restored service discovery of XMPP contact addresses from version 0.1 of spec.

 + 0.5 2007-01-06 @@ -77,20 +83,64 @@

Consistent with RFC 2142, a domain that offers a Jabber/XMPP service SHOULD provide an Internet mailbox of "XMPP" for inquiries related to that service.

 - -

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 a reserved address of <xmpp@domain.tld> for this functionality.

-

In particular, it is RECOMMENDED for a service provider to handle XML stanzas with a 'to' address of <xmpp@domain.tld> as follows:

-
    -

  1. For &MESSAGE; stanzas, deliver them to the administrators of the XMPP service.

    2. -

  2. For &PRESENCE; stanzas, ignore them.

    3. -

  3. For &IQ; stanzas, respond with a &unavailable; error.

    4. -
-

A service provider MAY aggregate presence from the server administrators so that the presence associated with <xmpp@domain.tld> reflects the presence of the server administrators (e.g., if at least one of the server administrators is online, then the alias <xmpp@domain.tld> will also appear to be online); alternatively, the service provider MAY refuse all requests for presence information about the <xmpp@domain.tld> address.

+ +

The administrators of an XMPP service may desire to advertise contact information related to that service. + 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. + 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 RFC 2142. 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 XEP-0128) and data form fields registered for this purpose as defined in the XMPP Registrar Considerations section of this document.

+

To illustrate this usage, consider the following example of a disco#info request sent to the mythical shakespeare.lit XMPP server:

+ + + + ]]> + + + + + + + http://jabber.org/network/serverinfo + + + mailto:abuse@shakespeare.lit + xmpp:abuse@shakespeare.lit + + + mailto:xmpp@shakespeare.lit + xmpp:admins@shakespeare.lit + + + http://shakespeare.lit/feedback.php + mailto:feedback@shakespeare.lit + xmpp:feedback@shakespeare.lit + + + xmpp:bard@shakespeare.lit + + + xmpp:security@shakespeare.lit + + + http://shakespeare.lit/support.php + xmpp:support@shakespeare.lit + + + + + ]]>

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.

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.

-

A service provider that supports the functionality specified herein may advertise the service through an XMPP URI (see &rfc4622;) of <xmpp:xmpp@domain.tld> or (per &xep0147;) <xmpp:xmpp@domain.tld?message>, and through a Mailto URI (see &rfc2368;) of <mailto:xmpp@domain.tld>.

+

A service provider that supports the functionality specified herein may advertise the service through a Mailto URI (see &rfc2368;) of <mailto:xmpp@domain.tld> and through appropriate XMPP URIs (see &rfc4622;) such as <xmpp:admins@domain.tld> or (per &xep0147;) <xmpp:admins@domain.tld?message>.

+

It is a matter of service policy whether the XMPP addresses provided are dedicated accounts or aliases that redirect communications to the appropriate accounts.

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.

@@ -99,6 +149,39 @@

This document requires no interaction with &IANA;.

 -

This document requires no interaction with the ®ISTRAR;.

+

The ®ISTRAR; shall include the following information in its registries.

+ +

&xep0068; defines a process for standardizing the fields used within Data Forms qualified by a particular namespace, and XEP-0128 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.

+ + http://jabber.org/network/serverinfo + XEP-0157 + + Forms enabling the communication of contact addresses + and other server information. + + + + + + + + ]]> +