ETSI ES 203 915-14-2007 Open Service Access (OSA) Application Programming Interface (API) Part 14 Presence and Availability Management SCF (Parlay 5)《开放业务接入(OSA) 应用编程接口(API) 第14部分 _1.pdf

1、 ETSI ES 203 915-14 V1.2.1 (2007-01)ETSI Standard Open Service Access (OSA);Application Programming Interface (API);Part 14: Presence and Availability Management SCF(Parlay 5)floppy3 ETSI ETSI ES 203 915-14 V1.2.1 (2007-01) 2 Reference RES/TISPAN-01029-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 2007. The Parlay Group 2007. 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 203 915-14 V1.2.1 (2007-01) 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 16 5.2 Event registration and notification .17 6 Class Diagrams.18 6.1 PAM Provisioning SCF Class Diagrams18 6.2 PAM Access SCF Class Diagrams.19 6.3 PAM Event SCF Class Diagrams.20 7 The Se

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

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

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

13、1 (2007-01) 4 8.1.2.4 Method createGroupIdentity().28 8.1.2.5 Method deleteGroupIdentity().28 8.1.2.6 Method addToGroup() 29 8.1.2.7 Method removeFromGroup()29 8.1.2.8 Method listMembers().29 8.1.2.9 Method isGroupIdentity() .30 8.1.2.10 Method listGroupMembership() .30 8.1.2.11 Method addAlias() 30

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

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

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

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

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

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

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

21、 .51 8.1.6.9 Method removeAgentTypeAttributes().52 8.1.6.10 Method listAgentTypeAttributes()52 ETSI ETSI ES 203 915-14 V1.2.1 (2007-01) 5 8.1.7 Interface Class IpPAMCapabilityManagement 52 8.1.7.1 Method createCapabilityAttribute() 53 8.1.7.2 Method deleteCapabilityAttribute() 53 8.1.7.3 Method getC

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

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

24、8 8.2.1.2 Method obtainInterface() 58 8.2.1.3 Method getAccessControl()59 8.2.1.4 Method setAccessControl() 59 8.2.1.5 Method activateService()60 8.2.1.6 Method deactivateService()60 8.2.1.7 Method isActiveIdentity() 60 8.2.2 Interface Class IpPAMIdentityPresence .61 8.2.2.1 Method setIdentityPresen

25、ce()61 8.2.2.2 Method setIdentityPresenceExpiration().62 8.2.2.3 Method getIdentityPresence() .62 8.2.3 Interface Class IpPAMAvailability.63 8.2.3.1 Method getAvailability().63 8.2.3.2 Method getPreference().64 8.2.3.3 Method setPreference() .64 8.2.4 Interface Class IpPAMAgentPresence65 8.2.4.1 Met

26、hod setAgentPresence() 66 8.2.4.2 Method setCapabilityPresence() .66 8.2.4.3 Method setAgentPresenceExpiration()66 8.2.4.4 Method setCapabilityPresenceExpiration().67 8.2.4.5 Method getAgentPresence()67 8.2.4.6 Method getCapabilityPresence().68 8.2.5 Interface Class IpAppPAMPreferenceCheck69 8.2.5.1

27、 Method computeAvailability()69 8.3 PAM Event SCF Interface Classes.69 8.3.1 Interface Class IpPAMEventManager 70 8.3.1.1 Method getAuthToken()70 8.3.1.2 Method obtainInterface() 70 8.3.1.3 Method getAccessControl()71 8.3.1.4 Method setAccessControl() 71 8.3.1.5 Method activateService()72 8.3.1.6 Me

28、thod deactivateService()72 8.3.1.7 Method isActiveIdentity() 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.2.4 Method deregisterAppInterface()74 8.3.2.5 Method deregisterFromEvent().75 8.3

29、.3 Interface Class IpAppPAMEventHandler.75 8.3.3.1 Method eventNotify()75 8.3.3.2 Method eventNotifyErr() 76 9 State Transition Diagrams76 10 PAM Service Properties .76 ETSI ETSI ES 203 915-14 V1.2.1 (2007-01) 6 10.1 PAM Access Service 76 10.2 PAM Event Service77 11 PAM Data Definitions77 11.1 Entit

30、y Address Definitions .77 11.1.1 TpPAMFQName.77 11.1.2 TpPAMFQNameList 77 11.2 Attribute Data Definitions 77 11.2.1 TpPAMAttribute.77 11.2.2 TpPAMAttributeList.77 11.2.3 TpPAMAttributeDef.77 11.2.4 TpPAMAttributeDefList.78 11.3 Presence Data Definitions 78 11.3.1 TpPAMCapability.78 11.3.2 TpPAMCapab

31、ilityList 78 11.3.3 TpPAMPresenceData78 11.3.4 TpPAMPresenceDataList .78 11.4 Pre-defined Presence type 79 11.4.1 Presentity 79 11.5 Availability Data Definitions .79 11.5.1 TpPAMAvailabilityProfile .79 11.5.2 TpPAMAvailabilityProfileList .79 11.5.3 TpPAMPrivacyCode.79 11.6 Availability Context Data

32、 Definitions79 11.6.1 TpPAMContext.80 11.6.2 TpPAMContextName .80 11.6.3 TpPAMContextData .80 11.6.4 TpPAMCommunicationContext .80 11.6.5 TpPAMContextList 80 11.7 Credential data definitions81 11.7.1 TpPAMCredential.81 11.8 Availability and Access Control Preference Data Definitions .81 11.8.1 IpApp

33、PAMPreferenceCheckRef.81 11.8.2 TpPAMAccessControlData 81 11.8.3 TpPAMACLDefault .81 11.8.4 TpPAMPreferenceOp .81 11.8.5 TpPAMPreferenceType 82 11.8.6 TpPAMPreferenceData.82 11.9 Time data definitions82 11.9.1 TpPAMTimeInterval 82 11.10 Pre-defined Entity Types and Attributes 82 11.11 Interface name

34、 definitions 83 11.11.1 TpPAMProvisioningInterfaceName .83 11.11.2 TpPAMPresenceAvailabilityInterfaceName.83 11.11.3 TpPAMEventInterfaceName 83 11.12 Event data definitions.84 11.12.1 IpAppPAMEventHandlerRef84 11.12.2 TpPAMClientID .84 11.12.3 TpPAMEventID84 11.12.4 TpPAMEventName 84 11.12.5 TpPAMEv

35、entNameList 84 11.12.6 TpPAMEventInfo .85 11.12.7 TpPAMEventInfoList .85 11.12.8 TpPAMNotificationInfo .85 11.12.9 TpPAMNotificationInfoList .85 11.12.10 PAM_CE_IDENTITY_CREATED86 11.12.10.1.1 TpPAMICEventData.86 11.12.10.1.2 TpPAMICNotificationData.86 11.12.11 PAM_CE_IDENTITY_DELETED 86 11.12.11.1

36、TpPAMIDEventData.86 11.12.11.2 TpPAMIDNotificationData.86 11.12.12 PAM_CE_GROUP_MEMBERSHIP_CHANGED87 ETSI ETSI ES 203 915-14 V1.2.1 (2007-01) 7 11.12.12.1 TpPAMGMCEventData87 11.12.12.2 TpPAMGMCNotificationData87 11.12.13 PAM_CE_AGENT_CREATED.87 11.12.13.1 TpPAMACEventData .87 11.12.13.2 TpPAMACNoti

37、ficationData .87 11.12.14 PAM_CE_AGENT_DELETED .88 11.12.14.1 TpPAMADEventData .88 11.12.14.2 TpPAMADNotificationData .88 11.12.15 PAM_CE_AGENT_ASSIGNED .88 11.12.15.1 TpPAMAAEventData .88 11.12.15.2 TpPAMAANotificationData .89 11.12.16 PAM_CE_AGENT_UNASSIGNED89 11.12.16.1 TpPAMAUEventData .89 11.12

38、.16.2 TpPAMAUNotificationData .89 11.12.17 PAM_CE_CAPABILITY_CHANGED89 11.12.17.1 TpPAMCCEventData .90 11.12.17.2 TpPAMCCNotificationData90 11.12.18 PAM_CE_AGENT_CAPABILITY_PRESENCE_SET.90 11.12.18.1 TpPAMACPSEventData.90 11.12.18.2 TpPAMACPSNotificationData.91 11.12.19 PAM_CE_AGENT_PRESENCE_SET 91

39、11.12.19.1 TpPAMAPSEventData .91 11.12.19.2 TpPAMAPSNotificationData91 11.12.20 PAM_CE_IDENTITY_PRESENCE_SET .91 11.12.20.1 TpPAMIPSEventData .92 11.12.20.2 TpPAMIPSNotificationData .92 11.12.21 PAM_CE_AVAILABILITY_CHANGED.92 11.12.21.1 TpPAMAVCEventData 93 11.12.21.2 TpPAMAVCNotificationData 93 11.

40、12.22 PAM_CE_WATCHERS_CHANGED .93 11.12.22.1 TpPAMWCEventData 94 11.12.22.2 TpPAMWCNotificationData 94 11.12.22.3 TpPAMwatcherChangeType.94 11.13 Error Types.95 11.13.1 TpPAMErrorCause .95 11.13.2 TpPAMErrorInfo 95 12 Presence and Availability Management Exception Classes.95 Annex A (informative): F

41、urther PAM Information97 A.1 UML Models97 A.1.1 Identity .97 A.1.2 Agent 98 A.2 Model .98 A.3 Architecture99 A.4 Levels of access100 A.4.1 Application.101 A.4.2 Service101 A.4.3 Thin client 101 A.5 Use cases 102 A.5.1 Identity Management102 A.5.2 Agent Management 102 A.5.3 Agent Assignment 103 A.5.4

42、 Agent Presence.103 A.5.5 Identity Presence 103 A.5.6 Availability.103 Annex B (normative): OMG IDL Description of Presence and Availability Management SCF104 ETSI ETSI ES 203 915-14 V1.2.1 (2007-01) 8 Annex C (informative): W3C WSDL Description of the Presence and Availability Management SCFs.105 A

43、nnex D (informative): Java API Description of the Presence and Availability Management SCFs.106 Annex E (informative): Contents of 3GPP OSA R6 Presence and Availability Management107 Annex F (informative): Description of Presence and Availability Management for 3GPP2 cdma2000 networks .108 F.1 Gener

44、al Exceptions.108 F.2 Specific Exceptions108 F.2.1 Clause 1: Scope 108 F.2.2 Clause 2: References 108 F.2.3 Clause 3: Definitions and abbreviations.108 F.2.4 Clause 4: Presence and Availability Management SCF .108 F.2.5 Clause 5: Sequence Diagrams 108 F.2.6 Clause 6: Class Diagrams.108 F.2.7 Clause

45、7: The Service Interface Specifications 108 F.2.8 Clause 8: Presence and Availability Management Interface Classes .109 F.2.9 Clause 9: State Transition Diagrams 109 F.2.10 Clause 10: PAM Service Properties .109 F.2.11 Clause 11: PAM Data Definitions109 F.2.12 Clause 12: Presence and Availability Ma

46、nagement Exception Classes .109 F.2.13 Annex B (normative): OMG IDL Description of Presence and Availability Management SCF .109 F.2.14 Annex D (informative): Java API Description of Presence and Availability Management SCF .109 Annex G (informative): Record of changes 110 G.1 Interfaces 110 G.1.1 N

47、ew 110 G.1.2 Deprecated110 G.1.3 Modified.110 G.1.4 Removed.110 G.2 Methods111 G.2.1 New 111 G.2.2 Deprecated111 G.2.3 Modified.111 G.2.4 Removed.111 G.3 Data Definitions .112 G.3.1 New 112 G.3.2 Modified.112 G.3.3 Removed.112 G.4 Service Properties.112 G.4.1 New 112 G.4.2 Deprecated112 G.4.3 Modifi

48、ed.113 G.4.4 Removed.113 G.5 Exceptions 113 G.5.1 New 113 G.5.2 Modified.113 G.5.3 Removed.113 G.6 Others .113 History 114 ETSI ETSI ES 203 915-14 V1.2.1 (2007-01) 9 Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The infor

49、mation pertaining to these 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 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 refe