org.pac4j.http.client.indirect

Class IndirectBasicAuthClient

java.lang.Object

org.pac4j.core.util.InitializableWebObject

org.pac4j.core.client.BaseClient<C,U>

org.pac4j.core.client.IndirectClient<C,U>

org.pac4j.core.client.IndirectClientV2<UsernamePasswordCredentials,CommonProfile>

org.pac4j.http.client.indirect.IndirectBasicAuthClient

All Implemented Interfaces:

Client<UsernamePasswordCredentials,CommonProfile>

public class IndirectBasicAuthClient
extends IndirectClientV2<UsernamePasswordCredentials,CommonProfile>

This class is the client to authenticate users through HTTP basic auth. It was previously named: BasicAuthClient.

For authentication, the user is redirected to the callback url. If the user is not authenticated by basic auth, a specific exception : HttpAction is returned which must be handled by the application to force authentication.

Since:

1.8.0

Author:

Jerome Leleu

Field Summary

Fields inherited from class org.pac4j.core.client.IndirectClient

ATTEMPTED_AUTHENTICATION_SUFFIX, callbackUrl, callbackUrlResolver

Fields inherited from class org.pac4j.core.client.BaseClient

logger

Constructor Summary

Constructors

Constructor and Description
IndirectBasicAuthClient()
IndirectBasicAuthClient(Authenticator usernamePasswordAuthenticator)
IndirectBasicAuthClient(Authenticator usernamePasswordAuthenticator, ProfileCreator profileCreator)
IndirectBasicAuthClient(String realmName, Authenticator usernamePasswordAuthenticator)

Method Summary

Modifier and Type	Method and Description
String	getRealmName()
protected void	internalInit(WebContext context) Internal initialization of the object.
protected UsernamePasswordCredentials	retrieveCredentials(WebContext context) Retrieve the credentials.
void	setRealmName(String realmName)
String	toString()

Methods inherited from class org.pac4j.core.client.IndirectClientV2

getAuthenticator, getCredentialsExtractor, getProfileCreator, getRedirectActionBuilder, retrieveRedirectAction, retrieveUserProfile, setAuthenticator, setCredentialsExtractor, setProfileCreator, setRedirectActionBuilder

Methods inherited from class org.pac4j.core.client.IndirectClient

computeFinalCallbackUrl, getAjaxRequestResolver, getCallbackUrl, getCallbackUrlResolver, getCredentials, getRedirectAction, getStateParameter, isIncludeClientNameInCallbackUrl, redirect, setAjaxRequestResolver, setCallbackUrl, setCallbackUrlResolver, setIncludeClientNameInCallbackUrl

Methods inherited from class org.pac4j.core.client.BaseClient

addAuthorizationGenerator, addAuthorizationGenerators, getAuthorizationGenerators, getName, getUserProfile, setAuthorizationGenerator, setAuthorizationGenerators, setAuthorizationGenerators, setName

Methods inherited from class org.pac4j.core.util.InitializableWebObject

init, reinit

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

IndirectBasicAuthClient

public IndirectBasicAuthClient()

IndirectBasicAuthClient

public IndirectBasicAuthClient(Authenticator usernamePasswordAuthenticator)

IndirectBasicAuthClient

public IndirectBasicAuthClient(String realmName,
                               Authenticator usernamePasswordAuthenticator)

IndirectBasicAuthClient

public IndirectBasicAuthClient(Authenticator usernamePasswordAuthenticator,
                               ProfileCreator profileCreator)

Method Detail

internalInit

protected void internalInit(WebContext context)

Description copied from class: InitializableWebObject

Internal initialization of the object.

Overrides:

internalInit in class IndirectClient<UsernamePasswordCredentials,CommonProfile>

Parameters:

context - the web context

retrieveCredentials

protected UsernamePasswordCredentials retrieveCredentials(WebContext context)
                                                   throws HttpAction

Description copied from class: BaseClient

Retrieve the credentials.

Overrides:

retrieveCredentials in class IndirectClientV2<UsernamePasswordCredentials,CommonProfile>

Parameters:

context - the web context

Returns:

the credentials

Throws:

HttpAction - whether an additional HTTP action is required

getRealmName

public String getRealmName()

setRealmName

public void setRealmName(String realmName)

toString

public String toString()

Overrides:

toString in class IndirectClientV2<UsernamePasswordCredentials,CommonProfile>