1、 ETSI ES 204 915-14 V1.1.1 (2008-05)ETSI Standard Open Service Access (OSA);Application Programming Interface (API);Part 14: Presence and Availability Management SCF(Parlay 6)floppy3 ETSI ETSI ES 204 915-14 V1.1.1 (2008-05) 2 Reference DES/TISPAN-01032-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 2008. The Parlay Group 2008. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTM, TIPHONTM, the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered for the benefit of
7、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 204 915-14 V1.1.1 (2008-05) 3 Contents Intellectual Property Rights9 Foreword.9 1 Scope 10 2 References 10 3 Definitions and abbreviations.10 3.1 Definitions10
8、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 Scope of PAM information 15 4.6 Security and privacy.15 5 Sequence Diag
9、rams 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 Service Interface Specifications22 7.1 Interface Specification Format .
10、22 7.1.1 Interface Class 22 7.1.2 Method descriptions22 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 Interface .23 7.4.1 Interface Class IpService 23 7.4.1.1 Method setC
11、allback()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 getAuthToken()25 8.1.1.2 Method obtainInterface() 26 8.1.1.3 Method getAc
12、cessControl() 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().28 8.1.2.3 Method isIdentity()29 ETSI ETSI ES 204 915-14 V1.1.1 (2008-05) 4 8.1.2.4 Method createGroupIdentity().29 8.1.2.5 Method
13、 deleteGroupIdentity().29 8.1.2.6 Method addToGroup() 30 8.1.2.7 Method removeFromGroup()30 8.1.2.8 Method listMembers().30 8.1.2.9 Method isGroupIdentity() .31 8.1.2.10 Method listGroupMembership() .31 8.1.2.11 Method addAlias() 32 8.1.2.12 Method removeAliases().32 8.1.2.13 Method listAliases()32
14、8.1.2.14 Method lookupByAlias() 33 8.1.2.15 Method associateTypes() 33 8.1.2.16 Method disassociateTypes()33 8.1.2.17 Method listTypesOfIdentity() .34 8.1.2.18 Method hasType() .34 8.1.2.19 Method getIdentityAttributes() .35 8.1.2.20 Method setIdentityAttributes()35 8.1.3 Interface Class IpPAMAgentM
15、anagement .36 8.1.3.1 Method createAgent() .37 8.1.3.2 Method deleteAgent() .37 8.1.3.3 Method isAgent() 37 8.1.3.4 Method enableCapabilities() .38 8.1.3.5 Method disableCapabilities() 38 8.1.3.6 Method listEnabledCapabilities()38 8.1.3.7 Method listAllCapabilities()39 8.1.3.8 Method isCapableOf().3
16、9 8.1.3.9 Method associateTypes() 39 8.1.3.10 Method disassociateTypes()40 8.1.3.11 Method listTypesOfAgent() 40 8.1.3.12 Method hasType() .41 8.1.3.13 Method getAgentAttributes() 41 8.1.3.14 Method setAgentAttributes().42 8.1.4 Interface Class IpPAMAgentAssignment.42 8.1.4.1 Method assignAgent().43
17、 8.1.4.2 Method unassignAgent().43 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 Method isIdentityCapableOf() 45 8.1.5 Interface Class IpPAMIdentityTyp
18、eManagement 46 8.1.5.1 Method createIdentityAttribute() 46 8.1.5.2 Method deleteIdentityAttribute() 47 8.1.5.3 Method getIdentityAttributeDefinition().47 8.1.5.4 Method listAllIdentityAttributes() 47 8.1.5.5 Method createIdentityType().48 8.1.5.6 Method deleteIdentityType().48 8.1.5.7 Method listIde
19、ntityTypes()48 8.1.5.8 Method addIdentityTypeAttributes() 49 8.1.5.9 Method removeIdentityTypeAttributes() 49 8.1.5.10 Method listIdentityTypeAttributes() .49 8.1.6 Interface Class IpPAMAgentTypeManagement .50 8.1.6.1 Method createAgentAttribute().50 8.1.6.2 Method deleteAgentAttribute().51 8.1.6.3
20、Method getAgentAttributeDefinition() .51 8.1.6.4 Method listAllAgentAttributes().51 8.1.6.5 Method createAgentType() .52 8.1.6.6 Method deleteAgentType() .52 8.1.6.7 Method listAgentTypes() 52 8.1.6.8 Method addAgentTypeAttributes() .52 8.1.6.9 Method removeAgentTypeAttributes().53 8.1.6.10 Method l
21、istAgentTypeAttributes()53 ETSI ETSI ES 204 915-14 V1.1.1 (2008-05) 5 8.1.7 Interface Class IpPAMCapabilityManagement 54 8.1.7.1 Method createCapabilityAttribute() 54 8.1.7.2 Method deleteCapabilityAttribute() 55 8.1.7.3 Method getCapabilityAttributeDefinition() 55 8.1.7.4 Method listAllCapabilityAt
22、tributes() 55 8.1.7.5 Method createCapability() 56 8.1.7.6 Method deleteCapability() 56 8.1.7.7 Method listCapabilities().56 8.1.7.8 Method addCapabilityAttributes() 57 8.1.7.9 Method removeCapabilityAttributes() 57 8.1.7.10 Method listCapabilityAttributes() .57 8.1.7.11 Method assignCapabilitiesToT
23、ype() .58 8.1.7.12 Method unassignCapabilitiesFromType().58 8.1.7.13 Method listCapabilitiesOfType() 58 8.2 PAM Access SCF Interface Classes.59 8.2.1 Interface Class IpPAMPresenceAvailabilityManager 59 8.2.1.1 Method getAuthToken()59 8.2.1.2 Method obtainInterface() 60 8.2.1.3 Method getAccessContro
24、l() 60 8.2.1.4 Method setAccessControl().61 8.2.1.5 Method activateService() 61 8.2.1.6 Method deactivateService().61 8.2.1.7 Method isActiveIdentity().62 8.2.2 Interface Class IpPAMIdentityPresence .62 8.2.2.1 Method setIdentityPresence()63 8.2.2.2 Method setIdentityPresenceExpiration().63 8.2.2.3
25、Method getIdentityPresence() .63 8.2.3 Interface Class IpPAMAvailability.64 8.2.3.1 Method getAvailability().65 8.2.3.2 Method getPreference().66 8.2.3.3 Method setPreference() .66 8.2.4 Interface Class IpPAMAgentPresence67 8.2.4.1 Method setAgentPresence() 67 8.2.4.2 Method setCapabilityPresence()
26、.68 8.2.4.3 Method setAgentPresenceExpiration()68 8.2.4.4 Method setCapabilityPresenceExpiration().69 8.2.4.5 Method getAgentPresence()69 8.2.4.6 Method getCapabilityPresence().70 8.2.5 Interface Class IpAppPAMPreferenceCheck70 8.2.5.1 Method computeAvailability()70 8.3 PAM Event SCF Interface Class
27、es.71 8.3.1 Interface Class IpPAMEventManager 71 8.3.1.1 Method getAuthToken()72 8.3.1.2 Method obtainInterface() 72 8.3.1.3 Method getAccessControl() 73 8.3.1.4 Method setAccessControl().73 8.3.1.5 Method activateService() 74 8.3.1.6 Method deactivateService().74 8.3.1.7 Method isActiveIdentity().7
28、4 8.3.2 Interface Class IpPAMEventHandler75 8.3.2.1 Method isRegistered().75 8.3.2.2 Method registerAppInterface()76 8.3.2.3 Method registerForEvent()76 8.3.2.4 Method deregisterAppInterface()76 8.3.2.5 Method deregisterFromEvent().77 8.3.3 Interface Class IpAppPAMEventHandler.77 8.3.3.1 Method even
29、tNotify()77 8.3.3.2 Method eventNotifyErr() 78 9 State Transition Diagrams78 10 PAM Service Properties .78 ETSI ETSI ES 204 915-14 V1.1.1 (2008-05) 6 10.1 PAM Access Service 79 10.2 PAM Event Service79 11 PAM Data Definitions79 11.1 Entity Address Definitions .79 11.1.1 TpPAMFQName.79 11.1.2 TpPAMFQ
30、NameList 79 11.2 Attribute Data Definitions 79 11.2.1 TpPAMAttribute.79 11.2.2 TpPAMAttributeList.79 11.2.3 TpPAMAttributeDef.80 11.2.4 TpPAMAttributeDefList.80 11.3 Presence Data Definitions 80 11.3.1 TpPAMCapability.80 11.3.2 TpPAMCapabilityList 80 11.3.3 TpPAMPresenceData80 11.3.4 TpPAMPresenceDa
31、taList .81 11.4 Pre-defined Presence type 81 11.4.1 Presentity 81 11.5 Availability Data Definitions .81 11.5.1 TpPAMAvailabilityProfile .81 11.5.2 TpPAMAvailabilityProfileList .81 11.5.3 TpPAMPrivacyCode.81 11.6 Availability Context Data Definitions81 11.6.1 TpPAMContext.82 11.6.2 TpPAMContextName
32、.82 11.6.3 TpPAMContextData .82 11.6.4 TpPAMCommunicationContext .82 11.6.5 TpPAMContextList 82 11.7 Credential data definitions83 11.7.1 TpPAMCredential.83 11.8 Availability and Access Control Preference Data Definitions .83 11.8.1 IpAppPAMPreferenceCheckRef.83 11.8.2 TpPAMAccessControlData 83 11.8
33、.3 TpPAMACLDefault .83 11.8.4 TpPAMPreferenceOp .83 11.8.5 TpPAMPreferenceType 84 11.8.6 TpPAMPreferenceData.84 11.9 Time data definitions84 11.9.1 TpPAMTimeInterval 84 11.10 Pre-defined Entity Types and Attributes 84 11.11 Interface name definitions 85 11.11.1 TpPAMProvisioningInterfaceName .85 11.
34、11.2 TpPAMPresenceAvailabilityInterfaceName.85 11.11.3 TpPAMEventInterfaceName 85 11.12 Event data definitions.86 11.12.1 IpAppPAMEventHandlerRef86 11.12.2 TpPAMClientID .86 11.12.3 TpPAMEventID86 11.12.4 TpPAMEventName 86 11.12.5 TpPAMEventNameList 86 11.12.6 TpPAMEventInfo .86 11.12.7 TpPAMEventIn
35、foList .87 11.12.8 TpPAMNotificationInfo .87 11.12.9 TpPAMNotificationInfoList .87 11.12.10 PAM_CE_IDENTITY_CREATED87 11.12.10.1 TpPAMICEventData.88 11.12.10.2 TpPAMICNotificationData.88 11.12.11 PAM_CE_IDENTITY_DELETED 88 11.12.11.1 TpPAMIDEventData.88 11.12.11.2 TpPAMIDNotificationData.88 11.12.12
36、 PAM_CE_GROUP_MEMBERSHIP_CHANGED88 ETSI ETSI ES 204 915-14 V1.1.1 (2008-05) 7 11.12.12.1 TpPAMGMCEventData89 11.12.12.2 TpPAMGMCNotificationData89 11.12.13 PAM_CE_AGENT_CREATED.89 11.12.13.1 TpPAMACEventData .89 11.12.13.2 TpPAMACNotificationData .89 11.12.14 PAM_CE_AGENT_DELETED .89 11.12.14.1 TpPA
37、MADEventData .90 11.12.14.2 TpPAMADNotificationData .90 11.12.15 PAM_CE_AGENT_ASSIGNED .90 11.12.15.1 TpPAMAAEventData .90 11.12.15.2 TpPAMAANotificationData .91 11.12.16 PAM_CE_AGENT_UNASSIGNED91 11.12.16.1 TpPAMAUEventData .91 11.12.16.2 TpPAMAUNotificationData .91 11.12.17 PAM_CE_CAPABILITY_CHANG
38、ED91 11.12.17.1 TpPAMCCEventData .92 11.12.17.2 TpPAMCCNotificationData92 11.12.18 PAM_CE_AGENT_CAPABILITY_PRESENCE_SET.92 11.12.18.1 TpPAMACPSEventData.92 11.12.18.2 TpPAMACPSNotificationData.93 11.12.19 PAM_CE_AGENT_PRESENCE_SET 93 11.12.19.1 TpPAMAPSEventData .93 11.12.19.2 TpPAMAPSNotificationDa
39、ta93 11.12.20 PAM_CE_IDENTITY_PRESENCE_SET .93 11.12.20.1 TpPAMIPSEventData .94 11.12.20.2 TpPAMIPSNotificationData .94 11.12.21 PAM_CE_AVAILABILITY_CHANGED.94 11.12.21.1 TpPAMAVCEventData 94 11.12.21.2 TpPAMAVCNotificationData 95 11.12.22 PAM_CE_WATCHERS_CHANGED .95 11.12.22.1 TpPAMWCEventData 95 1
40、1.12.22.2 TpPAMWCNotificationData 96 11.12.22.3 TpPAMwatcherChangeType.96 11.13 Error Types.96 11.13.1 TpPAMErrorCause .96 11.13.2 TpPAMErrorInfo 96 12 Presence and Availability Management Exception Classes.97 Annex A (informative): Further PAM Information98 A.1 UML Models98 A.1.1 Identity .98 A.1.2
41、 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 Thin client 102 A.5 Use cases 102 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 Availabilit
42、y.104 Annex B (normative): OMG IDL Description of Presence and Availability Management SCF105 ETSI ETSI ES 204 915-14 V1.1.1 (2008-05) 8 Annex C (informative): W3C WSDL Description of the Presence and Availability Management SCFs.106 Annex D (informative): Java API Description of the Presence and Av
43、ailability Management SCFs.107 Annex E (informative): Contents of 3GPP OSA R7 Presence and Availability Management108 Annex F (informative): Description of Presence and Availability Management for 3GPP2 cdma2000 networks .109 F.1 General Exceptions.109 F.2 Specific Exceptions109 F.2.1 Clause 1: Scop
44、e 109 F.2.2 Clause 2: References 109 F.2.3 Clause 3: Definitions and abbreviations.109 F.2.4 Clause 4: Presence and Availability Management SCF .109 F.2.5 Clause 5: Sequence Diagrams 109 F.2.6 Clause 6: Class Diagrams.109 F.2.7 Clause 7: The Service Interface Specifications 109 F.2.8 Clause 8: Prese
45、nce and Availability Management Interface Classes .110 F.2.9 Clause 9: State Transition Diagrams 110 F.2.10 Clause 10: PAM Service Properties .110 F.2.11 Clause 11: PAM Data Definitions110 F.2.12 Clause 12: Presence and Availability Management Exception Classes .110 F.2.13 Annex B (normative): OMG I
46、DL Description of Presence and Availability Management SCF .110 F.2.14 Annex D (informative): Java API Description of Presence and Availability Management SCF .110 Annex G (informative): Record of changes 111 G.1 Interfaces 111 G.1.1 New 111 G.1.2 Deprecated111 G.1.3 Modified.111 G.1.4 Removed.111 G
47、.2 Methods111 G.2.1 New 111 G.2.2 Deprecated112 G.2.3 Modified.112 G.2.4 Removed.112 G.3 Data Definitions .112 G.3.1 New 112 G.3.2 Modified.112 G.3.3 Removed .112 G.4 Service Properties.113 G.4.1 New 113 G.4.2 Deprecated113 G.4.3 Modified.113 G.4.4 Removed.113 G.5 Exceptions 113 G.5.1 New 113 G.5.2
48、Modified.113 G.5.3 Removed.114 G.6 Others .114 History 115 ETSI ETSI ES 204 915-14 V1.1.1 (2008-05) 9 Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The information pertaining to these essential IPRs, if any, is publicly a
49、vailable 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 referenced in ETSI SR 000 314 (or the updates on the ETSI Web serve
