public interface AuthenticationValidationSession extends OsidSession
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.
Modifier and Type | Method and Description |
---|---|
Authentication |
authenticate(AuthenticationInput input)
Validates and returns the authentication credential from the given
data.
|
AuthenticationInput |
getAuthenticationInput()
Gets an interface for authentication input.
|
Challenge |
getChallengeData(AuthenticationInput input)
Gets data that can be used for a challenge to the peer attempting
authentication.
|
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
AuthenticationInput getAuthenticationInput()
mandatory
- This method is must be implemented. Authentication authenticate(AuthenticationInput input) throws OperationFailedException, PermissionDeniedException
input
- the authentication input to be validatedNullArgumentException
- input
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnsupportedException
- input
is not of
this servicemandatory
- This method is must be implemented. Challenge getChallengeData(AuthenticationInput input) throws OperationFailedException, PermissionDeniedException
input
- authentication inputNullArgumentException
- input
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failureUnimplementedException
- challenge response not
availableUnsupportedException
- input
is not of
this serviceoptional
- This method must be implemented if
AuthenticationProcessManager.supportsChallenge()
is true.