OSID - osid.authentication.AuthenticationManager Service Interface Definition

Interface	osid.authentication.AuthenticationManager
Implements	`osid.OsidManager`
Implements	`osid.authentication.AuthenticationProfile`
Used By	`osid.orchestration.OrchestrationManager`
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`.