XCON H. Khartabil
Internet-Draft P. Koskelainen
Expires: March 10, 2005 A. Niemi
Nokia
September 9, 2004
The Conference Policy Control Protocol (CPCP)
draft-ietf-xcon-cpcp-00
Status of this Memo
By submitting this Internet-Draft, I certify that any applicable
patent or other IPR claims of which I am aware have been disclosed,
and any of which I become aware will be disclosed, in accordance with
RFC 3668.
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 March 10, 2005.
Copyright Notice
Copyright (C) The Internet Society (2004). All Rights Reserved.
Abstract
The Conference Policy is defined as the complete set of rules for a
particular conference manipulated by the conference policy server.
The Conferece Policy Control Protocol (CPCP) is the protocol used by
clients to manipulate the conference policy. This document describes
the Conference Policy Control Protocol (CPCP). It specifies an
Extensible Markup Language (XML) Schema that enumerates the
conference policy data elements that enable a user to define a
conference policy.
Khartabil, et al. Expires March 10, 2005 [Page 1]
Internet-Draft CPCP September 2004
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Conventions Used in This Document . . . . . . . . . . . . . . 3
3. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 3
4. Structure of a Conference Policy document . . . . . . . . . . 4
4.1 MIME Type for CPCP XML Document . . . . . . . . . . . . . 4
4.2 Conference Root . . . . . . . . . . . . . . . . . . . . . 4
4.3 XML Document Description . . . . . . . . . . . . . . . . . 5
4.3.1 Conference Settings . . . . . . . . . . . . . . . . . 5
4.3.2 Conference Information . . . . . . . . . . . . . . . . 7
4.3.3 Conference Time . . . . . . . . . . . . . . . . . . . 8
4.3.4 Conference Authorization Rules . . . . . . . . . . . . 9
4.3.5 Conference Dial-Out List . . . . . . . . . . . . . . . 20
4.3.6 Conference Refer List . . . . . . . . . . . . . . . . 20
4.3.7 Conference Media Streams . . . . . . . . . . . . . . . 21
4.4 XML Schema Extensibility . . . . . . . . . . . . . . . . . 21
4.5 XML Schema . . . . . . . . . . . . . . . . . . . . . . . . 22
5. Conference Policy Manipulation and Conference Entity
Behaviour . . . . . . . . . . . . . . . . . . . . . . . . . . 27
5.1 Overview of Operation . . . . . . . . . . . . . . . . . . 27
5.2 Use of External Lists . . . . . . . . . . . . . . . . . . 27
5.3 Communication Between Conference Entities . . . . . . . . 28
5.4 Manipulating Participant Lists . . . . . . . . . . . . . . 28
5.4.1 Expelling a Participant . . . . . . . . . . . . . . . 28
5.5 Re-joining a Conference . . . . . . . . . . . . . . . . . 30
6. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
6.1 A Simple Conference Policy Document . . . . . . . . . . . 30
6.2 A Complex Conference Policy Document . . . . . . . . . . . 31
7. Security Considerations . . . . . . . . . . . . . . . . . . . 33
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 34
8.1 XCAP Application Usage ID . . . . . . . . . . . . . . . . 34
8.2 application/conference-policy+xml MIME TYPE . . . . . . . 34
8.3 URN Sub-Namespace Registration for
urn:ietf:params:xml:ns:conference-policy . . . . . . . . . 35
9. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 36
10. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 36
11. References . . . . . . . . . . . . . . . . . . . . . . . . . 36
11.1 Normative References . . . . . . . . . . . . . . . . . . . . 36
11.2 Informative References . . . . . . . . . . . . . . . . . . . 38
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . 38
Intellectual Property and Copyright Statements . . . . . . . . 40
Khartabil, et al. Expires March 10, 2005 [Page 2]
Internet-Draft CPCP September 2004
1. Introduction
The SIP conferencing framework [13] defines the mechanisms for
multi-party centralized conferencing in a SIP environment.
Existing SIP mechanisms allow users, for example, to join and leave a
conference, as described in [9]. A centralised server, called focus,
can expel and invite users, and may have proprietary access control
lists and user privilege definitions. This document defines an XML
Schema in Section 4 that enumerates the conference policy data
elements that enable a user to define a conference policy. This
policy document may be given to a focus using a number of transports
that are outside the scope of this document.
A focus conforming to this specification MUST support the XML object
defined in Section 4.
2. Conventions Used in This Document
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 [2].
3. Terminology
This document uses terminology from [13]. Some additional
definitions are introduced here.
Conference authorization policy (CAP): Conference authorization
policy consists of an unordered set of rules, which control the
permissions and privileges that are given to conference
participants.
Conference Policy Server (CPS): Conference Policy Server. See [13]
Conference participant: Conference participant is a user who has an
on-going session (e.g. SIP dialog) with the conference focus.
Floor control: Floor control is a mechanism that enables
applications or users to gain safe and mutually exclusive or
non-exclusive access to the shared object or resource in a
conference.
Dial-Out List (DL): The Dial-out list (DL) is a list of users who
the focus needs to invite to the conference.
Khartabil, et al. Expires March 10, 2005 [Page 3]
Internet-Draft CPCP September 2004
Privileged user: A privileged user is a user that has the right to
manipulate parts or all of the conference policy XML document.
Conference Policy URI: The URI of conference policy. It identifies
the XML document. The URI construction is specified in [10].
Refer List (RL): The Refer list (RL) is a list of users who the
focus needs to refer to the conference.
Sidebar: A sub-conference of a main conference.
4. Structure of a Conference Policy document
The conference policy document is an XML [6] document that MUST be
well-formed and MUST be valid. The Conference policy documents MUST
be based on XML 1.0 and MUST be encoded using UTF-8. This
specification makes use of XML namespaces for identifying conference
policy documents and document fragments. The namespace URI for
elements defined by this specification is a URN [3], using the
namespace identifier 'ietf' defined by [4] and extended by [15].
This URN is:
urn:ietf:params:xml:ns:conference-policy
4.1 MIME Type for CPCP XML Document
The MIME type for the CPCP XML document is "application/
conference-policy+xml".
4.2 Conference Root
A conference policy document begins with the root element tag
<conference>. Other elements from different namespaces MAY be
present for the purposes of extensibility. Elements or attributes
from unknown namespaces MUST be ignored. The conference policy is
build up using the following:
o The <settings> element: This element is mandatory and contains
various conference settings. It contains the conference URI(s),
the maximum number of participants, the conference security level,
and sidebar settings. It can occur only once in the document.
o The <info> element: This element is optional and includes
information describing the conference, that can be used, for
example, search purposes. This information can also be used in
the session description when the focus is sending invitations. It
Khartabil, et al. Expires March 10, 2005 [Page 4]
Internet-Draft CPCP September 2004
can occur only once in the document.
o The <time> element: This optional element defines conference time
information, namely elements defining start and stop times for a
media mixing.
o The <authorization> element: This optional element is the
conference authorisation rules. It contains rules for users who
can dial into the conference, users who are blocked from dialling
in, amongst others.
o The <dialout-list> element: This optional element is for the
dial-out list. It contains URIs for users that the focus will
invite to the conference.
o The <refer-list> element: This optional element is for the refer
list. It contains URIs for users that the focus will refer to the
conference.
o The <ms> element: This optional element contains the media streams
to be used in the conference.
The elements are described in more detail in the forthcoming
sections.
A user may create a new conference at the CPS by placing a new
conference policy document. Depending on server policy and user
privileges, the CPS may accept the creation, or it may reject it.
A conference can be deleted permanently by removing the conference
policy from the CPS, which consequently frees the resources. When
the user deletes a conference, the CPS MUST also delete all its
sub-conferences ("sidebars") at a server. Conference sidebars have
unique URIs at the server. Sidebars are created in [18].
4.3 XML Document Description
4.3.1 Conference Settings
The <settings> element contains 2 sub-elements; the <conference-uri>
element and the <max-participant-count> element.
<conference-uri> is a mandatory element. It can occur more than once
to accommodate multiple signaling protocols. Once a conference URI
is set, it MUST NOT be changed or removed for the duration of the
conference. Only one URI per protocol MUST be set. URIs can be
added at any time.
Khartabil, et al. Expires March 10, 2005 [Page 5]
Internet-Draft CPCP September 2004
<max-participant-count> is an optional element. It carries the
maximum number of participants allowed in the conference. When the
maximum number of participants threshold is reached, no new users are
not allowed to join until the number of participants decreases again.
If using SIP, the server can reject a request to join (INVITE) with
a "480 Temporarily Unavailable" response. Alternatively, the sever
may implement a waiting queue.
<security-level> is an optional element. It describes the security
level that the creator of the conference wishes to have for the
conference being created, including signalling and media. There are
4 security levels defined: none, low, medium, and high with medium
being the default value if this element is absent. Those levels are
loosly defined here. The interpretation of those levels and the
security protocols applied is left as a local policy of the focus. A
focus may interpret those levels as follows:
none: No security is required for the signalling nor the media
low: Signalling and media integrity is required
medium: Signalling and media confidentiality is required
high: Signalling and media integrity and confidentiality are
required
<allow-sidebars> is an optional element with a boolean value
indicating if sidebars are allowed in this conference or not. The
default value, if omitted, is "true" indicating that sidebars are
allowed.
<sidebar> is an element identifying a side bar. Multiple <sidebar>
elements can occur indicating multiple sidebars. No <sidebar>
elements appearing in a conference policy indicates that there are no
sidebars currently for this conference. A <sidebar> element contains
a mandatory 'id' attribute that uniquely identifies the sidebar. It
also contains an <uri> element that hold the sidebar URI. It can
occur more than once to accommodate multiple signaling protocols.
Once a sidebar URI is set, it MUST NOT be changed or removed for the
duration of the conference. Only one URI per protocol MUST be set.
URIs can be added at any time.
A sidebar MAY have its own policy. This policy is created exactly in
the same manner as any other conference. The <policy> element in the
<sidebar> element points to such policy. If the <policy> element is
omitted, the sidebar inherits the policy of the conference it is a
sidebar of.
Khartabil, et al. Expires March 10, 2005 [Page 6]
A conference is identified by one or more conference URIs, one for
each call signaling protocol that is supported. There must be at
least one URI for a conference. Conference URIs can be proposed by
the creator of the conference policy, as it may be useful to have
human-friendly name in some cases, or can be assigned by the CPS. If
the creator has proposed a conference URI, the server needs to decide
whether to accept the name proposed by the client or not. It does
this determination by examining if the conference URI already exists
or not. If it exists, the CPS rejects the request to create the
conference with that conference URI. Similarly, the CPS rejects the
request to create a conference with a conference URI for a signalling
protocol it does not support.
A Conference URI can be SIP, SIPS, TEL, or any supported URI scheme.
The CPS MAY assign multiple conference URIs to a conference, one for
each call signaling protocol that it supports.
Sidebar URIs are subject to the same behaviour.
4.3.2 Conference Information
The <info> element includes informative conference parameters which
may be helpful describing the purpose of a conference, e.g. for
search purposes or for providing host contact information. The
<info> element has a special attribute 'xml:lang' to specify the
language used in the contents of this element as defined Section 2.12
of [6].
Each conference has an optional <subject> element, which describes
the current topic in a conference. The optional <display-name>
element is the display name of the conference, which usually does not
change over time.
<free-text> and <keywords> are optional elements. They provide
additional textual information about the conference. This
information can be made available to potential conference
participants by means outside the scope of this document. Examples
of usage could be searching for a conference based on some keywords.
The optional <web-page> element points to a URI where additional
information about the conference can be found.
The optional <host-info> element contains the <uri>, <e-mail> and
<web-page> elements. They give additional information about the user
hosting the conference. This information can, for example, be
included into the SDP fields of the SIP INVITE requests sent by the
focus. The <uri> element is optional and can occur more than once.
Khartabil, et al. Expires March 10, 2005 [Page 7]
Internet-Draft CPCP September 2004
4.3.3 Conference Time
The information related to conference time and lifetime is contained
in the <time> element. The conference may occur for a limited period
of time (i.e. bounded), or the conference may be unbounded (i.e. it
does not have a specified end time). Bounded conferences may occur
multiple times(e.g. on weekly basis).
The <time> element contains one or more <occurrence> elements each
defining the time information of a single conference occurrence.
Multiple <occurrence> elements MAY be used if a conference is active
at multiple times; each additional <occurrence> element contains time
information for a specific occurrence.
For each occurrence, the <mixing-start-time> element specifies when
conference media mixing starts. the <mixing-stop-time> element
specifies the time a conference media mixing stops. If the
<mixing-start-time> element is not present, it indicates that the
conference media mixing starts immediately. If the
<mixing-stop-time> element is not present, it indicates that the
conference occurrence is not bounded, i.e. permanent unitl the
conference policy is removed from the server.
<mixing-start-time> and <mixing-stop-time> elements both have the
mandatory 'require-participant' attribute. This attribute has one of
3 values: "none", "key-participant", and "participant". For mixing
start time, this attribute allows a privileged user to define when
media mixing starts based on the latter of the mixing start time, and
the time the first participant or key participant arrives. If the
value is set to "none", mixing starts according to the mixing start
time. For mixing stop time, this attribute allows a privileged user
to define when media mixing stops based on the earlier of the mixing
stop time, and the time the last participant or key participant
leaves. If the value is set to "none", mixing stops according to the
mixing stop time.
Users can be allowed to join a conference before the media mixing
time starts and after a certain time. A conference privileged user
can indicate the time when users can join by populating the
<can-join-after> element. Similarly, a conference privileged user
can define the time after which new users are not allowed to join the
conference anymore. This is done by populating the
<must-join-before> element.
It is possible to define the time when users or resources on the
dial-out list and on the refer-list are requested to join the
conference by using the <request-users> element. It is also possible
to define that the users and resources on the dial-out list and the
Khartabil, et al. Expires March 10, 2005 [Page 8]
Internet-Draft CPCP September 2004
refer-list are requested to join the conference only after the first
a participant or key participant has joined. This is achieved with
the 'require-participant' attribute. A value of "none" indicates
that the focus sends the requests immediately after the specified
time has lapsed.
The absence of this conference time information indicates that a
conference starts immediately and terminates when the conference
policy is removed.
A running conference instance can be extended or stopped by modifying
the conference time information. Note that those conference times do
not guarantee resources for the conference to be available.
If a conference is in progress when deleted or stopped, the focus
issues signalling requests to terminate all conference related
sessions it has with participants. In SIP, the focus issues BYE
requests.
4.3.4 Conference Authorization Rules
One of the key components of conference policy is the set of
authorization rules that specify who is allowed to join a conference,
see floors and request/grant them, subscribe to
conference-information notifications and so on. The unordered list
of authorization rules together define the conference authorization
policy
The conference authorization rules are enclosed in the
<authorization-rules> element and are formatted according to the XML
schema defined in the common policy framework [1]. In the
<authorization-rules> element, there can be multiple rules, each rule
is represented by the <rule> element, each of which consist of three
parts: conditions, actions and transformations. Conditions determine
whether a particular rule applies to a request. Each action or
transformation in the applied rule is a positive grant of permission
to the conference participant. The details of each specific element
and attribute is described in [1].
Asking the focus to allow certain users to join the conference is
achieved by modifying an existing authorization rule or creating a
new one. The CPS then informs the focus of such change.
If the conference is long-lasting, it is possible that new rules are
added all the time but old rules are almost never removed (some of
them are overwritten, though). This leads easily to the situation
that the conference policy contains many unnecessary rules which are
not really needed anymore. Therefore, there is a need to delete
Khartabil, et al. Expires March 10, 2005 [Page 9]
Internet-Draft CPCP September 2004
rules. This can be achieved by removing that portion of the policy.
Conflicting rules may exist (for example, both allowed and blocked
action is defined for same target). The common policy directives [1]
dictate the behaviour in such situations.
This section outlines the new conditions, actions and transformations
for conference authorization policy.
4.3.4.1 Conditions
4.3.4.1.1 Validity
The <validity> element, as defined in the common policy framework
[1], expresses the rule validity period by two attributes, a starting
and a ending time. Times are expressed in XML dateTime format.
Expressing the lifetime of a rule implements a garbage collection
mechanism. A rule maker might not have always access to the
conference policy server to remove some rules which grant
permissions. Hence this mechanisms allows to remove or invalidate
granted permissions automatically without further interaction between
the rule maker and the conference policy server.
To give a real life example, there are often meetings where
management are allowed to join the first half of the conference and
engineers are only allowed to join the conference during the second
half of that meeting to report technical findings, etc. Two rules
can be set in this scenario, the first rules allows the managers to
join the conference without specifying a validity contraint. The
second rule allows engineers to join an hour into the conference.
The following example demostrates this. The meeting starts at 9:30
and ends at 12:30. The manager can join at any time while the
engineer cannot only join before 10:30 (Note that the example is
simplified for clarity).
Khartabil, et al. Expires March 10, 2005 [Page 10]
Internet-Draft CPCP September 2004
<rule id="1">
<conditions>
<identity>
<id>manager@example.com</id>
</identity>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
<rule id="2">
<conditions>
<validity>
<from>2004-12-17T10:30:00-05:00</from>
<to>2004-12-17T12:30:00-05:00</to>
</validity>
<identity>
<id>engineeer@example.com</id>
</identity>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
...
<time>
<occurrence>
<mixing-start-time required-participant="participant">
2004-12-17T09:30:00-05:00</mixing-start-time>
<mixing-stop-time required-participant="none">
2004-12-17T12:30:00-05:00</mixing-stop-time>
</occurrence>
</time>
4.3.4.1.2 Identity
The <identity> element is already defined in the common policy
framework [1]The presence of the <identity> element is a condition
requires any identity within it to be authenticated before a rule is
applied to it. This includes the <id> element (Section 4.3.4.1.2.1),
the <any> element (Section 4.3.4.1.2.2), the <external-list> element
(Section 4.3.4.1.2.4), their exceptions, and any future extension
that carries an identity. The absence of the <identity> element with
in a condition indicated that the rule applies to all unauthenticated
Khartabil, et al. Expires March 10, 2005 [Page 11]
Internet-Draft CPCP September 2004
identities. That is participants that have provided no authenticated
identity to the conference focus.
4.3.4.1.2.1 Interpreting the <id> Element
As earlier indicated, the <identity> element is already defined in
the common policy framework [1]. However, the rules for interpreting
the identities in <id> elements are left for each application to
define separately. This document, however, does not define the rules
for interpreting identities in <id> elements in conferencing
applications since those interpretation rules are signalling protocol
specific.
OPEN ISSUE: Do we need to state more than this? How are identities
derived from users that join using POTS, H.323, etc.?
4.3.4.1.2.2 Matching Any Identity
The <any> element is used to match any participant. This allows a
conference to be open to any authenticated user. Just as for the
<domain> element in <identity> element, The <any> element contains a
list of <except> elements and allows to implement a simple blacklist
mechanism. The <except> element contains the identity. It differs
from the <domain> element in that the domain part is needed in the
identity since it has not domain to refer to.
4.3.4.1.2.3 Matching Pseudonymous Identities
The <pseudonymous> element is used to match participants that have
provided an authenticated identity to the conference focus, but have
requested pseudonymity in the conference itself. A user requests
pseudonymity by authenticating himself to the conference focus and
providing an pseudonym in the signalling protocol (for example, using
the From-header of a SIP reqeust). A rule allowing pseudonymous
users to join looks like the following:
<rule id="4">
<conditions>
<pseudonymous>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
Khartabil, et al. Expires March 10, 2005 [Page 12]
Internet-Draft CPCP September 2004
The <pseudonymous> element can be combined with the <identity>
element to provide the focus with a rule on what to do when a
specific identity is authenticated and that identity is requesting
pseudonymity through the signalling protocol. An example of such a
rule follows:
<rule id="4">
<conditions>
<identity>
<id>alice@example.com</id>
</identity>
<pseudonymous>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
4.3.4.1.2.4 Matching Identities in External Lists
The <external-list> element can be used to match those participants
that are part of a resource list that is created externally. Section
5.2 talks about the use of this condition in more detail.
4.3.4.1.2.5 Matching Referred Identities
The <has-been-referred> element can be used to match those
participants that the focus has referred to the conference.
4.3.4.1.2.6 Matching Invited Identities
The <has-been-invited> element can be used to match those
participants that the focus has invited into the conference.
4.3.4.1.2.7 Matching Identities of Former Conference Participants
The <has-been-in-conference> element can be used to match those
participants that have joined the conference in the past.
4.3.4.1.2.8 Matching Identities Currently in the Conference
The <is-in-conference> element can be used to match those
participants that are currently participating in the conference.
Khartabil, et al. Expires March 10, 2005 [Page 13]
Internet-Draft CPCP September 2004
4.3.4.1.2.9 Matching Key Participant Identities
The <key-participant> element can be used to match those participants
that are key participants of a conference.
4.3.4.1.2.10 Matching Identities on the Dial-out List
The <is-on-dialout-list> element can be used to match those
participants that are on the dial-out list.
4.3.4.1.2.11 Matching Identities on the Refer List
The <is-on-refer-list> element can be used to match those
participants that are on the refer list.
4.3.4.1.2.12 Floor ID
The <floor-id> element can be used to assign users as floor
moderators. It MUST be used in conjunction with the <id> element
that identifies the floor moderator. The <floor-id> element carries
the floor ID of the floor that the user is a moderator of. The
transformation <is-floor-moderator> is used to assert that the user
identified using the <id> condition is the floor moderator of the
floor identified in the <floor-id> condition.
The <floor-id> element is also used with the <floor-request-handling>
element (Section 4.3.4.2.6) to set rules on who is allowed to request
a floor.
4.3.4.1.2.13 Matching PIN Codes
The <pin> element can be used to match those participants that are
have knowledge on a PIN code for the conference. For example:
<rule id="1">
<conditions>
<pin>12345</pin>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
So the condition is the PIN. If any user knows the PIN, ignoring
Khartabil, et al. Expires March 10, 2005 [Page 14]
Internet-Draft CPCP September 2004
their identity, the user is allowed to join.
A combination of the <identity> condition and the <pin> condition
creates the possibility of assigning users personal PIN codes to
enable them to join a conference. For example:
<rule id="2">
<conditions>
<identity>
<id>358401234567</id>
</identity>
<pin>67890</pin>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
4.3.4.1.2.14 Matching Passwords
The <password> element can be used to match those participants that
are have knowledge on a password for the conference. For example:
<rule id="3">
<conditions>
<password>pass1</password>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
So the condition is the password. If any user knows the password,
ignoring their identity, the user is allowed to join.
A combination of the <identity> condition and the <password>
condition creates the possibility of assigning users personal
passwords to enable them to join a conference. For example:
Khartabil, et al. Expires March 10, 2005 [Page 15]
Internet-Draft CPCP September 2004
<rule id="4">
<conditions>
<identity>
<id>alice@example.com</id>
</identity>
<password>pass2</password>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
4.3.4.2 Actions
4.3.4.2.1 Conference State Events
The <allow-conference-state> element represents a boolean action. If
set to TRUE, the focus is instructed to allow the subscription to
conference state events, such as the SIP Event Package for Conference
State [14]. If set to FALSE, the subscription to conference state
events would be rejected.
If this element is undefined it has a value of TRUE, causing the
subscription to conference state events to be accepted.
4.3.4.2.2 Floor Control Events
The <allow-floor-events> element represents a boolean action. If set
to TRUE, the focus is instructed to accept the subscription to floor
control events. If set to FALSE, the focus is instructed to reject
the subscription.
If this element is undefined, it has a value of FALSE, causing the
subscription to floor control events to be rejected.
4.3.4.2.3 Conference Join Handling
The <join-handling> element defines the actions used by the
conference focus to control conference participation. This element
defines the action that the focus is to take when processing a
particular request to join a conference. This element is an
enumerated integer type, with defined values of:
Khartabil, et al. Expires March 10, 2005 [Page 16]
Internet-Draft CPCP September 2004
block: This action instructs the focus to deny access to the
conference. This action has a value of zero and it is the lowest
value of the <join-handling> element. This action is the default
action taken in the absence of any other actions.
confirm: This action instructs the focus to place the participant on
a pending list (e.g., by parking the call on a music-on-hold
server), awaiting moderator input for further actions. This
action has a value of one.
allow: This action instructs the focus to accept the conference join
request and grant access to the conference within the instructions
specified in the transformations of this rule. This action has a
value of two.
Note that placing a value of block for this element doesn't guarantee
that a participant is blocked from joining the conference. Any other
rule that might evaluate to true for this participant that carried an
action whose value was higher than block would automatically grant
confirm/allow permission to that participant.
4.3.4.2.4 Dynamically Referring Users
The <allow-refer-users-dynamically> element represents a boolean
action. If set to TRUE, the identity is allowed to instruct the
focus to refer a user to the conference without modifying the
refer-list (in SIP terms, the identity is allowed to send a REFER
request to the focus which results in the focus sending a REFER
request to the user the referrer wishes to join the conference). If
set to FALSE, the refer request is rejected.
If this element is undefined it has a value of FALSE, causing the
refer to be rejected.
4.3.4.2.5 Dynamically Inviting Users
The <allow-invite-users-dynamically> element represents a boolean
action. If set to TRUE, the identity is allowed to instruct the
focus to invite a user to the conference without modifying the
dial-out list (in SIP terms, the identity is allowed to send a REFER
request to the focus which results in the focus sending an INVITE
requested to the user the referrer wishes to join the conference).
If set to FALSE, the refer request is rejected.
If this element is undefined it has a value of FALSE, causing the
refer to be rejected.
Khartabil, et al. Expires March 10, 2005 [Page 17]
Internet-Draft CPCP September 2004
4.3.4.2.6 Floor Request Handling
The <floor-request-handling> element defines the actions used by the
conference focus to control floor requests. This element defines the
action that the focus is to take when processing a particular request
to a floor within a conference. This element is an enumerated
integer type, with defined values of:
block: This action instructs the focus to deny the floor request.
This action has a value of zero and it is the lowest value of the
<floor-request-handling> element. This action is the default
action taken in the absence of any other actions.
confirm: This action instructs the focus to allow the request. The
focus then uses the defined floor algorithm to further allow of
deny the floor. The algorithms used are outside the scope of this
document.
Note that placing a value of block for this element doesn't guarantee
that a participant is blocked from joining the conference. Any other
rule that might evaluate to true for this participant that carried an
action whose value was higher than block would automatically grant
confirm/allow permission to that participant.
4.3.4.3 Transformations
4.3.4.3.1 Key Participant
When the <is-key-participant> element is set to TRUE, the joining
participant is denoted as a key participant. If set to FALSE, the
participant is not denoted as a key participant.
If this element is undefined, it has a value of FALSE, causing no key
participant status to be given to the participant.
4.3.4.3.2 Floor Moderator
When the <is-floor-moderator> element is set to TRUE, the joining
conference participant is denoted as floor moderator, meaning that
they are privileged to control the floor in the conference. If set
to FALSE, floor moderator privileges are not given to the conference
participant.
If this element is undefined, it has a value of FALSE, causing no
floor moderator privileges to being granted.
Khartabil, et al. Expires March 10, 2005 [Page 18]
Internet-Draft CPCP September 2004
4.3.4.3.3 Conference Information
The <show-conference-info> element is of type boolean transformation.
If set to TRUE, conference information is shown to the conference
participant. If set to FALSE, conference information is not shown to
the participant.
The <show-conference-info> element controls whether information in
the <settings>, <time> and <info> elements may be made available
publicly. For example, an application at a conference server might
list the ongoing conferences on web page, or it may allow searching
for conferences based on the keywords listed in the <Conference-info>
element. Not setting this transformation to any users instructs the
application not to reveal any such information to any user. However,
information in other elements, such as <dialout-list>, should not be
seen by anyone else other than a privileged user, even with this
transformation enabled for a user.
If this element is undefined, it has a value of FALSE, causing no
conference information to being shown.
4.3.4.3.4 Floor Holder
The <show-floor-holder> element is of type boolean transformation.
If set to TRUE, the conference participant is able to see who is
currently holding the floor. If set to FALSE, the participant is not
able to see the floor holder.
If this element is undefined, it has a value of FALSE, causing the
floor holder not be shown to the participant.
4.3.4.3.5 Floor Requests
The <show-floor-requests> element is of type boolean transformation.
If set to TRUE, the conference participant is able to see the floor
requests. If set to FALSE, the conference participant is not able to
see floor requests.
If this element is undefined, it has a value of FALSE, causing the
floor requests to not being seen by the conference participant.
4.3.4.3.6 Providing anonymity
A rule can be set that provides anonymity to a specific identity. In
this case, the focus provides to the rest of the participants an
anonymous identity for that user, for example anonymous1. This can
be achieved by using the <provide-anonymity> element. It is a
boolean transformation. If set to TRUE, the conference participants
Khartabil, et al. Expires March 10, 2005 [Page 19]
Internet-Draft CPCP September 2004
will see an anonymous identity for the user whose identity is present
in the conditions. An example of such rule follows:
<rule id="4">
<conditions>
<identity>
<id>alice@example.com</id>
</identity>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations>
<provide-anonymity>
</transformation>
</rule>
If this element is undefined, it has a value of FALSE, causing the
identity to be revealed.
4.3.5 Conference Dial-Out List
The dial-out list (DL) is a list of user URIs that the focus uses to
learn who to invite to join a conference. This list can be created
at conference policy creation time or updated during the conference
lifetime so it can be used for mid-conference invites (and
mass-invites) as well.
Asking the focus to invite (add) a user into the conference is
achieved by adding that user's URI to the Dial-Out List (DL). The
CPS then triggers the focus to send the conference invitation, eg:
SIP INVITE as needed. Similarly, a user can be removed from the
Dial-out list by removing the URI from the dial-out list.
The <dialout-list> element is optional and includes zero or more
<target> elements and zero or more <external> elements. Those two
elements includes the mandatory 'uri' attribute. The use of the
<external> element is described in more detail in Section 5.2
4.3.6 Conference Refer List
The Refer List (RL) contains a list of resources that the focus needs
to refer to the conference. In SIP, this is achieved by the focus
sending a REFER request to those potential participants. This list
can be updated during the conference lifetime so it can be used for
Khartabil, et al. Expires March 10, 2005 [Page 20]
Internet-Draft CPCP September 2004
mid-conference refers as well.
The Refer List differs from the Dial-out list in that the dial-out
list contains a list of resources that the focus will initiate a
session with. The resources on the refer list, on the other had, are
expected to initiate the session establishment towards the focus
themselves. It is also envisioned that difference users will have
different access rights to those lists and therefore a separation
between the two is needed.
The <refer-list> element is optional and identical to the
<dialout-list> element in Section 4.3.5.
4.3.7 Conference Media Streams
Media policy is an integral part of the conference policy. It
defines e.g. what kind of media topologies exist in the conference.
Media policy is documented in [20].This document does not define
media policy, but instead enables the user to specify the media
streams a conference has. This is used by the focus to know what
media streams to invite users with and what media streams it should
accept from dialling in users. Media can be added to or removed from
a conference by a privileged user before or during a conference
occurance. This might result in the focus modifying the session it
has with each participant. In SIP, this means re-issuing and INVITE
request modifying the session description (SDP).
The definition starts with the optional <media-streams> element.
This element lists the media streams allowed for this conference. It
can contain at most one of each media type using the <video>,
<audio>, <message> and <text> elements.
4.4 XML Schema Extensibility
The schema as be extended at multiple places:
o The <conference> element to enable more conference policy
information to be added
o The <settings> element to allow for future conference settings to
be defined
o The <info> element to allow further conference and host
information to be conveyed
o The <occurrence> element to allow further conference timing
information
Khartabil, et al. Expires March 10, 2005 [Page 21]
Internet-Draft CPCP September 2004
o The <target> element and the <external> element in <dialout-list>
and <refer-list> to allow extensions on the behaviour of the
focus. For example, how many times to retry inviting a user
o The <media-streams> element to allow introduction of new media
streams
o The <sidebar> element to allow introduction of new sidebar
information
4.5 XML Schema
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema targetNamespace="urn:ietf:params:xml:ns:conference-policy" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="urn:ietf:params:xml:ns:conference-policy" elementFormDefault="qualified">
<!-- This import brings in the XML language attribute xml:lang-->
<xs:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="http://www.w3.org/2001/xml.xsd"/>
<!-- The root Conference Element -->
<xs:element name="conference">
<xs:complexType>
<xs:sequence>
<xs:element name="settings" type="ConferenceSettings"/>
<xs:element name="info" type="ConferenceInfo" minOccurs="0"/>
<xs:element name="time" type="ConferenceTime" minOccurs="0"/>
<xs:element name="authorization-rules" type="ConferenceAuthorizationRules" minOccurs="0"/>
<xs:element name="dailout-list" type="UserList" minOccurs="0"/>
<xs:element name="refer-list" type="UserList" minOccurs="0"/>
<xs:element name="media-streams" type="ConferenceMediaStreams" minOccurs="0"/>
<xs:any namespace="##other" processContents="lax" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- Conference Settings -->
<xs:complexType name="ConferenceSettings">
<xs:sequence>
<xs:element name="conference-uri" type="xs:anyURI" maxOccurs="unbounded"/>
<xs:element name="max-participant-count" type="xs:nonNegativeInteger" minOccurs="0"/>
<xs:element name="security-level" type="SecurityLevel" default="medium" minOccurs="0"/>
<xs:element name="allow-sidebars" type="xs:boolean" default="true" minOccurs="0"/>
<xs:element name="sidebar" type="Sidebar" minOccurs="0" maxOccurs="unbounded"/>
<xs:any namespace="##other" processContents="lax" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<!-- Conference Info -->
<xs:complexType name="ConferenceInfo">
<xs:sequence>
<xs:element name="subject" type="xs:string" minOccurs="0"/>
Khartabil, et al. Expires March 10, 2005 [Page 22]
Internet-Draft CPCP September 2004
<xs:element name="display-name" type="xs:string" minOccurs="0"/>
<xs:element name="free-text" type="xs:string" minOccurs="0"/>
<xs:element name="keywords" minOccurs="0">
<xs:simpleType>
<xs:list itemType="xs:string"/>
</xs:simpleType>
</xs:element>
<xs:element name="web-page" type="xs:anyURI" minOccurs="0"/>
<xs:element name="host-info" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="uri" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="e-mail" type="xs:anyURI" minOccurs="0"/>
<xs:element name="web-page" type="xs:anyURI" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:any namespace="##other" processContents="lax" minOccurs="0"/>
</xs:sequence>
<xs:attribute ref="xml:lang"/>
</xs:complexType>
<!-- Conference time -->
<xs:complexType name="ConferenceTime">
<xs:sequence>
<xs:element name="occurrence" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="mixing-start-time" type="StartStopTime" minOccurs="0"/>
<xs:element name="mixing-stop-time" type="StartStopTime" minOccurs="0"/>
<xs:element name="can-join-after" type="xs:dateTime" minOccurs="0"/>
<xs:element name="must-join-before" type="xs:dateTime" minOccurs="0"/>
<xs:element name="request-users" type="StartStopTime" minOccurs="0"/>
<xs:any namespace="##other" processContents="lax" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<!-- Conferenece Authorisation -->
<xs:complexType name="ConferenceAuthorizationRules">
<xs:sequence>
<xs:element name="rule" type="ruleType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ruleType">
<xs:sequence>
<xs:element name="conditions" minOccurs="0">
<xs:complexType>
Khartabil, et al. Expires March 10, 2005 [Page 23]
Internet-Draft CPCP September 2004
<xs:sequence>
<xs:element ref="condition" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="actions" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element ref="action" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="transformations" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element ref="transformation" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required"/>
</xs:complexType>
<xs:element name="condition" abstract="true"/>
<xs:element name="action" abstract="true"/>
<xs:element name="transformation" abstract="true"/>
<xs:element name="validity" substitutionGroup="condition">
<xs:complexType>
<xs:all>
<xs:element name="from" type="xs:dateTime"/>
<xs:element name="to" type="xs:dateTime"/>
</xs:all>
</xs:complexType>
</xs:element>
<xs:element name="identity" substitutionGroup="condition">
<xs:complexType>
<xs:choice>
<xs:element name="id" type="xs:string" maxOccurs="unbounded"/>
<xs:sequence>
<xs:element name="domain" type="xs:string"/>
<xs:sequence minOccurs="0">
<xs:element name="except" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:sequence>
<xs:sequence>
<xs:element name="any" type="xs:string"/>
<xs:sequence minOccurs="0">
<xs:element name="except" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
Khartabil, et al. Expires March 10, 2005 [Page 24]
Internet-Draft CPCP September 2004
</xs:sequence>
<xs:sequence>
<xs:element name="external-list" type="xs:string"/>
<xs:sequence minOccurs="0">
<xs:element name="except" type="xs:string" maxOccurs="unbounded"/>
</xs:sequence>
</xs:sequence>
</xs:choice>
</xs:complexType>
</xs:element>
<xs:element name="pseudonymous" type="xs:string" substitutionGroup="condition"/>
<xs:element name="has-been-referred" type="xs:string" substitutionGroup="condition"/>
<xs:element name="has-been-invited" type="xs:string" substitutionGroup="condition"/>
<xs:element name="has-been-in-conference" type="xs:string" substitutionGroup="condition"/>
<xs:element name="is-in-conference" type="xs:string" substitutionGroup="condition"/>
<xs:element name="key-participant" type="xs:string" substitutionGroup="condition"/>
<xs:element name="is-on-dialout-list" type="xs:string" substitutionGroup="condition"/>
<xs:element name="is-on-refer-list" type="xs:string" substitutionGroup="condition"/>
<xs:element name="floor-id" type="xs:anyURI" substitutionGroup="condition"/>
<xs:element name="pin" type="xs:anyURI" substitutionGroup="condition"/>
<xs:element name="password" type="xs:anyURI" substitutionGroup="condition"/>
<xs:element name="allow-conference-state" type="xs:boolean" substitutionGroup="action"/>
<xs:element name="allow-floor-events" type="xs:boolean" substitutionGroup="action"/>
<xs:element name="join-handling" type="JoinHandling" substitutionGroup="action"/>
<xs:element name="allow-refer-users-dynamically" type="xs:boolean" substitutionGroup="action"/>
<xs:element name="allow-invite-users-dynamically" type="xs:boolean" substitutionGroup="action"/>
<xs:element name="floor-request-handling" type="xs:boolean" substitutionGroup="action"/>
<xs:element name="is-key-participant" type="xs:boolean" substitutionGroup="transformation"/>
<xs:element name="is-floor-moderator" type="xs:boolean" substitutionGroup="transformation"/>
<xs:element name="show-conference-info" type="xs:boolean" substitutionGroup="transformation"/>
<xs:element name="show-floor-holder" type="xs:boolean" substitutionGroup="transformation"/>
<xs:element name="show-floor-requests" type="xs:boolean" substitutionGroup="transformation"/>
<xs:element name="provide-anonymity" type="xs:boolean" substitutionGroup="transformation"/>
<!-- User List -->
<xs:complexType name="UserList">
<xs:sequence>
<xs:element name="target" type="Target" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="external" type="Target" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Conference Media Streams -->
<xs:complexType name="ConferenceMediaStreams">
<xs:sequence>
<xs:element name="video" type="xs:string" minOccurs="0"/>
<xs:element name="audio" type="xs:string" minOccurs="0"/>
<xs:element name="message" type="xs:string" minOccurs="0"/>
<xs:element name="text" type="xs:string" minOccurs="0"/>
<xs:any namespace="##other" processContents="lax" minOccurs="0"/>
Khartabil, et al. Expires March 10, 2005 [Page 25]
Internet-Draft CPCP September 2004
</xs:sequence>
</xs:complexType>
<!-- Target -->
<xs:complexType name="Target">
<xs:sequence>
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="uri" type="xs:anyURI" use="required"/>
</xs:complexType>
<!-- Start/Stop time -->
<xs:complexType name="StartStopTime">
<xs:simpleContent>
<xs:extension base="xs:dateTime">
<xs:attribute name="required-participant" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="key-participant"/>
<xs:enumeration value="participant"/>
<xs:enumeration value="none"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<!-- Security Level -->
<xs:simpleType name="SecurityLevel">
<xs:restriction base="xs:string">
<xs:enumeration value="none"/>
<xs:enumeration value="low"/>
<xs:enumeration value="medium"/>
<xs:enumeration value="high"/>
</xs:restriction>
</xs:simpleType>
<!-- Join Handling -->
<xs:simpleType name="JoinHandling">
<xs:restriction base="xs:string">
<xs:enumeration value="block"/>
<xs:enumeration value="allow"/>
<xs:enumeration value="confirm"/>
</xs:restriction>
</xs:simpleType>
<!-- Sidebar -->
<xs:complexType name="Sidebar">
<xs:sequence>
<xs:element name="uri" type="xs:anyURI" maxOccurs="unbounded"/>
<xs:element name="policy" type="xs:anyURI" minOccurs="0"/>
<xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
Khartabil, et al. Expires March 10, 2005 [Page 26]
Internet-Draft CPCP September 2004
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required"/>
</xs:complexType>
</xs:schema>
5. Conference Policy Manipulation and Conference Entity Behaviour
5.1 Overview of Operation
This document assumes that the user knows the location of conference
policy serve, the details of that discovery are beyond the scope of
this document.
CPCP allows clients to manipulate the conference policy at the
conference policy server (CPS). CPS is able to inform the focus
about changes in conference policy, if necessary. For example, if
new users are added to the dial-out list, then conference policy
server informs the focus which makes the invitations as requested.
Some assumptions about the conferencing architecture are made.
Clients always connect to the conference policy server (CPS) when
they perform manipulation operations. It is assumed that the CPS
informs other conferencing entities, such as focus, the floor control
server and the mixer directly or via the focus. For example, if user
A wants to expel user B from an ongoing conference, user A must first
manipulate the conference policy data. The CPS then communicates
that change to the focus to perform the operation.
User privileges are defined in [19]
5.2 Use of External Lists
External lists MAY be used in a conference policy. They can be used
in the dial-out list, the refer-list and the authorization policy.
An external list is a list of resources created by means outside the
scope of this document.
A privileged user of the conference policy uses an external list by
placing its URI in an conference policy element that is dedicated to
carrying external list URIs. The external list URI is the URI used
to manipulate the list and not the URI used to signal to the list.
There are three such elements documented in this memo: the
<external-list> element in the authorization rules (Section
4.3.4.1.2.4) and the <external> element in both, the dialout list
(Section 4.3.5) and the refer list (Section 4.3.6). At the time the
focus needs to activate the policy surrounding the URI, the focus
fetches the URIs for the members of the external list using the list
Khartabil, et al. Expires March 10, 2005 [Page 27]
Internet-Draft CPCP September 2004
URI. For example, a conference creator creates a conference and
places the URI of an external list in the dial-out list. At some
point, the focus needs to invite using on the dial-out list to join
the conference. It is at that moment that the focus retrieves the
members of the external list. It then sends INVITE (in SIP terms) to
the members of that external list. This results in all participants
connected to one focus.
It can happen that the external list is not accessible at the time
the focus requires it. In this case, the external list is ignored,
and in the case of an authorization rule, that rule fails.
There are also cases where the external list has been manipulated.
It is outside the scope of this document how the focus can learn of
such manipulation. But if is does, it reacts in a similar manner as
it would have if the list was local and has been modified.
If an external list contains a reference to yet another list, that
referenced list is also fetched if the focus has not already done so.
This is to avoid list loops.
5.3 Communication Between Conference Entities
The communication between different (logical) conferencing elements
is beyond the scope of this document. It can be expected that in
most cases CPS includes also those logical functions.
5.4 Manipulating Participant Lists
A user with sufficient privileges is allowed to perform user
management operations, such as adding a new user to the conference or
expelling a user from the conference. These operations are performed
by modifying the conference policy at the conference policy server.
After authorising the user to do such manipulations, the conference
policy server communicates the change to the focus. The focus reacts
by performing singlling operations such as sending SIP INVITE, BYE or
REFER.
5.4.1 Expelling a Participant
Expelling a user is performed by a privileged user creating or
manipulating an existing authorization rule and setting that user's
<join-handling> action to "block>. The focus reacts by terminating
the session with that participant, such as a sending SIP BYE request.
Care must be taken since if one rules allows a user to join and one
blocks a user from joining, the result in that the user is allowed to
join. For example, Bob can join a conference since an authorization
Khartabil, et al. Expires March 10, 2005 [Page 28]
Internet-Draft CPCP September 2004
rule has been defined to allow everyone at example.com:
<rule id="1">
<conditions>
<identity>
<domain>example.com</domain>
</identity>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
Setting the following rule will not block Bob from joining nor will
it expel him since the above rule overrides it:
<rule id="2">
<conditions>
<identity>
<uri>bob@example.com</uri>
</identity>
</conditions>
<actions>
<join-handling>block</join-handling>
</actions>
<transformations/>
</rule>
So, in order to expel Bob, the original rule has to be modified using
the <except> element:
Khartabil, et al. Expires March 10, 2005 [Page 29]
Internet-Draft CPCP September 2004
<rule id="1">
<conditions>
<identity>
<domain>example.com</domain>
<except>bob@domain.com</except>
</identity>
</conditions>
<actions>
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
5.5 Re-joining a Conference
Participants can drop out of a conference for many reasons including:
client crash, out of coverage, had to leave for a while. It might be
of interest to enable that user to re-join the conference. To allow
that, participants that have departed the conference gracefully can
only re-join if a privileged user has added an authorization rule
allowing them to join. Participants that have departed the
conference ungracefully (eg: crash) require a special behaviour from
the focus . The focus is aware when a user has not gracefully
departed a conference (for example; it did not receive a SIP BYE
request and media is no longer being received). If this is the case,
the focus is required to re-issue the invitation or referral to that
user after a pre-configured unit of time.
6. Examples
6.1 A Simple Conference Policy Document
The simplist of a conference policy document contains the conference
URI, a dial-out list, and the media. An example looks like
this:
Khartabil, et al. Expires March 10, 2005 [Page 30]
Internet-Draft CPCP September 2004
<?xml version="1.0" encoding="UTF-8"?>
<conference xmlns="urn:ietf:params:xml:ns:conference-policy" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<settings>
<conference-uri>sip:myconference@example.com</conference-uri>
</settings>
<dailout-list>
<target uri="sip:bob@example.com"/>
<target uri="sip:alice@example.com"/>
<target uri="sip:john@example.com"/>
<target uri="sip:robert@example.com"/>
</dailout-list>
<media-streams>
<audio/>
</media-streams>
</conference>
6.2 A Complex Conference Policy Document
Alice creates a conference with the follows policy:
o Conference URIs are suggested to be sip:myconference@example.com
and tel:+3581234567.
o Maximum number of participants in the conference is 10.
o The security level for the conference is medium.
o The conference allows sidebars
o Media mixing starts at the latter of 9:30 am and the first
participant arrives
o Media mixing sends at 12:30 pm. The conference does not need a
key participant to continue.
o Users can join 5 minutes before media mixing starts and cannot
join half an hour before media mixing ends.
o Users are requested to join a conference (invited and referred) 5
minutes before the conference starts and no participant nor
key-participant is needed for this action to take place.
o Everyone at the domain example.com is allowed to join and can
subscribe to the conference state event package.
o Alice is a key participant
Khartabil, et al. Expires March 10, 2005 [Page 31]
Internet-Draft CPCP September 2004
o Alice will be invited to join the conference while Sarah will be
referred to the conference.
o Two media are made available in the conference:audio and video.
The resulting CPCP document looks like
<?xml version="1.0" encoding="UTF-8"?>
<conference xmlns="urn:ietf:params:xml:ns:conference-policy" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<settings>
<conference-uri>sip:myconference@example.com</conference-uri>
<max-participant-count>10</max-participant-count>
<allow-sidebars>true</allow-sidebars>
</settings>
<info xml:lang="en-us">
<subject>What's happening tonight</subject>
<display-name>Party Goer's</display-name>
<free-text>John and Peter will join the conference soon</free-text>
<keywords>party nightclub beer</keywords>
<host-info>
<uri>sip:Alice@example.com</uri>
<uri>tel:+3581234567</uri>
<e-mail>mailto:Alice@example.com</e-mail>
<web-page>http://www.example.com/users/Alice</web-page>
</host-info>
</info>
<time>
<occurrence>
<mixing-start-time required-participant="participant">2004-12-17T09:30:00-05:00</mixing-start-time>
<mixing-stop-time required-participant="none">2004-12-17T12:30:00-05:00</mixing-stop-time>
<can-join-after>2001-12-17T09:25:00-05:00</can-join-after>
<must-join-before>2004-12-17T12:00:00-05:00</must-join-before>
<request-users required-participant="none">2001-12-17T09:30:00-05:00</request-users>
</occurrence>
</time>
<authorization-rules>
<rule id="1">
<conditions>
<identity>
<domain>example.com</domain>
</identity>
</conditions>
<actions>
<allow-conference-state>true</allow-conference-state>
Khartabil, et al. Expires March 10, 2005 [Page 32]
Internet-Draft CPCP September 2004
<join-handling>allow</join-handling>
</actions>
<transformations/>
</rule>
<rule id="2">
<conditions>
<identity>
<id>alice@example.com</id>
</identity>
</conditions>
<actions/>
<transformations>
<is-key-participant>true</is-key-participant>
</transformations>
</rule>
</authorization-rules>
<dailout-list>
<target uri="sip:bob@example.com"/>
</dailout-list>
<refer-list>
<target uri="sip:sarah@example.com"/>
</refer-list>
<media-streams>
<video/>
<audio/>
</media-streams>
</conference>
7. Security Considerations
A conference document may contain information that is highly
sensitive. Its delivery to the conference server needs to happen
strictly, paying special attention to integrity and confidentiality.
Reading the document is also a security concern since the conference
policy contains sensitive information like the topic of the
conference, who is allowed to join and the URIs of the users that can
participate.
Manipulations of the conference policy have similar security issues.
Users with relevant privileges can manipulate parts of the conference
policy giving themselves and others privileges to manipulate the
conference policy, including the dial-out list and the security level
settings for a conference. This can happen because the conference
policy itself carries the identities and the authorization rules that
apply to those identities. Those authorization rules carry the
privileges that certain identities have. If an unauthorized user
gets access to this document (pretending to be someone else), s/he
Khartabil, et al. Expires March 10, 2005 [Page 33]
Internet-Draft CPCP September 2004
can manipulate those rules giving himself and other unauthorized
users access to the conference policy. S/he can also manipulate
other parts of the conference policy under a false identity. Some of
the things that a malicious user can do include: denying users
certain privileges, giving himself floor moderation, removing users
from lists, removing rules for certain identities, giving privileges
to other malicious users, changing the media streams and changing
conference time. Therefore, it is very important that only
authorized clients are able to manipulate the conference policy. Any
conference policy transport protocol MUST provide authentication,
confidentiality and integrity.
In the case that XCAP is used to create and manipulate a conference
policy, the XCAP base specification mandates that all XCAP servers
MUST implement HTTP Authentication: Basic and Digest Access
Authentication [16]. Furthermore, XCAP servers MUST implement HTTP
over TLS [17]. It is recommended that administrators of XCAP servers
use an HTTPS URI as the XCAP root services URI, so that the digest
client authentication occurs over TLS. By using these means, XCAP
client and server can ensure the confidentiality and integrity of the
XCAP created conference policy document and its manipulation
operations, and that only authorized clients are allowed to perform
them.
8. IANA Considerations
8.1 XCAP Application Usage ID
This section registers a new XCAP Application Usage ID (AUID)
according to the IANA procedures defined in..
Name of the AUID: conference-policy
Description: Conference policy application manipulates conference
policy at a server.
8.2 application/conference-policy+xml MIME TYPE
MIME media type: application
MIME subtype name: conference-policy+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].
Khartabil, et al. Expires March 10, 2005 [Page 34]
Internet-Draft CPCP September 2004
Security considerations: See section 10 of RFC 3023 [7] and section
Section 8 of this document.
Interoperability considerations: none.
Published specification: This document.
Applications which use this media type: This document type has been
used to support conference policy manipulation for SIP based
conferencing.
Additional information:
Magic number: None
File extension: .cl or .xml
Macintosh file type code: "TEXT"
Personal and email address for further information: Petri Koskelainen
(petri.koskelainen@nokia.com)
Intended Usage: COMMON
Author/change controller: The IETF
8.3 URN Sub-Namespace Registration for
urn:ietf:params:xml:ns:conference-policy
This section registers a new XML namespace, as per guidelines in URN
document [15].
URI: The URI for this namespace is
urn:ietf:params:xml:ns:conference-policy.
Registrant Contact: IETF, XCON working group, Petri Koskelainen
(petri.koskelainen@nokia.com)
XML:
Khartabil, et al. Expires March 10, 2005 [Page 35]
Internet-Draft CPCP September 2004
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>Conference Policy Namespace</title>
</head>
<body>
<h1>Namespace for Conference Policy</h1>
<h2>application/conference-policy+xml</h2>
<p>See <a href="[[[URL of published RFC]]]">RFCXXXX</a>.</p>
</body>
</html>
END
9. Contributors
Jose Costa-Requena
Simo Veikkolainen
Teemu Jalava
10. Acknowledgements
The authors would like to thank Markus Isomaki, Adam Roach, Eunsook
Kim, Roni Evan, Alan Johnston, Hannes Tschofenig and the IETF XCON
working group for their feedback and suggestions.
11. References
11.1 Normative References
[1] Schulzrinne, H., Tschofenig, H., Cuellar, J., Polk, J. and J.
Rosenberg, "Common Policy", Internet-Draft
I-D.ietf-geopriv-common-policy, February 2004.
[2] Bradner, S., "Key words for use in RFCs to Indicate Requirement
Levels", RFC 2119, BCD 14, March 1997.
[3] Moats, R., "URN Syntax", RFC 2141, May 1997.
[4] Moats, R., "A URN Namespace for IETF Documents", RFC 2648,
Khartabil, et al. Expires March 10, 2005 [Page 36]
Internet-Draft CPCP September 2004
August 1999.
[5] Rosenberg, J., Shulzrinne, H., Camarillo, G., Johnston, A.,
Peterson, J., Sparks, R., Handley, M. and E. Schooler, "SIP:
Session Initiation Protocol", RFC 3261, June 2002.
[6] Bray, T., Paoli, J., Sperberg-McQueen, C. and E. Maler,
"Extensible Markup Language (XML) 1.0 (Second Edition)", W3C
REC REC-xml-20001006, October 2000.
[7] Murata, M., Laurent, S. and D. Kohn, "XML Media Types", RFC
3023, January 2001.
[8] Koskelainen, P. and H. Khartabil, "Requirements for conference
policy control protocol", draft-ietf-xcon-cpcp-req-01 (work in
progress), January 2004.
[9] Johnston, A. and O. Levin, "Session Initiation Protocol Call
Control - Conferencing for User Agents",
draft-ietf-sipping-cc-conferencing-03 (work in progress),
February 2004.
[10] Rosenberg, J., "The Extensible Markup Language (XML)
Configuration Access Protocol (XCAP)",
draft-ietf-simple-xcap-02 (work in progress), February 2004.
[11] Rosenberg, J., "An Extensible Markup Language (XML)
Configuration Access Protocol (XCAP) Usage for Presence Lists",
draft-ietf-simple-xcap-list-usage-02 (work in progress),
February 2004.
[12] Rosenberg, J., "A Session Initiation Protocol (SIP) Event
Package for Modification Events for the Extensible Markup
Language (XML) Configuration Access Protocol (XCAP) Managed
Documents", draft-ietf-simple-xcap-package-01 (work in
progress), February 2004.
[13] Rosenberg, J., "A Framework for Conferencing with the Session
Initiation Protocol",
draft-ietf-sipping-conferencing-framework-01 (work in
progress), October 2003.
[14] Rosenberg, J., Shulzrinne, H. and O. Levin, "A Session
Initiation Protocol (SIP) Event Package for Conference State",
draft-ietf-sipping-conference-package-03, February 2004.
[15] Mealling, M., "The IETF XML Registry", RFC 3688, January 2004.
Khartabil, et al. Expires March 10, 2005 [Page 37]
Internet-Draft CPCP September 2004
[16] Franks, J., "HTTP Authentication: Basic and Digest Access
Authentication", RFC 2617, June 1999.
[17] Rescorla, E., "HTTP Over TLS", RFC 2818, May 2000.
11.2 Informative References
[18] Rosen, B., "SIP Conferencing: Sub-conferences and Sidebars",
draft-rosen-xcon-conf-sidebars-00 (work in progress), July
2004.
[19] Khartabil, H. and A. Niemi, "Privileges for Manipulating a
Conference Policy",
draft-ietf-xcon-conference-policy-privileges-00 (work in
progress), September 2004.
[20] Jennings, C. and B. Rosen, "Media Mixer Control for XCON",
draft-jennings-xcon-media-control-00 (work in progress),
February 2004.
[21] Handly, M., Eriksson, G., Jacobson, V. and C. Perkins,
"Grouping of Media Lines in SDP", draft-ietf-mmusic-sdp-new-18
(work in progress), June 2004.
Authors' Addresses
Hisham Khartabil
Nokia
P.O. Box 321
Helsinki FIN-00045
Finland
EMail: hisham.khartabil@nokia.com
Petri Koskelainen
Nokia
P.O. Box 100 (Visiokatu 1)
Tampere FIN-33721
Finland
EMail: petri.koskelainen@nokia.com
Khartabil, et al. Expires March 10, 2005 [Page 38]
Internet-Draft CPCP September 2004
Aki Niemi
Nokia
P.O. Box 100
NOKIA GROUP, FIN 00045
Finland
Phone: +358 50 389 1644
EMail: aki.niemi@nokia.com
Khartabil, et al. Expires March 10, 2005 [Page 39]
Internet-Draft CPCP September 2004
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 (2004). 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.
Khartabil, et al. Expires March 10, 2005 [Page 40]
