SIPPING J. Rosenberg Internet-Draft dynamicsoft Expires:January 16,April 25, 2005 H. Schulzrinne Columbia University O. Levin, Ed. Microsoft CorporationJuly 18,October 25, 2004 A Session Initiation Protocol (SIP) Event Package for Conference Statedraft-ietf-sipping-conference-package-05draft-ietf-sipping-conference-package-06 Status of this Memo This document is an Internet-Draft and is subject to all provisions of section 3 of RFC 3667. By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she 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 athttp:// www.ietf.org/ietf/1id-abstracts.txt.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 onJanuary 16,April 25, 2005. 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 and optionally about changes in the state of additional conference components. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . .45 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . .56 3. Conference Event Package . . . . . . . . . . . . . . . . . . .67 3.1 Event Package Name . . . . . . . . . . . . . . . . . . . .67 3.2 SUBSCRIBE Bodies . . . . . . . . . . . . . . . . . . . . .67 3.3 Subscription Duration . . . . . . . . . . . . . . . . . .67 3.4 NOTIFY Bodies . . . . . . . . . . . . . . . . . . . . . .78 3.5 Notifier Processing of SUBSCRIBE Requests . . . . . . . .78 3.6 Notifier Generation of NOTIFY Requests . . . . . . . . . .78 3.7 Subscriber Processing of NOTIFY Requests . . . . . . . . .89 3.8 Handling of Forked Requests . . . . . . . . . . . . . . .89 3.9 Rate of Notifications . . . . . . . . . . . . . . . . . .89 3.10 State Agents . . . . . . . . . . . . . . . . . . . . . . .89 4. Conference DataFormatModel . . . . . . . . . . . . . . . . . . . .10 4.1 Conference Information11 5. Constructing Coherent State . . . . . . . . . . . . . . . . . 12 6. Conference Data . .10 4.1.1 User Element. . . . . . . . . . . . . . . . . . . . .10 4.1.1.1 User Attributes14 6.1 Conference Information . . . . . . . . . . . . . . . . .11 4.1.1.2 User Status Elements. 14 6.1.1 Conference Type . . . . . . . . . . . . . .12 4.1.1.3 Media Information. . . . . 14 6.1.1.1 conference-description of conference-description-type . . . . . . . . . . .13 4.1.1.3.1 Media Attributes14 6.1.1.2 host-info of host-type . . . . . . . . . . . . . . 14 6.1.1.3 conference-state of conference-state-type .13 4.1.1.3.2 Media Elements. . . 15 6.1.1.4 user of user-type . . . . . . . . . . . . .14 4.1.1.4 User Role. . . 15 6.1.1.5 sidebars-by-ref of uris-type . . . . . . . . . . . 15 6.1.1.6 sidebar-by-val of conference-type . . . . . .14 4.1.2 Sidebar Element. . 15 6.1.2 Conference Description Type . . . . . . . . . . . . . 15 6.1.2.1 display-text of string type . . . .15 4.1.3 Additional Conference Identifiers. . . . . . . 15 6.1.2.2 subject of string type . . . . . .15 4.1.4 Policy URIs. . . . . . . . 15 6.1.2.3 free-text of string type . . . . . . . . . . . . . 154.1.5 Recording6.1.2.4 keywords of keywords-type . . . . . . . . . . . . 16 6.1.2.5 web-page of anyURI type . . . . . . . . . . .15 4.1.6 Streaming. . 16 6.1.2.6 conf-uris of uris-type . . . . . . . . . . . . . . 16 6.1.2.7 service-uris of uris-type . . . . . . .16 4.2 Constructing Coherent State. . . . . 16 6.1.2.8 maximum-user-count of user-count-type . . . . . . 16 6.1.2.9 available-media of conference-medias-type . . . . 164.2.1 The Algorithm6.1.3 Host Type . . . . . . . . . . . . . . . . . . . .17 4.3 Schema. . 16 6.1.3.1 display-text of string type . . . . . . . . . . . 16 6.1.3.2 web-page of anyURI type . . . . . . . . . . . . .18 4.4 Example17 6.1.3.3 uris of uris-type . . . . . . . . . . . . . . . . 17 6.1.4 Conference State Type . . . . . . . . .21 5. Security Considerations. . . . . . . 17 6.1.4.1 user-count of user-count-type . . . . . . . . . . 17 6.1.4.2 security-level of security-level-type . .23 6. IANA Considerations. . . . 17 6.1.4.3 active of Boolean type . . . . . . . . . . . . . . 17 6.1.4.4 locked of Boolean type . . .24 6.1 conference Event Package Registration. . . . . . . . . .24 6.2 application/conference-info+xml MIME Registration. 17 6.1.4.5 recording of uris-type . . .24 6.3 URN Sub-Namespace Registration for urn:ietf:params:xml:ns:conference-info. . . . . . . . . .24 6.4 XML Schema Registration. 17 6.1.4.6 active-media of conference-medias-type . . . . . . 18 6.1.5 User Type . . . . . . . . . .25 7. Acknowledgements. . . . . . . . . . . . 18 6.1.5.1 display-text of string type . . . . . . . . . . .26 8. Changes History18 6.1.5.2 associated-aors of anyURI type . . . . . . . . . . 18 6.1.5.3 roles of user-roles-type . . . . . . . . . . . . .27 8.1 Changes since -0418 6.1.5.4 language of language type . . . . . . . . . . . . 19 6.1.5.5 cascaded-focus of anyURI type . . . . . . . .27 8.2 Changes since -03. . 19 6.1.5.6 endpoint of endpoint-type . . . . . . . . . . . . 19 6.1.6 Endpoint Type . . . . . .27 8.3 Changes since -02. . . . . . . . . . . . . . 19 6.1.6.1 display-text of string type . . . . . .27 8.4 Changes since -01. . . . . 20 6.1.6.2 referred of execution-type . . . . . . . . . . . . 20 6.1.6.3 state of endpoint-state-type . . .28 9. References. . . . . . . . 20 6.1.6.4 joining-method of joining-type . . . . . . . . . . 21 6.1.6.5 joining-info of execution-type . . . . . . . .29 9.1 Normative References. . 21 6.1.6.6 disconnection-method of disconnection-type . . . . 22 6.1.6.7 disconnection-info of disconnection-type . . . . . 22 6.1.6.8 whispering-to of uris-type . . . . . . . . .29 9.2 Informative References. . . 22 6.1.6.9 media of media-type . . . . . . . . . . . . . . . 22 6.1.7 Media Type .29 Authors' Addresses. . . . . . . . . . . . . . . . . . . . . 23 6.1.7.1 display-text of string type .30 Intellectual Property and Copyright Statements. . . . . . . .32 1. Introduction. . 23 6.1.7.2 proto of string type . . . . . . . . . . . . . . . 23 6.1.7.3 ssrc of string type . . . . . . . . . . . . . . . 23 6.1.7.4 label of string type . . . . . . . . . . . . . . . 24 6.1.7.5 state of media-state-type . . . . . . . . . . . . 24 6.1.7.6 snd-status of media-state-type . . . . . . . . . . 24 6.1.7.7 rcv-status state of media-state-type . . . . . . . 24 6.1.7.8 call of call-type . . . . . . . . . . . . . . . . 24 7. Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 8. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 8.1 Basic Example . . . . . . . . . . . . . . . . . . . . . . 33 8.2 Rich Example . . . . . . . . . . . . . . . . . . . . . . . 35 9. Security Considerations . . . . . . . . . . . . . . . . . . . 40 10. IANA Considerations . . . . . . . . . . . . . . . . . . . . 41 10.1 conference Event Package Registration . . . . . . . . . . 41 10.2 application/conference-info+xml MIME Registration . . . . 41 10.3 URN Sub-Namespace Registration for urn:ietf:params:xml:ns:conference-info . . . . . . . . . . 41 10.4 XML Schema Registration . . . . . . . . . . . . . . . . . 42 11. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 43 12. Changes History . . . . . . . . . . . . . . . . . . . . . . 44 12.1 Changes since -05 . . . . . . . . . . . . . . . . . . . . 44 12.2 Changes since -04 . . . . . . . . . . . . . . . . . . . . 44 12.3 Changes since -03 . . . . . . . . . . . . . . . . . . . . 44 12.4 Changes since -02 . . . . . . . . . . . . . . . . . . . . 44 12.5 Changes since -01 . . . . . . . . . . . . . . . . . . . . 45 13. References . . . . . . . . . . . . . . . . . . . . . . . . . 46 13.1 Normative References . . . . . . . . . . . . . . . . . . . . 46 13.2 Informative References . . . . . . . . . . . . . . . . . . . 46 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . 47 Intellectual Property and Copyright Statements . . . . . . . . 49 1. Introduction The Session Initiation Protocol (SIP) [6] Events framework Events Framework [7] 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 [15]. As described there, subscriptions to a conference URI are routed to the focus that is handling the conference. It acts as the notifier, 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 description), conference sidebars, conference service URIs, etc. 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 [2] and indicate requirement levels for compliant implementations. 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, as described in Conferencing Framework [15]. 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" element as specified by this package. This section provides the details for defining a SIP Events package, as specified by RFC 3265 [7]. 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 RFC 3265 [7]. 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 conference are terminated, with a reason of "noresource" RFC 3265 [7]. 3.4 NOTIFY Bodies As described in RFC 3265 [7], 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 6. TheSession Initiation Protocol (SIP) [6] Events framework Events Framework [7] defines general mechanismssubscribe 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. 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 MUST be generated forsubscribing to,the conference state when a new participant joins (i.e. gets "connected" to) or a participant leaves (i.e. gets "disconnected" from) the conference. Subject to a local focus policy, additional changes in participants' status, changes in their media types, andreceiving notifications of, events within SIP networks. It introducesother optional information MAY be reported by thenotionfocus. Changes in sidebar rosters SHOULD be reported by the focus to their participants and MAY be reported to others, subject to local policy. Changes in conference identifiers and service URIs SHOULD be reported by the focus to the Conference package subscribers. Changes in other conference state information MAY be reported by the focus to the Conference package subscribers. 3.7 Subscriber Processing of NOTIFY Requests The SIP Events framework expects packages to specify how apackage, which is asubscriber processes NOTIFY requests in any package specific"instantiation"ways, and in particular, how it uses the NOTIFY requests to construct a coherent view of theevents frameworkstate 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 awell-defined setcoherent view ofevents. Here, we define an eventthe total state of all users, a subscriber to the conference packagefor SIP conferences. Thiswill need to combine NOTIFYs received over time. Notifications within this packageprovidescan convey partial information; that is, they can indicate information about a subset of theconference notification service as outlinedstate associated with the subscription. This means that an explicit algorithm needs to be defined inthe SIP conferencing framework [14]. As described there, subscriptionsorder toa conference URIconstruct coherent and consistent state. The details of this mechanism areroutedspecific to thefocus that is handling the conference. It acts as the notifier, and provides clients with updatesparticular document type. See Section 5 for information onconference state. Theconstructing coherent informationprovided by this package is comprisedfrom an application/conference-info+xml document. 3.8 Handling ofconference identifier(s), conference participants (optionally withForked Requests By theirstatuses and media description), conference sidebars, conference policy URIs, etc. 2. Terminology In this document,nature, thekey words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL"conferences supported by this package areto be interpreted as described in RFC 2119 [2] and indicate requirement levelscentralized. Therefore, SUBSCRIBE requests forcompliant implementations. 3. Conference Event Package Thea conferenceeventshould not generally fork. Users of this packageallows a user to subscribe toMUST NOT install more than aconference. In SIP, conferences are represented by URIs. These URIs route tosingle subscription as aSIP user agent, calledresult of afocus, thatsingle SUBSCRIBE request. 3.9 Rate of Notifications For reasons of congestion control, it isresponsible for ensuringimportant thatall users in the conference can communicate with each other, as described in Conferencing Framework [14]. The focus has sufficient information aboutthestaterate of notifications not become excessive. As a result, it is RECOMMENDED that theconference to inform subscribers about it. Itserver not generate notifications for a single subscriber at a rate faster than once every 5 seconds. 3.10 State Agents Conference state ispossible a participantideally maintained in theconference mayelement infact be another focus. In order to provide a more complete participant list,which thefocus MAY subscribe toconference resides. Therefore, the elements that maintain the conferencepackage ofare theother focusones best suited todiscover the participant list inhandle subscriptions to it. Therefore, thecascaded conference. Thisusage of state agents is NOT RECOMMENDED for this package. 4. Conference Data Model Conference informationcan thenis an XML document that MUST beincluded in notifications bywell-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 ofthe "cascaded-focus" attribute as specifiedXML namespaces for identifying dialog information documents and document fragments. The namespace URI for elements defined by thispackage. This section provides the details for definingspecification is aSIP Events package, as specifiedURN [3], using the namespace identifier 'ietf' defined byRFC 3265 [7]. 3.1 Event Package Name[4] and extended by [1]. This URN is: Thename of this event packageconference information is"conference". This package namedescribed by a hierarchal XML structure with the root element "conference-info". The root element iscarried intheEvent and Allow-Events header, as definedonly element inRFC 3265 [7]. 3.2 SUBSCRIBE Bodies A SUBSCRIBEthe schema that carries meaningful version number foraall the elements in the document. The whole conferencepackage MAY contain a body. This body defines a filter to apply toinformation is associated with this version number. All sub-elements in thesubscription. Filter documents are not specified"conference-info" hierarchal XML structure can be classified inthis document,two groups: those that carry relatively small amount of data andat the timethose that can potentially carry a lot ofwriting,data. During partial notifications, the light elements areexpected to beupdated as atomic pieces of data. On thesubjectother hand, elements that can carry a substantial amount offuture standardization activity. A SUBSCRIBEdata have the general "state" attribute attached to them. That is in order to support partial notifications for their content. A "state" attribute of aconference package MAY be sent without a body. This implieschild element in thedefault subscription filtering policy. The default policy is: o Notifications are generated every time theredocument MUST adhere to its parent "state". It means that if the parent's "state" isany change in"full", the state of its children MUST be "full". If theconference. o Notifications do not normally contain full state; rather, they only indicate the state that has changed. The exceptionparent's "state" isa NOTIFY sent in response to a SUBSCRIBE. These NOTIFYs contain"partial", thefullstate of its children MAY be either "partial", "full", or "deleted". For elements with theinformation requested byoptional "state" attribute, if thesubscriber. 3.3 Subscription Duration The default expiration time for a subscription to a conferenceattribute isone hour. Onceomitted from theconference ends, all subscriptions to that particular conference are terminated, with a reason of "noresource" RFC 3265 [7]. 3.4 NOTIFY Bodies As described in RFC 3265 [7],notification for theNOTIFY message will contain bodieselement, it means thatdescribethe reported element's stateof the subscribed resource. This bodyisin"full". All sub-elements, with possible multiple appearances under aformat listedcommon parent, have keys defined to them inthe Accept header fieldorder to uniquely identify each element among others of theSUBSCRIBE, or a package-specific default ifsame type in theAccept header field was omittedpartial notification event. 5. Constructing Coherent State A Conference package subscriber MUST initialize the "version" attribute from theSUBSCRIBE. In this event package,"conference-info" element with thebody ofvalue in thenotification contains a conference information document. Thisfirst documentdescribes the state ofreceived. The conference package subscriber locally maintains aconference. All subscribers and notifiers MUST supportlocal element for each element in the"application/conference-info+xml" data format describedschema and a table for each element with key(s) inSection 4. The subscribe request MAY contain an Accept header field. If no such header field is present, it hasthe schema and indexed by these key(s). Each time adefaultnew NOTIFY is received, the value of"application/ conference-info+xml". Iftheheader field is present, it MUST include "application/conference-info+xml",local version number andMAY include any other types capable of representing dialog state. Of course, the notifications generated bytheserver MUST be"version" attribute inone oftheformats specified innew received document are compared. If theAccept header fieldvalue in theSUBSCRIBE 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 policynew document isatone higher than thediscretion oflocal version number, theadministrator, as always. However, a few recommendations can be made. Itlocal version number isRECOMMENDED that all usersincreased by one, and the document is processed. If the value in theconference be allowed to subscribe todocument is more than one higher than theconference. 3.6 Notifier Generation of NOTIFY Requests Notifications SHOULD be generated forlocal version number, theconference whenever therelocal version number isa change inset to thestatevalue inany oftheinformation delivered to the subscriber. The changes generally occur when anewparticipant joins (i.e. gets "connected" to) or a participant leaves (i.e. gets "disconnected" from)document, theconference. Subjectdocument is processed, and the subscriber SHOULD generate a refresh request to trigger alocal focus policy, additional changes in participant's status, changes in its media types, and other optional media attributes MAY be reported byfull state notification. If thefocus. Changesvalue insidebar rosters SHOULD be reported bythefocus to their participants and MAY be reported to others, subject todocument is less than the localpolicy. Changes in conference identifiers and policy URIs SHOULD be reported byversion, thefocus todocument is discarded without processing. Further processing of the conferenceparticipants. 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, howinformation document depends on whether itusescontains full or partial state. If it contains full state, indicated by theNOTIFY requests to construct a coherent viewvalue of thestate of"state" attribute in thesubscribed resource. Typically,"conference-info" element, theNOTIFY forwhole local content is flushed and repopulated from theconference package will only contain information about those users whose statedocument. If it contains "deleted" state, indicated by the value of the "state" attribute in the "conference-info" element, it means that the conferencehas changed. To construct a coherent view ofceased to exist and thetotal state of all users, asubscribertoSHOULD terminate theconference package will need to combine NOTIFYs received over time. Notifications within this package can conveySUBSCRIBE dialog. If the document contains partialinformation; that is, they can indicate information about a subsetstate, as indicated by the value of thestate associated with"state" attribute in thesubscription. This means that an explicit algorithm needs"conference-info" element, the document is used tobe definedupdate the local content as described below. Starting from outer elements inorder to construct coherent and consistent state. The details of this mechanism are specific totheparticular document type. See Section 4.2 for information on constructing coherent informationreceived document, 1. If the parent element contains "full" state, the whole local element content is flushed and repopulated froman application/ conference-info+xmlthe document.3.8 Handling of Forked Requests By their nature,2. Otherwise, if theconferences supported by this package are centralized. Therefore, SUBSCRIBE requests for a conference should not generally fork. Users of this packageparent element contains "deleted" state, the whole element MUSTNOT install more than a single subscription asbe removed from the local content. 3. Otherwise, if the parent element contains "partial" state: 3.1 For elements with keys, the subscriber compares the keys received in the update with the keys in the local tables. 3.1.1 If aresult ofkey does not exist in the local table, asingle SUBSCRIBE request. 3.9 Rate of Notifications For reasons of congestion control, itrow is added, and its content isimportant thatset to therate of notifications not become excessive. Aselement information from the update. 3.1.2 Otherwise, if aresult, it is RECOMMENDED thatkey of theserver not generate notificationssame value does exist, fora single subscriber at a rate faster than once every 5 seconds. 3.10 State Agents Conference state is ideally maintainedeach sub-element in the row the algorithm is applied from step 2.2. 3.2 For each atomic element received inwhichtheconference resides. Therefore,schema, theelements that maintainelement is replaced with theconference arenew information as a whole. Also, for each non-atomic element received in theones best suited to handle subscriptions to it. Therefore,schema with either no "state" attribute included or theusage ofstateagentsattribute isNOT RECOMMENDED for this package. 4. Conference Data Format Conference informationset to "full", the element is replaced with the new information as a whole. 3.2.1 If anXML documentelement, which doesnĘt have key(s), is updated or created such thatMUST 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 specificationits content isa URN [3], usingempty, that element MAY be removed from thenamespace identifier 'ietf' defined by [4] and extended by [1]. This URN is:local content at any time. 3.3 For each non-atomic element with the state attribute set to "partial", the algorithm is applied recursively starting from step 3. 6. Conference Data urn:ietf:params:xml:ns:conference-info A conference information document begins with the root element tag "conference-info".4.16.1 Conference InformationConference information begins with theA conference instance is defined as a top level element"conference-info"."conference-info" of a type "conference-type". Sections below describe the complex types composing the hierarchal "conference-type". The full XML schema is defined in Section 7. 6.1.1 Conference Type Thiselementtype hasthree mandatorythe following 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. entity: This mandatory attribute contains the conference URI that identifies the conference being described in the document. state: This mandatory attribute indicates whether the document contains thefullwhole conferenceinformation, or whether it containsinformation ("full"), only the information that has changed since the previous document(partial). entity:("partial"), or the conference ceased to exist ("deleted"). For more details see Section 5. Thismandatory attribute containstype defines an extendable sequence of the following optional child elements: 6.1.1.1 conference-description of conference-description-type This element contains conferenceURIinformation thatidentifiesis derived from system conference policies, is set before the conferencebeing described inactivation, and is rarely changed during thedocument. The "conference-info"conference lifetime. 6.1.1.2 host-info of host-type This elementhas zero or more "user" sub-elements which containcontains informationonabout theusers inentity that hosts the conference. Thisis followed by zero or more "sidebar" sub-elements which containinformationon the sidebars in the conference. Thisisfollowed by zero or more "conf-uri" sub-elements which contain information on additional URIs thatset before the conferencecan be accessed by. Thisactivation, and isfollowed by zero or more "policy-uri" sub-elements which contain information on additional URIs thatrarely changed during the conferencepolicies can be accessed by. This is followed by "recording" and "streaming" elements describing recording and streaming statuses of the conference. 4.1.1 User Element 4.1.1.1 User Attributes The user element has one mandatory attribute, "uri" that indicates the URI forlifetime, unless theuser in the conference. Thiswhole conference isa logical identifier, which correspondsmoved tothe authenticated identity of the participant. The "uri" attribute MUSTbeunique in the userhosted by another entity. 6.1.1.3 conference-state of conference-state-type This elementlist because it is used ascontains thekey in partial notificationsdynamic information aboutusers' state. If a conference participant has more than a single signaling dialog associated withtheconference,current state of theconference focus MAY presentfocus. 6.1.1.4 user of user-type This element contains theuser's aggregatedinformation(e.g. the statuses) and display all its media streams underabout asingle user element. Note, thatparticipant in theoptionalconference. The element"instance"of"media" (see below) MAY be usedthe user-type can have unbounded number of appearance inthis case to specifytheactual signaling dialogconference-type for eachmedia stream. An anonymousparticipant in the conference. 6.1.1.5 sidebars-by-ref of uris-type This element provides aconference SHOULD be represented by an anonymous URI generated bypointer to sidebar information through sidebar URIs. The recipient of thefocus. For multiple anonymous participants,information can then subscribe to sidebar information independently from thefocus must ensure that each anonymous URI is unique. The guidelines for generating anonymous URIs in RFC 3323 [8] should be followed. For example, "Anonymous1" <sip:anonymous1@anonymous.invalid> could be used formain Conference package subscription. 6.1.1.6 sidebar-by-val of conference-type This element provides sidebar information as aparticipant requesting privacy. The optional attribute "display-name"part of the main Conference package information. 6.1.2 Conference Description Type This element containsa display name fortheuser. The standard "xml:lang" language"state" attribute which canalso be present to indicatecontain thelanguagevalues "full", "partial", or deleted". This type defines an extendable sequence of thedisplay-name. Thefollowing optionalattribute "cascaded-focus"child elements: 6.1.2.1 display-text of string type This element contains text information about the conference. 6.1.2.2 subject of string type This element contains information about the subject of a conference. 6.1.2.3 free-text of string type This element contains free form text about the conference. 6.1.2.4 keywords of keywords-type This element contains a list of keywords which describe the conference topic. 6.1.2.5 web-page of anyURI type This element contains a URI of a web page that contains information related to the conference. 6.1.2.6 conf-uris of uris-type This element contains information about additional conference URIs that this conference can be accessed by. Examples of such URIs include h323: [14] and tel: [13] URIs. 6.1.2.7 service-uris of uris-type This element containsa conference URI (different fromthemain conference URI) for users that are connectedservice-related URIs. These URIs can be used to manipulate themainconferenceaspolicies or state, for example. 6.1.2.8 maximum-user-count of user-count-type This element contains aresultcount offocus cascading. In accordance withtheSIP conferencing framework [14], this package allows for representationmaximum number ofpeer-to-peer (i.e. "flat") focus cascading only.users permitted in the conference. Theactual cascading graphcount cannotbededuced from the information providedspecified for all participants in total (using thepackage alone. Advanced applications can constructsub-element with value "any") or count thegraphusers bysubscribing to both this package andtheir roles in theDialog Package [15]conference. 6.1.2.9 available-media of conference-medias-type This element contains information about thecascaded foci and correlating the relevant information. If the main conference "state" is "full", the state of its user(s)media types available in a conference. The "entry" sub-element MUST"full". Ifbe a value registered for "proto" of SDP [12]. 6.1.3 Host Type This element contains themain conference"state"is "partial",attribute which can contain thestate of its user(s) MAY be either "partial"values "full", "partial", or"full". 4.1.1.2 User Status Elements Three optional status elements are defined: status, joining-mode, and disconnection-reason. o "status": provides information about user's current leveldeleted". This type defines an extendable sequence ofparticipation intheconference. o "joining-mode": if present, providesfollowing optional child elements: 6.1.3.1 display-text of string type This element contains display text information about theway theuserjoinedhosting the conference.o "disconnection-reason": if present, provides information6.1.3.2 web-page of anyURI type This element contains a web page URI about theway theuserlefthosting the conference. 6.1.3.3 uris of uris-type Thefollowing statuses are defined for"entity" sub-element contains additional URIs relating to the"status" element: connected: Theuserishosting the conference. 6.1.4 Conference State Type This element contains the "state" attribute which can contain the values "full", "partial", or deleted". This type defines an extendable sequence of the following optional child elements. 6.1.4.1 user-count of user-count-type This element contains aparticipantcount of the current number of users in the conference.Depending on the media policies, he/she can send and receive media to and from other participants. disconnected:Theuser is not a participantcount can be specified for all participants in total (using theconference and no active dialog exists between the user and the focus. 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"sub-element with value "any") or count theconference mix, nor is his/her media being mixedusers by their roles in the conference.As an example, the user has asked to join6.1.4.2 security-level of security-level-type This element contains information about the conferenceusing SIP, but his/her participation is pending based on moderator approval. Insecurity level. The values can be "none", "low", "medium", or "high". 6.1.4.3 active of Boolean type This element contains information about whether themeantime he/sheconference ishearing music-on-holdcurrently active orsome other kindnot. 6.1.4.4 locked ofrelated content. muted-via-focus: Active SIP dialog exists between a user and a focus and the user can "listen" toBoolean type This element contains information about whether theconference, but user's mediaconference isnot being mixed into the conference. Notecurrently locked. In this context, locked means thatsometimes a subset of user media streamsthe conference roster can not bemuted by focus (such as poor quality video) while others (such as voiceadded to (although participants may leave orIM) can stillbeactive. In this case, it is RECOMMENDED thatremoved from the"aggregated" user connectivity "status" reflectsconference). 6.1.4.5 recording of uris-type The "entry" sub-element contains URIs related to thestatusrecording of themostly active media. blocked: User is denied from ever participating in this conference. pending: User is not yetconference. 6.1.4.6 active-media of conference-medias-type This element contains information about the media types currently active in thesession, but itconference which isanticipated that he/she will joina subset of those listed in thenear future. calling:"available-media" element. 6.1.5 Useris being called byType This type has thefocus. ringing: An PSTN ALERTING or SIP 180 Ringing was returnedfollowing attributes: entity: The mandatory attribute contains the URI for theoutbound call,useris being alerted. dialing-in: User is dialing into the conference, not yetin theroster (probably being authenticated). disconnecting: Focusconference. This isina logical identifier, which corresponds to theprocessauthenticated identity ofdisconnecting user (either DISCONNECT or BYE was sent totheuser's device). removed: This status is used to removeparticipant. The "entity" attribute MUST be unique in the userfromelement list because it is used as theroster usingkey in partial notificationsmechanism. Note that the defined transient states (e.g., calling, ringing, etc.) could generateabout users' state. An anonymous participant in alot of notifications. Implementations MAY choose not to generate notifications on these to all participants if it will generate too much traffic.conference SHOULD be represented by an anonymous URI generated by the focus. For multiple anonymous participants, the focus must ensure that each anonymous URI is unique. Thefollowing statuses are definedguidelines for generating anonymous URIs in RFC 3323 [8] should be followed. For example, "Anonymous1" <sip:anonymous1@anonymous.invalid> could be used for a participant requesting privacy. state: This mandatory attribute indicates whether the"joining-mode" element: dialed-in: The user dialed intodocument contains theconference, i.e. sent INVITE towhole conference information ("full"), only thefocus, which resulted in successful dialog establishment. dialed-out: The focusinformation that hasbroughtchanged since theuser intoprevious document ("partial"), or the conferenceby sending a successful INVITEceased to exist ("deleted"). This type defines an extendable sequence of theuser. focus-owner: The user isfollowing optional child elements. 6.1.5.1 display-text of string type This element contains thefocusdisplay text forthis conference.the user. 6.1.5.2 associated-aors of anyURI type Thisstatus is used only when a participant UA acts as a conference focus. The following statuses are defined forelement contains associated URIs of thedisconnection-reason element: departed: The user sentuser. Usually this information will be manually provided by aBYE, thus leavingsystem administrator showing theconference. booted: The user was sent a BYE bylogical association between signaling entities otherwise independent. 6.1.5.3 roles of user-roles-type This element contains thefocus, booting him/her outroles of theconference. Alternatively,user. 6.1.5.4 language of language type This element contains theuser tried to dial into to conference without success because was rejectedlanguage used by thefocus 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 inuser. 6.1.5.5 cascaded-focus of anyURI type This element contains anon-200 class final response. Alternatively, the user tried to dial into theconferencewithout success due to technical reasons. 4.1.1.3 Media Information Each user has zero or more "media" sub-elements. Each "media" element indicates the media thatURI (different from theuser is currently connected to. Here, "connected to" impliesmain conference URI) for users thata user has a media line in his/her SDP [12] document(s). With this definition, a user isare connected toa media stream even if he/she is not sending any media. 4.1.1.3.1 Media Attributes The "media" element has a mandatory "media-type" attribute which identifiesthemedia type (e.g. audio, video, message and application) and MUST have onemain conference as a result of focus cascading. In accordance with thevalues registeredSIP conferencing framework [15], this package allows for"media"representation ofSDP [12].peer-to-peer (i.e. "flat") focus cascading only. Theoptional "id" attribute serves as a unique reference to a "media" element within the "user" element. It MUSTactual cascading graph can not beincluded for each "media" element for all notifications ifdeduced from thefocus uses "partial" user notifications for this conference. Otherwise,information provided in the"id" attribute MAY be omitted. Ifpackage alone. Advanced applications can construct theuser "state" is "full",graph by subscribing to both this package and thestateDialog Package [16] ofits "media" element(s) MUST be "full". Iftheuser "state" is "partial",cascaded foci and correlating thestaterelevant information. 6.1.5.6 endpoint ofits "media" element(s) MAY be either "partial" or "full". 4.1.1.3.2 Media Elements The "media"endpoint-type This elementhas alsocontains information about anoptional "proto" sub-element, which MUST hasendpoint of thevalue registered for "proto"user. The element ofSDP [12]. An optional "ssrc" sub-element, if present, carriesthevalueendpoint-type can have unbounded number ofSSRC (definedappearance inRTP/RTCP [10]) as generated bytheuseruser-type for each endpoint of thestream it sends. When an RTP mixer generatesuser participating in the conference. In aCSRC list according to RTP/RTCP [10], it insertscase when authentication is performed per endpoint (rather than per user) in alist of the SSRC identifierssystem, a focus can be not aware of thesources that contributed tological association among endpoints being used by thegeneration of a particular packet intosame user. In this case theRTP header of that packet. "An example application is audio conferencing where a mixer indicates allfocus MAY present thetalkers whose speech was combinedendpoints as belonging toproduce the outgoing packet, allowingseparate users in thereceiverconference schema. In a different case, due toindicateprivacy concerns for a user thecurrent talker, even though allfocus may want to shield theaudio packets containinformation about multiple endpoints from thesame SSRC identifier (thatrecipients of themixer)." An optional "info" sub-element, if present, carries a human readable description for this stream populated byConference document. To do so thefocus. The value of this element corresponds tofocus MAY aggregate the multiple endpoint informationmedia attribute "i" in SDP [12]. An optional "label" sub-element, if present, carriesinto aunique identifier forsingle endpoint element under thisstream among all streams in the conference and is assigned byuser. 6.1.6 Endpoint Type This type has thefocus.following attributes: entity: Thevalue of this element corresponds to the "label" mediamandatory attributein SDP [12] and defined in [18]. An optional "instance" sub-element, if present, carries a URI, which MUST uniquely identifycontains thesignaling dialog being usedendpoint URI forestablishing of this media stream.the user in the conference. InSIP, for example, values ofSIP terms, this is the Contact URI orGRUU [17] canGRUU. The "entity" attribute MUST beused for this purpose. Itunique in the endpoint element list because it isRECOMMENDED to includeused as the"instance" information for every user that has more thankey in partial notifications about users' endpoints. An anonymous participant in asingle dialog associated with the conference. This elementconference SHOULDNOTbeincluded forrepresented by an anonymousparticipant. An optional "status" sub-element, if present,URI generated by the focus. For multiple anonymous participants, the focus must ensure that each anonymous URI isused to remove "media" elements during partial notifications. Optional "snd-status" and "rcv-status" sub-elements, if present, describeunique. The guidelines for generating anonymous URIs in RFC 3323 [8] should be followed. state: This mandatory attribute indicates whether the element contains the whole endpoint information ("full"), only the information that has changed since thestatusprevious document ("partial"), or the endpoint has been deleted from the conference ("deleted"). This type defines an extendable sequence ofmedia streams in each direction. 4.1.1.4 User Role Thethe following optional"role"child elements. 6.1.6.1 display-text of string type This element contains the display text for the endpoint. 6.1.6.2 referred of execution-type This elementconveyscontains theroleURI of the user who's action resulted in this endpoint being brought into theconference, e.g. participant, presenter, panelist, host, etc. User's role MAY change dynamically in the course ofconference (e.g. theconference. Also, auserMAY have more thanidentified by this URI sent asingle role in one time. This document does not define fixed values forREFER to the"role" element, instead it is expected that conferencing applications will define custom-fit roles by templates. 4.1.2 Sidebar Element The sidebarfocus). 6.1.6.3 state of endpoint-state-type This elementiscontains the state of thegeneral "conference-type"endpoint, andMAY use allcan assume theattributes and elements defined by it. Typically, onlyfollowing values: connected: The endpoint is a participant in the"entity", which uniquely identifiesconference. Depending on thesidebar,media policies, he/she can send andthe "user" elements will be useful to presentreceive media tothe majority of the participantsand from other participants. disconnected: The endpoint is not a participant in theconference. The "conference-type" mandatory attributes MUST be included for each sidebar. The value ofconference and no active dialog exists between the"version" attributeendpoint and the focus. on-hold: Active SIP dialog exists between an endpoint and a focus, but endpoint ismeaningless"on-hold" for"sidebar" elements and MUST be ignored because itthis conference, i.e. neither he/she isalways overruled by"hearing" the"version" attribute ofconference mix, nor is his/her media being mixed in themain "conference-info". Ifconference. As an example, the endpoint has asked to join themainconference"state"using SIP, but his/her participation is"full",pending based on moderator approval. In the meantime he/she is hearing music-on-hold or some other kind of related content. muted-via-focus: Active SIP dialog exists between an endpoint and a focus and thestate of its sidebar(s) MUST be "full". Ifendpoint can "listen" to themain conference "state"conference, but endpoint's media is"partial",not being mixed into thestateconference. Note that sometimes a subset ofits sidebar(s) MAYendpoint media streams can beeither "full"muted by focus (such as poor quality video) while others (such as voice or"partial". The "entity" URI attribute MUSTIM) can still beunique amongactive. In this case, it is RECOMMENDED that thesidebar identifiers"aggregated" endpoint connectivity "status" reflects the status of thesame conference. Attribute "entity"mostly active media. pending: Endpoint isused asnot yet in thekey for "sidebar" elementssession, but it is anticipated that he/she will join inpartial notificationsthe near future. alerting: A PSTN ALERTING or SIP 180 Ringing was returned for"conference-info". 4.1.3 Additional Conference Identifiers In addition totheConference URI present inoutbound call, endpoint is being alerted. dialing-in: Endpoint is dialing into the"entity" attribute, a conference MAY have additional URIs of various types. Connecting to these URIs will resultconference, not yet injoiningthe roster (probably being authenticated). dialing-out: Focus has dialed out to connect thesame conference. 4.1.4 Policy URIs A policy URI specifies where and how a certain policy pertainingendpoint to theconference can be accessed. The actual policy name and usage is deduced fromconference, but theURI schema name. An example forendpoint is not yet in the"policy-uri" usageroster (probably being authenticated). disconnecting: Focus isinclusion ofin theURIprocess ofthe CPCP [16]. A subscriberdisconnecting endpoint (either DISCONNECT or BYE was sent to theConference package can use the Policy URI to access and modifyendpoint's device). Note that theconference policy. 4.1.5 Recording In many cases, legal regulations require conference providersdefined transient states (e.g., disconnecting, alerting, etc.) could generate a lot of notifications. Implementations MAY choose not toannouncegenerate notifications on these totheall participantsthat a specific conference is being recorded. In addition to the recording "status" information, the "recording"if it will generate too much traffic. 6.1.6.4 joining-method of joining-type This elementMAY includecontains method by which theURIs specifyingendpoint joined thelocationconference, andthe format of the recorded data. Typically, the recorded data becomes available after the conference ends. Multiple URIscanbe provided, for example, specifying different content types. For Web-Page embedded media, a plain HTTP URI MAY be provided. 4.1.6 Streamingassume the following values: dialed-in: The"streaming" element, if present, specifies whetherendpoint dialed into theconference output is being streamed (to general public, for example),conference, i.e. sent INVITE to the focus, which resulted inwhat streaming format, and at what (e.g. multicast) addresses it can be listened at. RTSP [11] is an example of such streaming protocol. 4.2 Constructing Coherent Statesuccessful dialog establishment. dialed-out: The focus has brought the endpoint into the conferenceinformation is describedby sending ahierarchal XML structure withsuccessful INVITE to theroot element "conference-info".endpoint. focus-owner: Theroot elementendpoint is theonly element in the schema that carries meaningful version numberfocus forall the elements in the document. The whole conference information is associated withthisversion 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 documentconference. This status isreceived, the valueused only when a participant UA acts as a conference focus. 6.1.6.5 joining-info of execution-type This element contains information about how thelocal version number,endpoint joined and can contain the"version" attribute in the new document, are compared. Iffollowing sub-elements: when: This element contains thevalue indate and time that thenew document is one higher thanendpoint joined thelocal version number,conference. reason: This element contains thelocal version number is increased by one, andreason thedocument is processed. Ifendpoint joined thevalue inconference. by: This element contains thedocument is more than one higher thanURI of thelocal version number,entity who caused thelocal version number is setendpoint to join thevalue inconference. 6.1.6.6 disconnection-method of disconnection-type This element contains method by which thenew document,endpoint departed thedocument is processed,conference, and can assume thesubscriber SHOULD generatefollowing values: departed: The endpoint sent arefresh request to triggerBYE, thus leaving the conference. booted: The endpoint was sent afull state notification. IfBYE by thevalue infocus, booting him/her out of thedocument is less thanconference. Alternatively, the endpoint tried to dial into to conference without success because was rejected by the focus according to localversion,policy decisions. failed: The server tried to bring thedocument is discardedendpoint into the conference, but its attempt to contact the specific endpoint resulted in a non-200 class final response. Alternatively, the endpoint tried to dial into the conference withoutprocessing. Further processingsuccess due to technical reasons. 6.1.6.7 disconnection-info of disconnection-type This element contains information about the endpoint's departure from the conferenceinformation document depends on whether it contains full or partial state. If itand can contain the following sub-elements: when: This element containsfull state, indicated bythevalue ofdate and time that the"state" attribute inendpoint departed the"conference-info" element,conference. reason: This element contains thewhole local content is flushed and repopulated fromreason thedocument. Ifendpoint departed thedocumentconference. by: This element containspartial state, as indicated bythevalueURI of the"state" attribute in the "conference-info" element,entity who caused thedocument is usedendpoint toupdatedepart thelocal content as described below. All sub-elementsconference. 6.1.6.8 whispering-to of uris-type If an endpoint is participating in a whisper session with other entities, the"conference-info" hierarchal XML structure canURIs of these other entities MAY beclassifiedcontained intwo groups: those that carry relatively small amountthis element. 6.1.6.9 media of media-type This element contains information about a media stream ofdata and those thatthis endpoint. The element of the media-type canpotentially carry a lothave unbounded number ofdata. During partial notifications,appearance in thelight elements are updated as atomic piecesendpoint-type for each media stream ofdata. Ontheother hand, elementsendpoint. Note thatcan carryit is possible that media streams listed under asubstantial amount of data havecommon endpoint MAY be established by separate signaling means and consequently belong to different signaling "calls". 6.1.7 Media Type This type has thegeneral "state"following attributes: entity: The mandatory attributeattached to them. Thatisin order to support partial notifications for their content. A "state" attributea unique identifier of achildmedia stream on a per endpoint basis. This attribute is used as a key to identify media streams which may be added and deleted on a dynamic basis during the conference. The value of this element SHOULD correspond to the "mid" value in the SDP documentMUST adhere to its parent "state". It means that ifas defined in Grouping of Media Lines in theparent's "state" is "full",SDP [9]. state: This mandatory attribute indicates whether thestate of its children MUST be "full". Ifelement contains theparent's "state" is "partial",whole media information ("full"), only thestate of its children MAY be either "partial"information that has changed since the previous document ("partial"), or"full". For elements with optional "state" attribute, iftheattribute is not included formedia element has been deleted from the conference document ("deleted"). This type defines anelement, it means thatextendable sequence of theelement's state is "full". For a parentfollowing optional child elements. 6.1.7.1 display-text of string type This elementwith "state", its sub-elements with possible multiple appearances undercontains theparent have keys that uniquely identify eachdisplay text for the media stream. 6.1.7.2 proto of string type This elementamong others incontains thesame list. 4.2.1 The Algorithmmedia type for the media stream. Theconference package subscriber locally maintains a localvalue of this element MUST be a value registered foreach"proto" of SDP [12]. 6.1.7.3 ssrc of string type The "ssrc" elementincarries theschema and a table for each "element with key(s)"value of SSRC (defined inthe schema. The tables are indexedRTP/RTCP [10]) as generated by thekey(s) defined in schemaendpoint for theelement. Starting from outer elements in the received document, 1. Ifstream it sends. When an RTP mixer generates a CSRC list according to RTP/RTCP [10], it inserts a list of theparent element contains full state,SSRC identifiers of theelement is replaced withsources that contributed to thenew information asgeneration of awhole. 2. Otherwise, ifparticular packet into theparent element contains partial state, 2.1 For elements with keys,RTP header of that packet. "An example application is audio conferencing where a mixer indicates all thesubscriber comparestalkers whose speech was combined to produce thekeys received inoutgoing packet, allowing theupdate withreceiver to indicate thekeys incurrent talker, even though all thelocal tables. 2.1.1 If a key doesn't exist inaudio packets contain thelocal table, a row is added, and its content is set tosame SSRC identifier (that of the mixer)." 6.1.7.4 label of string type The elementinformation from the update. 2.1.2 Otherwise, if"label" carries akey of the same value does exist,unique identifier foreach sub-elementthis stream among all streams in therow the algorithmconference and isapplied from step 2.2. 2.2 For each atomicassigned by the focus. The value of this elementreceivedcorresponds to the "label" media attribute in SDP [12] and defined in [19]. 6.1.7.5 state of media-state-type The element "state" contains theschema,state of theelement is replaced withmedia stream and can have thenew information as a whole. Also, for each non-atomicvalues "active", "inactive", or "muted". 6.1.7.6 snd-status of media-state-type The elementreceived in the schema with either no"state"attribute included orcontains the stateattribute is set to "full",of theelement is replaced withsending media stream (from thenew information as a whole. 2.2.1 Ifperspective of theupdatedendpoint) and can have the values "active", "inactive", orcreated"muted". 6.1.7.7 rcv-status state of media-state-type The elementcarries"state" contains the"removed" status, that element SHOULD be removed fromstate of thelocal content. Ifreceiving media stream (from theelement is updatedperspective of the endpoint) and can have the values "active", "inactive", orcreated, such that it is empty, that"muted". 6.1.7.8 call of call-type The "call" elementMAY be removed fromcontains thelocal content at any time. 2.3 For each non-atomic element with"sip" sub-element which contains thestate attribute set to "partial",SIP dialog identifier of thealgorithm is applied recursively starting from step 2. 4.3endpoint's dialog with the focus. The "sip" element includes sub-elements "display-text", "call-id", "to-tag", "from-tag" 7. Schema <?xml version="1.0" encoding="UTF-8" ?> <xs:schema targetNamespace="urn:ietf:params:xml:ns:conference-info" xmlns:tns="urn:ietf:params:xml:ns:conference-info" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="urn:ietf:params:xml:ns:conference-info" elementFormDefault="qualified" attributeFormDefault="unqualified"> <!-- 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/03/xml.xsd" /> <!-- CONFERENCE ELEMENT --> <xs:element name="conference-info"type="tns:conference-type"/>type="conference-type"/> <!-- CONFERENCE TYPE --> <xs:complexType name="conference-type"> <xs:sequence> <xs:element name="conference-description" type="conference-description-type" minOccurs="0"/> <xs:element name="host-info" type="host-type" minOccurs="0"/> <xs:element name="conference-state" type="conference-state-type" minOccurs="0"/> <xs:element name="user" type="user-type" minOccurs="0" maxOccurs="unbounded"/> <xs:element name="sidebars-by-ref" type="uris-type" minOccurs="0"/> <xs:element name="sidebar-by-val" type="conference-type" minOccurs="0" maxOccurs="unbounded"/> <xs:element name="extended" type="extended-type" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="entity" type="xs:anyURI" use="required"/> <xs:attribute name="state" type="state-type" use="optional"/> <xs:attribute name="version" type="xs:string" use="optional"/> <xs:anyAttribute/> </xs:complexType> <!-- STATE TYPE --> <xs:simpleType name="state-type"> <xs:restriction base="xs:string"> <xs:enumerationvalue="full" />value="full"/> <xs:enumerationvalue="partial" />value="partial"/> <xs:enumeration value="deleted"/> </xs:restriction> </xs:simpleType> <!-- CONFERENCE DESCRIPTION TYPE --> <xs:complexType name="conference-description-type"> <xs:sequence> <xs:element name="display-text" type="xs:string" minOccurs="0"/> <xs:element name="subject" type="xs:string" minOccurs="0"/> <xs:element name="free-text" type="xs:string" minOccurs="0"/> <xs:element name="keywords" type="keywords-type" minOccurs="0"/> <xs:element name="web-page" type="xs:anyURI" minOccurs="0"/> <xs:element name="conf-uris" type="uris-type" minOccurs="0"/> <xs:element name="service-uris" type="uris-type" minOccurs="0"/> <xs:element name="maximum-user-count" type="user-count-type" minOccurs="0"/> <xs:element name="available-media" type="conference-medias-type" minOccurs="0"/> <xs:element name="extended" type="extended-type" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="state" type="state-type" use="optional"/> <xs:anyAttribute/> </xs:complexType> <!-- HOST TYPE --> <xs:complexType name="host-type"> <xs:sequence> <xs:element name="display-text" type="xs:string" minOccurs="0"/> <xs:element name="web-page" type="xs:anyURI" minOccurs="0"/> <xs:element name="uris" type="uris-type" minOccurs="0"/> <xs:element name="extended" type="extended-type" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="state" type="state-type" use="optional"/> <xs:anyAttribute/> </xs:complexType> <!-- CONFERENCE STATE TYPE --> <xs:complexTypename="conference-type">name="conference-state-type"> <xs:sequence> <xs:elementname="user" type="user-type" minOccurs="0" maxOccurs="unbounded" />name="user-count" type="user-count-type" minOccurs="0"/> <xs:elementname="sidebar" type="conference-type" minOccurs="0" maxOccurs="unbounded" />name="security-level" type="security-level-type" minOccurs="0"/> <xs:elementname="conf-ids" type="conf-ids-type" minOccurs="0" maxOccurs="1" />name="active" type="xs:boolean" minOccurs="0"/> <xs:elementname="policy-ids" type="policy-ids-type" minOccurs="0" maxOccurs="1" />name="locked" type="xs:boolean" minOccurs="0"/> <xs:element name="recording"type="recording-type" minOccurs="0" maxOccurs="1" />type="uris-type" minOccurs="0"/> <xs:elementname="streaming" type="streaming-type" minOccurs="0" maxOccurs="1" /> <xs:any processContents="lax"name="active-media" type="conference-medias-type" minOccurs="0"/> <xs:element name="extended" type="extended-type" minOccurs="0"maxOccurs="unbounded" />maxOccurs="unbounded"/> </xs:sequence> <xs:attributename="version" type="xs:nonNegativeInteger" use="required"/> <xs:attributename="state"type="tns:state-type" use="required"/>type="state-type" use="optional"/> <xs:anyAttribute/> </xs:complexType> <!-- CONFERENCE MEDIAS TYPE --> <xs:complexType name="conference-medias-type"> <xs:sequence> <xs:element name="entry" type="conference-media-type" maxOccurs="unbounded"/> </xs:sequence> <xs:attributename="entity" type="xs:anyURI" use="required"/> <xs:anyAttribute />name="state" type="state-type" use="optional"/> <xs:anyAttribute/> </xs:complexType> <!-- CONFERENCE MEDIA TYPE --> <xs:complexTypename="conf-ids-type">name="conference-media-type"> <xs:sequence> <xs:elementname="conf-uri" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded" /> <xs:any processContents="lax"name="proto" type="xs:string"/> <xs:element name="extended" type="extended-type" minOccurs="0"maxOccurs="unbounded" />maxOccurs="unbounded"/> </xs:sequence><xs:anyAttribute /><xs:anyAttribute/> </xs:complexType> <!-- CONFERENCE URIs TYPE --> <xs:complexTypename="policy-ids-type">name="uris-type"> <xs:sequence> <xs:elementname="policy-uri" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded" /> <xs:any processContents="lax" minOccurs="0" maxOccurs="unbounded" />name="entry" type="uri-type" maxOccurs="unbounded"/> </xs:sequence><xs:anyAttribute /><xs:attribute name="state" type="state-type" use="optional"/> <xs:anyAttribute/> </xs:complexType> <!-- CONFERENCE URI TYPE --> <xs:complexTypename="recording-type">name="uri-type"> <xs:sequence> <xs:element name="uri"type="xs:anyURI" minOccurs="0" maxOccurs="unbounded" /> <xs:any processContents="lax"type="xs:anyURI"/> <xs:element name="label" type="xs:string" minOccurs="0"/> <xs:element name="modified" type="execution-type" minOccurs="0"/> <xs:element name="extended" type="extended-type" minOccurs="0"maxOccurs="unbounded" />maxOccurs="unbounded"/> </xs:sequence> <xs:anyAttribute/> </xs:complexType> <!-- USER COUNT TYPE --> <xs:complexType name="user-count-type"> <xs:sequence> <xs:element name="entry" type="count-type" maxOccurs="unbounded"/> </xs:sequence> <xs:attributename="status" type=="stream-status-type" use="required"/> <xs:anyAttribute />name="state" type="state-type" use="optional"/> <xs:anyAttribute/> </xs:complexType> <!-- COUNT TYPE --> <xs:complexTypename="streaming-type">name="count-type"> <xs:sequence> <xs:elementname="uri" type="xs:anyURI" minOccurs="0" maxOccurs="unbounded" /> <xs:any processContents="lax"name="role" type="user-role-type"/> <xs:element name="count" type="xs:nonNegativeInteger"/> <xs:element name="extended" type="extended-type" minOccurs="0"maxOccurs="unbounded" />maxOccurs="unbounded"/> </xs:sequence><xs:attribute name="status" type="stream-status-type" use="required"/> <xs:anyAttribute /><xs:anyAttribute/> </xs:complexType> <!-- SECURITY LEVEL TYPE --> <xs:simpleType name="security-level-type"> <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> <!-- KEWORDS TYPE --> <xs:simpleType name="keywords-type"> <xs:list itemType="xs:string"/> </xs:simpleType> <!-- USER TYPE --> <xs:complexType name="user-type"> <xs:sequence> <xs:elementname="status" type="tns:user-status-type"name="display-text" type="xs:string" minOccurs="0"/> <xs:elementname="joining-mode" type="tns:user-joining-mode-type"name="associated-aors" type="uris-type" minOccurs="0"/> <xs:elementname="disconnection-reason" type="tns:user-disconnection-reason-type"name="roles" type="user-roles-type" minOccurs="0"/> <xs:elementname="media" type="tns:media-type" minOccurs="0" maxOccurs="unbounded"/>name="language" type="xs:language" minOccurs="0"/> <xs:elementname="role" type="xs:string"name="cascaded-focus" type="xs:anyURI" minOccurs="0"/> <xs:element name="endpoint" type="endpoint-type" minOccurs="0" maxOccurs="unbounded"/><xs:any processContents="lax"<xs:element name="extended" type="extended-type" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attributename="uri" type="xs:anyURI" use="required"/>name="entity" type="xs:anyURI"/> <xs:attributename="display-name" type="xs:string"name="state" type="state-type" use="optional"/> <xs:anyAttribute/> </xs:complexType> <!-- USER ROLES TYPE --> <xs:complexType name="user-roles-type"> <xs:sequence> <xs:element name="entry" type="user-role-type" maxOccurs="unbounded"/> </xs:sequence> <xs:attributeref="xml:lang"name="state" type="state-type" use="optional"/> <xs:anyAttribute/> </xs:complexType> <!-- USER ROLE TYPE --> <xs:complexType name="user-role-type"> <xs:choice> <xs:element name="label" type="xs:string"/> </xs:choice> <xs:attributename="cascaded-focus" type="xs:anyURI"name="conf-template" type="xs:string" use="optional"/> </xs:complexType> <!-- ENDPOINT TYPE --> <xs:complexType name="endpoint-type"> <xs:sequence> <xs:element name="display-text" type="xs:string" minOccurs="0"/> <xs:element name="referred" type="execution-type" minOccurs="0"/> <xs:element name="state" type="endpoint-state-type" minOccurs="0"/> <xs:element name="whispering-to" type="uris-type" minOccurs="0"/> <xs:element name="joining-method" type="joining-type" minOccurs="0"/> <xs:element name="joining-info" type="execution-type" minOccurs="0"/> <xs:element name="disconnection-method" type="disconnection-type" minOccurs="0"/> <xs:element name="disconnection-info" type="execution-type" minOccurs="0"/> <xs:element name="media" type="media-type" minOccurs="0" maxOccurs="unbounded"/> <xs:element name="extended" type="extended-type" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="entity" type="xs:anyURI"/> <xs:attribute name="state"type="tns:state-type"type="state-type" use="optional"/><xs:anyAttribute /><xs:anyAttribute/> </xs:complexType> <!-- ENDPOINT STATE TYPE --> <xs:simpleTypename="user-status-type">name="endpoint-state-type"> <xs:restriction base="xs:string"> <xs:enumerationvalue="connected"/> <xs:enumeration value="disconnected"/> <xs:enumeration value="on-hold"/>value="pending"/> <xs:enumerationvalue="muted-via-focus"/>value="dialing-out"/> <xs:enumerationvalue="blocked"/>value="dialing-in"/> <xs:enumerationvalue="pending"/>value="alerting"/> <xs:enumerationvalue="calling"/>value="on-hold"/> <xs:enumerationvalue="ringing"/>value="connected"/> <xs:enumerationvalue="dialing-in"/>value="muted-via-focus"/> <xs:enumeration value="disconnecting"/> <xs:enumerationvalue="removed"/>value="disconnected"/> </xs:restriction> </xs:simpleType> <!-- JOINING TYPE --> <xs:simpleTypename="user-joining-mode-type">name="joining-type"> <xs:restriction base="xs:string"> <xs:enumerationvalue="dialed-in" />value="dialed-in"/> <xs:enumerationvalue="dialed-out" />value="dialed-out"/> <xs:enumerationvalue="focus-owner" />value="focus-owner"/> </xs:restriction> </xs:simpleType> <!-- DISCONNECTION TYPE --> <xs:simpleTypename="user-disconnection-reason-type">name="disconnection-type"> <xs:restriction base="xs:string"> <xs:enumerationvalue="departed" />value="departed"/> <xs:enumerationvalue="booted" />value="booted"/> <xs:enumerationvalue="failed" />value="failed"/> </xs:restriction> </xs:simpleType> <!-- EXECUTION TYPE --> <xs:complexTypename="media-type">name="execution-type"> <xs:sequence> <xs:elementname="proto"name="when" type="xs:dateTime" minOccurs="0"/> <xs:element name="reason" type="xs:string" minOccurs="0"/> <xs:elementname="ssrc" type="xs:nonNegativeInteger"name="by" type="xs:anyURI" minOccurs="0"/> </xs:sequence> <xs:anyAttribute/> </xs:complexType> <!-- MEDIA TYPE --> <xs:complexType name="media-type"> <xs:sequence> <xs:elementname="info"name="display-text" type="xs:string" minOccurs="0"/> <xs:elementname="label"name="proto" type="xs:string" minOccurs="0"/> <xs:elementname="instance" type="xs:anyURI"name="ssrc" type="xs:string" minOccurs="0"/> <xs:element name="label" type="xs:string" minOccurs="0"/> <xs:elementname="status" type="tns:media-status-type"name="state" type="media-state-type" minOccurs="0"/> <xs:element name="snd-status"type="tns:stream-status-type"type="media-state-type" minOccurs="0"/> <xs:element name="rcv-status"type="tns:stream-status-type"type="media-state-type" minOccurs="0"/><xs:any processContents="lax"<xs:element name="call" type="call-type" minOccurs="0"/> <xs:element name="extended" type="extended-type" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attributename="media"name="entity" type="xs:string" use="required"/> <xs:attributename="id" type="nonNegativeInteger" use="optional"/> <xs:attributename="state"type="tns:state-type"type="state-type" use="optional"/><xs:anyAttribute /><xs:anyAttribute/> </xs:complexType> <!-- MEDIA STATUS TYPE --> <xs:simpleTypename="media-status-type"> <xs:restriction base="xs:string"> <xs:enumeration value="removed" /> </xs:restriction> </xs:simpleType> <xs:simpleType name="stream-status-type">name="media-state-type"> <xs:restriction base="xs:string"> <xs:enumerationvalue="on"/>value="active"/> <xs:enumerationvalue="off"/>value="inactive"/> <xs:enumerationvalue="muted" />value="muted"/> </xs:restriction> </xs:simpleType> <!-- CALL TYPE --> <xs:complexType name="call-type"> <xs:choice> <xs:element name="sip" type="sip-dialog-id-type"/> <xs:element name="extended" type="extended-type" minOccurs="0" maxOccurs="unbounded"/> </xs:choice> <xs:anyAttribute/> </xs:complexType> <!-- SIP DIALOG ID TYPE --> <xs:complexType name="sip-dialog-id-type"> <xs:sequence> <xs:element name="display-text" type="xs:string" minOccurs="0"/> <xs:element name="dialog-id" type="xs:string"/> <xs:element name="from-tag" type="xs:string"/> <xs:element name="to-tag" type="xs:string"/> <xs:element name="extended" type="extended-type" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:anyAttribute/> </xs:complexType> <!-- EXTENDED TYPE --> <xs:complexType name="extended-type"> <xs:sequence> <xs:any minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="target-namespace" type="xs:string" use="required"/> </xs:complexType> </xs:schema>4.48. Examples 8.1 Basic Example The following is an example conference information document:<?xml version="1.0" encoding="utf-8" ?><conference-infoversion="0" state="full" entity="sip:conf233@example.com">entity="sips:conf233@example.com" state="partial" version="5" > <!-- CONFERENCE INFO --> <conference-description> <subject>Agenda: This month's target</subject> <service-uris> <entry> <uri>http://salesgroup.example.com/conference-policies/sales-weekly-meeting.xml</uri> <label>CPCP</label> </entry> </service-uris> </conference-description> <!-- CONFERENCE STATE --> <conference-state> <user-count> <entry> <role> <label>any</label> </role> <count>33</count> </entry> </user-count> <active-media> <entry> <proto>audio</proto> </entry> </active-media> </conference-state> <!-- USER --> <useruri="sip:bob@example.com" display-name="Bob Jones"> <status>connected</status> <joining-mode>dialed-in</joining-mode>entity="sip:bob@example.com" state="full"> <display-text>Bob Hoskins</display-text> <!-- ENDPOINTS --> <endpoint entity="sip:bob@pc33.example.com"> <display-text>Bob's Laptop</display-text> <state>disconnected</state> <disconnection-method>departed</disconnection-method> <disconnection-info> <when>2005-03-04T20:00:00Z</when> <reason>bad voice quality</reason> <by>sip:mike@example.com</by> </disconnection-info> <!-- MEDIA --> <mediamedia="audio"> <proto>RTP/AVP</proto> <ssrc>583398</ssrc>entity="1"> <display-text>main audio</display-text> <proto>audio</proto> <ssrc>432424</ssrc> <label>34567</label> <state>active</state> </media> </endpoint> </user> <!-- USER --> <useruri="sip:barbara@example.com" display-name="Barbara Jones"> <status>on-hold</status> </user> <user uri="sip:bill@example.com" display-name="Bill Minelli"> <status>on-hold</status>entity="sip:alice@example.net" state="full"> <display-text>Alice</display-text> <!-- ENDPOINTS --> <endpoint entity="sip:4kfk4j392jsu@example.net;grid=433kj4j3u"> <state>connected</state> <joining-method>dialed-out</joining-method> <joining-info> <when>2005-03-04T20:00:00Z</when> <by>sip:mike@example.com</by> </joining-info> <!-- MEDIA --> <media entity="1"> <display-text>main audio</display-text> <proto>audio</proto> <ssrc>534232</ssrc> <label>34564</label> <state>active</state> </media> </endpoint> </user><sidebar version="0" state="full" entity="sip:conf233.1@example.com"> <user uri="sip:barbara@example.com" /> <user uri="sip:bill@example.com" /> </sidebar> <conf-ids> <conf-uri>tel:+18005671234</conf-uri> <conf-uri>h323:conf545@example.com</conf-uri> </conf-ids> <recording status="on"> <uri>http://quicktime.streaming.com/54634/recording.mov</uri> <uri>http://real.streaming.com/54634/recording.ram</uri> <uri>http://windowsmedia.streaming.com/54634/recording.wmv</uri> <uri>http://www.streaming.com/54634/recording.html</uri> </recording></conference-info>This8.2 Rich Example The following is an example conferencecurrently has three users, twoinformation document. In this example ofwhicha partial state notification, there are 32 participants in asidebar conversation.voice conference. The user Bob has been booted from the conferenceis being recorded. There are additional meansby Mike due tojoinbad voice quality. Note that there are three sidebars in theconference eitherconference, two are referenced just byphone using teltheir sidebar URI[14] or by H.323 protocol using H.323 URL [13]. 5.and information about the third sidebar is included in this notification. Also note that while this conference offers both audio and video capabilities, only audio is currently in use. <conference-info entity="sips:conf233@example.com" state="partial" version="5" > <!-- CONFERENCE INFO --> <conference-description> <display-text>Weekly Sales Meeting</display-text> <subject>Agenda: This month's target</subject> <free-text>xyz</free-text> <keywords>sales, meeting, weekly</keywords> <web-page>http://sharepoint/salesgroup/</web-page> <conf-uris> <entry> <uri>tel:+18005671234</uri> <label>TTI Bridge</label> </entry> <entry> <uri>h323:conf545@h323.example.com</uri> </entry> </conf-uris> <service-uris> <entry> <uri>http://salesgroup.example.com/conference-policies/sales-weekly-meeting.xml</uri> <label>CPCP</label> </entry> </service-uris> <maximum-user-count> <entry> <role> <label>any</label> </role> <count>52</count> </entry> <entry> <role conf-template="Basic"> <label>participant</label> </role> <count>50</count> </entry> </maximum-user-count> <available-media> <entry> <proto>audio</proto> </entry> <entry> <proto>video</proto> </entry> </available-media> </conference-description> <!-- HOST INFO --> <host-info> <display-text>Sales Host</display-text> <web-page>http://sharepoint/salesgroup/hosts/</web-page> <uris> <entry> <uri>sip:sales@example.com</uri> </entry> </uris> </host-info> <!-- CONFERENCE STATE --> <conference-state> <user-count> <entry> <role> <label>any</label> </role> <count>33</count> </entry> <entry> <role conf-template="Basic"> <label>participant</label> </role> <count>32</count> </entry> </user-count> <security-level>medium</security-level> <active>true</active> <locked>false</locked> <recording> <entry> <uri>http://quicktime.streaming.com/54634/recording.mov</uri> <label>Quicktime</label> </entry> <entry> <uri>http://real.streaming.com/54634/recording.ram</uri> </entry> </recording> <active-media> <entry> <proto>audio</proto> </entry> </active-media> </conference-state> <!-- USERS --> <user entity="sip:bob@example.com" state="full"> <display-text>Bob Hoskins</display-text> <associated-aors> <entry> <uri>mailto:bob@example.com</uri> <label>email</label> </entry> </associated-aors> <roles> <entry> <label>participant</label> </entry> </roles> <language>en</language> <!-- ENDPOINTS --> <endpoint entity="sip:bob@pc33.example.com"> <display-text>Bob's Laptop</display-text> <referred> <when>2005-03-04T20:00:00Z</when> <by>sip:mike@example.com</by> </referred> <state>disconnecting</state> <whispering-to> <entry> <uri>sip:rob@example.com</uri> </entry> <entry> <uri>sip:helen@example.com</uri> </entry> </whispering-to> <joining-method>dialed-out</joining-method> <joining-info> <when>2005-03-04T20:00:00Z</when> <reason>invitation</reason> <by>sip:mike@example.com</by> </joining-info> <disconnection-method>booted</disconnection-method> <disconnection-info> <when>2005-03-04T20:00:00Z</when> <reason>bad voice quality</reason> <by>sip:mike@example.com</by> </disconnection-info> <!-- MEDIA --> <media entity="1" state="full"> <display-text>main audio</display-text> <proto>audio</proto> <ssrc>432424</ssrc> <label>34567</label> <state>active</state> <call> <sip> <display-text>full info</display-text> <dialog-id>hsjh8980vhsb78</dialog-id> <from-tag>vav738dvbs</from-tag> <to-tag>8954jgjg8432</to-tag> </sip> </call> </media> </endpoint> </user> <!-- SIDEBARS BY REFERENCE --> <sidebars-by-ref> <entry> <uri>sips:conf233@example.com; grid=45</uri> <label>sidebar with Carol</label> </entry> <entry> <uri>sips:conf233@example.com; grid=21</uri> <label>private sidebar with Peter</label> </entry> </sidebars-by-ref> <!-- SIDEBARS BY VALUE --> <sidebar-by-val entity="sips:conf233@example.com; grid=77" state="partial"> <user entity="sip:bob@example.com" state="partial"></user> <user entity="sip:mark@example.com" state="partial"></user> <user entity="sip:dan@example.com" state="partial"></user> </sidebar-by-val> </conference-info> 9. 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. Since a focus provides participants identity information using this event package, participant privacy needs to be taken into account. A focus MUST support requests by participants for privacy. Privacy can be indicated by the conference policy - for every participant or select participants. It can also be indicated in the session signaling. In SIP this can be done using the Privacy header field described in RFC 3323 [8]. For a participant requesting privacy, no identity information SHOULD be revealed by the focus such as a URI (e.g. the Address of Record, Contact, or GRUU). For these cases, the anonymous URI generation method outlined in section "User Element" of this document MUST be followed.6.10. 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.110.1 conference Event Package Registration This specification registers an event package, based on the registration procedures defined in RFC 3265 [7]. 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.210.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 [5]. Encoding considerations: Same as encoding considerations of application/xml as specified in RFC 3023 [5]. Security considerations: See Section 10 of RFC 3023 [5] and Section59 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. Additional Information: Magic Number: None File Extension: .cif or .xml Macintosh file type code: "TEXT" Personal and email address for further information: Jonathan Rosenberg, <jdrosen@jdrosen.net> Intended usage: COMMON Author/Change controller: The IETF.6.310.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 [1]. URI: The URI for this namespace is urn:ietf:params:xml:ns:conference-info. Registrant Contact: IETF, SIPPING working group, <sipping@ietf.org>, Jonathan Rosenberg <jdrosen@jdrosen.net>. XML: BEGIN <?xml version="1.0"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.0//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic10.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"/> <title>Conference Information Namespace</title> </head <body> <h1>Namespace for Conference Information</h1> <h2>urn:ietf:params:xml:ns:conference-info</h2> <p>See <a href="[[[URL of published RFC]]]">RFCXXXX</a>.</p> </body> </html> END6.410.4 XML Schema Registration This specification registers a schema, as per the guidelines in in [1]. URI: please assign. Registrant Contact: IETF, SIPPING Working Group (sipping@ietf.org), Jonathan Rosenberg (jdrosen@jdrosen.net). XML: The XML can be found as the sole content of Section4.3.7. 11. Acknowledgements The authors would like to thank Dan Petrie, Sean Olson, Alan Johnston, and Rohan Mahy for their comments and inputs.8.12. Changes History8.112.1 Changes since -05 o General schema clean-up. o Definition of common types being used by multiple elements. o Introduction of an "endpoint" element as a part of hierarchy: user/endpoint/media. 12.2 Changes since -04 o o "Sidebar-type" has been removed. "Sidebar" conference element is defined using the general "conference-type". o "Recording" conference attribute has been replaced with "recording" and "streaming" elements within "conference-type". New "recording-type" and "streaming-type" have been introduced. o Attribute "state" has been added to "user-type". o Element "media-stream" within "user-type" has been renamed to "media". o Element "role" within "user-type" has been introduced. o The following statuses have been added to "user-status-type": blocked, pending, calling, ringing, dialing-in, disconnecting, removed. o User status "muted-by-focus" has been renamed to "muted-via-focus". o Attributes "id" and "state" have been added to "media-type". o Elements "status", "snd-status" and "rcv-status" have been added to "media-type". o Element "dialog-id" has been renamed to "instance". o "Constructing Coherent State" section has been updated to include user and media partial notifications.8.212.3 Changes since -03 o "Constructing Coherent State" section has been updated. o In order to support partial notifications, two placeholders "conference-ids" and "policy-ids" (for "conf-uri" and "policy-uri" elements, correspondingly) are created. o Discussion and security considerations regarding anonymous participation have been added. o Optional elements "dialog-uri", "info" and "label" per media stream are added.8.312.4 Changes since -02 o State "muted-by-focus" is added to user's status. o Optional conference attribute "recording" is added. o Policy URI placeholder (i.e. element "policy-uri") is created. o Example's syntax is corrected. o Optional attribute "cascaded-focus" URI per user is added. o Optional additional conference identifiers (i.e. element "conf-uri") are added. o In order to cover all possible cases, participant's status is expressed using three optional statuses: "status", "joining-mode" and "disconnection-reason". That is instead of "activity-status", "history-status" and "is-on-dial-out-list".8.412.5 Changes since -01 o Package parameters are removed. Decision about performing "recursive" membership algorithm is perceived as a focus local policy. o General information (i.e. pointers to additional available services) is removed. The defined XML schema can be extended in future to include those when XCON work matures. o Dialog information is removed. It can be obtained by direct subscription to a dialog package of a participant. o Media stream information is aligned with SDP definitions (media and proto) and SSRC attribute is added. o Participant's status is expressed using two optional statuses: "activity" and "history". Optional "is-on-a-dial-out-list" indication is added. o Normative references to XCON work are removed. o Optional sidebar rosters are added.9.13. References9.113.1 Normative References [1] Mealling, M., "The IETF XML Registry", draft-mealling-iana-xmlns-registry-05 (work in progress), June 2003. [2] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [3] Moats, R., "URN Syntax", RFC 2141, May 1997. [4] Moats, R., "A URN Namespace for IETF Documents", RFC 2648, August 1999. [5] Murata, M., St. Laurent, S. and D. Kohn, "XML Media Types", RFC 3023, January 2001. [6] Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, A., Peterson, J., Sparks, R., Handley, M. and E. Schooler, "SIP: Session Initiation Protocol", RFC 3261, June 2002. [7] Roach, A., "Session Initiation Protocol (SIP)-Specific Event Notification", RFC 3265, June 2002. [8] Peterson, J., "A Privacy Mechanism for the Session Initiation Protocol (SIP)", RFC 3323, November 2002. [9] Camarillo, G., Eriksson, G., Holler, J. and H. Schulzrinne, "Grouping of Media Lines in the Session Description Protocol (SDP)", RFC 3388, December 2002. [10] Schulzrinne, H., Casner, S., Frederick, R. and V. Jacobson, "RTP: A Transport Protocol for Real-Time Applications", STD 64, RFC 3550, July 2003.9.213.2 Informative References [11] Schulzrinne, H., Rao, A. and R. Lanphier, "Real Time Streaming Protocol (RTSP)", RFC 2326, April 1998. [12] Handley, M. and V. Jacobson, "SDP: Session Description Protocol", RFC 2327, April 1998. [13] Vaha-Sipila, A., "URLs for Telephone Calls", RFC 2806, April 2000. [14] Levin, O., "H.323 Uniform Resource Locator (URL) Scheme Registration", RFC 3508, April 2003.[14][15] Rosenberg, J., "A Framework for Conferencing with the Session Initiation Protocol",draft-ietf-sipping-conferencing-framework-02draft-ietf-sipping-conferencing-framework-03 (work in progress),JuneOctober 2004.[15][16] Rosenberg, J. and H. Schulzrinne, "An INVITE Inititiated Dialog Event Package for the Session Initiation Protocol (SIP)", draft-ietf-sipping-dialog-package-04 (work in progress), February 2004.[16][17] Koskelainen, P. and H. Khartabil, "Requirements for Conference Policy Control Protocol",draft-ietf-xcon-cpcp-reqs-03draft-ietf-xcon-cpcp-reqs-04 (work in progress),AprilAugust 2004.[17][18] Rosenberg, J., "Obtaining and Using Globally Routable User Agent (UA) URIs (GRUU) in the Session Initiation Protocol (SIP)", draft-ietf-sip-gruu-02 (work in progress), July 2004.[18][19] Levin, O. and G. Camarillo, "The SDP (Session Description Protocol) Label Attribute",draft-levin-mmusic-sdp-media-label-00draft-ietf-mmusic-sdp-media-label-00 (work in progress),JulySeptember 2004. Authors' Addresses Jonathan Rosenberg dynamicsoft 600 Lanidex Plaza Parsippany, NJ 07054 US Phone: +1 973 952-5000 EMail: jdrosen@dynamicsoft.com URI: http://www.jdrosen.net Henning Schulzrinne Columbia University M/S 0401 1214 Amsterdam Ave. New York, NY 10027 US EMail: schulzrinne@cs.columbia.edu URI: http://www.cs.columbia.edu/~hgs Orit Levin (editor) Microsoft Corporation One Microsoft Way Redmond, WA 98052 USA EMail: oritl@microsoft.com 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.