SIPPING J. Rosenberg
Internet-Draft dynamicsoft
Expires: August 15, 2004 H. Schulzrinne
Columbia University
O. Levin, Ed.
Microsoft Corporation
February 15, 2004
A Session Initiation Protocol (SIP) Event Package for Conference
State
draft-ietf-sipping-conference-package-03
Status of this Memo
This document is an Internet-Draft and is in full conformance with
all provisions of Section 10 of RFC2026.
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 August 15, 2004.
Copyright Notice
Copyright (C) The Internet Society (2004). All Rights Reserved.
Abstract
This document defines a conference event package for the Session
Initiation Protocol (SIP) Events framework, along with a data format
used in notifications for this package. The conference package allows
users to subscribe to a conference URI. Notifications are sent about
changes in the membership of this conference, the status of users'
participation in the conference, and the sidebars in the conference.
Rosenberg, et al. Expires August 15, 2004 [Page 1]
Internet-Draft Conference Package February 2004
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . 3
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . 4
3. Conference Event Package . . . . . . . . . . . . . . . . . 5
3.1 Event Package Name . . . . . . . . . . . . . . . . . . . . 5
3.2 SUBSCRIBE Bodies . . . . . . . . . . . . . . . . . . . . . 5
3.3 Subscription Duration . . . . . . . . . . . . . . . . . . 5
3.4 NOTIFY Bodies . . . . . . . . . . . . . . . . . . . . . . 6
3.5 Notifier Processing of SUBSCRIBE Requests . . . . . . . . 6
3.6 Notifier Generation of NOTIFY Requests . . . . . . . . . . 6
3.7 Subscriber Processing of NOTIFY Requests . . . . . . . . . 7
3.8 Handling of Forked Requests . . . . . . . . . . . . . . . 7
3.9 Rate of Notifications . . . . . . . . . . . . . . . . . . 7
3.10 State Agents . . . . . . . . . . . . . . . . . . . . . . . 7
4. Conference Data Format . . . . . . . . . . . . . . . . . . 8
4.1 Conference Information . . . . . . . . . . . . . . . . . . 8
4.1.1 User Element . . . . . . . . . . . . . . . . . . . . . . . 9
4.1.1.1 User Statuses . . . . . . . . . . . . . . . . . . . . . . 9
4.1.1.2 Media Stream Information . . . . . . . . . . . . . . . . . 10
4.1.2 Sidebar . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.1.3 Additional Conference Identifiers . . . . . . . . . . . . 11
4.1.4 Policy URIs . . . . . . . . . . . . . . . . . . . . . . . 11
4.2 Constructing Coherent State . . . . . . . . . . . . . . . 11
4.3 Schema . . . . . . . . . . . . . . . . . . . . . . . . . . 12
4.4 Example . . . . . . . . . . . . . . . . . . . . . . . . . 15
5. Security Considerations . . . . . . . . . . . . . . . . . 16
6. IANA Considerations . . . . . . . . . . . . . . . . . . . 17
6.1 conference Event Package Registration . . . . . . . . . . 17
6.2 application/conference-info+xml MIME Registration . . . . 17
6.3 URN Sub-Namespace Registration for
urn:ietf:params:xml:ns:conference-info . . . . . . . . . . 18
6.4 XML Schema Registration . . . . . . . . . . . . . . . . . 19
7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . 20
8. Changes since -02 . . . . . . . . . . . . . . . . . . . . 21
9. Changes since -01 . . . . . . . . . . . . . . . . . . . . 22
Normative References . . . . . . . . . . . . . . . . . . . 23
Informative References . . . . . . . . . . . . . . . . . . 24
Authors' Addresses . . . . . . . . . . . . . . . . . . . . 24
Intellectual Property and Copyright Statements . . . . . . 26
Rosenberg, et al. Expires August 15, 2004 [Page 2]
Internet-Draft Conference Package February 2004
1. Introduction
The Session Initiation Protocol (SIP) [3] Events framework [2]
defines general mechanisms for subscribing to, and receiving
notifications of, events within SIP networks. It introduces the
notion of a package, which is a specific "instantiation" of the
events framework for a well-defined set of events. Here, we define an
event package for SIP conferences. This package provides the
conference notification service as outlined in the SIP conferencing
framework [9]. As described there, subscriptions to a conference URI
are routed to the focus that is handling the conference. It acts as
the notifer, and provides clients with updates on conference state.
The information provided by this package is comprised of conference
identifier(s), conference participants (optionally with their
statuses and media types) and conference sidebars.
Rosenberg, et al. Expires August 15, 2004 [Page 3]
Internet-Draft Conference Package February 2004
2. Terminology
In this document, the key words "MUST", "MUST NOT", "REQUIRED",
"SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",
and "OPTIONAL" are to be interpreted as described in RFC 2119 [1] and
indicate requirement levels for compliant implementations.
Rosenberg, et al. Expires August 15, 2004 [Page 4]
Internet-Draft Conference Package February 2004
3. Conference Event Package
The conference event package allows a user to subscribe to a
conference. In SIP, conferences are represented by URIs. These URIs
route to a SIP user agent, called a focus, that is responsible for
ensuring that all users in the conference can communicate with each
other [9]. The focus has sufficient information about the state of
the conference to inform subscribers about it.
It is possible a participant in the conference may in fact be another
focus. In order to provide a more complete participant list, the
focus MAY subscribe to the conference package of the other focus to
discover the participant list in the cascaded conference. This
information can then be included in notifications by using of the
"cascaded-focus" attribute as specified by this package.
This section provides the details for defining a SIP Events package,
as specified by [2].
3.1 Event Package Name
The name of this event package is "conference". This package name is
carried in the Event and Allow-Events header, as defined in [2].
3.2 SUBSCRIBE Bodies
A SUBSCRIBE for a conference package MAY contain a body. This body
defines a filter to apply to the subscription. Filter documents are
not specified in this document, and at the time of writing, are
expected to be the subject of future standardization activity.
A SUBSCRIBE for a conference package MAY be sent without a body. This
implies the default subscription filtering policy. The default policy
is:
o Notifications are generated every time there is any change in the
state of the conference.
o Notifications do not normally contain full state; rather, they
only indicate the state that has changed. The exception is a
NOTIFY sent in response to a SUBSCRIBE. These NOTIFYs contain the
full state of the information requested by the subscriber.
3.3 Subscription Duration
The default expiration time for a subscription to a conference is one
hour. Once the conference ends, all subscriptions to that particular
Rosenberg, et al. Expires August 15, 2004 [Page 5]
Internet-Draft Conference Package February 2004
conference are terminated, with a reason of "noresource" [2].
3.4 NOTIFY Bodies
As described in RFC 3265 [2], the NOTIFY message will contain bodies
that describe the state of the subscribed resource. This body is in a
format listed in the Accept header field of the SUBSCRIBE, or a
package-specific default if the Accept header field was omitted from
the SUBSCRIBE.
In this event package, the body of the notification contains a
conference information document. This document describes the state of
a conference. All subscribers and notifiers MUST support the
"application/conference-info+xml" data format described in Section 4.
The subscribe request MAY contain an Accept header field. If no such
header field is present, it has a default value of "application/
conference-info+xml". If the header field is present, it MUST include
"application/conference-info+xml", and MAY include any other types
capable of representing dialog state.
Of course, the notifications generated by the server MUST be in one
of the formats specified in the Accept header field in the SUBSCRIBE
request.
3.5 Notifier Processing of SUBSCRIBE Requests
The conference information contains very sensitive information.
Therefore, all subscriptions SHOULD be authenticated and then
authorized before approval. Authorization policy is at the discretion
of the administrator, as always. However, a few recommendations can
be made.
It is RECOMMENDED that all users in the conference be allowed to
subscribe to the conference.
3.6 Notifier Generation of NOTIFY Requests
Notifications SHOULD be generated for the conference whenever there
is a change in the state in any of the information delivered to the
subscriber.
The changes generally occur when a new participant joins, a
participant leaves, or a participant is put on-hold. Subject to a
local focus policy, changes in media types and other optional media
attributes MAY be reported by the focus. In addition, creation and
deletion of sidebars together with their rosters MAY be reported by
the focus, subject to its local policy.
Rosenberg, et al. Expires August 15, 2004 [Page 6]
Internet-Draft Conference Package February 2004
3.7 Subscriber Processing of NOTIFY Requests
The SIP Events framework expects packages to specify how a subscriber
processes NOTIFY requests in any package specific ways, and in
particular, how it uses the NOTIFY requests to contruct a coherent
view of the state of the subscribed resource.
Typically, the NOTIFY for the conference package will only contain
information about those users whose state in the conference has
changed. To construct a coherent view of the total state of all
users, a subscriber to the conference package will need to combine
NOTIFYs received over time.
Notifications within this package can convey partial information;
that is, they can indicate information about a subset of the state
associated with the subscription. This means that an explicit
algorithm needs to be defined in order to construct coherent and
consistent state. The details of this mechanism are specific to the
particular document type. See Section 4.2 for information on
constructing coherent information from an application/
conference-info+xml document.
3.8 Handling of Forked Requests
By their nature, the conferences supported by this package are
centralized. Therefore, SUBSCRIBE requests for a conference should
not generally fork. Users of this package MUST NOT install more than
a single subscription as a result of a single SUBSCRIBE request.
3.9 Rate of Notifications
For reasons of congestion control, it is important that the rate of
notifications not become excessive. As a result, it is RECOMMENDED
that the server not generate notifications for a single subscriber at
a rate faster than once every 5 seconds.
3.10 State Agents
Conference state is ideally maintained in the element in which the
conference resides. Therefore, the elements that maintain the
conference are the ones best suited to handle subscriptions to it.
Therefore, the usage of state agents is NOT RECOMMENDED for this
package.
Rosenberg, et al. Expires August 15, 2004 [Page 7]
Internet-Draft Conference Package February 2004
4. Conference Data Format
Conference information is an XML document that MUST be well-formed
and SHOULD be valid. Dialog information documents MUST be based on
XML 1.0 and MUST be encoded using UTF-8. This specification makes use
of XML namespaces for identifying dialog information documents and
document fragments. The namespace URI for elements defined by this
specification is a URN [4], using the namespace identifier 'ietf'
defined by [5] and extended by [6]. This URN is:
urn:ietf:params:xml:ns:conference-info
A conference information document begins with the root element tag
"conference-info".
4.1 Conference Information
Conference information begins with the top level element
"conference-info". This element has three mandatory and one optional
attributes:
version: This mandatory attribute allows the recipient of conference
information documents to properly order them. Versions start at 0
and increment by one for each new document sent to a subscriber.
Versions are scoped within a subscription. Versions MUST be
represented using a 32 bit integer.
state: This mandatory attribute indicates whether the document
contains the full conference information, or whether it contains
only the information that has changed since the previous document
(partial).
entity: This mandatory attribute contains the conference URI that
identifies the conference being described in the document.
recording: This optional attribute indicates whether the conference
is being recorded at this moment ("on") or not ("off").
The "conference-info" element has zero or more "user" sub-elements
which contain information on the users in the conference. This is
followed by zero or more "sidebar" sub-elements which contain
information on the sidebars in the conference. This is followed by
zero or more "conf-uri" sub-elements which contain information on
additional URIs that the conference can be accessed by. This is
followed by zero or more "policy-uri" sub-elements which contain
information on additional URIs that the conference policies can be
accessed by.
Rosenberg, et al. Expires August 15, 2004 [Page 8]
Internet-Draft Conference Package February 2004
4.1.1 User Element
The user element has one mandatory attribute, "uri" that indicates
the URI for the user in the conference. This is a logical identifier,
not a machine specific one (i.e., it's taken from the authenticated
identity of the participant). The optional attribute "display-name"
contains a display name for the user. The standard "xml:lang"
language attribute can also be present to indicate the language of
the display-name.
The optional attribute "cascaded-focus" contains a conference URI
(different from the main conference URI) for users that are connected
to the main conference as a result of focus cascading. In accordance
with the SIP conferencing framework [9], this defined package allows
for representation of peer-to-peer (i.e. "flat") focus cascading
only. The actual cascading graph is not explicitly expressed in this
package because most applications do not care about the actual
topology of the cascaded focuses as long as the information about
their participants is available. In addition, an advanced application
can construct the graph by subscribing to both this package and the
Dialog Package [10] of the involved focuses and correlating the
required information.
4.1.1.1 User Statuses
Three optional status elements are defined: status, joining-mode, and
disconnection-reason.
o "status": provides information about user's current level of
participation in the conference.
o "joining-mode": if present, provides information about the way the
user joined the conference.
o "disconnection-reason": if present, provides information about the
way the user left the conference.
The following statuses are defined for the "status" element:
connected: The user is a participant in the conference. Depending on
the media policies, he/she can send and receive media to and from
other participants.
disconnected: The user is not a participant in the conference and no
active dialog exists between the user and the focus.
Rosenberg, et al. Expires August 15, 2004 [Page 9]
Internet-Draft Conference Package February 2004
on-hold: Active SIP dialog exists between a user and a focus, but
user is "on-hold" for this conference, i.e. neither he/she is
"hearing" the conference mix, nor is his/her media being mixed in
the conference. As an example, the user has asked to join the
conference using SIP, but his/her participation is pending based
on moderator approval. In the meantime he/she is hearing
music-on-hold or some other kind of related content.
muted-by-focus: Active SIP dialog exists between a user and a focus
and the user can "listen" to the conference, but user's media is
not being mixed into the conference.
The following statuses are defined for the "joining-mode" element:
dialed-in: The user dialed into the conference, i.e. sent INVITE to
the focus, which resulted in successful dialog establishment.
dialed-out: The focus has brought the user into the conference by
sending a successful INVITE to the user.
focus-owner: The user is the focus itself for this conference.
The following statuses are defined for the disconnection-reason
element:
departed: The user sent a BYE, thus leaving the conference.
booted: The user was sent a BYE by the focus, booting him/her out of
the conference. Alternatively, the user tried to dial into to
conference without success because was rejected by the focus
according to local policy decisions.
failed: The server tried to bring the user into the conference, but
its attempt to contact the specific user resulted in a non-200
class final response. Alternatively, the user tried to dial into
the conference without success due to technical reasons.
4.1.1.2 Media Stream Information
Each user has zero or more "media-stream" sub-elements.
Each "media-stream" element indicates the media stream that the user
is currently connected to. Here, "connected to" implies that a user
has a media line in their SDP [12]. With this definition, a user is
connected to a media stream even if they are not sending any media.
The "media-stream" element has a mandatory "media-type" attribute
Rosenberg, et al. Expires August 15, 2004 [Page 10]
Internet-Draft Conference Package February 2004
which identifies the media type (e.g. audio, video, message and
application) and MUST have one of the values registered for "media"
of SDP [12].
The "media-stream" element has also an optional "proto" sub-element,
which MUST has the value registered for "proto" of SDP [12]).
An optional "ssrc" sub-element, if present, carries the value of SSRC
(RTP/RTCP [8]) as generated by the user for the stream it sends.
When an RTP mixer generates a CSRC list according to RTP/RTCP [8], it
inserts a list of the SSRC identifiers of the sources that
contributed to the generation of a particular packet into the RTP
header of that packet. "An example application is audio conferencing
where a mixer indicates all the talkers whose speech was combined to
produce the outgoing packet, allowing the receiver to indicate the
current talker, even though all the audio packets contain the same
SSRC identifier (that of the mixer)."
4.1.2 Sidebar
The sidebar element has one attribute - "entity" that indicates the
URI which identifiers the sidebar. A sidebar has zero or more users
that are of type "user-type" as the users of the main conference are.
4.1.3 Additional Conference Identifiers
In addition to the Conference URI present in the "entity" attribute,
a conference MAY have additional URIs of various types. Connecting to
these URIs will result in joining to the same conference.
4.1.4 Policy URIs
A policy URI specifies where and how a certain policy pertaining to
the conference can be accessed. The actual policy name and usage is
deduced from the URI schema name.
An example for the "policy-uri" usage is inclusion of the URI of the
CPCP [11]. A subscriber to the Conference package can use the Policy
URI to access and modify the conference policy.
4.2 Constructing Coherent State
The conference information subscriber maintains a table for the list
of users in the conference. The table contains a row for each user.
Each row is indexed by a URI, present in the "uri" attribute of the
"user" element. The contents of each row contain the state of that
user as conveyed in the document.
Rosenberg, et al. Expires August 15, 2004 [Page 11]
Internet-Draft Conference Package February 2004
The table is associated with a version number. The version number
MUST be initialized with the value of the "version" attribute from
the "conference-info" element in the first document received. Each
time a new document is received, the value of the local version
number, and the "version" attribute in the new document, are
compared. If the value in the new document is one higher than the
local version number, the local version number is increased by one,
and the document is processed. If the value in the document is more
than one higher than the local version number, the local version
number is set to the value in the new document, the document is
processed, and the subscriber SHOULD generate a refresh request to
trigger a full state notification. If the value in the document is
less than the local version, the document is discarded without
processing.
The processing of the conference information document depends on
whether it contains full or partial state. If it contains full state,
indicated by the value of the "state" attribute in the
"conference-info" element, the contents of the table is flushed. It
is repopulated from the document. A new row in the user table is
created for each "user" element. If the document contains partial
state, as indicated by the value of the "state" attribute in the
"conference-info" element, the document is used to update the table.
For each "user" element in the document, the subscriber checks to see
whether a row exists for that user in the user table. This check is
done by comparing the URI in the "uri" attribute of the "user"
element with the URI associated with the row. If the user doesn't
exist in the table, a row is added, and its state is set to the
information from that "user" element. If the user does exist, its
state is updated to be the information from that "user" element. If a
row is updated or created, such that its state is now disconnected,
booted, failed or departed, that entry MAY be removed from the table
at any time.
4.3 Schema
Rosenberg, et al. Expires August 15, 2004 [Page 12]
Internet-Draft Conference Package February 2004
Rosenberg, et al. Expires August 15, 2004 [Page 13]
Internet-Draft Conference Package February 2004
Rosenberg, et al. Expires August 15, 2004 [Page 14]
Internet-Draft Conference Package February 2004
4.4 Example
The following is an example conference information document:
connected
dialed-in
RTP/AVP
583398
on-hold
on-hold
tel:+18005671234
h323:conf545@example.com
This conference currently has three users, two of which are in a
sidebar conversation. The conference is being recorded. There are
additional means to join the conference either by phone using tel URI
[14] or by H.323 protocol using h323 URL [13].
Rosenberg, et al. Expires August 15, 2004 [Page 15]
Internet-Draft Conference Package February 2004
5. Security Considerations
Subscriptions to conference state can reveal very sensitive
information. For this reason, the document recommends authentication
and authorization, and provides guidelines on sensible authorization
policies.
Since the data in notifications is sensitive as well, end-to-end SIP
encryption mechanisms using S/MIME SHOULD be used to protect it.
Rosenberg, et al. Expires August 15, 2004 [Page 16]
Internet-Draft Conference Package February 2004
6. IANA Considerations
This document registers a SIP event package, a new MIME type,
application/conference-info+xml, a new XML namespace, and a new XML
schema.
6.1 conference Event Package Registration
This specification registers an event package, based on the
registration procedures defined in RFC 3265 [2]. The following is the
information required for such a registration:
Package Name: conference
Package or Template-Package: This is a package.
Published Document: RFC XXXX (Note to RFC Editor: Please fill in XXXX
with the RFC number of this specification).
Person to Contact: Jonathan Rosenberg, jdrosen@jdrosen.net.
6.2 application/conference-info+xml MIME Registration
MIME media type name: application
MIME subtype name: conference-info+xml
Mandatory parameters: none
Optional parameters: Same as charset parameter application/xml as
specified in RFC 3023 [7].
Encoding considerations: Same as encoding considerations of
application/xml as specified in RFC 3023 [7].
Security considerations: See Section 10 of RFC 3023 [7] and Section 5
of this specification.
Interoperability considerations: none.
Published specification: This document.
Applications which use this media type: This document type has been
used to support SIP conferencing applications.
Rosenberg, et al. Expires August 15, 2004 [Page 17]
Internet-Draft Conference Package February 2004
Additional Information:
Magic Number: None
File Extension: .cif or .xml
Macintosh file type code: "TEXT"
Personal and email address for further information: Jonathan
Rosenberg,
Intended usage: COMMON
Author/Change controller: The IETF.
6.3 URN Sub-Namespace Registration for
urn:ietf:params:xml:ns:conference-info
This section registers a new XML namespace, as per the guidelines in
[6].
URI: The URI for this namespace is
urn:ietf:params:xml:ns:conference-info.
Registrant Contact: IETF, SIPPING working group, ,
Jonathan Rosenberg .
XML:
BEGIN
Conference Information Namespace
Namespace for Conference Information
urn:ietf:params:xml:ns:conference-info
See RFCXXXX.