io.dropwizard.auth

Interface Authenticator<C,P extends Principal>

Type Parameters:

C - the type of credentials the authenticator can authenticate

P - the type of principals the authenticator returns

All Known Implementing Classes:

CachingAuthenticator

public interface Authenticator<C,P extends Principal>

An interface for classes which authenticate user-provided credentials and return principal objects.

Method Summary

Modifier and Type	Method and Description
com.google.common.base.Optional<P>	authenticate(C credentials) Given a set of user-provided credentials, return an optional principal.

Method Detail

authenticate

com.google.common.base.Optional<P> authenticate(C credentials)
                                         throws AuthenticationException

Given a set of user-provided credentials, return an optional principal.

If the credentials are valid and map to a principal, returns an Optional.of(p).

If the credentials are invalid, returns an Optional.absent().

Parameters:

credentials - a set of user-provided credentials

Returns:

either an authenticated principal or an absent optional

Throws:

AuthenticationException - if the credentials cannot be authenticated due to an underlying error