com.sun.identity.saml2.plugins

Class DefaultIDPAdapter

java.lang.Object

com.sun.identity.saml2.plugins.DefaultIDPAdapter

All Implemented Interfaces:

SAML2IdentityProviderAdapter

public class DefaultIDPAdapter
extends Object
implements SAML2IdentityProviderAdapter

This class DefaultIDPAdapter implements a SAML2 Identity Provider Adapter.

Constructor Summary

Constructors

Constructor and Description
DefaultIDPAdapter() Default Constructor.

Method Summary

Modifier and Type	Method and Description
void	initialize(String hostedEntityID, String realm) Default implementation, takes no action.
boolean	preAuthentication(String hostedEntityID, String realm, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, AuthnRequest authnRequest, Object session, String reqID, String relayState) Default implementation, takes no action and returns false (no interruption to processing).
void	preSendFailureResponse(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, String faultCode, String faultDetail) Default implementation, takes no action.
boolean	preSendResponse(AuthnRequest authnRequest, String hostProviderID, String realm, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Object session, String reqID, String relayState) Default implementation, takes no action and returns false (no interruption to processing).
void	preSignResponse(AuthnRequest authnRequest, Response res, String hostProviderID, String realm, javax.servlet.http.HttpServletRequest request, Object session, String relayState) Called after the SAML Response object is created, but before the Response is signed/encrypted.
boolean	preSingleSignOn(String hostedEntityID, String realm, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, AuthnRequest authnRequest, String reqID) Default implementation, takes no action and returns false (no interruption to processing).

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultIDPAdapter

public DefaultIDPAdapter()

Default Constructor.

Method Detail

initialize

public void initialize(String hostedEntityID,
                       String realm)

Default implementation, takes no action.

Specified by:

initialize in interface SAML2IdentityProviderAdapter

Parameters:

hostedEntityID - entity ID for the hosted IDP

realm - realm of the hosted IDP

preSingleSignOn

public boolean preSingleSignOn(String hostedEntityID,
                               String realm,
                               javax.servlet.http.HttpServletRequest request,
                               javax.servlet.http.HttpServletResponse response,
                               AuthnRequest authnRequest,
                               String reqID)
                        throws SAML2Exception

Default implementation, takes no action and returns false (no interruption to processing).

Specified by:

preSingleSignOn in interface SAML2IdentityProviderAdapter

Parameters:

hostedEntityID - entity ID for the hosted IDP

realm - realm of the hosted IDP

request - servlet request

response - servlet response

authnRequest - the original authentication request sent from SP

reqID - the id to use for continuation of processing if the adapter redirects

Returns:

true if browser redirection is happening after processing, false otherwise. Default to false.

Throws:

SAML2Exception - for any exceptions occurring in the adapter. The federation process will continue.

preAuthentication

public boolean preAuthentication(String hostedEntityID,
                                 String realm,
                                 javax.servlet.http.HttpServletRequest request,
                                 javax.servlet.http.HttpServletResponse response,
                                 AuthnRequest authnRequest,
                                 Object session,
                                 String reqID,
                                 String relayState)
                          throws SAML2Exception

Default implementation, takes no action and returns false (no interruption to processing).

Specified by:

preAuthentication in interface SAML2IdentityProviderAdapter

Parameters:

hostedEntityID - entity ID for the hosted IDP

realm - realm of the hosted IDP

request - servlet request

response - servlet response

authnRequest - the original authentication request sent from SP

session - the user session or null if the user has no session

reqID - the id to use for continuation of processing if the adapter redirects

relayState - the relayState that will be used in the redirect

Returns:

true if browser redirection is happening after processing, false otherwise. Default to false.

Throws:

SAML2Exception - for any exceptions occurring in the adapter. The federation process will continue.

preSendResponse

public boolean preSendResponse(AuthnRequest authnRequest,
                               String hostProviderID,
                               String realm,
                               javax.servlet.http.HttpServletRequest request,
                               javax.servlet.http.HttpServletResponse response,
                               Object session,
                               String reqID,
                               String relayState)
                        throws SAML2Exception

Default implementation, takes no action and returns false (no interruption to processing).

Specified by:

preSendResponse in interface SAML2IdentityProviderAdapter

Parameters:

authnRequest - original authnrequest

hostProviderID - hosted providerID.

realm - realm of the hosted IDP

request - HttpServletRequest

response - HttpServletResponse

session - the user session or null if the user has no session

reqID - the id to use for continuation of processing if the adapter redirects

relayState - the relayState that will be used in the redirect

Returns:

true if browser redirection happened after processing, false otherwise. Default to false.

Throws:

SAML2Exception - if error occurs. The federation process will continue.

preSendFailureResponse

public void preSendFailureResponse(javax.servlet.http.HttpServletRequest request,
                                   javax.servlet.http.HttpServletResponse response,
                                   String faultCode,
                                   String faultDetail)
                            throws SAML2Exception

Default implementation, takes no action.

Specified by:

preSendFailureResponse in interface SAML2IdentityProviderAdapter

Parameters:

request - HttpServletRequest

response - HttpServletResponse

faultCode - the fault code that will be returned in the SAML response

faultDetail - the fault detail that will be returned in the SAML response

Throws:

SAML2Exception - if error occurs. The federation process will continue.

preSignResponse

public void preSignResponse(AuthnRequest authnRequest,
                            Response res,
                            String hostProviderID,
                            String realm,
                            javax.servlet.http.HttpServletRequest request,
                            Object session,
                            String relayState)
                     throws SAML2Exception

Description copied from interface: SAML2IdentityProviderAdapter

Called after the SAML Response object is created, but before the Response is signed/encrypted. When artifact binding is being used, this method is invoked when the response object is created, and not when the artifact is actually resolved. This extension point's purpose is to make it possible to adjust the content of the SAML response (for example by adding custom SAML extensions), hence this method does not provide a way to abort the SAML flow.

Specified by:

preSignResponse in interface SAML2IdentityProviderAdapter

Parameters:

authnRequest - The original SAML Authentication Request (may be null if this was an IdP initiated SSO).

res - The SAML Response.

hostProviderID - The entity ID of the IdP.

realm - The realm the IdP belongs to.

request - The HttpServletRequest object.

session - The user session or null if the user has no session.

relayState - The relayState that will be used in the redirect

Throws:

SAML2Exception - If an error occurs. The federation process will continue.