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

Interface	osid.authentication.process.AuthenticationValidationSession
Implements	`osid.OsidSession`
Description	This session is the remote end of a transport link from the acquisition session and validates authentication credentials sent to it. The basic method, `authenticate()` accepts a credential, validates it and returns an `Authentication` containing the identity of the authenticated user. This OSID does not define any root interface for credentials and challenge data. The object representing these are completely defined within their `Type,` providing flexibility in adapting to a variety of application environments.
Method	getAuthenticationInput
Description	Gets an interface for authentication input.
Return	`osid.authentication.process.AuthenticationInput`		authentication input
Compliance	`mandatory`		This method is must be implemented.
Method	authenticate
Description	Validates and returns the authentication credential from the given data.
Parameters	`osid.authentication.process.AuthenticationInput`	`input`	the authentication input to be validated
Return	`osid.authentication.process.Authentication`		the resulting authentication
Errors	NULL_ARGUMENT		`input` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
	UNSUPPORTED		`input` is not of this service
Compliance	`mandatory`		This method is must be implemented.
Method	getChallengeData
Description	Gets data that can be used for a challenge to the peer attempting authentication.
Parameters	`osid.authentication.process.AuthenticationInput`	`input`	authentication input
Return	`osid.authentication.process.Challenge`		the acquired challenge data
Errors	NULL_ARGUMENT		`input` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure
	UNIMPLEMENTED		challenge response not available
	UNSUPPORTED		`input` is not of this service
Compliance	`optional`		This method must be implemented if `AuthenticationProcessManager.supportsChallenge()` is `true.`