Merge branch 'feature/xep-0292' into premerge

This commit is contained in:
Jonas Schäfer 2021-06-08 21:04:07 +02:00
commit c839de2723
1 changed files with 10 additions and 4 deletions

View File

@ -32,6 +32,12 @@
<email>samizzi@cisco.com</email>
<jid>samizzi@cisco.com</jid>
</author>
<revision>
<version>0.11</version>
<date>2020-06-08</date>
<initials>ka</initials>
<remark><p>Recommend use of contact bare JIDs for item IDs</p></remark>
</revision>
<revision>
<version>0.10</version>
<date>2013-09-12</date>
@ -356,12 +362,12 @@
</section2>
<section2 topic='Storage' anchor='contacts-storage'>
<p>Because contact vCards are private information, they are best stored using &xep0223;. The canonical location is a well-known pubsub node "urn:xmpp:contacts". In accordance with <cite>XEP-0223</cite>, this node MUST have an access type of "whitelist" by default. When a client stores items at this node, it SHOULD NOT include an ItemID, so that the pubsub service can assign those identifiers.</p>
<p>Because contact vCards are private information, they are best stored using &xep0223;. The canonical location is a well-known pubsub node "urn:xmpp:contacts". In accordance with <cite>XEP-0223</cite>, this node MUST have an access type of "whitelist" by default. When a client stores items at this node, it MUST include an ItemID set to the bare JID of the contact.</p>
<example caption='Storing a Contact vCard'><![CDATA[
<iq from='stpeter@stpeter.im/squire' type='set' id='h3vs7163'>
<pubsub xmlns='http://jabber.org/protocol/pubsub'>
<publish node='urn:xmpp:contacts'>
<item>
<item id='samizzi@cisco.com'>
<vcard xmlns="urn:ietf:params:xml:ns:vcard-4.0">
<fn><text>Samantha Mizzi</text></fn>
<n>
@ -412,7 +418,7 @@
id='ka92g1b5'>
<event xmlns='http://jabber.org/protocol/pubsub#event'>
<items node='urn:xmpp:contacts'>
<item id='9703CC4E-CF7E-4A86-9E61-2C670235F9CB'>
<item id='samizzi@cisco.com'>
<vcard xmlns="urn:ietf:params:xml:ns:vcard-4.0">
<fn><text>Samantha Mizzi</text></fn>
<n>
@ -448,7 +454,7 @@
id='pty14x69'>
<event xmlns='http://jabber.org/protocol/pubsub#event'>
<items node='urn:xmpp:contacts'>
<item id='9703CC4E-CF7E-4A86-9E61-2C670235F9CB'>
<item id='samizzi@cisco.com'>
<vcard xmlns="urn:ietf:params:xml:ns:vcard-4.0">
<fn><text>Samantha Mizzi</text></fn>
<n>