path: root/doc/rfc/rfc4354.txt

Network Working Group                                   M. Garcia-Martin
Request for Comments: 4354                                         Nokia
Category: Informational                                     January 2006


   A Session Initiation Protocol (SIP) Event Package and Data Format
                    for Various Settings in Support
            for the Push-to-Talk over Cellular (PoC) Service

Status of This Memo

   This memo provides information for the Internet community.  It does
   not specify an Internet standard of any kind.  Distribution of this
   memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (2006).

Abstract

   The Open Mobile Alliance (OMA) is defining the Push-to-talk over
   Cellular (PoC) service where SIP is the protocol used to establish
   half-duplex media sessions across different participants, to send
   instant messages, etc.  This document defines a SIP event package to
   support publication, subscription, and notification of additional
   capabilities required by the PoC service.  This SIP event package is
   applicable to the PoC service and may not be applicable to the
   general Internet.






















Garcia-Martin                Informational                      [Page 1]
^L
RFC 4354               PoC Settings Event Package           January 2006


Table of Contents

   1. Introduction ....................................................3
   2. Terminology .....................................................5
   3. Applicability Statement .........................................5
   4. Requirements ....................................................5
   5. The "poc-settings" Event Package ................................6
      5.1. Package Name ...............................................6
      5.2. Event Package Parameters ...................................7
      5.3. SUBSCRIBE Bodies ...........................................7
      5.4. Subscription Duration ......................................7
      5.5. NOTIFY Bodies ..............................................7
      5.6. Notifier Processing of SUBSCRIBE Requests ..................8
           5.6.1. Authentication ......................................8
           5.6.2. Authorization .......................................8
      5.7. Notifier Generation of NOTIFY Requests .....................8
      5.8. Subscriber Processing of NOTIFY Requests ...................9
      5.9. Handling of Forked Requests ...............................10
      5.10. Rate of Notifications ....................................10
      5.11. State Agents .............................................10
      5.12. Examples .................................................10
      5.13. Use of URIs to Retrieve State ............................10
      5.14. PUBLISH Bodies ...........................................11
      5.15. PUBLISH Response Bodies ..................................11
      5.16. Multiple Sources for Event State .........................11
      5.17. Event State Segmentation .................................11
      5.18. Rate of Publication ......................................12
   6. PoC-Settings Document ..........................................12
      6.1. XML Schema ................................................14
      6.2. Example ...................................................16
   7. Security Considerations ........................................17
   8. Acknowledgements ...............................................17
   9. IANA Considerations ............................................17
      9.1. Registration of the "poc-settings" Event Package ..........17
      9.2. Registration of the "application/poc-settings+xml"
           MIME type .................................................18
   10. References ....................................................19
      10.1. Normative References .....................................19
      10.2. Informative References ...................................20












Garcia-Martin                Informational                      [Page 2]
^L
RFC 4354               PoC Settings Event Package           January 2006


1.  Introduction

   The Open Mobile Alliance (OMA) (http://www.openmobilealliance.org) is
   currently specifying the Push-to-talk over Cellular (PoC) service.
   This service allows a SIP User Agent (PoC terminal) to establish a
   session to one or more SIP User Agents (UAs) simultaneously, usually
   initiated when the initiating user pushes a button.

   OMA has defined a collection of very stringent requirements in
   support of the PoC service.  In order to provide the user with a
   satisfactory experience, the initial session establishment (from the
   time the user presses the button to the time they get an indication
   to speak) must be minimized.

   The PoC terminal may support hardware capabilities such as a
   speakerphone and/or headset and software that provide the capability
   for the user to configure the PoC terminal to accept session
   initiations immediately and play out the media as soon as it is
   received without requiring the intervention of the called user.  This
   mode of operation is known as Auto-Answer mode or automatic mode.
   The user may alternatively configure the PoC terminal to first alert
   the user and require the user to accept the session invitation
   manually before media is accepted.  This mode of operation is known
   as Manual-Answer mode.  The PoC terminal may support both or only one
   of these modes of operation.  The user may change the Answer Mode
   (AM) configuration of the PoC terminal frequently based on their
   current circumstances and preference (perhaps because the user is
   busy or in a public area where she cannot use a speaker phone, etc.).

   SIP PoC terminals can support various SIP-based communication
   services in addition to Push-to-talk (e.g., VoIP telephony, presence
   services, messaging services, etc.).  The user may at times wish to
   disable the acceptance of Push-to-talk sessions whilst still
   remaining SIP registered for one or more other SIP-based services.
   When the PoC terminal is configured to not accept any incoming Push-
   to-talk sessions, this is known as Incoming Session Barring (ISB).

   A user may wish to contact another user who has a PoC terminal with
   Incoming Session Barring enabled.  A user may send an Instant
   Personal Alert to another user to inform him that he wishes to engage
   him in a PoC Session.  This Instant Personal Alert is received even
   when the destination PoC terminal has enabled Incoming Session
   Barring.  If a user wishes to disable the acceptance of Instant
   Personal Alerts, he can configure his PoC terminal not accept any
   incoming Instant Personal Alerts.  This is known as Instant Personal
   Alert Barring (IPAB).





Garcia-Martin                Informational                      [Page 3]
^L
RFC 4354               PoC Settings Event Package           January 2006


   Some PoC terminals may provide support for handling multiple PoC
   sessions simultaneously whereas other terminals are only able to
   handle one PoC session at time.  Or, even if the terminal is able to
   handle multiple PoC sessions simultaneously, the user may desire to
   have just one single PoC session at a time.  This indication of
   support for multiple PoC sessions simultaneously is known as
   Simultaneous PoC Sessions Support (SSS).

   The OMA PoC Architecture utilizes SIP servers within the network that
   may perform roles such as a conference focus [12], an RTP translator,
   or a policy server.  A possible optimization to minimize the delay in
   providing the caller with an indication to speak consist of the SIP
   network server to perform buffering of media packets in order to
   provide an early or unconfirmed indication to the caller and allow
   the caller to start speaking before the called PoC terminal has
   answered.  This optimization only is appropriate when the called PoC
   terminal is currently accepting PoC sessions and its Answer Mode is
   set to Auto-Answer.  This optimization therefore requires the network
   SIP server to have knowledge of the current ISB and AM settings of
   the called PoC terminal.

   Similarly, in order to avoid unnecessary transmission of Instant
   Personal Alerts across the radio interface, the network SIP server
   needs to have knowledge of the current IPAB setting at the terminal.

   When the UA supports multiple PoC sessions simultaneously the server
   needs to act as a B2BUA in order to multiplex media and floor control
   signaling between multiple sessions using a single bandwidth limited
   radio bearer.  When handling of multiple PoC sessions simultaneously
   is not needed the server can act as a SIP proxy.  It is therefore
   advantageous for the server to be informed whether the UA currently
   intends to support multiple PoC sessions simultaneously.

   This document proposes additional SIP capabilities to enable the
   communication of the ISB, AM, IPAB, and SSS settings between the SIP
   PoC terminal and the SIP network server.

   We define a SIP event package that allows a SIP Event Publication
   Agent (EPA) to publish the user's settings at that particular EPA
   which may impact some specific session attempts.  This allows
   subscribers to subscribe to the Event State Compositor to this event
   package to gather this information, and anticipate to the user's
   needs when a session is attempted to that user.  It is believed that
   the SIP event package defined here is not applicable to the general
   Internet: it has been designed to serve the architecture of the PoC
   service.  In particular, and in the context defined by RFC 3903 [8],
   it is the intention of OMA to make PoC terminals behave as Event
   Publication Agents (EPA), and network servers behave as Event State



Garcia-Martin                Informational                      [Page 4]
^L
RFC 4354               PoC Settings Event Package           January 2006


   Compositors (ESC).  It is possible that PoC terminals and network
   servers may also subscribe to the user's PoC related settings, so
   that changes in this state made in one terminal are kept in
   synchronization across all different terminals or with the network
   server for a particular user.

   This document defines a PoC-settings document that allows an EPA to
   convey its ISB, AM, IPAB, and SSS settings to an ESC.  The EPA sends
   a PoC-settings document in PUBLISH requests [8].  The PoC-settings
   document contain represents the settings view at that particular EPA.
   The ESC can collect PoC-settings document for the same user at
   different EPAs, apply a composition policy, and provide
   notifications.  Notifications can contain a composed view of the
   settings or a list of settings per EPA, depending on whether the ESC
   is able to resolve conflicts.  A subscriber can receive notifications
   of changes in this document according to the procedures specified in
   RFC 3265 [5].  The aim of this memo is to follow the procedure
   indicated in RFC 3427 [6] and to register a new poc-settings event
   package with IANA.

2.  Terminology

   In this document, the key words "MUST", "MUST NOT", "REQUIRED",
   "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT
   RECOMMENDED", "MAY", and "OPTIONAL" are to be interpreted as
   described in BCP 14, RFC 2119 [1] and indicate requirement levels for
   compliant implementations.

3.  Applicability Statement

   The event package defined in this document is intended for use with
   network-based application servers that provide a Push-to-Talk over
   Cellular service.

4.  Requirements

   A comprehensive description of all the requirements that affect the
   Push-to-Talk over Cellular service developed by the Open Mobile
   Alliance can be found in the Open Mobile Alliance web page at
   http://www.openmobilealliance.org.

   For the sake of simplicity, we briefly discuss here those
   requirements that affect the solution described in this document.
   These requirements can be summarized as follows:







Garcia-Martin                Informational                      [Page 5]
^L
RFC 4354               PoC Settings Event Package           January 2006


   1.  There must be a mechanism that reduces the session setup time as
       much as possible.
   2.  In order to allow proper usage of scarce resources, there must be
       a mechanism that saves the air interface from being congested
       with unneeded or undesired traffic.
   3.  The mechanism should not involve the implementation of new
       protocols, unless strictly needed.

   These requirements lead to a solution whereby the user can indicate
   to a network node his ability to accept or reject sessions or certain
   types of messages.  Pushing these settings to a network node allows
   the network node to produce a faster response to the originator,
   perhaps even declining or filtering some SIP requests towards the
   destination.  This approaches the goal of reducing the session setup
   time.

5.  The "poc-settings" Event Package

   RFC 3265 [5] defines a SIP extension for subscribing to remote nodes
   and receiving notifications of changes (events) in their states.  It
   leaves the definition of many aspects of these events to concrete
   extensions, known as event packages.  This document qualifies as an
   event package.  This section fills in the information required for
   all event packages by RFC 3265 [5].

   Additionally, RFC 3903 [8] defines an extension that allows SIP User
   Agents to publish event state.  According to RFC 3903 [8], any event
   package intended to be used in conjunction with the SIP PUBLISH
   method has to include a considerations section.  This section also
   fills the information for all event packages to be used with PUBLISH
   requests.

   We define a new "poc-settings" event package.  Event Publication
   Agents (EPA) use PUBLISH requests to inform an Event State Compositor
   (ESC) of changes in the poc-settings event package.  Acting as a
   notifier, the ESC notifies subscribers to the user's poc-settings
   information when changes occur.

5.1.  Package Name

   The name of this package is "poc-settings".  As specified in RFC 3265
   [5], this value appears in the Event header field present in
   SUBSCRIBE and NOTIFY requests.  As specified in RFC 3903 [8], this
   value also appears in the Event header field present in PUBLISH
   requests.






Garcia-Martin                Informational                      [Page 6]
^L
RFC 4354               PoC Settings Event Package           January 2006


5.2.  Event Package Parameters

   RFC 3265 [5] allows event packages to define additional parameters
   carried in the Event header field.  This event package,
   "poc-settings", does not define additional parameters.

5.3.  SUBSCRIBE Bodies

   According to RFC 3265 [5], a SUBSCRIBE request can contain a body.
   The purpose of the body depends on its type.  Subscriptions to the
   poc-settings event package will normally not contain bodies.

   The Request-URI of the SUBSCRIBE request identifies the user about
   whose poc-settings the subscriber wants to be informed.

5.4.  Subscription Duration

   The default expiration time for subscriptions within this package is
   3600 seconds.  As per RFC 3265 [5], the subscriber MAY specify an
   alternate expiration in the Expires header field.

5.5.  NOTIFY Bodies

   As described in RFC 3265 [5], the NOTIFY message will contain bodies
   describing the state of the subscribed resource.  This body is in a
   format listed in the Accept header field of the SUBSCRIBE request, or
   a package-specific default format if the Accept header field was
   omitted from the SUBSCRIBE request.

   In this event package, the body of the notification contains a PoC-
   settings document (see Section 6).  The ESC has gathered PoC-
   settings documents for the user at different EPAs.  The ESC applies a
   composition policy and composes a PoC-settings document with a common
   view of all these settings across different EPAs.  In case the ESC is
   not able to resolve a conflict, due to contradictory information
   provided by two different EPAs, the ESC provides a PoC-settings
   document containing the settings at each terminal so that the
   subscriber can resolve the conflict.

   All subscribers and notifiers of the "poc-settings" event package
   MUST support the "application/poc-settings+xml" data format described
   in Section 6.  The SUBSCRIBE request MAY contain an Accept header
   field.  If no such header field is present, it has a default value of
   "application/poc-settings+xml" (assuming that the Event header field
   contains a value of "poc-settings").  If the Accept header field is
   present, it MUST include "application/poc-settings+xml" and MAY
   include any other types capable of representing user settings for
   PoC.



Garcia-Martin                Informational                      [Page 7]
^L
RFC 4354               PoC Settings Event Package           January 2006


5.6.  Notifier Processing of SUBSCRIBE Requests

   The contents of a PoC-settings document can contain sensitive
   information that can reveal some privacy information.  Therefore,
   PoC-settings documents MUST only be sent to authorized subscribers.
   In order to determine if a subscription originates in an authorized
   user, the user MUST be authenticated as described in Section 5.6.1
   and then he MUST be authorized to be a subscriber as described in
   Section 5.6.2.

5.6.1.  Authentication

   Notifiers MUST authenticate all subscription requests.  This
   authentication can be done using any of the mechanisms defined in RFC
   3261 [4] and other authentication extensions.

5.6.2.  Authorization

   Once authenticated, the notifier makes an authorization decision.  A
   notifier MUST NOT accept a subscription unless authorization has been
   provided by the user.  The means by which authorization are provided
   are outside the scope of this document.  Authorization may have been
   provided ahead of time through access lists, perhaps specified in a
   web page.  Authorization may have been provided by means of uploading
   some kind of standardized access control list document.

5.7.  Notifier Generation of NOTIFY Requests

   RFC 3265 [5] details the formatting and structure of NOTIFY messages.
   However, packages are mandated to provide detailed information on
   when to send a NOTIFY, how to compute the state of the resource, how
   to generate neutral or fake state information, and whether state
   information is complete or partial.  This section describes those
   details for the poc-settings event package.

   A notifier MAY send a NOTIFY at any time.  Typically, it will send
   one when the poc-settings stage of a user changes.  The NOTIFY
   request MAY contain a body containing a PoC-settings document.  The
   times at which the NOTIFY is sent for a particular subscriber, and
   the contents of the body within that notification, are subject to any
   rules specified by the authorization policy that governs the
   subscription.  However, typically the NOTIFY will contain an
   indication of those PoC-related services for which a change has
   occurred.

   In the case of a pending subscription, when final authorization is
   determined, a NOTIFY can be sent.  If the result of the authorization
   decision was success, a NOTIFY SHOULD be sent and SHOULD contain a



Garcia-Martin                Informational                      [Page 8]
^L
RFC 4354               PoC Settings Event Package           January 2006


   complete PoC-settings document with the current state of the user's
   PoC settings.  If the subscription is rejected, a NOTIFY MAY be sent.
   As described in RFC 3265 [5], the Subscription-State header field
   indicates the state of the subscription.

   The body of the NOTIFY MUST be sent using one of the types listed in
   the Accept header field in the most recent SUBSCRIBE request, or
   using the type "application/poc-settings+xml" if no Accept header
   field was present.

   Notifiers will typically act as Event State Compositors (ESC) and
   thus will learn the poc-settings event state via PUBLISH requests
   sent from the user's Event Publication Agent (EPA) when the user
   changes one of those settings.  It is possible that the notifier
   generates a NOTIFY request for a user for which no publication has
   taken place.  In that case, the PoC-settings document will not
   contain any <entity> element (see Section 6.1 for a detailed
   description of the <entity> element).

   For reasons of privacy, it will frequently be necessary to encrypt
   the contents of the notifications.  This can be accomplished using
   S/MIME [9].  The encryption can be performed using the key of the
   subscriber as identified in the From field of the SUBSCRIBE request.
   Similarly, integrity of the notifications is important to
   subscribers.  As such, the contents of the notifications MAY provide
   authentication and message integrity using S/MIME [9].  Since the
   NOTIFY is generated by the notifier, which may not have access to the
   key of the user represented by the poc-settings user, often the
   NOTIFY will be signed by a third party.  The NOTIFY request SHOULD be
   signed by an authority over the domain of the user.  In other words,
   for a user whose SIP URI is sip:user@example.com, the signator of the
   NOTIFY SHOULD be the authority for example.com.

5.8.  Subscriber Processing of NOTIFY Requests

   RFC 3265 [5] leaves it to event packages to describe the process
   followed by the subscriber upon receipt of a NOTIFY request,
   including any logic required to form a coherent resource state.

   In this specification, each NOTIFY request contains either no PoC-
   settings document, or a document representing one or more PoC related
   settings for a given user.  Within a dialog, the PoC-settings
   document in the NOTIFY request with the highest CSeq header field
   value is the current one.  When no document is present in that
   NOTIFY, the PoC-settings document present in the NOTIFY with the next
   highest CSeq value is used.





Garcia-Martin                Informational                      [Page 9]
^L
RFC 4354               PoC Settings Event Package           January 2006


5.9.  Handling of Forked Requests

   RFC 3265 [5] requires each package to describe handling of forked
   SUBSCRIBE requests.

   This specification only allows a single dialog to be constructed as a
   result of emitting an initial SUBSCRIBE request.  This guarantees
   that only a single subscriber is generating notifications for a
   particular subscription to a particular user.  The result of this is
   that a user can have multiple SIP User Agents active, but these
   should be homogeneous, so that each can generate the same set of
   notifications for the user's poc-settings.

5.10.  Rate of Notifications

   RFC 3265 [5] requires each package to specify the maximum rate at
   which notifications can be sent.

   Poc-settings notifiers SHOULD NOT generate notifications for a single
   user at a rate of more than once every five seconds.

5.11.  State Agents

   RFC 3265 [5] requires each package to consider the role of state
   agents in the package and, if they are used, to specify how
   authentication and authorization are done.

   This specification allows state agents to be located in the network.
   Publication of PoC-settings document is linked to a user.  However, a
   user may be simultaneously logged in at different PoC terminals.  If
   a user changes her PoC settings from a terminal, it will send a
   PUBLISH request containing a PoC-settings document.  These settings
   are applicable to the user independently of the terminal at which she
   is logged in.  In other words, PoC settings changes done in a
   terminal affect all the PoC terminals where the user is logged.  It
   is RECOMMENDED that each of the terminals where the user is logged in
   subscribes to its own PoC-settings document in order to keep a
   coherent state view with the state agent.

5.12.  Examples

   An example of a PoC-setting document is provided in Section 6.2.

5.13.  Use of URIs to Retrieve State

   RFC 3265 [5] allows packages to use URIs to retrieve large state
   documents.




Garcia-Martin                Informational                     [Page 10]
^L
RFC 4354               PoC Settings Event Package           January 2006


   PoC-settings documents are fairly small.  This event package does not
   provide a mechanism to use URIs to retrieve large state documents.

5.14.  PUBLISH Bodies

   RFC 3903 [8] requires event packages to define the content types
   expected in PUBLISH requests.

   In this event package, the body of a PUBLISH request contains a PoC-
   settings document (see Section 6).  This PoC-settings document
   describes the PoC-related settings of a user at an EPA.  EPAs SHOULD
   include their own information in a PoC-settings document; i.e., there
   SHOULD be a single <entity> element in the body of the PUBLISH
   request (See Section 6.1 for a detailed description of the <entity>
   element).

   All EPAs and ESCs MUST support the "application/poc-settings+xml"
   data format described in Section 6 and MAY support other formats.

5.15.  PUBLISH Response Bodies

   This specification does not associate semantics to a body in a
   PUBLISH response.

5.16.  Multiple Sources for Event State

   RFC 3903 [8] requires event packages to specify whether multiple
   sources can contribute to the event state view at the ESC.

   This event package allows different EPAs to publish the PoC settings
   for a particular user.  Each EPA publishes its own settings grouped
   in an <entity> element.  The EPA provides a globally unique
   identifier for a given address of record.  This allows the ESC to
   differentiate EPAs and either compose a state resolving conflicts or
   provide the union of the states of all the EPAs that contributed to
   it.  The composition policy at the ESC is outside the scope of this
   document.

5.17.  Event State Segmentation

   RFC 3903 [8] defines segments within a state document.  Each segment
   is defined as one of potentially many identifiable sections in the
   published event state.

   This event package defines, for a given EPA, four segments identified
   by the elements <isb-settings>, <am-settings>, <ipab-settings>, and
   <sss-settings>, respectively.  Each of them refers to different
   states of the EPA.



Garcia-Martin                Informational                     [Page 11]
^L
RFC 4354               PoC Settings Event Package           January 2006


5.18.  Rate of Publication

   RFC 3903 [8] allows event packages to define their own rate of
   publication.

   There are no rate-limiting recommendations for poc-settings
   publication.  Since changes in a PoC-settings document are typically
   triggered by interaction with a human user, there is not periodicity,
   nor a minimum or maximum rate of publication.

6.  PoC-Settings Document

   PoC-settings is an XML document [10] that MUST be well-formed and
   SHOULD be valid.  PoC-settings documents MUST be based on XML 1.0 and
   MUST be encoded using UTF-8 [7].  This specification makes use of XML
   namespaces for identifying PoC-settings documents.  The namespace URI
   for elements defined by this specification is a URN [2], using the
   namespace identifier 'oma'.  This URN is:

      urn:oma:params:xml:ns:poc:poc-settings

   PoC-settings documents are identified with the MIME type
   "application/poc-settings+xml" and are instances of the XML schema
   defined in Section 6.1.

   A PoC-settings document begins with the root element tag
   <poc-settings>.  It consists of zero or more <entity> elements, each
   one including an 'id' attribute that contains a globally unique
   identifier for a given address of record that represents an EPA.  An
   <entity> element represents an EPA, and it is uniquely identified by
   the 'id' attribute.  EPAs SHOULD include a single <entity> element in
   a PoC-settings document.  ESCs MAY include several <entity> elements
   in a PoC-settings document, typically when the ESC is unable to
   resolve conflicts due to incongruent publication from different
   sources.

      A valid PoC-settings document can include zero <entity> elements
      if the ESC provides a notification for which no publication has
      occurred.

   The <entity> element MAY contain other elements and attributes from
   different namespaces for the purposes of extensibility; elements or
   attributes from unknown namespaces MUST be ignored.

   The <entity> element consists of zero or one <isb-settings> elements,
   zero or one <am-settings> elements, zero or one <ipab-settings>, and
   zero or one <sss-settings> elements.  Other elements and attributes




Garcia-Martin                Informational                     [Page 12]
^L
RFC 4354               PoC Settings Event Package           January 2006


   from different namespaces MAY be present for the purposes of
   extensibility; elements or attributes from unknown namespaces MUST be
   ignored.

   An <isb-settings> element contains a single <incoming-session-
   barring> element that contains a boolean 'active' attribute.  The
   'active' attribute indicates whether incoming sessions are barred at
   the UA, depending on the user's preferences for this setting.  Other
   elements and attributes from different namespaces MAY be present for
   the purposes of extensibility; elements or attributes from unknown
   namespaces MUST be ignored.

   An <am-settings> element contains an <answer-mode> element, whose
   value can be set to either "automatic" or "manual".  Other elements
   and attributes from different namespaces MAY be present for the
   purposes of extensibility; elements or attributes from unknown
   namespaces MUST be ignored.

   A server such as a URI-list server [11] receives a SIP request
   addressed to one or more recipients.  If the intended recipient set
   the <answer-mode> to "manual", the URI-list server proceeds with the
   session attempt.  If she set it to "automatic", the URI-list server
   generates a 200-class response prior to contacting the intended
   recipient.

   An <ipab-settings> element contains a single <incoming-personal-
   alert-barring> element that contains a boolean 'active' attribute.
   The 'active' attribute indicates whether incoming personal alert
   messages are barred at the UA, depending on the user's preferences
   for this setting.  Other elements from different namespaces MAY be
   present for the purposes of extensibility; elements or attributes
   from unknown namespaces MUST be ignored.

   An <sss-settings> element contains a single <simultaneous-sessions-
   support> element that contains a boolean 'active' attribute.  The
   'active' attribute indicates whether the SIP UA is willing to handle
   more than one PoC session simultaneously.  If the 'active' attribute
   is set to "false" or "0", then when the SIP UA is engaged in a PoC
   session, and the SIP UA receives an second incoming request for a SIP
   PoC session, the UA will decline the invitation.  If the 'active'
   attribute is set to "true" or "1", then when the SIP UA is engaged in
   a PoC session, and the SIP UA receives an second incoming request for
   a SIP PoC session, the UA will possibly accept the invitation.  Other
   elements and attributes from different namespaces MAY be present for
   the purposes of extensibility; elements or attributes from unknown
   namespaces MUST be ignored.





Garcia-Martin                Informational                     [Page 13]
^L
RFC 4354               PoC Settings Event Package           January 2006


6.1.  XML Schema

   Implementations according to this specification MUST comply to the
   following XML Schema, which defines the constraints of the PoC-
   settings document:

   <?xml version="1.0" encoding="UTF-8"?>
   <xs:schema targetNamespace="urn:oma:params:xml:ns:poc:poc-settings"
       xmlns="urn:oma:params:xml:ns:poc:poc-settings"
       xmlns:xs="http://www.w3.org/2001/XMLSchema"
       elementFormDefault="qualified"
       attributeFormDefault="unqualified">

     <xs:import namespace="http://www.w3.org/XML/1998/namespace"
                schemaLocation="http://www.w3.org/2001/xml.xsd"/>
     <xs:annotation>
       <xs:documentation xml:lang="en">
         XML Schema Definition in support of the Incoming Session
         Barring, Answer Mode, Incoming Personal Alert Barring,
         and Simultaneous Sessions Support in the Push-to-talk
         over Cellular (PoC) service.
       </xs:documentation>
     </xs:annotation>

     <xs:element name="poc-settings" type="poc-settingsType"/>

     <xs:complexType name="poc-settingsType">
       <xs:sequence>
         <xs:element name="entity" type="entityType"
                     minOccurs="0" maxOccurs="unbounded" />
         <xs:any namespace="##other" processContents="lax"
                  minOccurs="0" maxOccurs="unbounded"/>
       </xs:sequence>
       <xs:anyAttribute namespace="##any" processContents="lax"/>
     </xs:complexType>

     <xs:complexType name="entityType">
       <xs:sequence>
         <xs:element name="isb-settings" type="isbSettingType"
                     minOccurs="0"/>
         <xs:element name="am-settings" type="amSettingType"
                     minOccurs="0"/>
         <xs:element name="ipab-settings" type="ipabSettingType"
                     minOccurs="0"/>
         <xs:element name="sss-settings" type="sssSettingType"
                     minOccurs="0"/>
         <xs:any namespace="##other" processContents="lax"
                 minOccurs="0" maxOccurs="unbounded"/>



Garcia-Martin                Informational                     [Page 14]
^L
RFC 4354               PoC Settings Event Package           January 2006


       </xs:sequence>
       <xs:attribute name="id" type="xs:string" use="required"/>
       <xs:anyAttribute namespace="##any" processContents="lax"/>
     </xs:complexType>

     <xs:complexType name="isbSettingType">
       <xs:sequence>
         <xs:element name="incoming-session-barring">
           <xs:complexType>
             <xs:attribute name="active" type="xs:boolean"
                           use="required" />
           </xs:complexType>
         </xs:element>
         <xs:any namespace="##any" processContents="lax"
                 minOccurs="0" maxOccurs="unbounded"/>
       </xs:sequence>
       <xs:anyAttribute namespace="##any" processContents="lax"/>
     </xs:complexType>

     <xs:complexType name="amSettingType">
       <xs:sequence>
         <xs:element name="answer-mode">
           <xs:simpleType>
             <xs:restriction base="xs:string">
               <xs:enumeration value="automatic"/>
               <xs:enumeration value="manual"/>
             </xs:restriction>
           </xs:simpleType>
         </xs:element>
         <xs:any namespace="##any" processContents="lax"
                 minOccurs="0" maxOccurs="unbounded"/>
       </xs:sequence>
       <xs:anyAttribute namespace="##any" processContents="lax"/>
     </xs:complexType>

     <xs:complexType name="ipabSettingType">
       <xs:sequence>
         <xs:element name="incoming-personal-alert-barring">
           <xs:complexType>
             <xs:attribute name="active" type="xs:boolean"
                           use="required" />
           </xs:complexType>
         </xs:element>
         <xs:any namespace="##any" processContents="lax"
                 minOccurs="0" maxOccurs="unbounded"/>
       </xs:sequence>
       <xs:anyAttribute namespace="##any" processContents="lax"/>
     </xs:complexType>



Garcia-Martin                Informational                     [Page 15]
^L
RFC 4354               PoC Settings Event Package           January 2006


     <xs:complexType name="sssSettingType">
       <xs:sequence>
         <xs:element name="simultaneous-sessions-support">
           <xs:complexType>
             <xs:attribute name="active" type="xs:boolean"
                           use="required"/>
           </xs:complexType>
         </xs:element>
        <xs:any namespace="##any" processContents="lax"
                minOccurs="0" maxOccurs="unbounded"/>
       </xs:sequence>
       <xs:anyAttribute namespace="##any" processContents="lax"/>
     </xs:complexType>

   </xs:schema>

6.2.  Example

   The following is an example of a PoC-settings document:

   <?xml version="1.0" encoding="UTF-8"?>

   <poc-settings xmlns="urn:oma:params:xml:ns:poc:poc-settings">
     <entity id="do39s8zksn2d98x">
        <isb-settings>
          <incoming-session-barring active="true"/>
        </isb-settings>
        <am-settings>
          <answer-mode>automatic</answer-mode>
        </am-settings>
        <ipab-settings>
          <incoming-personal-alert-barring active="false"/>
        </ipab-settings>
        <sss-settings>
          <simultaneous-sessions-support active="true"/>
        </sss-settings>
     </entity>
   </poc-settings>













Garcia-Martin                Informational                     [Page 16]
^L
RFC 4354               PoC Settings Event Package           January 2006


7.  Security Considerations

   The "poc-settings" event package defined by this document is meant to
   be transported with SIP PUBLISH requests.  Therefore, the Security
   Considerations (Section 14) in RFC 3903 [8] apply to this document.
   In particular, the settings contained in the "poc-settings" event
   package are applicable to the user that generated the SIP PUBLISH
   request.  Therefore, servers that receive SIP PUBLISH requests
   containing a "poc-settings" event package SHOULD authenticate the
   user prior to authorizing the event publication (as required by RFC
   3903 [8]).

   Authentication and authorization of subscriptions have been discussed
   in Section 5.6.  Lack of authentication or authorization may provide
   poc-settings information to unauthorized parties, who can use that
   information for creating attacks.  For example, an unauthorized
   recipient of a PoC-settings document can learn that the publisher's
   terminal is set to answer PoC sessions in automatic answer mode and
   then create a malicious session containing inappropriate media that
   the UAS will play automatically.  Or the attacker can learn that the
   terminal is willing to receive simultaneous PoC sessions and then try
   to exhaust resources in the SIP UA by creating bogus PoC sessions
   that leave hung states in the attacked SIP UA.

   Integrity protection and confidentiality of notifications are also
   discussed in Section 5.7.  If a notifier does not encrypt bodies of
   NOTIFY requests, an eavesdropper could learn the status of a SIP user
   agent and use it to create malicious PoC sessions.  If the notifier
   does not integrity protect the bodies of NOTIFY requests, a man-in-
   the-middle attacker or malicious SIP proxy could modify the contents
   of the poc-settings event package notification.  Although this does
   not cause harm, it can create annoyances (e.g., media clip due to
   lack of buffering) when PoC sessions are delivered to the user.

8.  Acknowledgements

   The author wants to thank Ilkka Westman, Andrew Allen, Chinmay
   Padhye, Gonzalo Camarillo, Paul Kyzivat, Haris Zisimopoulos, Joel M.
   Halpern, and Russ Housley for their comments.

9.  IANA Considerations

9.1.  Registration of the "poc-settings" Event Package

   This specification registers an event package, based on the
   registration procedures defined in RFC 3265 [5].  The following is
   the information required for such a registration:




Garcia-Martin                Informational                     [Page 17]
^L
RFC 4354               PoC Settings Event Package           January 2006


   Package Name: poc-settings

   Package or Template-Package: This is a package.

   Published Document: RFC 4354

   Person to Contact: Miguel A. Garcia-Martin,
   miguel.an.garcia@nokia.com

9.2.  Registration of the "application/poc-settings+xml" MIME type

   To: ietf-types@iana.org

   Subject: Registration of MIME media type application/
   poc-settings+xml

   MIME media type name: application

   MIME subtype name: poc-settings+xml

   Required parameters: (none)

   Optional parameters: charset; Indicates the character encoding of
   enclosed XML.  Default is UTF-8 [7].

   Encoding considerations: Uses XML, which can employ 8-bit
   characters, depending on the character encoding used.  See RFC
   3023 [3], Section 3.2.

   Security considerations: This content type is designed to carry
   information about current PoC user settings, which in some cases
   may be considered private information.  Appropriate precautions
   should be adopted to limit disclosure of this information.

   Interoperability considerations: This content type provides a
   common format for exchange of PoC settings information.

   Published specification: RFC 4354 (this document).

   Applications which use this media type: Push-to-talk over Cellular
   systems in compliance with the Open Mobile Alliance (OMA) PoC
   specifications.

   Additional information: The Open Mobile Alliance publishes the
   Push-to-talk over Cellular specifications in the OMA web site at
   http://www.openmobilealliance.org





Garcia-Martin                Informational                     [Page 18]
^L
RFC 4354               PoC Settings Event Package           January 2006


   Person & email address to contact for further information: Miguel
   A. Garcia-Martin, miguel.an.garcia@nokia.com

   Intended usage: Limited use, restricted to PoC terminals and
   servers.

   Author/Change controller: Open Mobile Alliance
   (http://www.openmobilealliance.org), PoC working group.

   Other information: This media type is a specialization of
   application/xml RFC 3023 [3], and many of the considerations
   described there also apply to application/poc-settings+xml.

10.  References

10.1.  Normative References

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

   [2]   Moats, R., "URN Syntax", RFC 2141, May 1997.

   [3]   Murata, M., St. Laurent, S., and D. Kohn, "XML Media Types",
         RFC 3023, January 2001.

   [4]   Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, A.,
         Peterson, J., Sparks, R., Handley, M., and E. Schooler, "SIP:
         Session Initiation Protocol", RFC 3261, June 2002.

   [5]   Roach, A., "Session Initiation Protocol (SIP)-Specific Event
         Notification", RFC 3265, June 2002.

   [6]   Mankin, A., Bradner, S., Mahy, R., Willis, D., Ott, J., and B.
         Rosen, "Change Process for the Session Initiation Protocol
         (SIP)", BCP 67, RFC 3427, December 2002.

   [7]   Yergeau, F., "UTF-8, a transformation format of ISO 10646",
         STD 63, RFC 3629, November 2003.

   [8]   Niemi, A., "Session Initiation Protocol (SIP) Extension for
         Event State Publication", RFC 3903, October 2004.

   [9]   Ramsdell, B., "Secure/Multipurpose Internet Mail Extensions
         (S/MIME) Version 3.1 Message Specification", RFC 3851,
         July 2004.






Garcia-Martin                Informational                     [Page 19]
^L
RFC 4354               PoC Settings Event Package           January 2006


   [10]  Paoli, J., Sperberg-McQueen, C., Bray, T., and E. Maler,
         "Extensible Markup Language (XML) 1.0 (Second Edition)", W3C
         FirstEdition REC-xml-20001006, October 2000.

10.2.  Informative References

   [11]  Camarillo, G. and A. Roach, "Requirements and Framework for
         Session Initiation Protocol (SIP) Uniform Resource Identifier
         (URI)-List Services", Work in Progress, April 2005.

   [12]  Rosenberg, J., "A Framework for Conferencing with the Session
         Initiation Protocol (SIP)", RFC 4353, January 2006.

Author's Address

   Miguel A. Garcia-Martin
   Nokia
   P.O.Box 407
   NOKIA GROUP, FIN  00045
   Finland

   EMail: miguel.an.garcia@nokia.com





























Garcia-Martin                Informational                     [Page 20]
^L
RFC 4354               PoC Settings Event Package           January 2006


Full 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.

   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.

Intellectual Property

   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.

Acknowledgement

   Funding for the RFC Editor function is provided by the IETF
   Administrative Support Activity (IASA).







Garcia-Martin                Informational                     [Page 21]
^L