OSID - osid.authentication.process.AuthenticationProcessManager Service Interface Definition

Interface	osid.authentication.process.AuthenticationProcessManager
Implements	`osid.OsidManager`
Implements	`osid.authentication.process.AuthenticationProcessProfile`
Description	The authentication process manager provides access to authentication sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are: `AuthenticationAcquisitionSession:` a session to acquire credentials from a user and serialize them for transport to a remote peer for authentication `AuthenticationValidationSession: a` session to receive and validate authentication credentials from a remote peer wishing to authenticate `TrustLookupSession:` a session to look up authentication circles of trust `CircleOfTrustSession:` a session to examine agent circles of trust
Method	getAuthenticationAcquisitionSession
Description	Gets an `AuthenticationAcquisitionSession` which is responsible for acquiring authentication credentials on behalf of a service client.
Return	`osid.authentication.process.AuthenticationAcquisitionSession`		an acquisition session for this service
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAuthenticationAcquisition()` is `false`
Compliance	`optional`		This method must be implemented if `supportsAcquisition()` is `true.`
Method	getAuthenticationValidationSession
Description	Gets the `OsidSession` associated with the `AuthenticationValidation` service.
Return	`osid.authentication.process.AuthenticationValidationSession`		an `AuthenticationValidationSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsAuthenticationValidation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsValidation()` is `true.`
Method	getTrustLookupSession
Description	Gets the `OsidSession` associated with the trust lookup service.
Return	`osid.authentication.process.TrustLookupSession`		a `TrustLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsTrustLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTrustLookup()` is `true.`
Method	getTrustLookupSessionForAgency
Description	Gets the `OsidSession` associated with the trust lookup service for the given agency.
Parameters	`osid.id.Id`	`agencyId`	the `Id` of the agency
Return	`osid.authentication.process.TrustLookupSession`		a `TrustLookupSession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agencyId` is `null`
	OPERATION_FAILED		`unable to complete request`
	UNIMPLEMENTED		`supportsTrustLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsTrustLookup()` and `supportsVisibleFederation()` are `true.`
Method	getCircleOfTrustSession
Description	Gets the `OsidSession` associated with the trust circle service.
Return	`osid.authentication.process.CircleOfTrustSession`		a `CircleOfTrustSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsCircleOfTrust()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCircleOfTrust()` is `true.`
Method	getCircleOfTrustSessionForAgency
Description	Gets the `OsidSession` associated with the trust circle service for the given agency.
Parameters	`osid.id.Id`	`agencyId`	the `Id` of the agency
Return	`osid.authentication.process.CircleOfTrustSession`		a `CircleOfTrustSession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agencyId` is `null`
	OPERATION_FAILED		`unable to complete request`
	UNIMPLEMENTED		`supportsCiirleOfTrust()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsCircleOfTrust()` and `supportsVisibleFederation()` are `true.`