%ents; ]>
vCard4 Over XMPP This document specifies an XMPP extension for use of the vCard4 XML format in XMPP systems, with the intent of obsoleting the vcard-temp format. &LEGALNOTICE; 0292 Experimental Standards Track Standards Council XMPP Core draft-ietf-vcarddav-vcardrev draft-ietf-vcarddav-vcardxml XEP-0054 NOT_YET_ASSIGNED Samantha Mizzi samizzi@cisco.com samizzi@cisco.com &stpeter; 0.4 2011-06-20 psa

Defined provisional mapping from vcard-temp to vCard4.

0.3 2011-04-07 psa

Updated to track base vCard4 specs; defined IQ transport, with pubsub for notifications; added examples for server vCards; described several problematic aspects of mapping from vcard-temp.

0.2 2011-04-07 psa

Updated to track base vCard4 specs; defined IQ transport, with pubsub for notifications; added examples for server vCards; specified mapping from vcard-temp.

0.1 2011-03-02 psa

Initial published version.

0.0.5 2011-02-28 psa

Corrected more errors in the examples.

0.0.4 2011-02-25 psa

Corrected some errors in the examples.

0.0.3 2011-02-12 psa

Third draft.

0.0.2 2011-01-31 srm

Second draft.

0.0.1 2010-11-30 srm

First draft.

Since 1999, the Jabber/XMPP community has used an interim, unofficial XML representation of vCard data for personal contacts, called &xep0054;. Recently, the IETF has upgraded vCard from vCard3 to &vcardrev;, and at the same time has defined &vcardxml; as an official XML format for vCard4. This document specifies an XMPP extension for use of the vCard4 XML format in XMPP systems, with the intent of obsoleting the vcard-temp format. Primarily this document defines the encapsulation method itself; secondarily it also defines transport methods and a mapping to the vcard-temp format for migration by clients and servers.

This specification was designed with the following requirements in mind.

  1. Reuse vCard4 as defined in draft-ietf-vcarddav-vcardrev.
  2. Reuse the vCard4 XML format as defined in draft-ietf-vcarddav-vcardxml.
  3. Ensure that clients and servers can easily migrate from vcard-temp to the new encapsulation format.
  4. Notify interested parties of changes to vCard data using standard XMPP extensions, specifically &xep0163;.
  5. Support vCards for non-human entities such as XMPP servers and &xep0045; rooms.
  6. Enable XMPP servers to store vCard4 XML data in LDAP directories if desired.

Because there is now an XML namespace for the official vCard format, we can simply re-use that namespace: "urn:ietf:params:xml:ns:vcard-4.0".

The vCard XML format defined at the IETF specifies that the root element is <vcards/>, where the only defined child element is <vcard/>. For use in XMPP, we specify that the root element shall be <vcard/>, not <vcards/>.

As in XEP-0054, the primary method for publishing and retrieving vCards is the XMPP &IQ; stanza.

An XMPP entity retrieves the vCard of another entity (or itself) by sending an IQ-get to the target entity containing a <vcard/> child element (note the lowercase "c"!) qualified by the 'urn:ietf:params:xml:ns:vcard-4.0' namespace.

]]>

If a vCard exists for the target entity, the responsible entity (e.g., the XMPP server that hosts the account for a bare JID) MUST return the data in an IQ-result:

Peter Saint-Andre Saint-AndrePeter stpeter psa http://me.stpeter.im/images/stpeter_oscon.jpg 1966-08-06 work Suite 600 1899 Wynkoop Street Denver CO 80202 USA home Denver CO 80210 USA workvoice tel:+1-303-308-3282 workfax tel:+1-303-308-3219 homevoice tel:+1-303-555-1212 geo:39.59,-105.01 <text>Executive Director</text> Patron Saint data:image/jpeg; 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 0vx/+oqw7D4D8qysrzcv7jro/9k= work XMPP Standards Foundation https://stpeter.im/ http://www.saint-andre.com/ -----BEGIN PGP PUBLIC KEY BLOCK----- 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 =4sgL -----END PGP PUBLIC KEY BLOCK----- More information about me is located on my personal website: https://stpeter.im/ M 1 en work psaintan@cisco.com home stpeter@jabber.org home xmpp:psaintan@cisco.com home xmpp:stpeter@jabber.org work https://stpeter.im/index.php/contact/ ]]>

If no vCard exists, the server MUST return an IQ-result containing an empty <vcard/> element.

]]>

An XMPP entity publishes or updates its vCard by sending an IQ-set to itself, containing a <vcard/> child element qualified by the 'urn:ietf:params:xml:ns:vcard-4.0' namespace.

[...] ]]>

If no error occurs, the responsible entity returns an IQ-result.

]]>

Note: An entity MAY have authorization to update the vCard of another entity (e.g., a server administrator might have authorization to modify the server's vCard).

&xep0060; provides a way to subscribe to events, and &xep0163; defines a pubsub profile for events associated with instant messaging (IM) accounts. If PEP is supported by an IM server, it can be used to automatically generate event notifications when a user's vCard is modified.

The canonical location for notifications regarding a user's vCard is a pubsub node whose name is "urn:xmpp:vcard4".

Let us imagine that Juliet wishes to receive the updates that Romeo publishes to his vCard. She has two options:

  1. Implicitly subscribe by advertising support for "urn:xmpp:vcard4+notify" in her &xep0115; data. Romeo's PEP service then automatically sends vCard updates to her when it receives presence from her, until and unless she sends presence of type unavailable or stops advertising an interest in vCard updates. This is in accordance with XEP-0060, section 6.1.
  2. Explicitly subscribe by sending a formal subscription request to the "urn:xmpp:vcard4" node at Romeo's JabberID. Romeo's PEP service may send her all vCard updates even if she is offline at the time (depending on service policies regarding presence integration).

Because Juliet has sent presence to Romeo including Entity Capabilities data that includes the "urn:xmpp:vcard4+notify" feature, Romeo's XMPP server will send a PEP notification to Juliet. The notification can include an XMPP message body for backwards-compatibility with XMPP clients that are not pubsub-capable (see Message Body). This is in accordance with XEP-0060, second 6.1.7.

]]>

Note: There is no payload, because this is a pure notification (the receiver needs to retrieve the vCard using an IQ-get as described earlier..

Traditionally, vCards have been used on the XMPP network for entities other than human users, e.g. by XMPP servers and chatrooms. When such automated entities use vCards, it is RECOMMENDED to specify a value of "thing" for the vCard4 KIND property &vcardthing;. An example follows.

jabber.org IM service http://www.jabber.org/ 1 en xmpp@jabber.org xmpp:jabber.org http://www.jabber.org/images/logo.png geo:42.25,-91.05 America/Chicago thing ]]>

The vCard information published to one's XMPP server is world-readable; therefore, users should exercise due caution when determining what information to include (e.g., street addresses, personal telephone numbers, or email addresses).

This document does not require interaction with &IANA;.

This section provides a more detailed description of mapping vcard-temp properties to vcard4 properties.

The vcard-temp specification defined a <DESC/> element. This element was not part of the vCard3 schema. Mapping the vcard-temp <DESC/> element to the vCard4 NOTE property is appropriate.

More information about me is located on my personal website: https://stpeter.im/ ]]> More information about me is located on my personal website: https://stpeter.im/ ]]>

The vcard-temp specification defined a <JABBERID/> element:

stpeter@jabber.org ]]>

Although the JABBERID field was not part of the vCard3 schema and was simply hacked into vcard-temp, &rfc4770; defined an IMPP property for instant messaging and presence addresses, which was ported to vCard4. In the vCard4 XML format, the IMPP property for a JabberID would be as follows.

xmpp:stpeter@jabber.org ]]>

Several of the properties in vcard-temp are defined differently in vCard3. In fact, the definitions even differ from those provisionally made in the so-called "Dawson drafts" from which vcard-temp was supposedly defined (for reference, the last of these is archived at <http://www.watersprings.org/pub/id/draft-dawson-vcard-xml-dtd-03.txt>). The reasons for these discrepancies are unknown. However, care must be taken in correctly mapping these properties from vcard-temp to vCard4.

The DTD in XEP-0054 provided this definition for the KEY element:

]]>

However, the DTD in the final Dawson draft provided the following definition:

]]>

The relevant RelaxNG definition in vCard4 XML is as follows:

The source of the spurious <TYPE/> and <CRED/> elements is unknown. Here we map the vcard-temp <CRED/> element to the vCard4 value-text construction.

The DTD in XEP-0054 provided this definition for the SOUND element:

]]>

However, the DTD in the final Dawson draft provided the following definition:

]]>

The source of the spurious <PHONETIC/> element is unknown. However, it does not exist in vCard4 and therefore is simply discarded when mapping.

The following properties are defined differently in vcard-temp and vCard4. As a result, the mappings are workable but might not preserve all information that could have been contained in vcard-temp data.

The following address type values allowed in vCard3 were removed from vCard4:

  • DOM
  • INTL
  • PARCEL
  • POSTAL

In vCard3 and vcard-temp, the AGENT property was allowed to contain inline vCard of someone who could act as an agent for the primary owner of the referenced vCard. In vCard4, inline vCards are disallowed. Therefore only pointers to external vCard objects are now allowed, by means of a URI.

The ORGUNIT property was removed from vCard4, with the result that the ORGNAME property becomes the only value for an ORG.

The SORT-STRING property from vCard3 was renamed to SORT-AS in vCard4.

The following telephony type values allowed in vCard3 were removed from vCard4:

  • BBS
  • ISDN
  • MODEM
  • MSG
  • PCS

In addition, in vCard4 the telephone number is represented as a tel: URI, not by means of a NUMBER property.

The following properties are defined similarly in vcard-temp, vCard3, and vCard4, and the mappings are fairly straightforward (a future version of this document might provide more detailed narrative descriptions of the mappings).

  • BDAY
  • CATEGORIES
  • EMAIL
  • FN
  • GEO
  • LOGO
  • N
  • NICKNAME
  • NOTE
  • PHOTO
  • PRODID
  • REV
  • ROLE
  • TITLE
  • UID
  • URL

The following properties were defined in vCard3 but were removed from vCard4:

  • CLASS
  • LABEL
  • MAILER

There is no mapping from these properties to vCard4.

This section provides a highly provisional and purely informational XSLT script for migration from vcard-temp to vCard4.

data:; xmpp: geo:, <text><xsl:value-of select='.'/></text> data:; data:audio/basic;base64, home work 1 home work text voice fax cell video pager textphone tel: home work 1 ]]>

Thanks to Joe Hildebrand, Waqas Hussain, and Matt Miller for their feedback.