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> <email>samizzi@cisco.com</email>
<jid>samizzi@cisco.com</jid> <jid>samizzi@cisco.com</jid>
</author> </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> <revision>
<version>0.10</version> <version>0.10</version>
<date>2013-09-12</date> <date>2013-09-12</date>
@ -356,12 +362,12 @@
</section2> </section2>
<section2 topic='Storage' anchor='contacts-storage'> <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[ <example caption='Storing a Contact vCard'><![CDATA[
<iq from='stpeter@stpeter.im/squire' type='set' id='h3vs7163'> <iq from='stpeter@stpeter.im/squire' type='set' id='h3vs7163'>
<pubsub xmlns='http://jabber.org/protocol/pubsub'> <pubsub xmlns='http://jabber.org/protocol/pubsub'>
<publish node='urn:xmpp:contacts'> <publish node='urn:xmpp:contacts'>
<item> <item id='samizzi@cisco.com'>
<vcard xmlns="urn:ietf:params:xml:ns:vcard-4.0"> <vcard xmlns="urn:ietf:params:xml:ns:vcard-4.0">
<fn><text>Samantha Mizzi</text></fn> <fn><text>Samantha Mizzi</text></fn>
<n> <n>
@ -412,7 +418,7 @@
id='ka92g1b5'> id='ka92g1b5'>
<event xmlns='http://jabber.org/protocol/pubsub#event'> <event xmlns='http://jabber.org/protocol/pubsub#event'>
<items node='urn:xmpp:contacts'> <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"> <vcard xmlns="urn:ietf:params:xml:ns:vcard-4.0">
<fn><text>Samantha Mizzi</text></fn> <fn><text>Samantha Mizzi</text></fn>
<n> <n>
@ -448,7 +454,7 @@
id='pty14x69'> id='pty14x69'>
<event xmlns='http://jabber.org/protocol/pubsub#event'> <event xmlns='http://jabber.org/protocol/pubsub#event'>
<items node='urn:xmpp:contacts'> <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"> <vcard xmlns="urn:ietf:params:xml:ns:vcard-4.0">
<fn><text>Samantha Mizzi</text></fn> <fn><text>Samantha Mizzi</text></fn>
<n> <n>