ETSI ES 202 915-14-2005 Open Service Access (OSA) Application Programming Interface (API) Part 14 Presence and Availability Management SCF (V1 2 1 Parlay 4 Includes Diskette)《开放业务接.pdf

1、 ETSI ES 202 915-14 V1.2.1 (2005-03)ETSI Standard Open Service Access (OSA);Application Programming Interface (API);Part 14: Presence and Availability Management SCF(Parlay 4)floppy3 ETSI ETSI ES 202 915-14 V1.2.1 (2005-03) 2 Reference RES/TISPAN-01009-14-OSA Keywords API, IDL, OSA, UML ETSI 650 Rou

2、te des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice Individual copies of the present document can be downloaded

3、 from: http:/www.etsi.org The present document may be made available in more than one electronic version or in print. In any case of existing or perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). In case of dispute, the reference shal

4、l be the printing on ETSI printers of the PDF version kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is availa

5、ble at http:/portal.etsi.org/tb/status/status.asp If you find errors in the present document, please send your comment to one of the following services: http:/portal.etsi.org/chaircor/ETSI_support.asp Copyright Notification No part may be reproduced except as authorized by written permission. The co

6、pyright and the foregoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2005. The Parlay Group 2005. All rights reserved. DECTTM, PLUGTESTSTM and UMTSTM are Trade Marks of ETSI registered for the benefit of its Members. TIPHONTMand the TIPHON logo a

7、re Trade Marks currently being registered by ETSI for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI ES 202 915-14 V1.2.1 (2005-03) 3 Contents Intellectual Property Rights9 Foreword.9 1 Scope 10

8、2 References 10 3 Definitions and abbreviations.10 3.1 Definitions10 3.2 Abbreviations .10 4 Presence and Availability Management SCF.11 4.1 Introduction 11 4.2 Motivation 11 4.3 Goals 11 4.4 Concepts.12 4.4.1 Identity12 4.4.2 Agent 12 4.4.3 Presence 13 4.4.4 Availability .14 4.4.5 Events .15 4.5 Sc

9、ope of PAM information 15 4.6 Security and privacy.15 5 Sequence Diagrams 16 5.1 Use of authentication tokens 17 5.2 Event registration and notification .18 6 Class Diagrams.18 6.1 PAM Provisioning SCF Class Diagrams19 6.2 PAM Access SCF Class Diagrams.20 6.3 PAM Event SCF Class Diagrams.21 7 The Se

10、rvice Interface Specifications22 7.1 Interface Specification Format .22 7.1.1 Interface Class 22 7.1.2 Method descriptions23 7.1.3 Parameter descriptions23 7.1.4 State Model.23 7.2 Base Interface.23 7.2.1 Interface Class IpInterface 23 7.3 Service Interfaces .23 7.3.1 Overview 23 7.4 Generic Service

11、 Interface .23 7.4.1 Interface Class IpService 23 7.4.1.1 Method setCallback()24 7.4.1.2 Method setCallbackWithSessionID()24 8 Presence and Availability Management Interface Classes.24 8.1 PAM Provisioning SCF Interface Classes25 8.1.1 Interface Class IpPAMProvisioningManager .25 8.1.1.1 Method getA

12、uthToken()25 8.1.1.2 Method obtainInterface() 26 8.1.1.3 Method getAccessControl()26 8.1.1.4 Method setAccessControl() 26 8.1.2 Interface Class IpPAMIdentityManagement 27 8.1.2.1 Method createIdentity().28 8.1.2.2 Method deleteIdentity().29 8.1.2.3 Method isIdentity()29 ETSI ETSI ES 202 915-14 V1.2.

13、1 (2005-03) 4 8.1.2.4 Method createGroupIdentity().29 8.1.2.5 Method deleteGroupIdentity().30 8.1.2.6 Method addToGroup() 30 8.1.2.7 Method removeFromGroup()31 8.1.2.8 Method listMembers().31 8.1.2.9 Method isGroupIdentity() .31 8.1.2.10 Method listGroupMembership() .32 8.1.2.11 Method addAlias() 32

14、 8.1.2.12 Method removeAliases().32 8.1.2.13 Method listAliases()33 8.1.2.14 Method lookupByAlias() 33 8.1.2.15 Method associateTypes() 34 8.1.2.16 Method disassociateTypes()34 8.1.2.17 Method listTypesOfIdentity() .34 8.1.2.18 Method hasType() .35 8.1.2.19 Method getIdentityAttributes() .35 8.1.2.2

15、0 Method setIdentityAttributes()36 8.1.3 Interface Class IpPAMAgentManagement .36 8.1.3.1 Method createAgent() .37 8.1.3.2 Method deleteAgent() .38 8.1.3.3 Method isAgent() 38 8.1.3.4 Method enableCapabilities() .38 8.1.3.5 Method disableCapabilities() 39 8.1.3.6 Method listEnabledCapabilities()39 8

16、.1.3.7 Method listAllCapabilities()39 8.1.3.8 Method isCapableOf().40 8.1.3.9 Method associateTypes() 40 8.1.3.10 Method disassociateTypes()41 8.1.3.11 Method listTypesOfAgent() 41 8.1.3.12 Method hasType() .41 8.1.3.13 Method getAgentAttributes() 42 8.1.3.14 Method setAgentAttributes().42 8.1.4 Int

17、erface Class IpPAMAgentAssignment.43 8.1.4.1 Method assignAgent().43 8.1.4.2 Method unassignAgent().44 8.1.4.3 Method listAssignedAgents()44 8.1.4.4 Method listAssociatedIdentitiesOfAgent()44 8.1.4.5 Method listAssignedAgentsByCapability() 45 8.1.4.6 Method listCapabilitiesOfIdentity() 45 8.1.4.7 Me

18、thod isIdentityCapableOf() 46 8.1.5 Interface Class IpPAMIdentityTypeManagement 46 8.1.5.1 Method createIdentityAttribute() 47 8.1.5.2 Method deleteIdentityAttribute() 47 8.1.5.3 Method getIdentityAttributeDefinition().48 8.1.5.4 Method listAllIdentityAttributes() 48 8.1.5.5 Method createIdentityTyp

19、e().48 8.1.5.6 Method deleteIdentityType().49 8.1.5.7 Method listIdentityTypes()49 8.1.5.8 Method addIdentityTypeAttributes() 49 8.1.5.9 Method removeIdentityTypeAttributes() 50 8.1.5.10 Method listIdentityTypeAttributes() .50 8.1.6 Interface Class IpPAMAgentTypeManagement .50 8.1.6.1 Method createA

20、gentAttribute().51 8.1.6.2 Method deleteAgentAttribute().51 8.1.6.3 Method getAgentAttributeDefinition() .52 8.1.6.4 Method listAllAgentAttributes().52 8.1.6.5 Method createAgentType() .52 8.1.6.6 Method deleteAgentType() .53 8.1.6.7 Method listAgentTypes() 53 8.1.6.8 Method addAgentTypeAttributes()

21、 .53 8.1.6.9 Method removeAgentTypeAttributes().54 8.1.6.10 Method listAgentTypeAttributes()54 ETSI ETSI ES 202 915-14 V1.2.1 (2005-03) 5 8.1.7 Interface Class IpPAMCapabilityManagement 54 8.1.7.1 Method createCapabilityAttribute() 55 8.1.7.2 Method deleteCapabilityAttribute() 56 8.1.7.3 Method getC

22、apabilityAttributeDefinition() 56 8.1.7.4 Method listAllCapabilityAttributes() 56 8.1.7.5 Method createCapability() 57 8.1.7.6 Method deleteCapability() 57 8.1.7.7 Method listCapabilities().57 8.1.7.8 Method addCapabilityAttributes() 58 8.1.7.9 Method removeCapabilityAttributes() 58 8.1.7.10 Method

23、listCapabilityAttributes() .58 8.1.7.11 Method assignCapabilitiesToType() .59 8.1.7.12 Method unassignCapabilitiesFromType().59 8.1.7.13 Method listCapabilitiesOfType() 59 8.2 PAM Access SCF Interface Classes.60 8.2.1 Interface Class IpPAMPresenceAvailabilityManager 60 8.2.1.1 Method getAuthToken()6

24、0 8.2.1.2 Method obtainInterface() 61 8.2.1.3 Method getAccessControl()61 8.2.1.4 Method setAccessControl() 61 8.2.2 Interface Class IpPAMIdentityPresence .62 8.2.2.1 Method setIdentityPresence()62 8.2.2.2 Method setIdentityPresenceExpiration().63 8.2.2.3 Method getIdentityPresence() .63 8.2.3 Inter

25、face Class IpPAMAvailability.64 8.2.3.1 Method getAvailability().65 8.2.3.2 Method getPreference().65 8.2.3.3 Method setPreference() .66 8.2.4 Interface Class IpPAMAgentPresence66 8.2.4.1 Method setAgentPresence() 67 8.2.4.2 Method setCapabilityPresence() .67 8.2.4.3 Method setAgentPresenceExpiratio

26、n()68 8.2.4.4 Method setCapabilityPresenceExpiration().68 8.2.4.5 Method getAgentPresence()69 8.2.4.6 Method getCapabilityPresence().69 8.2.5 Interface Class IpAppPAMPreferenceCheck70 8.2.5.1 Method computeAvailability()70 8.3 PAM Event SCF Interface Classes.71 8.3.1 Interface Class IpPAMEventManage

27、r 71 8.3.1.1 Method getAuthToken()71 8.3.1.2 Method obtainInterface() 72 8.3.1.3 Method getAccessControl()72 8.3.1.4 Method setAccessControl() 72 8.3.2 Interface Class IpPAMEventHandler73 8.3.2.1 Method isRegistered().73 8.3.2.2 Method registerAppInterface()74 8.3.2.3 Method registerForEvent()74 8.3

28、.2.4 Method deregisterAppInterface()75 8.3.2.5 Method deregisterFromEvent().75 8.3.3 Interface Class IpAppPAMEventHandler.75 8.3.3.1 Method eventNotify()76 8.3.3.2 Method eventNotifyErr() 76 9 State Transition Diagrams76 10 PAM Service Properties .76 10.1 PAM Provisioning service properties.77 10.2

29、PAM Access Service 77 10.3 PAM Event Service77 11 PAM Data Definitions78 11.1 Entity Address Definitions .78 11.1.1 TpPAMFQName.78 ETSI ETSI ES 202 915-14 V1.2.1 (2005-03) 6 11.1.2 TpPAMFQNameList 78 11.2 Attribute Data Definitions 78 11.2.1 TpPAMAttribute.78 11.2.2 TpPAMAttributeList.78 11.2.3 TpPA

30、MAttributeDef.79 11.2.4 TpPAMAttributeDefList.79 11.3 Presence Data Definitions 79 11.3.1 TpPAMCapability.79 11.3.2 TpPAMCapabilityList 79 11.3.3 TpPAMPresenceData79 11.3.4 TpPAMPresenceDataList .80 11.4 Pre-defined Presence type 80 11.4.1 Presentity 80 11.5 Availability Data Definitions .80 11.5.1

31、TpPAMAvailabilityProfile .80 11.5.2 TpPAMAvailabilityProfileList .80 11.5.3 TpPAMPrivacyCode.80 11.6 Availability Context Data Definitions80 11.6.1 TpPAMContext.81 11.6.2 TpPAMContextName .81 11.6.3 TpPAMContextData .81 11.6.4 TpPAMCommunicationContext .81 11.6.5 TpPAMContextList 81 11.7 Credential

32、data definitions82 11.7.1 TpPAMCredential.82 11.8 Availability and Access Control Preference Data Definitions .82 11.8.1 IpAppPAMPreferenceCheckRef.82 11.8.2 TpPAMAccessControlData 82 11.8.3 TpPAMACLDefault .82 11.8.4 TpPAMPreferenceOp .82 11.8.5 TpPAMPreferenceType 83 11.8.6 TpPAMPreferenceData.83

33、11.9 Time data definitions83 11.9.1 TpPAMTimeInterval 83 11.10 Pre-defined Entity Types and Attributes 83 11.11 Interface name definitions 84 11.11.1 TpPAMProvisioningInterfaceName .84 11.11.2 TpPAMPresenceAvailabilityInterfaceName.84 11.11.3 TpPAMEventInterfaceName 84 11.12 Event data definitions.8

34、5 11.12.1 IpAppPAMEventHandlerRef85 11.12.2 TpPAMClientID .85 11.12.3 TpPAMEventID85 11.12.4 TpPAMEventName 85 11.12.5 TpPAMEventNameList 85 11.12.6 TpPAMEventInfo .86 11.12.7 TpPAMEventInfoList .86 11.12.8 TpPAMNotificationInfo .86 11.12.9 TpPAMNotificationInfoList .86 11.12.10 PAM_CE_IDENTITY_CREA

35、TED87 11.12.10.1 TpPAMICEventData.87 11.12.10.2 TpPAMICNotificationData.87 11.12.11 PAM_CE_IDENTITY_DELETED 87 11.12.11.1 TpPAMIDEventData.87 11.12.11.2 TpPAMIDNotificationData.87 11.12.12 PAM_CE_GROUP_MEMBERSHIP_CHANGED88 11.12.12.1 TpPAMGMCEventData88 11.12.12.2 TpPAMGMCNotificationData88 11.12.13

36、 PAM_CE_AGENT_CREATED.88 11.12.13.1 TpPAMACEventData .88 11.12.13.2 TpPAMACNotificationData .88 11.12.14 PAM_CE_AGENT_DELETED .89 ETSI ETSI ES 202 915-14 V1.2.1 (2005-03) 7 11.12.14.1 TpPAMADEventData .89 11.12.14.2 TpPAMADNotificationData .89 11.12.15 PAM_CE_AGENT_ASSIGNED .89 11.12.15.1 TpPAMAAEve

37、ntData .89 11.12.15.2 TpPAMAANotificationData .90 11.12.16 PAM_CE_AGENT_UNASSIGNED90 11.12.16.1 TpPAMAUEventData .90 11.12.16.2 TpPAMAUNotificationData .90 11.12.17 PAM_CE_CAPABILITY_CHANGED90 11.12.17.1 TpPAMCCEventData .91 11.12.17.2 TpPAMCCNotificationData91 11.12.18 PAM_CE_AGENT_CAPABILITY_PRESE

38、NCE_SET.91 11.12.18.1 TpPAMACPSEventData.91 11.12.18.2 TpPAMACPSNotificationData.92 11.12.19 PAM_CE_AGENT_PRESENCE_SET 92 11.12.19.1 TpPAMAPSEventData .92 11.12.19.2 TpPAMAPSNotificationData92 11.12.20 PAM_CE_IDENTITY_PRESENCE_SET .92 11.12.20.1 TpPAMIPSEventData .93 11.12.20.2 TpPAMIPSNotificationD

39、ata .93 11.12.21 PAM_CE_AVAILABILITY_CHANGED.93 11.12.21.1 TpPAMAVCEventData 94 11.12.21.2 TpPAMAVCNotificationData 94 11.12.22 PAM_CE_WATCHERS_CHANGED .94 11.12.22.1 TpPAMWCEventData 95 11.12.22.2 TpPAMWCNotificationData 95 11.12.22.3 TpPAMwatcherChangeType.95 11.13 Error Types.96 11.13.1TpPAMError

40、Cause96 11.13.2TpPAMErrorInfo.96 12 Presence and Availability Management Exception Classes.96 Annex A (informative): Further PAM Information98 A.1 UML Models98 A.1.1 Identity .98 A.1.2 Agent 99 A.2 Model .99 A.3 Architecture100 A.4 Levels of access101 A.4.1 Application.102 A.4.2 Service102 A.4.3 Thi

41、n client 102 A.5 Use cases 103 A.5.1 Identity Management103 A.5.2 Agent Management 103 A.5.3 Agent Assignment 104 A.5.4 Agent Presence.104 A.5.5 Identity Presence 104 A.5.6 Availability.104 Annex B (normative): OMG IDL Description of Presence and Availability Management SCF105 Annex C (informative):

42、 Java API Description of the Presence and Availability Management SCFs.106 Annex D (informative): Contents of 3GPP OSA R5 Presence and Availability Management107 ETSI ETSI ES 202 915-14 V1.2.1 (2005-03) 8 Annex E (informative): Record of changes 108 E.1 Interfaces 108 E.1.1 New 108 E.1.2 Deprecated1

43、08 E.1.3 Modified.108 E.1.4 Removed.108 E.2 Methods109 E.2.1 New 109 E.2.2 Deprecated109 E.2.3 Modified.109 E.2.4 Removed.110 E.3 Data Definitions .110 E.3.1 New 110 E.3.2 Modified.110 E.3.3 Removed.110 E.4 Service Properties.111 E.4.1 New 111 E.4.2 Deprecated111 E.4.3 Modified.111 E.4.4 Removed.111

44、 E.5 Exceptions 111 E.5.1 New 111 E.5.2 Modified.112 E.5.3 Removed.112 E.6 Others .112 History 113 ETSI ETSI ES 202 915-14 V1.2.1 (2005-03) 9 Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The information pertaining to the

45、se essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, which is available from the ETSI Secretariat. Latest

46、 updates are available on the ETSI Web server (http:/webapp.etsi.org/IPR/home.asp). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates o

47、n the ETSI Web server) which are, or may be, or may become, essential to the present document. Foreword This ETSI Standard (ES) has been produced by ETSI Technical Committee Telecommunications and Internet converged Services and Protocols for Advanced Networking (TISPAN). The present document is par

48、t 14 of a multi-part deliverable covering Open Service Access (OSA); Application Programming Interface (API), as identified below. The API specification (ES 202 915) is structured in the following parts: Part 1: “Overview“; Part 2: “Common Data Definitions“; Part 3: “Framework“; Part 4: “Call Contro

49、l“; Part 5: “User Interaction SCF“; Part 6: “Mobility SCF“; Part 7: “Terminal Capabilities SCF“; Part 8: “Data Session Control SCF“; Part 9: “Generic Messaging SCF“; Part 10: “Connectivity Manager SCF“; Part 11: “Account Management SCF“; Part 12: “Charging SCF“; Part 13: “Policy management SCF“; Part 14: “Presence and Availability Management SCF“. The present document has been defined jointly between ETSI, The Parlay Group (http:/www.parlay.org) and the 3GPP, in co-operation with a number of JAIN Community (http:/ member companies. The presen