OSID Logo
OSID Specifications
authentication keys package
Version 3.0.0
Release Candidate Preview
Interfaceosid.authentication.keys.KeyNotificationSession
Implementsosid.OsidSession
Description

This session defines methods to receive asynchronous notifications on adds/changes to Key objects. This session is intended for consumers needing to synchronize their state with this service without the use of polling. Notifications are cancelled when this session is closed.

The two views defined in this session correspond to the views in the KeyLookupSession.

MethodgetAgencyId
Description

Gets the Agency Id associated with this session.

Returnosid.id.Idthe Agency Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetAgency
Description

Gets the Agency associated with this session.

Returnosid.authentication.Agencythe Agency associated with this session
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanRegisterForKeyNotifications
Description

Tests if this user can register for Key notifications. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer notification operations.

Returnboolean false if notification methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethoduseFederatedAgencyView
Description

Federates the view for methods in this session. A federated view will include keys in agencies which are children of this agency in the agency hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedAgencyView
Description

Isolates the view for methods in this session. An isolated view restricts notifications to this agency only.

CompliancemandatoryThis method is must be implemented.
MethodreliableKeyNotifications
Description

Reliable notifications are desired. In reliable mode, notifications are to be acknowledged using acknowledgeKeyNotification() .

CompliancemandatoryThis method is must be implemented.
MethodunreliableKeyNotifications
Description

Unreliable notifications are desired. In unreliable mode, notifications do not need to be acknowledged.

CompliancemandatoryThis method is must be implemented.
MethodacknowledgeKeyNotification
Description

Acknowledge a key notification.

Parametersosid.id.IdnotificationIdthe Id of the notification
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForNewKeys
Description

Register for notifications of new keys. KeyReceiver.newKeys() is invoked when a new Key is created.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedKeys
Description

Registers for notification of updated keys. KeyReceiver.changedKeys() is invoked when an key is changed.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForChangedKey
Description

Registers for notification of an updated key. KeyReceiver.changedKeys() is invoked when the specified key is changed.

Parametersosid.id.IdkeyIdthe Id of the Key to monitor
ErrorsNULL_ARGUMENT keyId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedKeys
Description

Registers for notification of deleted keys. KeyReceiver.deletedKeys() is invoked when an key is removed from this agency.

ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodregisterForDeletedKey
Description

Registers for notification of a deleted key. KeyReceiver.deletedKeys() is invoked when the specified key is removed from this agency.

Parametersosid.id.IdkeyIdthe Id of the Key to monitor
ErrorsNULL_ARGUMENT keyId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.