Changeset 75


Ignore:
Timestamp:
16/03/14 20:07:24 (9 years ago)
Author:
stpeter@…
Message:

fixes awaiting approval

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-stox-presence.xml

    r67 r75  
    1414      <organization>&amp;yet</organization>
    1515      <address>
     16        <postal>
     17          <street>P.O. Box 787</street>
     18          <city>Parker</city>
     19          <region>CO</region>
     20          <code>80134</code>
     21          <country>USA</country>
     22        </postal>
    1623        <email>ietf@stpeter.im</email>
    1724      </address>
     
    8491    <section title="Terminology" anchor="terms">
    8592      <t>A number of terms used here (user, contact, subscription, notification, etc.) are explained in <xref target='RFC3261'/>, <xref target='RFC3856'/>, <xref target='RFC6120'/>, and <xref target='RFC6121'/>.  This document uses some, but not all, of the terms defined in the Model for Presence and Instant Messaging <xref target='RFC2778'/>.</t>
     93      <t>In flow diagrams, SIP traffic is shown using arrows such as "***&gt;" whereas XMPP traffic is shown using arrows such as "...&gt;".</t>
    8694      <t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in <xref target='RFC2119'/>.</t>
    8795    </section>
     
    112120 | (F1) XMPP |            |              |            |           |
    113121 | subscribe |            |              |            |           |
    114  |---------->|            |              |            |           |
     122 |..........>|            |              |            |           |
    115123 |           | (F2) XMPP  |              |            |           |
    116124 |           | subscribe  |              |            |           |
    117  |           |----------->|              |            |           |
    118  |           |            | (F3) SIP     |            |           |
     125 |           |...........>|              |            |           |
     126 |           |            | (F3) SIP SUBSCRIBE        |           |
    119127 |           |            | SUBSCRIBE    |            |           |
    120  |           |            |------------->|            |           |
    121  |           |            |              | (F4) SIP   |           |
    122  |           |            |              | SUBSCRIBE  |          |
    123  |           |            |              |----------->|           |
     128 |           |            |**************************>|           |
     129 |           |            |              |            | (F4) SIP  |
     130 |           |            |              |            | SUBSCRIBE |
     131 |           |            |              |            |**********>|
    124132 |           |            |              |            | (F5) SIP  |
    125  |           |            |              |            | SUBSCRIBE |
    126  |           |            |              |            |---------->|
    127  |           |            |              |            | (F6) SIP  |
    128133 |           |            |              |            | 200 OK    |
    129  |           |            |              | (F7) SIP   |<----------|
    130  |           |            |              | 200 OK     | (F8) SIP  |
    131  |           |            |              |<-----------| NOTIFY    |
    132  |           |            |              |            |<----------|
     134 |           |            |              | (F6) SIP   |<**********|
     135 |           |            |              | 200 OK     | (F7) SIP  |
     136 |           |            |              |<***********| NOTIFY    |
     137 |           |            |              |            |<**********|
     138 |           |            |              | (F8) SIP   |           |
     139 |           |            |              | NOTIFY     |           |
     140 |           |            |              |<***********|           |
    133141 |           |            |              | (F9) SIP   |           |
    134  |           |            |              | NOTIFY     |           |
    135  |           |            |              |<-----------|           |
    136  |           |            |              | (F10) SIP  |           |
    137142 |           |            |              | 200 OK     |           |
    138  |           |            | (F12) XMPP   |----------->|           |
    139  |           |            | subscribed   |            | (F11) SIP |
    140  |           |            |<-------------|            | 200 OK    |
    141  |           | (F13) XMPP |              |            |---------->|
    142  |           | subscribed | (F15) XMPP   |            |           |
    143  |           |<-----------| presence     |            |           |
    144  | (F14) XMPP|            |<-------------|            |           |
    145  | subscribed| (F16) XMPP |              |            |           |
    146  |<----------| presence   |              |            |           |
    147  |           |<-----------|              |            |           |
    148  | (F17) XMPP|            |              |            |           |
     143 |           |            |              |***********>|           |
     144 |           |            |              |            | (F10) SIP |
     145 |           |    (F11) XMPP subscribed  |            | 200 OK    |
     146 |           |<..........................|            |**********>|
     147 |           |    (F12) XMPP presence    |            |           |
     148 |           |<..........................|            |           |
     149 | (F13) XMPP|            |              |            |           |
     150 | subscribed|            |              |            |           |
     151 |<..........|            |              |            |           |
     152 | (F14) XMPP|            |              |            |           |
    149153 | presence  |            |              |            |           |
    150  |<----------|            |              |            |           |
    151 
    152             ]]></artwork>
    153           </figure>
    154           <t>An XMPP user (e.g., juliet@example.com) initiates a subscription by sending a subscription request to a contact (e.g., romeo@example.net), and the contact either accepts or declines the request.  If the contact accepts the request, the user will have a subscription to the contact's presence information until (1) the user unsubscribes or (2) the contact cancels the subscription.  The subscription request is encapsulated in a presence stanza of type "subscribe":</t>
     154 |<..........|            |              |            |           |
     155 |           |            |              |            |           |
     156            ]]></artwork>
     157          </figure>
     158            <t>An XMPP user (e.g., juliet@example.com) initiates a subscription by sending a subscription request to a contact (e.g., romeo@example.net), and the contact either accepts or declines the request.  If the contact accepts the request, the user will have a subscription to the contact's presence information until (1) the user unsubscribes or (2) the contact cancels the subscription.  The subscription request is encapsulated in a presence stanza of type "subscribe":</t>
    155159          <figure>
    156160            <preamble>Example 1: XMPP user subscribes to SIP contact (F1)</preamble>
     
    181185          <t>Once the SIP-XMPP gateway has passed the SIP SUBSCRIBE off to the SIP server and the SIP server has delivered the SIP SUBSCRIBE to the SIP user (F4 and F5, no examples shown), the SIP user then would send a response indicating acceptance of the subscription request:</t>
    182186          <figure>
    183             <preamble>Example 3: SIP accepts subscription request (F6)</preamble>
     187            <preamble>Example 3: SIP user accepts subscription request (F5)</preamble>
    184188            <artwork><![CDATA[
    185189|  SIP/2.0 200 OK
     
    226230          <t>Upon receiving the first NOTIFY with a subscription state of active, the XMPP-SIP gateway MUST generate a presence stanza of type "subscribed":</t>
    227231          <figure>
    228             <preamble>Example 5: XMPP user receives acknowledgement from SIP contact (F14)</preamble>
     232            <preamble>Example 5: XMPP user receives acknowledgement from SIP contact (F13)</preamble>
    229233            <artwork><![CDATA[
    230234|  <presence from='romeo@example.net'
     
    235239          <t>As described under <xref target="pres"/>, the gateway MUST also generate a presence notification addressed to the XMPP user:</t>
    236240          <figure>
    237             <preamble>Example 6: XMPP user receives presence notification from SIP contact (F17)</preamble>
     241            <preamble>Example 6: XMPP user receives presence notification from SIP contact (F14)</preamble>
    238242            <artwork><![CDATA[
    239243|  <presence from='romeo@example.net/orchard'
     
    254258User      Server      Gateway        Gateway       Server        User
    255259 |           |            |              |            |           |
    256  | (F18) XMPP|            |              |            |           |
     260 | (F15) XMPP|            |              |            |           |
    257261 |unsubscribe|            |              |            |           |
    258  |---------->|            |              |            |           |
    259  |           | (F19) XMPP |              |            |           |
     262 |..........>|            |              |            |           |
     263 |           | (F16) XMPP |              |            |           |
    260264 |           | unsubscribe|              |            |           |
    261  |           |----------->|              |            |           |
    262  |           |            | (F20) SIP    |            |           |
    263  |           |            | SUBSCRIBE    |            |           |
     265 |           |...........>|              |            |           |
     266 |           |            | (F17) SIP SUBSCRIBE       |           |
    264267 |           |            | Expires: 0   |            |           |
    265  |           |            |------------->|            |           |
    266  |           |            |              | (F21) SIP  |           |
    267  |           |            |              | SUBSCRIBE  |           |
    268  |           |            |              | Expires: 0 |           |
    269  |           |            |              |----------->|           |
    270  |           |            |              |            | (F22) SIP |
     268 |           |            |**************************>|           |
     269 |           |            |              |            | (F18) SIP |
    271270 |           |            |              |            | SUBSCRIBE |
    272271 |           |            |              |            | Expires: 0|
    273  |           |            |              |            |---------->|
    274  |           |            |              |            | (F23) SIP |
     272 |           |            |              |            |**********>|
     273 |           |            |              |            | (F19) SIP |
    275274 |           |            |              |            | 200 OK    |
    276  |           |            |              |            |<----------|
    277  |           |            |              | (F24) SIP  |           |
     275 |           |            |              |            |<**********|
     276 |           |            |              | (F20) SIP  |           |
    278277 |           |            |              | 200 OK     |           |
    279  |           |            |              |<-----------|           |
    280  |           |            | (F25) XMPP   |            |           |
    281  |           |            | unsubscribed |            |           |
    282  |           |            |<-------------|            |           |
    283  |           | (F26) XMPP |              |            |           |
    284  |           |unsubscribed|              |            |           |
    285  |           |<-----------|              |            |           |
    286  | (F27) XMPP|            |              |            |           |
     278 |           |            |              |<***********|           |
     279 |           |  (F21) XMPP unsubscribed  |            |           |
     280 |           |<..........................|            |           |
     281 | (F22) XMPP|            |              |            |           |
    287282 | unsub'd   |            |              |            |           |
    288  |<----------|            |              |            |           |
     283 |<..........|            |              |            |           |
    289284 |           |            |              |            |           |
    290 
    291285            ]]></artwork>
    292286          </figure>
    293287          <t>At any time after subscribing, the XMPP user can unsubscribe from the contact's presence.  This is done by sending a presence stanza of type "unsubscribe":</t>
    294288          <figure>
    295             <preamble>Example 7: XMPP user unsubscribes from SIP contact (F18)</preamble>
     289            <preamble>Example 7: XMPP user unsubscribes from SIP contact (F15)</preamble>
    296290            <artwork><![CDATA[
    297291|  <presence from='juliet@example.com'
     
    302296          <t>The XMPP-SIP gateway is responsible for translating the unsubscribe command into a SIP SUBSCRIBE request with the "Expires" header set to a value of zero:</t>
    303297          <figure>
    304             <preamble>Example 8: SIP transformation of XMPP unsubscribe (F20)</preamble>
     298            <preamble>Example 8: SIP transformation of XMPP unsubscribe (F17)</preamble>
    305299            <artwork><![CDATA[
    306300|  SUBSCRIBE sip:romeo@example.net SIP/2.0
     
    319313          <t>Upon sending the transformed unsubscribe, the XMPP-SIP gateway SHOULD send a presence stanza of type "unsubscribed" addressed to the XMPP user:</t>
    320314          <figure>
    321             <preamble>Example 9: XMPP user receives unsubscribed notification (F27)</preamble>
     315            <preamble>Example 9: XMPP user receives unsubscribed notification (F22)</preamble>
    322316            <artwork><![CDATA[
    323317|  <presence from='romeo@example.net'
     
    336330User      Server      Gateway        Gateway       Server        User
    337331 |           |            |              |            |           |
    338  | (F28) SIP |            |              |            |           |
     332 | (F23) SIP |            |              |            |           |
    339333 | SUBSCRIBE |            |              |            |           |
    340  |---------->|            |              |            |           |
    341  |           | (F29) SIP  |              |            |           |
     334 |**********>|            |              |            |           |
     335 |           | (F24) SIP  |              |            |           |
    342336 |           | SUBSCRIBE  |              |            |           |
    343  |           |----------->|              |            |           |
    344  |           |            | (F30) XMPP   |            |           |
    345  |           |            | subscribe    |            |           |
    346  |           |            |------------->|            |           |
    347  |           |            |              | (F31) XMPP |           |
    348  |           |            |              | subscribe  |           |
    349  |           |            |              |----------->|           |
    350  |           |            |              |            | (F32) XMPP|
     337 |           |***********>|              |            |           |
     338 |           |            | (F25) XMPP subscribe      |           |
     339 |           |            |..........................>|           |
     340 |           |            |              |            | (F26) XMPP|
    351341 |           |            |              |            | subscribe |
    352  |           |            |              |            |---------->|
    353  |           |            |              |            | (F33) XMPP|
     342 |           |            |              |            |..........>|
     343 |           |            |              |            | (F27) XMPP|
    354344 |           |            |              |            | subscribed|
    355  |           |            |              |            |<----------|
    356  |           |            |              | (F34) XMPP |           |
     345 |           |            |              |            |<..........|
     346 |           |            |              | (F28) XMPP |           |
    357347 |           |            |              | subscribed |           |
    358  |           |            |              |<-----------|           |
    359  |           |            | (F35) SIP    |            |           |
    360  |           |            | 200 OK       |            |           |
    361  |           |            |<-------------|            |           |
    362  |           | (F36) SIP  |              |            |           |
    363  |           | 200 OK     |              |            |           |
    364  |           |<-----------|              |            |           |
    365  | (F37) SIP |            |              |            |           |
     348 |           |            |              |<...........|           |
     349 |           | (F29) SIP 200 OK          |            |           |
     350 |           |<**************************|            |           |
     351 | (F30) SIP |            |              |            |           |
    366352 | 200 OK    |            |              |            |           |
    367  |<----------|            |              |            |           |
     353 |<**********|            |              |            |           |
    368354 |           |            |              |            |           |
    369355
     
    372358          <t>A SIP user initiates a subscription to a contact's presence information by sending a SIP SUBSCRIBE request to the contact.  The following is an example of such a request:</t>
    373359          <figure>
    374             <preamble>Example 10: SIP user subscribes to XMPP contact (F28)</preamble>
     360            <preamble>Example 10: SIP user subscribes to XMPP contact (F23)</preamble>
    375361            <artwork><![CDATA[
    376362|  SUBSCRIBE sip:juliet@example.com SIP/2.0
     
    390376          <t>The SIP-XMPP gateway is then responsible for translating the SUBSCRIBE into an XMPP subscription request addressed from the SIP user to the XMPP user:</t>
    391377          <figure>
    392             <preamble>Example 11: XMPP transformation of SIP SUBSCRIBE (F30)</preamble>
     378            <preamble>Example 11: XMPP transformation of SIP SUBSCRIBE (F25)</preamble>
    393379            <artwork><![CDATA[
    394380|  <presence from='romeo@example.net'
     
    618604          ]]></artwork>
    619605        </figure>
    620         <t>Upon receiving the NOTIFY, the SIP server needs to determine the identity of the domain portion of the Request-URI or To header, which it does by following the procedures discussed in <xref target='I-D.ietf-stox-core'/>.  If the domain is an XMPP domain, the SIP server will hand off the SUBSCRIBE to an associated SIP-XMPP gateway or connection manager that natively communicates with XMPP servers.</t>
     606        <t>Upon receiving the NOTIFY, the SIP server needs to determine the identity of the domain portion of the Request-URI or To header, which it does by following the procedures discussed in <xref target='I-D.ietf-stox-core'/>.  If the domain is an XMPP domain, the SIP server will hand off the NOTIFY to an associated SIP-XMPP gateway or connection manager that natively communicates with XMPP servers.</t>
    621607        <t>The SIP-XMPP gateway is then responsible for translating the NOTIFY into an XMPP presence stanza addressed from the SIP user to the XMPP user:</t>
    622608        <figure>
     
    751737    <organization />
    752738</author>
    753 <date month='December' day='19' year='2013' />
     739<date month='February' day='11' year='2014' />
    754740<abstract><t>As a foundation for the definition of application-specific, bi-directional protocol mappings between the Session Initiation Protocol (SIP) and the Extensible Messaging and Presence Protocol (XMPP), this document specifies the architectural assumptions underlying such mappings as well as the mapping of addresses and error conditions.</t></abstract>
    755741</front>
    756 <seriesInfo name='Internet-Draft' value='draft-ietf-stox-core-09' />
     742<seriesInfo name='Internet-Draft' value='draft-ietf-stox-core-11' />
    757743<format type='TXT'
    758         target='http://www.ietf.org/internet-drafts/draft-ietf-stox-core-09.txt' />
     744        target='http://www.ietf.org/internet-drafts/draft-ietf-stox-core-11.txt' />
    759745</reference>
    760746
Note: See TracChangeset for help on using the changeset viewer.