[Docs] [txt|pdf] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]

Versions: (draft-kyzivat-sipping-gruu-reg-event) 00 01 02 03 04 05 06 07 08 09 RFC 5628

Sipping                                                       P. Kyzivat
Internet-Draft                                       Cisco Systems, Inc.
Expires: October 21, 2006                                 April 19, 2006


  Registration Event Package Extension for Session Initiation Protocol
           (SIP) Globablly Routeable User Agent URIs (GRUUs)
                  draft-ietf-sipping-gruu-reg-event-04

Status of this Memo

   By submitting this Internet-Draft, each author represents that any
   applicable patent or other IPR claims of which he or she is aware
   have been or will be disclosed, and any of which he or she becomes
   aware will be disclosed, in accordance with Section 6 of BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt.

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html.

   This Internet-Draft will expire on October 21, 2006.

Copyright Notice

   Copyright (C) The Internet Society (2006).

Abstract

   This draft defines an extension to RFC 3680 [2] for representing the
   GRUU associated with a Contact.









Kyzivat                 Expires October 21, 2006                [Page 1]

Internet-Draft          Reg Event GRUU Extension              April 2006


Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
   2.  Terminology  . . . . . . . . . . . . . . . . . . . . . . . . .  3
   3.  Description  . . . . . . . . . . . . . . . . . . . . . . . . .  3
   4.  Notifier Processing of SUBSCRIBE Requests  . . . . . . . . . .  4
   5.  Notifier Generation of NOTIFY Requests . . . . . . . . . . . .  4
   6.  Subscriber Processing of NOTIFY Requests . . . . . . . . . . .  4
   7.  Sample reginfo Document  . . . . . . . . . . . . . . . . . . .  4
   8.  Examples . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
     8.1.  Example: Welcome Notice  . . . . . . . . . . . . . . . . .  5
     8.2.  Example: Implicit Registration . . . . . . . . . . . . . .  6
   9.  XML Schema Definition  . . . . . . . . . . . . . . . . . . . .  8
   10. IANA Considerations  . . . . . . . . . . . . . . . . . . . . .  9
     10.1. URN Sub-Namespace Registration . . . . . . . . . . . . . .  9
     10.2. XML Schema Registration  . . . . . . . . . . . . . . . . . 10
   11. Security Considerations  . . . . . . . . . . . . . . . . . . . 10
   12. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 10
   13. References . . . . . . . . . . . . . . . . . . . . . . . . . . 10
     13.1. Normative References . . . . . . . . . . . . . . . . . . . 10
     13.2. Informative References . . . . . . . . . . . . . . . . . . 10
   Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 12
   Intellectual Property and Copyright Statements . . . . . . . . . . 13




























Kyzivat                 Expires October 21, 2006                [Page 2]

Internet-Draft          Reg Event GRUU Extension              April 2006


1.  Introduction

   The addition of GRUU (Globally Routable Unique URI) support to the
   REGISTER message, defined in [3], introduces another element of state
   to the registrar.  Subscribers to the registration event package [2]
   will sometimes have need for the new state.

   For example, the Welcome Notices example in [2] will only operate
   correctly if the contact address in the reg event notification is
   reachable by the sender of the welcome notice.  When the registering
   device is using the GRUU extension, it is likely that the registered
   contact address will not be globally addressable, and the GRUU should
   be used as the target address for the MESSAGE.

   Another case where this feature may be helpful is within the 3GPP IP
   Multimedia Subsystem (IMS).  IMS employs a technique where a REGISTER
   of a contact address to one Address of Record (AOR) causes the
   implicit registration of the same contact to other associated AORs.
   If a GRUU is requested and obtained as part of the registration
   request, then additional GRUUs will also be needed for the implicit
   registrations.  While assigning the additional GRUUs is
   straightforward, informing the registering UA of them is not.  In
   IMS, UAs typically subscribe to the 'reg' event, and subscriptions to
   the 'reg' event for an AOR result in notifications containing
   registration state for all the associated AORs.  The proposed
   extension provides a way to easily deliver the GRUUs for the
   associated AORs.

   The reg event package has provision for including extension elements
   within the <contact> element.  This document defines a new element
   that may be used in that context to deliver the GRUU corresponding to
   the contact.


2.  Terminology

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in RFC 2119. [1]


3.  Description

   A new element (<gruu>) is defined which contains a GRUU.

   This optional element is included within the body of a NOTIFY for the
   "reg" event package when a GRUU is associated with the contact.  The
   contact URI and the GRUU are then both available to the watcher.



Kyzivat                 Expires October 21, 2006                [Page 3]

Internet-Draft          Reg Event GRUU Extension              April 2006


4.  Notifier Processing of SUBSCRIBE Requests

   Unchanged from RFC 3680 [2].


5.  Notifier Generation of NOTIFY Requests

   A notifier for the "reg" event package [2] SHOULD include the <gruu>
   element when a contact has an Instance ID and a GRUU is associated
   with the combination of the AOR and the Instance ID.  When present,
   the <gruu> element MUST be be positioned as an instance of the <any>
   element within the <contact> element.


6.  Subscriber Processing of NOTIFY Requests

   When a subscriber receives a "reg" event notification [2] with a
   <contact> containing a <gruu>, it SHOULD use the GRUU in preference
   to the corresponding <uri> when sending SIP requests to the contact.

   Subscribers that are unaware of this extension will, as required by
   [2], ignore the <gruu> element.


7.  Sample reginfo Document

      Note: This example and others in the following section are
      indented for readability by the addition of a fixed amount of
      whitespace to the beginning of each line.  This whitespace is not
      part of the example.  The conventions of [8] are used to describe
      representation of long message lines.

   The following is an example registration information document
   including the new element:

















Kyzivat                 Expires October 21, 2006                [Page 4]

Internet-Draft          Reg Event GRUU Extension              April 2006


      <?xml version="1.0"?>
          <reginfo xmlns="urn:ietf:params:xml:ns:reginfo"
              xmlns:gr="urn:ietf:params:xml:ns:gruuinfo"
              version="0" state="full">
            <registration aor="sip:user@example.com" id="as9"
                 state="active">
              <contact id="76" state="active" event="registered"
                 duration-registered="7322"
                 q="0.8">
                   <uri>sip:user@192.0.2.1</uri>
      <allOneLine>
                   <unknown-param name="+sip.instance">
      "&lt;urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6&gt;"
      </unknown-param>
      </allOneLine>
      <allOneLine>
                   <gr:gruu>sip:user@example.com
      ;opaque=hha9s8d-999a</gr:gruu>
      </allOneLine>
              </contact>
            </registration>
          </reginfo>


8.  Examples

   Note: In the following examples the SIP messages have been
   simplified, removing headers that are not pertinent to the example.

8.1.  Example: Welcome Notice

   Consider the Welcome Notices example in [2].  When the application
   server receives a notification of a new registration containing the
   reginfo shown in Section 7 it should address messages using the
   contained GRUU as follows:

      MESSAGE sip:user@example.com;opaque=hha9s8d-999a SIP/2.0
      To: <sip:user@example.com>
      From: "SIPland Notifier" <sip:notifier@example.com>
      Content-Type: text/plain
      Content-Length: ...

      Welcome to SIPland!
      Blah, blah, blah.







Kyzivat                 Expires October 21, 2006                [Page 5]

Internet-Draft          Reg Event GRUU Extension              April 2006


8.2.  Example: Implicit Registration

   In an 3GPP IMS setting, a UA may send a single register message,
   requesting assignment of a GRUU, as follows:

      REGISTER sip:example.net SIP/2.0
      From: <sip:user_aor_1@example.net>;tag=5ab4
      To: <sip:user_aor_1@example.net>
      Contact: <sip:ua.example.com>
        ;expires=3600
        ;+sip.instance="<urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6>"
      Supported: path, gruu
      Content-Length: 0

   The response reports success of the registration and returns the GRUU
   assigned for the combination of AOR, Instance ID, and Contact.  It
   also indicates (via the P-Associated-URI header [6]) that there are
   two other associated AORs that may have been implicitly registered
   using the same contact.  But each of those implicitly registered AORs
   will have had a unique GRUU assigned, and there is no way defined to
   report that assignment in the response.

      SIP/2.0 200 OK
      From: <sip:user_aor_1@example.net>;tag=5ab4
      To: <sip:user_aor_1@example.net>;tag=373392
      Path: <sip:proxy.example.net;lr>
      Service-Route: <sip:proxy.example.net;lr>
      Contact: <sip:ua.example.com>
        ;expires=3600
        ;+sip.instance="<urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6>"
        ;gruu="sip:user_aor_1@example.net;opaque=hha9s8d-999a"
      P-Associated-URI: <sip:user_aor_2@example.net>,
        <sip:+358504821437@example.net;user=phone>
      Content-Length: 0

   The UA then subscribes to the 'reg' event package as follows:

      SUBSCRIBE sip:user_aor_1@example.net SIP/2.0
      From: <sip:user_aor_1@example.net>;tag=27182
      To: <sip:user_aor_1@example.net>
      Route: <sip:proxy.example.net;lr>
      Event: reg
      Expires: 3600
      Accept: application/reginfo+xml
      Contact: <sip:user_aor_1@example.net;opaque=hha9s8d-999a>
      Content-Length: 0

   (The successful response to the subscription is not shown.)  Once the



Kyzivat                 Expires October 21, 2006                [Page 6]

Internet-Draft          Reg Event GRUU Extension              April 2006


   subscription is established an initial notification is sent giving
   registration status.  In IMS deployments the response includes, in
   addition to the status for the requested URI, the status for the
   other associated URIs.

      NOTIFY sip:user_aor_1@example.net;opaque=hha9s8d-999a SIP/2.0
      From: <sip:user_aor_1@example.net>;tag=27182
      To: <sip:user_aor_1@example.net>;tag=262281
      Subscription-State: active;expires=3600
      Event: reg
      Content-Type: application/reginfo+xml
      Contact: <sip:registrar.example.net>
      Content-Length: (...)

      <?xml version="1.0"?>
          <reginfo xmlns="urn:ietf:params:xml:ns:reginfo"
              xmlns:gr="urn:ietf:params:xml:ns:gruuinfo"
              version="1" state="full">
            <registration aor="sip:user_aor_1@example.net" id="a7"
                 state="active">
              <contact id="92" state="active" event="registered"
                 duration-registered="1" expires="3599">
                   <uri>
                      sip:ua.example.com
                   </uri>
      <allOneLine>
                   <unknown-param name="+sip.instance">
      "&lt;urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6&gt;"
      </unknown-param>
      </allOneLine>
      <allOneLine>
                   <gr:gruu>sip:user_aor_1@example.net
      ;opaque=hha9s8d-999a</gr:gruu>
      </allOneLine>
              </contact>
            </registration>
            <registration aor="sip:user_aor_2@example.net" id="a8"
                 state="active">
              <contact id="93" state="active" event="created"
                 duration-registered="1" expires="3599">
                   <uri>
                      sip:ua.example.com
                   </uri>
      <allOneLine>
                   <unknown-param name="+sip.instance">
      "&lt;urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6&gt;"
      </unknown-param>
      </allOneLine>



Kyzivat                 Expires October 21, 2006                [Page 7]

Internet-Draft          Reg Event GRUU Extension              April 2006


      <allOneLine>
                   <gr:gruu>sip:user_aor_2@example.net
      ;opaque=hha9s8d-999b</gr:gruu>
      </allOneLine>
              </contact>
            </registration>
            <registration
                 aor="sip:+358504821437@example.net;user=phone"
                 id="a9"
                 state="active">
              <contact id="94" state="active" event="created"
                 duration-registered="1" expires="3599">
                   <uri>
                      sip:ua.example.com
                   </uri>
      <allOneLine>
                   <unknown-param name="+sip.instance">
      "&lt;urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6&gt;"
      </unknown-param>
      </allOneLine>
      <allOneLine>
                   <gr:gruu>sip:+358504821437@example.net;user=phone
      ;opaque=hha9s8d-999c</gr:gruu>
      </allOneLine>
              </contact>
            </registration>
          </reginfo>

   The status indicates that the associated URIs all have the same
   contact registered.  It also includes the unique GRUU that has been
   assigned to each.  The UA may then retain those GRUUs for use when
   establishing dialogs using the corresponding AORs.


9.  XML Schema Definition

   A GRUU document is an XML document that MUST be well-formed and
   SHOULD be valid.  GRUU documents MUST be based on XML 1.0 and MUST be
   encoded using UTF-8.  This specification makes use of XML namespaces
   for identifying GRUU documents.  The namespace URI for elements
   defined for this purpose is a URN, using the namespace identifier
   'ietf'.  This URN is:
      urn:ietf:params:xml:ns:gruuinfo








Kyzivat                 Expires October 21, 2006                [Page 8]

Internet-Draft          Reg Event GRUU Extension              April 2006


   BEGIN
   <?xml version="1.0" encoding="UTF-8"?>
   <xs:schema targetNamespace="urn:ietf:params:xml:ns:gruuinfo"
     elementFormDefault="qualified"
     attributeFormDefault="unqualified"
     xmlns:xs="http://www.w3.org/2001/XMLSchema"
     xmlns:tns="urn:ietf:params:xml:ns:gruuinfo">
     <xs:element name="gruu" type="xs:anyURI"/>
   </xs:schema>
   END


10.  IANA Considerations

   There are two IANA considerations associated with this specification.

10.1.  URN Sub-Namespace Registration

   This section registers a new XML namespace, per the guidelines in
   [4].

   URI: The URI for this namespace is urn:ietf:params:xml:ns:gruuinfo

   Registrant Contact: IETF, SIPPING working group, <sipping@ietf.org>,
   Paul Kyzivat <pkyzivat@cisco.com>

   XML:


         BEGIN
         <?xml version="1.0"?>
         <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.0//EN"
                   "http://www.w3.org/TR/xhtml-basic/xhtml-basic10.dtd">
         <html xmlns="http://www.w3.org/1999/xhtml">
         <head>
           <meta http-equiv="content-type"
              content="text/html;charset=iso-8859-1"/>
           <title>Reg Information GRUU Extension Namespace</title>
         </head>
         <body>
            <h1>Namespace for Reg Information GRUU Extension</h1>
            <h2>urn:ietf:params:xml:ns:gruuinfo</h2>
            <p>See <a href="[URL of published RFC]">RFCXXXX [[NOTE
      TO RFC-EDITOR/IANA: Please replace XXXX with the RFC Number of
      this specification]]</a>.</p>
          </body>
         </html>
         END



Kyzivat                 Expires October 21, 2006                [Page 9]

Internet-Draft          Reg Event GRUU Extension              April 2006


10.2.  XML Schema Registration

   This section registers an XML schema per the procedures in [4].

   URI: urn:ietf:params:xml:schema:gruuinfo.

   Registrant Contact: IETF, SIPPING working group, <sipping@ietf.org>,
   Paul Kyzivat <pkyzivat@cisco.com>

   The XML for this schema can be found in Section 9.


11.  Security Considerations

   Security considerations for the registration event package is
   discussed in RFC 3680 [2], and those considerations apply here.

   The addition of GRUU information does not impact security negatively
   because the GRUU is less sensitive than the contact URI itself.


12.  Acknowledgements

   The author would like to thank Jonathan Rosenberg for encouraging
   this draft.


13.  References

13.1.  Normative References

   [1]  Bradner, S., "Key words for use in RFCs to Indicate Requirement
        Levels", BCP 14, RFC 2119, March 1997.

   [2]  Rosenberg, J., "A Session Initiation Protocol (SIP) Event
        Package for Registrations", RFC 3680, March 2004.

   [3]  Rosenberg, J., "Obtaining and Using Globally Routable User Agent
        (UA) URIs (GRUU) in the  Session Initiation Protocol (SIP)",
        draft-ietf-sip-gruu-06 (work in progress), October 2005.

   [4]  Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
        January 2004.

13.2.  Informative References

   [5]  Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, A.,
        Peterson, J., Sparks, R., Handley, M., and E. Schooler, "SIP:



Kyzivat                 Expires October 21, 2006               [Page 10]

Internet-Draft          Reg Event GRUU Extension              April 2006


        Session Initiation Protocol", RFC 3261, June 2002.

   [6]  Garcia-Martin, M., Henrikson, E., and D. Mills, "Private Header
        (P-Header) Extensions to the Session Initiation Protocol (SIP)
        for the 3rd-Generation Partnership Project (3GPP)", RFC 3455,
        January 2003.

   [7]  Rosenberg, J., Schulzrinne, H., and P. Kyzivat, "Indicating User
        Agent Capabilities in the Session Initiation Protocol (SIP)",
        RFC 3840, August 2004.

   [8]  Sparks, R., "Session Initiation Protocol Torture Test Messages",
        draft-ietf-sipping-torture-tests-09 (work in progress),
        November 2005.





































Kyzivat                 Expires October 21, 2006               [Page 11]

Internet-Draft          Reg Event GRUU Extension              April 2006


Author's Address

   Paul H. Kyzivat
   Cisco Systems, Inc.
   1414 Massachusetts Avenue
   Boxborough, MA  01719
   USA

   Email: pkyzivat@cisco.com










































Kyzivat                 Expires October 21, 2006               [Page 12]

Internet-Draft          Reg Event GRUU Extension              April 2006


Intellectual Property Statement

   The IETF takes no position regarding the validity or scope of any
   Intellectual Property Rights or other rights that might be claimed to
   pertain to the implementation or use of the technology described in
   this document or the extent to which any license under such rights
   might or might not be available; nor does it represent that it has
   made any independent effort to identify any such rights.  Information
   on the procedures with respect to rights in RFC documents can be
   found in BCP 78 and BCP 79.

   Copies of IPR disclosures made to the IETF Secretariat and any
   assurances of licenses to be made available, or the result of an
   attempt made to obtain a general license or permission for the use of
   such proprietary rights by implementers or users of this
   specification can be obtained from the IETF on-line IPR repository at
   http://www.ietf.org/ipr.

   The IETF invites any interested party to bring to its attention any
   copyrights, patents or patent applications, or other proprietary
   rights that may cover technology that may be required to implement
   this standard.  Please address the information to the IETF at
   ietf-ipr@ietf.org.


Disclaimer of Validity

   This document and the information contained herein are provided on an
   "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
   OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
   ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
   INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
   INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
   WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.


Copyright Statement

   Copyright (C) The Internet Society (2006).  This document is subject
   to the rights, licenses and restrictions contained in BCP 78, and
   except as set forth therein, the authors retain all their rights.


Acknowledgment

   Funding for the RFC Editor function is currently provided by the
   Internet Society.




Kyzivat                 Expires October 21, 2006               [Page 13]


Html markup produced by rfcmarkup 1.108, available from http://tools.ietf.org/tools/rfcmarkup/