org.pac4j.openid.client

Class BaseOpenIdClient<U extends CommonProfile>

java.lang.Object

org.pac4j.core.util.InitializableWebObject

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

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

org.pac4j.openid.client.BaseOpenIdClient<U>

All Implemented Interfaces:

Cloneable, Client<OpenIdCredentials,U>

Direct Known Subclasses:

YahooOpenIdClient

public abstract class BaseOpenIdClient<U extends CommonProfile>
extends IndirectClient<OpenIdCredentials,U>

This class is a base implementation for an OpenID protocol client based on the openid4java library. It should work for all OpenID clients. In subclasses, some methods are to be implemented / customized for specific needs depending on the client.

Since:

1.4.0

Author:

Jerome Leleu

Field Summary

Fields

Modifier and Type	Field and Description
static String	DISCOVERY_INFORMATION

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

ATTEMPTED_AUTHENTICATION_SUFFIX, callbackUrl, callbackUrlResolver, NEEDS_CLIENT_REDIRECTION_PARAMETER

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

logger

Constructor Summary

Constructors

Constructor and Description
BaseOpenIdClient()

Method Summary

Modifier and Type	Method and Description
protected abstract U	createProfile(org.openid4java.message.AuthSuccess authSuccess) Create the appropriate OpenID profile.
ClientType	getClientType() Return the client type.
protected String	getDiscoveryInformationSessionAttributeName() Return the name of the attribute storing in session the discovery information.
protected abstract org.openid4java.message.ax.FetchRequest	getFetchRequest() Get a fetch request for attributes.
protected abstract String	getUser(WebContext context) Return the user identifier for the web context.
protected void	internalInit(WebContext context) Internal initialization of the object.
protected boolean	isDirectRedirection() Define if this client has a direct redirection.
protected OpenIdCredentials	retrieveCredentials(WebContext context)
protected RedirectAction	retrieveRedirectAction(WebContext context)
protected U	retrieveUserProfile(OpenIdCredentials credentials, WebContext context)

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

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

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

addAuthorizationGenerator, clone, getAuthorizationGenerators, getName, getUserProfile, newClient, setAuthorizationGenerator, setAuthorizationGenerators, setAuthorizationGenerators, setName, toString

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

init, reinit

Methods inherited from class java.lang.Object

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

Field Detail

DISCOVERY_INFORMATION

public static final String DISCOVERY_INFORMATION

See Also:

Constant Field Values

Constructor Detail

BaseOpenIdClient

public BaseOpenIdClient()

Method Detail

internalInit

protected void internalInit(WebContext context)

Description copied from class: InitializableWebObject

Internal initialization of the object.

Specified by:

internalInit in class InitializableWebObject

Parameters:

context - the web context

getUser

protected abstract String getUser(WebContext context)

Return the user identifier for the web context.

Parameters:

context - the web context

Returns:

the user identifier

getDiscoveryInformationSessionAttributeName

protected String getDiscoveryInformationSessionAttributeName()

Return the name of the attribute storing in session the discovery information.

Returns:

the name of the attribute storing in session the discovery information

getFetchRequest

protected abstract org.openid4java.message.ax.FetchRequest getFetchRequest()
                                                                    throws org.openid4java.message.MessageException

Get a fetch request for attributes.

Returns:

a fetch request for attributes

Throws:

org.openid4java.message.MessageException - an OpenID exception

retrieveRedirectAction

protected RedirectAction retrieveRedirectAction(WebContext context)

Specified by:

retrieveRedirectAction in class IndirectClient<OpenIdCredentials,U extends CommonProfile>

isDirectRedirection

protected boolean isDirectRedirection()

Description copied from class: IndirectClient

Define if this client has a direct redirection.

Specified by:

isDirectRedirection in class IndirectClient<OpenIdCredentials,U extends CommonProfile>

Returns:

if this client has a direct redirection

retrieveCredentials

protected OpenIdCredentials retrieveCredentials(WebContext context)

Specified by:

retrieveCredentials in class IndirectClient<OpenIdCredentials,U extends CommonProfile>

createProfile

protected abstract U createProfile(org.openid4java.message.AuthSuccess authSuccess)
                            throws org.openid4java.message.MessageException

Create the appropriate OpenID profile.

Parameters:

authSuccess - the authentication success message

Returns:

the appropriate OpenID profile

Throws:

org.openid4java.message.MessageException - an OpenID exception

retrieveUserProfile

protected U retrieveUserProfile(OpenIdCredentials credentials,
                                WebContext context)

Specified by:

retrieveUserProfile in class BaseClient<OpenIdCredentials,U extends CommonProfile>

getClientType

public ClientType getClientType()

Description copied from class: BaseClient

Return the client type.

Specified by:

getClientType in class BaseClient<OpenIdCredentials,U extends CommonProfile>

Returns:

the client type