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

Interface	osid.authentication.process.AuthenticationProcessProxyManager
Implements	`osid.OsidProxyManager`
Implements	`osid.authentication.process.AuthenticationProcessProfile`
Description	The authentication process proxy manager provides access to authentication sessions and provides interoperability tests for various aspects of this service. Methods in this manager support the passing of a `Proxy` object. The sessions included in this manager are: `AuthenticationAcquisitionSession:` session to acquire credentials from a user and serialize them for transport to a remote peer for authentication `AuthenticationValidationSession:` 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 the `OsidSession` associated with the `AuthenticationAcquisitionSession` using the supplied `Authentication.`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.authentication.process.AuthenticationAcquisitionSession`		an `AuthenticationAcquisitionSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	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 using the supplied `Authentication.`
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.authentication.process.AuthenticationValidationSession`		an `AuthenticationValidationSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	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.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.authentication.process.TrustLookupSession`		a `TrustLookupSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	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
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.authentication.process.TrustLookupSession`		a `TrustLookupSession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agencyId` or `proxy` 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.
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.authentication.process.CircleOfTrustSession`		a `CircleOfTrustSession`
Errors	NULL_ARGUMENT		`proxy` is `null`
	OPERATION_FAILED		unable to complete request
	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
Parameters	`osid.proxy.Proxy`	`proxy`	a proxy
Return	`osid.authentication.process.CircleOfTrustSession`		a `CircleOfTrustSession`
Errors	NOT_FOUND		`agencyId` not found
	NULL_ARGUMENT		`agencyId` or `proxy` 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.`