OSID - osid.authentication.AuthenticationManager Service Interface Definition

Interface	osid.authentication.AuthenticationManager
Implements	`osid.OsidManager`
Implements	`osid.authentication.AuthenticationProfile`
Description	The authentication manager provides access to authentication sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are: `AgentLookupSession:` a session to look up `Agents` `AgentQuerySession:` a session to query `Agents` `AgentSearchSession:` a session to search `Agents` `AgentAdminSession:` a session to create, modify and delete `Agents` `AgentNotificationSession: a` session to receive messages pertaining to `Agent` changes `AgentAgencySession:` a session to retrieve `Agent` to `Agency` mappings `AgentAgencyAssignmentSession:` a session to manage `Agent` to `Agency` mappings `AgentSmartAgencySession:` a session to create dynamic agencies `AgencyLookupSession:` a session to lookup agencies `AgencyQuerySession:` a session to query agencies `AgencySearchSession` : a session to search agencies `AgencyAdminSession` : a session to create, modify and delete agencies `AgencyNotificationSession` : a session to receive messages pertaining to `Agency` changes `AgencyHierarchySession` : a session to traverse the `Agency` hierarchy `AgencyHierarchyDesignSession` : a session to manage the `Agency` hierarchy
Method	getAgentLookupSession
Description	Gets the `OsidSession` associated with the agent lookup service.
Return	`osid.authentication.AgentLookupSession`		an `AgentLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgentLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentLookup()` is `true.`
Method	getAgentLookupSessionForAgency
Description	Gets the `OsidSession` associated with the agent lookup service for the given agency.
Parameters	`osid.id.Id`	`agencyId`	the `Id` of the agency
Return	`osid.authentication.AgentLookupSession`		`an AgentLookupSession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agencyId` is `null`
	OPERATION_FAILED		`unable to complete request`
	UNIMPLEMENTED		`supportsAgentLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentLookup()` and `supportsVisibleFederation()` are `true.`
Method	getAgentQuerySession
Description	Gets the `OsidSession` associated with the agent query service.
Return	`osid.authentication.AgentQuerySession`		an `AgentQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgentQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentQuery()` is `true.`
Method	getAgentQuerySessionForAgency
Description	Gets the `OsidSession` associated with the agent query service for the given agency.
Parameters	`osid.id.Id`	`agencyId`	the `Id` of the agency
Return	`osid.authentication.AgentQuerySession`		`an AgentQuerySession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agencyId` is `null`
	OPERATION_FAILED		`unable to complete request`
	UNIMPLEMENTED		`supportsAgentQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentQuery()` and `supportsVisibleFederation()` are `true.`
Method	getAgentSearchSession
Description	Gets the `OsidSession` associated with the agent search service.
Return	`osid.authentication.AgentSearchSession`		an `AgentSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgentSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentSearch()` is `true.`
Method	getAgentSearchSessionForAgency
Description	Gets the `OsidSession` associated with the agent search service for the given agency.
Parameters	`osid.id.Id`	`agencyId`	the `Id` of the agency
Return	`osid.authentication.AgentSearchSession`		`an AgentSearchSession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agencyId` is `null`
	OPERATION_FAILED		`unable to complete request`
	UNIMPLEMENTED		`supportsAgentSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentSearch()` and `supportsVisibleFederation()` are `true.`
Method	getAgentAdminSession
Description	Gets the `OsidSession` associated with the agent administration service.
Return	`osid.authentication.AgentAdminSession`		an `AgentAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgentAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentAdmin()` is `true.`
Method	getAgentAdminSessionForAgency
Description	Gets the `OsidSession` associated with the agent admin service for the given agency.
Parameters	`osid.id.Id`	`agencyId`	the `Id` of the agency
Return	`osid.authentication.AgentAdminSession`		`an AgentAdminSession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agencyId` is `null`
	OPERATION_FAILED		`unable to complete request`
	UNIMPLEMENTED		`supportsAgentAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentAdmin()` and `supportsVisibleFederation()` are `true.`
Method	getAgentNotificationSession
Description	Gets the notification session for notifications pertaining to service changes.
Parameters	`osid.authentication.AgentReceiver`	`agentReceiver`	the agent receiver
Return	`osid.authentication.AgentNotificationSession`		an `AgentNotificationSession`
Errors	NULL_ARGUMENT		`agentReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAgentNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentNotification()` is `true.`
Method	getAgentNotificationSessionForAgency
Description	Gets the `OsidSession` associated with the agent notification service for the given agency.
Parameters	`osid.authentication.AgentReceiver`	`agentReceiver`	the agent receiver
Parameters	`osid.id.Id`	`agencyId`	the `Id` of the agency
Return	`osid.authentication.AgentNotificationSession`		`an AgentNotificationSession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agentReceiver` or `agencyId` is `null`
	OPERATION_FAILED		`unable to complete request`
	UNIMPLEMENTED		`supportsAgentNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentNotification()` and `supportsVisibleFederation()` are `true.`
Method	getAgentAgencySession
Description	Gets the session for retrieving agent to agency mappings.
Return	`osid.authentication.AgentAgencySession`		an `AgentAgencySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgentAgency()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentAgency()` is `true.`
Method	getAgentAgencyAssignmentSession
Description	Gets the session for assigning agent to agency mappings.
Return	`osid.authentication.AgentAgencyAssignmentSession`		a `AgentAgencyAsignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgentAgencyAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentAgencyAssignment()` is `true.`
Method	getAgentSmartAgencySession
Description	Gets the `OsidSession` associated with the agent smart agency service for the given agency.
Parameters	`osid.id.Id`	`agencyId`	the `Id` of the agency
Return	`osid.authentication.AgentSmartAgencySession`		an `AgentSmartAgencySession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agencyId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAgentSmartAgency()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgentSmartAgency()` and `supportsVisibeFederation()` is `true.`
Method	getAgencyLookupSession
Description	Gets the `OsidSession` associated with the agency lookup service.
Return	`osid.authentication.AgencyLookupSession`		an `AgencyLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgencyLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgencyLookup()` is `true.`
Method	getAgencySearchSession
Description	Gets the `OsidSession` associated with the agency search service.
Return	`osid.authentication.AgencySearchSession`		an `AgencySearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgencySearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgencySearch()` is `true.`
Method	getAgencyAdminSession
Description	Gets the `OsidSession` associated with the agency administration service.
Return	`osid.authentication.AgencyAdminSession`		an `AgencyAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgencyAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgencyAdmin()` is `true.`
Method	getAgencyNotificationSession
Description	Gets the notification session for notifications pertaining to agency service changes.
Parameters	`osid.authentication.AgencyReceiver`	`agencyReceiver`	the agency receiver
Return	`osid.authentication.AgencyNotificationSession`		an `AgencyNotificationSession`
Errors	NULL_ARGUMENT		`agencyReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsAgencyNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgencyNotification()` is `true.`
Method	getAgencyHierarchySession
Description	Gets the session traversing agency hierarchies.
Return	`osid.authentication.AgencyHierarchySession`		an `AgencyHierarchySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgencyHierarchy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgencyHierarchy()` is `true.`
Method	getAgencyHierarchyDesignSession
Description	Gets the session designing agency hierarchies.
Return	`osid.authentication.AgencyHierarchyDesignSession`		an `AgencyHierarchyDesignSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAgencyHierarchyDesign()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAgencyHierarchyDesign()` is `true.`
Method	getAuthenticationBatchManager
Description	Gets an `AuthenticationBatchManager.`
Return	`osid.authentication.batch.AuthenticationBatchManager`		an `AuthenticationBatchManager.`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAuthenticationBatch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAuthenticationBatch()` is `true.`
Method	getAuthenticationKeysManager
Description	Gets an `AuthenticationKeysManager.`
Return	`osid.authentication.keys.AuthenticationKeysManager`		an `AuthenticationKeysManager.`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAuthenticationKeys()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAuthenticationKeys()` is `true.`
Method	getAuthenticationProcessManager
Description	Gets an `AuthenticationProcessManager.`
Return	`osid.authentication.process.AuthenticationProcessManager`		an `AuthenticationProcessManager.`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAuthenticationProcess()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAuthenticationProcess()` is `true.`