org.picketlink.identity.federation.bindings.tomcat.sp

Class BaseFormAuthenticator

java.lang.Object

org.apache.catalina.valves.ValveBase

org.apache.catalina.authenticator.AuthenticatorBase

org.apache.catalina.authenticator.FormAuthenticator

org.picketlink.identity.federation.bindings.tomcat.sp.BaseFormAuthenticator

All Implemented Interfaces:

MBeanRegistration, org.apache.catalina.Authenticator, org.apache.catalina.Contained, org.apache.catalina.Lifecycle, org.apache.catalina.Valve

Direct Known Subclasses:

AbstractSPFormAuthenticator

public abstract class BaseFormAuthenticator
extends org.apache.catalina.authenticator.FormAuthenticator

Base Class for Service Provider Form Authenticators

Since:

Jun 9, 2009

Author:

Anil.Saldhana@redhat.com

Field Summary

Fields

Modifier and Type	Field and Description
protected org.picketlink.identity.federation.core.audit.PicketLinkAuditHelper	auditHelper
protected String	canonicalizationMethod
protected org.picketlink.identity.federation.core.saml.v2.interfaces.SAML2HandlerChain	chain
protected Map<String,Object>	chainConfigOptions
protected Lock	chainLock A Lock for Handler operations in the chain
protected String	configFile
protected org.picketlink.identity.federation.web.util.SAMLConfigurationProvider	configProvider The user can inject a fully qualified name of a SAMLConfigurationProvider
protected boolean	enableAudit
protected String	identityURL
protected String	idpAddress
protected X509Certificate	idpCertificate If the service provider is configured with an IDP metadata file, then this certificate can be picked up from the metadata
protected String	issuerID
protected org.picketlink.identity.federation.core.interfaces.TrustKeyManager	keyManager
protected static org.picketlink.common.PicketLinkLogger	logger
protected org.picketlink.config.federation.PicketLinkType	picketLinkConfiguration
protected String	samlHandlerChainClass
protected boolean	saveRestoreRequest
protected String	serviceURL
protected org.picketlink.config.federation.SPType	spConfiguration
protected Timer	timer
protected int	timerInterval

Fields inherited from class org.apache.catalina.authenticator.FormAuthenticator

characterEncoding, info

Fields inherited from class org.apache.catalina.authenticator.AuthenticatorBase

algorithm, cache, context, DEFAULT_ALGORITHM, digest, disableProxyCaching, entropy, lifecycle, random, randomClass, securePagesWithPragma, SESSION_ID_BYTES, sm, sso, started

Fields inherited from class org.apache.catalina.valves.ValveBase

container, containerLog, controller, domain, mserver, next, oname

Fields inherited from interface org.apache.catalina.Lifecycle

AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, DESTROY_EVENT, INIT_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT

Constructor Summary

Constructors

Constructor and Description
BaseFormAuthenticator()

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	doSupportSignature() Indicates if digital signatures/validation of SAML assertions are enabled.
protected abstract String	getBinding() Return the SAML Binding that this authenticator supports
String	getConfigFile() Get the name of the configuration file
org.picketlink.config.federation.SPType	getConfiguration() Get the SPType
String	getIdentityURL() Get the Identity URL
X509Certificate	getIdpCertificate() Get the X509Certificate of the IDP if provided via the IDP metadata file
protected org.picketlink.identity.federation.saml.v2.metadata.IDPSSODescriptorType	getIDPSSODescriptor(org.picketlink.identity.federation.saml.v2.metadata.EntitiesDescriptorType entities)
protected org.picketlink.identity.federation.saml.v2.metadata.IDPSSODescriptorType	handleMetadata(org.picketlink.identity.federation.saml.v2.metadata.EntitiesDescriptorType entities)
protected org.picketlink.identity.federation.saml.v2.metadata.IDPSSODescriptorType	handleMetadata(org.picketlink.identity.federation.saml.v2.metadata.EntityDescriptorType entityDescriptor)
protected void	initializeHandlerChain()
protected abstract void	initKeyProvider(org.apache.catalina.Context context)
protected boolean	localAuthentication(org.apache.catalina.connector.Request request, org.apache.catalina.connector.Response response, org.apache.catalina.deploy.LoginConfig loginConfig) Fall back on local authentication at the service provider side
protected void	populateChainConfig()
protected void	processConfiguration() Process the configuration from the configuration file
protected void	processIDPMetadataFile(String idpMetadataFile) Attempt to process a metadata file available locally
protected void	register(org.apache.catalina.connector.Request request, org.apache.catalina.connector.Response response, Principal principal, String arg3, String arg4, String arg5) This method is a hack!!! Tomcat on account of Servlet3 changed their authenticator method signatures We utilize Java Reflection to identify the super register method on the first call and save it.
protected void	sendToLogoutPage(org.apache.catalina.connector.Request request, org.apache.catalina.connector.Response response, org.apache.catalina.Session session)
void	setAuditHelper(org.picketlink.identity.federation.core.audit.PicketLinkAuditHelper auditHelper)
void	setConfigFile(String configFile) Set the name of the configuration file
void	setConfigProvider(org.picketlink.identity.federation.web.util.SAMLConfigurationProvider configProvider) Set an instance of the SAMLConfigurationProvider
void	setConfigProvider(String cp) Set the SAMLConfigurationProvider fqn
void	setIdpAddress(String idpAddress) If the request.getRemoteAddr is not exactly the IDP address that you have keyed in your deployment descriptor for keystore alias, you can set it here explicitly
void	setIssuerID(String issuerID) Set a separate issuer id
void	setLogOutPage(String logOutPage) Set the logout page
void	setSamlHandlerChainClass(String samlHandlerChainClass) Set the SAML Handler Chain Class fqn
void	setSaveRestoreRequest(boolean saveRestoreRequest) Set whether the authenticator saves/restores the request during form authentication
void	setServiceURL(String serviceURL) Set the service URL
void	setTimerInterval(String value) Set the Timer Value to reload the configuration
protected void	startPicketLink()
void	testStart()
protected boolean	validate(org.apache.catalina.connector.Request request) Perform validation os the request object

Methods inherited from class org.apache.catalina.authenticator.FormAuthenticator

authenticate, forwardToErrorPage, forwardToLoginPage, getCharacterEncoding, getInfo, matchRequest, restoreRequest, savedRequestURL, saveRequest, setCharacterEncoding

Methods inherited from class org.apache.catalina.authenticator.AuthenticatorBase

addLifecycleListener, associate, findLifecycleListeners, generateSessionId, getAlgorithm, getCache, getContainer, getDigest, getDisableProxyCaching, getEntropy, getRandom, getRandomClass, getSecurePagesWithPragma, invoke, reauthenticateFromSSO, removeLifecycleListener, setAlgorithm, setCache, setContainer, setDisableProxyCaching, setEntropy, setRandomClass, setSecurePagesWithPragma, start, stop

Methods inherited from class org.apache.catalina.valves.ValveBase

backgroundProcess, createObjectName, event, getContainerName, getController, getDomain, getNext, getObjectName, getParentName, postDeregister, postRegister, preDeregister, preRegister, setController, setNext, setObjectName, toString

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected static final org.picketlink.common.PicketLinkLogger logger

enableAudit

protected boolean enableAudit

auditHelper

protected org.picketlink.identity.federation.core.audit.PicketLinkAuditHelper auditHelper

keyManager

protected org.picketlink.identity.federation.core.interfaces.TrustKeyManager keyManager

spConfiguration

protected org.picketlink.config.federation.SPType spConfiguration

picketLinkConfiguration

protected org.picketlink.config.federation.PicketLinkType picketLinkConfiguration

serviceURL

protected String serviceURL

identityURL

protected String identityURL

issuerID

protected String issuerID

configFile

protected String configFile

idpCertificate

protected transient X509Certificate idpCertificate

If the service provider is configured with an IDP metadata file, then this certificate can be picked up from the metadata

chain

protected transient org.picketlink.identity.federation.core.saml.v2.interfaces.SAML2HandlerChain chain

samlHandlerChainClass

protected transient String samlHandlerChainClass

chainConfigOptions

protected Map<String,Object> chainConfigOptions

saveRestoreRequest

protected boolean saveRestoreRequest

chainLock

protected Lock chainLock

A Lock for Handler operations in the chain

canonicalizationMethod

protected String canonicalizationMethod

configProvider

protected org.picketlink.identity.federation.web.util.SAMLConfigurationProvider configProvider

The user can inject a fully qualified name of a SAMLConfigurationProvider

timerInterval

protected int timerInterval

timer

protected Timer timer

idpAddress

protected String idpAddress

Constructor Detail

BaseFormAuthenticator

public BaseFormAuthenticator()

Method Detail

setIdpAddress

public void setIdpAddress(String idpAddress)

If the request.getRemoteAddr is not exactly the IDP address that you have keyed in your deployment descriptor for keystore alias, you can set it here explicitly

getConfigFile

public String getConfigFile()

Get the name of the configuration file

Returns:

setConfigFile

public void setConfigFile(String configFile)

Set the name of the configuration file

Parameters:

configFile -

setSamlHandlerChainClass

public void setSamlHandlerChainClass(String samlHandlerChainClass)

Set the SAML Handler Chain Class fqn

Parameters:

samlHandlerChainClass -

setServiceURL

public void setServiceURL(String serviceURL)

Set the service URL

Parameters:

serviceURL -

setSaveRestoreRequest

public void setSaveRestoreRequest(boolean saveRestoreRequest)

Set whether the authenticator saves/restores the request during form authentication

Parameters:

saveRestoreRequest -

setConfigProvider

public void setConfigProvider(String cp)

Set the SAMLConfigurationProvider fqn

Parameters:

cp - fqn of a SAMLConfigurationProvider

setConfigProvider

public void setConfigProvider(org.picketlink.identity.federation.web.util.SAMLConfigurationProvider configProvider)

Set an instance of the SAMLConfigurationProvider

Parameters:

configProvider -

getConfiguration

public org.picketlink.config.federation.SPType getConfiguration()

Get the SPType

Returns:

setIssuerID

public void setIssuerID(String issuerID)

Set a separate issuer id

Parameters:

issuerID -

setLogOutPage

public void setLogOutPage(String logOutPage)

Set the logout page

Parameters:

logOutPage -

setTimerInterval

public void setTimerInterval(String value)

Set the Timer Value to reload the configuration

Parameters:

value - an integer value that represents timer value (in miliseconds)

validate

protected boolean validate(org.apache.catalina.connector.Request request)

Perform validation os the request object

Parameters:

request -

Returns:

Throws:

IOException

GeneralSecurityException

getIdentityURL

public String getIdentityURL()

Get the Identity URL

Returns:

getIdpCertificate

public X509Certificate getIdpCertificate()

Get the X509Certificate of the IDP if provided via the IDP metadata file

Returns:

X509Certificate or null

register

protected void register(org.apache.catalina.connector.Request request,
            org.apache.catalina.connector.Response response,
            Principal principal,
            String arg3,
            String arg4,
            String arg5)

This method is a hack!!! Tomcat on account of Servlet3 changed their authenticator method signatures We utilize Java Reflection to identify the super register method on the first call and save it. Subsquent invocations utilize the saved Method

Overrides:

register in class org.apache.catalina.authenticator.AuthenticatorBase

See Also:

AuthenticatorBase.register(org.apache.catalina.connector.Request, org.apache.catalina.connector.Response, java.security.Principal, java.lang.String, java.lang.String, java.lang.String)

localAuthentication

protected boolean localAuthentication(org.apache.catalina.connector.Request request,
                          org.apache.catalina.connector.Response response,
                          org.apache.catalina.deploy.LoginConfig loginConfig)
                               throws IOException

Fall back on local authentication at the service provider side

Parameters:

request -

response -

loginConfig -

Returns:

Throws:

IOException

getBinding

protected abstract String getBinding()

Return the SAML Binding that this authenticator supports

Returns:

See Also:

JBossSAMLURIConstants#SAML_HTTP_POST_BINDING}, JBossSAMLURIConstants#SAML_HTTP_REDIRECT_BINDING}

processIDPMetadataFile

protected void processIDPMetadataFile(String idpMetadataFile)

Attempt to process a metadata file available locally

processConfiguration

protected void processConfiguration()

Process the configuration from the configuration file

handleMetadata

protected org.picketlink.identity.federation.saml.v2.metadata.IDPSSODescriptorType handleMetadata(org.picketlink.identity.federation.saml.v2.metadata.EntitiesDescriptorType entities)

handleMetadata

protected org.picketlink.identity.federation.saml.v2.metadata.IDPSSODescriptorType handleMetadata(org.picketlink.identity.federation.saml.v2.metadata.EntityDescriptorType entityDescriptor)

getIDPSSODescriptor

protected org.picketlink.identity.federation.saml.v2.metadata.IDPSSODescriptorType getIDPSSODescriptor(org.picketlink.identity.federation.saml.v2.metadata.EntitiesDescriptorType entities)

initializeHandlerChain

protected void initializeHandlerChain()
                               throws org.picketlink.common.exceptions.ConfigurationException,
                                      org.picketlink.common.exceptions.ProcessingException

Throws:

org.picketlink.common.exceptions.ConfigurationException

org.picketlink.common.exceptions.ProcessingException

populateChainConfig

protected void populateChainConfig()
                            throws org.picketlink.common.exceptions.ConfigurationException,
                                   org.picketlink.common.exceptions.ProcessingException

Throws:

org.picketlink.common.exceptions.ConfigurationException

org.picketlink.common.exceptions.ProcessingException

sendToLogoutPage

protected void sendToLogoutPage(org.apache.catalina.connector.Request request,
                    org.apache.catalina.connector.Response response,
                    org.apache.catalina.Session session)
                         throws IOException,
                                javax.servlet.ServletException

Throws:

IOException

javax.servlet.ServletException

testStart

public void testStart()
               throws org.apache.catalina.LifecycleException

Throws:

org.apache.catalina.LifecycleException

startPicketLink

protected void startPicketLink()
                        throws org.apache.catalina.LifecycleException

Throws:

org.apache.catalina.LifecycleException

doSupportSignature

protected boolean doSupportSignature()

Indicates if digital signatures/validation of SAML assertions are enabled. Subclasses that supports signature should override this method.

Returns:

initKeyProvider

protected abstract void initKeyProvider(org.apache.catalina.Context context)
                                 throws org.apache.catalina.LifecycleException

Throws:

org.apache.catalina.LifecycleException

setAuditHelper

public void setAuditHelper(org.picketlink.identity.federation.core.audit.PicketLinkAuditHelper auditHelper)