com.sun.liberty
Class LibertyManager

java.lang.Object
  com.sun.liberty.LibertyManager

public class LibertyManager

extends java.lang.Object

LibertyManager forms the basis of the Public APIs. It has all the methods which the JSPs etc. need to use for federation/termination/logout etc.

Constructor Summary

LibertyManager()

Method Summary

static java.lang.String	cleanQueryString(javax.servlet.http.HttpServletRequest request)
static java.lang.String	getAuthnRequestEnvelope(javax.servlet.http.HttpServletRequest request) Gets Authentication Request Envelope from a HTTP servlet request.
static java.lang.String	getConsentHandlerURL(javax.servlet.http.HttpServletRequest request) Returns the ConsentHandler.
static java.lang.String	getCOTKey() Returns the COT key from IFSConstants.
static java.util.List	getDiscoveryBootStrapCredentials(javax.servlet.http.HttpServletRequest request, java.lang.String providerID, java.lang.String providerRole) Gets the Discovery Service Credentials in the Advice element.
static org.w3c.dom.NodeList	getDiscoveryBootStrapResourceOfferings(javax.servlet.http.HttpServletRequest request, java.lang.String providerID, java.lang.String providerRole) Gets the Discovery Service Resource Offerings nodes in an attribute statement.
static java.lang.String	getErrorPageURL(java.lang.String providerId, java.lang.String providerRole, javax.servlet.http.HttpServletRequest request) Returns the provider's error page.
static java.util.Set	getFederatedProviders(java.lang.String userName, java.lang.String hostProviderId, java.lang.String hostProviderRole) Returns the set of federated providers for this userName using Account Management API.
static java.lang.String	getFederationDonePageURL(java.lang.String providerID, java.lang.String providerRole, javax.servlet.http.HttpServletRequest request) Returns the FederationDonePageURL from the provider ID.
static java.lang.String	getFederationHandlerURL(javax.servlet.http.HttpServletRequest request) Returns the FederationHandler.
static java.lang.String	getFedErrorKey() Returns Federation Error Key
static java.lang.String	getFedRemarkKey() Returns FederationRemark Key
static java.lang.String	getHomeURL(java.lang.String providerID, java.lang.String providerRole) Returns Provider's HomePageURL.
static boolean	getIDPFederationStatus(java.lang.String user, java.lang.String remoteProviderId, java.lang.String hostedProviderId, java.lang.String hostedProviderRole) Gets the federation status of a user name with an Identity Provider.
static java.util.Set	getIDPList() Returns the set of all active Identity Providers.
static java.util.Set	getIDPList(java.lang.String hostedProviderID) Returns a set of all trusted Identity Providers for a given hosted SP provider.
static java.lang.String	getInterSiteURL(javax.servlet.http.HttpServletRequest request) Returns the interSiteURL from IFSConstants.
static java.lang.String	getIntroducedProvider(javax.servlet.http.HttpServletRequest request) Gets the ID of the provider discovered via the introduction protocol.
static java.lang.String	getLECPContentType() Gets Liberty-enabled client and proxy profile HTTP content type
static java.lang.String	getLECPHeaderName() Gets Liberty-enabled client and proxy profile HTTP header name.
static java.util.Set	getListOfCOTs(java.lang.String providerId, java.lang.String providerRole) Returns the List of COTs for the given Provider.
static java.lang.String	getLoginURL(javax.servlet.http.HttpServletRequest request) Returns the LoginURL from IFSConstants
static java.lang.String	getLRURLKey() Returns the LRURLKey from IFSConstants.
static NameIdentifier	getMappedNameIdentifier(java.lang.String hostedSPMetaAlias, SSOToken ssoToken, java.lang.String remoteSPEntityID) Returns NameIdentifier between the IDP and the other SP for the same principal.
static java.lang.String	getMetaAlias(java.lang.String providerID, java.lang.String providerRole) Returns metaAlias from provider ID
static java.lang.String	getMetaAliasKey() Returns the metaAliasKey from IFSConstants.
static java.lang.String	getNameRegistrationDonePageURL(java.lang.String providerID, java.lang.String providerRole, javax.servlet.http.HttpServletRequest request) Returns the Name RegistrationDonePageURL from the providerID.
static java.lang.String	getNameRegistrationProviderIDKey() Returns name registration provider ID key.
static java.lang.String	getNameRegistrationURL(java.lang.String providerID, java.lang.String providerRole, javax.servlet.http.HttpServletRequest request) Returns NameRegistrationURL.
static java.lang.String	getNewRequest(javax.servlet.http.HttpServletRequest request) Creates New Request ID from the HttpRequestServlet.
static java.lang.String	getPreLoginServletURL(java.lang.String providerID, java.lang.String providerRole, javax.servlet.http.HttpServletRequest request) Returns PreLoginServlet URL and appends metaAlias to it.
static java.lang.String	getProviderID(java.lang.String metaAlias) Returns providerID from the ProviderAlias using AllianceMgmt calls.
static java.lang.String	getProviderIDKey() Returns the providerIDKey from IFSConstants.
static java.lang.String	getProviderRole(java.lang.String metaAlias) Returns providerRole from the ProviderAlias using AllianceMgmt calls.
static java.util.Set	getProvidersToFederate(java.lang.String providerID, java.lang.String providerRole, java.lang.String userName) Returns the list of all Trusted Identity Providers of this user not already federated with.
static java.util.Set	getRegisteredProviders(java.lang.String userName, java.lang.String hostProviderId, java.lang.String providerRole) Returns registered providers of an user.
static java.lang.String	getRequestIDKey() Returns the requestIDKey from IFSConstants.
static java.lang.String	getSelectedProviderKey() Returns the selectedProviderKey from IFSConstants.
static boolean	getSPFederationStatus(java.lang.String user, java.lang.String remoteProviderId, java.lang.String hostedProviderId, java.lang.String hostedProviderRole) Gets the federations status of a user with an Service Provider (This method assumes that the user is already federated with the provider).
static java.util.Set	getSPList() Returns a list of all active Service Providers
static java.util.Set	getSPList(java.lang.String hostedProviderID) Returns a list of all trusted Service Providers for this Hosted IDP Provider.
static java.lang.String	getSuccintID(java.lang.String providerID, java.lang.String providerRole) Returns succinct ID of a provider.
static java.lang.String	getTerminationDonePageURL(java.lang.String providerID, java.lang.String providerRole, javax.servlet.http.HttpServletRequest request) Returns the TerminationDonePageURL from the provider ID.
static java.lang.String	getTerminationProviderIDKey() Returns the termination providerIDKey from IFSConstants.
static java.lang.String	getTerminationURL(java.lang.String providerID, java.lang.String providerRole, javax.servlet.http.HttpServletRequest request) Returns Termination URL.
static java.lang.String	getUser(javax.servlet.http.HttpServletRequest request) Returns the user from HttpServletRequest.
static boolean	isFederationCancelled(javax.servlet.http.HttpServletRequest request) Returns true if Federation is cancelled.
static boolean	isLECPProfile(javax.servlet.http.HttpServletRequest request) Determines if a HTTP servlet request is Liberty-enabled client and proxy profile.
static boolean	isLogoutSuccess(javax.servlet.http.HttpServletRequest request) Returns true if logout succeeded.
static boolean	isNameRegistrationCancelled(javax.servlet.http.HttpServletRequest request) Returns true if name registration is cancelled.
static boolean	isNameRegistrationSuccess(javax.servlet.http.HttpServletRequest request) Returns true if name registration succeeds.
static boolean	isTerminationCancelled(javax.servlet.http.HttpServletRequest request) Returns true if termination is cancelled.
static boolean	isTerminationSuccess(javax.servlet.http.HttpServletRequest request) Returns true if Termination succeeds.
static FSAuthnRequest	newAuthnRequest(javax.servlet.http.HttpServletRequest request, java.lang.String hostedProviderID) creates new authentication request, this method can only be used inside the same FM web application.
static void	sendAuthnRequest(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, FSAuthnRequest authnRequest, java.lang.String remoteIDPProviderID) sends the authentication request to the IDP, user will be redirected to the single-sign-on URL on the IDP side.

Methods inherited from class java.lang.Object

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

Constructor Detail

LibertyManager

public LibertyManager()

Method Detail

getIDPList

public static java.util.Set getIDPList()

Returns the set of all active Identity Providers.

Returns:

Set A set of strings, each containing the provider ID of all active Identity Providers..

getIDPList

public static java.util.Set getIDPList(java.lang.String hostedProviderID)

Returns a set of all trusted Identity Providers for a given hosted SP provider.

Parameters:

hostedProviderID - hosted provider ID.

Returns:

Set A set of strings, each containing the provider ID of an trusted Identity Providers for this hosted provider ID.

getSPList

public static java.util.Set getSPList()

Returns a list of all active Service Providers

Returns:

Set A set of strings, each containing the provider ID of a Service Provider.

getSPList

public static java.util.Set getSPList(java.lang.String hostedProviderID)

Returns a list of all trusted Service Providers for this Hosted IDP Provider.

Parameters:

hostedProviderID - hosted provider IDs.

Returns:

Set A set of strings, each containing the provider ID of a Service Provider for a given hosted IDP Provider.

getIDPFederationStatus

public static boolean getIDPFederationStatus(java.lang.String user,
                                             java.lang.String remoteProviderId,
                                             java.lang.String hostedProviderId,
                                             java.lang.String hostedProviderRole)

Gets the federation status of a user name with an Identity Provider. (This method assumes that the user is already federated with the provider)

Parameters:

user - The user name obtained by calling getUser() on a Liberty-authenticated HttpServletRequest from the user

remoteProviderId - Provider ID of the Remote Identity Provider.

hostedProviderId - Hosted Provider ID.

hostedProviderRole - Hosted Provider Role.

Returns:

true if the user is federated, false otherwise.

getSPFederationStatus

public static boolean getSPFederationStatus(java.lang.String user,
                                            java.lang.String remoteProviderId,
                                            java.lang.String hostedProviderId,
                                            java.lang.String hostedProviderRole)

Gets the federations status of a user with an Service Provider (This method assumes that the user is already federated with the provider).

Parameters:

user - The user name obtained by calling getRemoteUser() on a Liberty-authenticated HttpServletRequest from the user.

remoteProviderId - The provider ID of the Remote Service Provider.

hostedProviderId - Hosted provider ID.

hostedProviderRole - Hosted Provider Role.

Returns:

The federation status of a user with an Service Provider.

getIntroducedProvider

public static java.lang.String getIntroducedProvider(javax.servlet.http.HttpServletRequest request)

Gets the ID of the provider discovered via the introduction protocol. If null, no provider was discovered. Can be passed to LoginServlet if null.

Parameters:

request - HTTP servlet request.

Returns:

the provider ID

getMetaAliasKey

public static java.lang.String getMetaAliasKey()

Returns the metaAliasKey from IFSConstants.

Returns:

the metaAliasKey from IFSConstants.

getTerminationProviderIDKey

public static java.lang.String getTerminationProviderIDKey()

Returns the termination providerIDKey from IFSConstants.

Returns:

the termination providerIDKey from IFSConstants.

getRequestIDKey

public static java.lang.String getRequestIDKey()

Returns the requestIDKey from IFSConstants.

Returns:

the requestIDKey from IFSConstants.

getProviderIDKey

public static java.lang.String getProviderIDKey()

Returns the providerIDKey from IFSConstants.

Returns:

the providerIDKey from IFSConstants.

getLRURLKey

public static java.lang.String getLRURLKey()

Returns the LRURLKey from IFSConstants.

Returns:

the LRURLKey from IFSConstants.

getCOTKey

public static java.lang.String getCOTKey()

Returns the COT key from IFSConstants.

Returns:

the COT key from IFSConstants.

getSelectedProviderKey

public static java.lang.String getSelectedProviderKey()

Returns the selectedProviderKey from IFSConstants.

Returns:

the selectedProviderKey from IFSConstants.

getFedErrorKey

public static java.lang.String getFedErrorKey()

Returns Federation Error Key

Returns:

Federation Error Key

getFedRemarkKey

public static java.lang.String getFedRemarkKey()

Returns FederationRemark Key

Returns:

FederationRemark Key

getUser

public static java.lang.String getUser(javax.servlet.http.HttpServletRequest request)

Returns the user from HttpServletRequest.

Parameters:

request - HTTP servlet request.

Returns:

the user from HttpServletRequest.

getHomeURL

public static java.lang.String getHomeURL(java.lang.String providerID,
                                          java.lang.String providerRole)

Returns Provider's HomePageURL.

Parameters:

providerID - Provider ID.

providerRole - Provider Role.

Returns:

Provider's HomePageURL.

getPreLoginServletURL

public static java.lang.String getPreLoginServletURL(java.lang.String providerID,
                                                     java.lang.String providerRole,
                                                     javax.servlet.http.HttpServletRequest request)

Returns PreLoginServlet URL and appends metaAlias to it.

Parameters:

providerID - Provider ID.

providerRole - Provider Role.

request - HTTP servlet request.

Returns:

PreLoginServlet URL and appends metaAlias to it.

getLoginURL

public static java.lang.String getLoginURL(javax.servlet.http.HttpServletRequest request)

Returns the LoginURL from IFSConstants

Parameters:

request - HTTP servlet request.

Returns:

the LoginURL from IFSConstants

getInterSiteURL

public static java.lang.String getInterSiteURL(javax.servlet.http.HttpServletRequest request)

Returns the interSiteURL from IFSConstants.

Parameters:

request - HTTP servlet request.

Returns:

the interSiteURL from IFSConstants.

getProviderID

public static java.lang.String getProviderID(java.lang.String metaAlias)

Returns providerID from the ProviderAlias using AllianceMgmt calls.

Parameters:

metaAlias - The metaAlias of the provider

Returns:

providerID corresponding to the metaAlias.

getProviderRole

public static java.lang.String getProviderRole(java.lang.String metaAlias)

Returns providerRole from the ProviderAlias using AllianceMgmt calls.

Parameters:

metaAlias - The metaAlias of the provider

Returns:

providerRole corresponding to the metaAlias.

getMappedNameIdentifier

public static NameIdentifier getMappedNameIdentifier(java.lang.String hostedSPMetaAlias,
                                                     SSOToken ssoToken,
                                                     java.lang.String remoteSPEntityID)

Returns NameIdentifier between the IDP and the other SP for the same principal. This method should be used by the code on the hosted SP, where the user has logged in, and has an account linking with the IDP. Futhermore, the same principal has an account linking between his/her other (remote) SP account and the IDP account.

Parameters:

hostedSPMetaAlias - The metaAlias of the local service provider.

ssoToken - The SSOToken of the logged- in user on the local service provider.

remoteSPEntityID - The entity ID of the remote service provider. In other words, it is the targeted name space for the returned name identifier.

Returns:

NameIdentifier of the same principal but original established between the remote SP and the IDP

getProvidersToFederate

public static java.util.Set getProvidersToFederate(java.lang.String providerID,
                                                   java.lang.String providerRole,
                                                   java.lang.String userName)

Returns the list of all Trusted Identity Providers of this user not already federated with. This is a subset of the Set returned by getIDPList(). This method is is used to show the drop-down menu consisting of all the Identity Providers that the user is not already federated with.

Parameters:

providerID - provider IDs.

userName - name of user.

providerRole - provider Role.

Returns:

Set containing all the Identity Provider IDs which the user is not already federated with.

getFederatedProviders

public static java.util.Set getFederatedProviders(java.lang.String userName,
                                                  java.lang.String hostProviderId,
                                                  java.lang.String hostProviderRole)

Returns the set of federated providers for this userName using Account Management API.

Parameters:

userName - for which the federated providers are to be returned.

hostProviderId - Hosted provider ID.

hostProviderRole - Hosted Provider Role.

Returns:

federated providers a Set containing the provider IDs of federated providers for the given userName.

getListOfCOTs

public static java.util.Set getListOfCOTs(java.lang.String providerId,
                                          java.lang.String providerRole)

Returns the List of COTs for the given Provider.

Parameters:

providerId - The ID of the provider whose COTList is to be found

providerRole - Provider Role.

Returns:

The set containing the authentication domains for the given provider.

getMetaAlias

public static java.lang.String getMetaAlias(java.lang.String providerID,
                                            java.lang.String providerRole)

Returns metaAlias from provider ID

Parameters:

providerID - Provider ID.

providerRole - Provider Role.

Returns:

metaAlias from provider ID

getFederationDonePageURL

public static java.lang.String getFederationDonePageURL(java.lang.String providerID,
                                                        java.lang.String providerRole,
                                                        javax.servlet.http.HttpServletRequest request)

Returns the FederationDonePageURL from the provider ID.

Parameters:

providerID - Provider ID.

providerRole - Provider Role.

request - HTTP servlet request.

Returns:

the FederationDonePageURL from the provider ID.

getTerminationDonePageURL

public static java.lang.String getTerminationDonePageURL(java.lang.String providerID,
                                                         java.lang.String providerRole,
                                                         javax.servlet.http.HttpServletRequest request)

Returns the TerminationDonePageURL from the provider ID.

Parameters:

providerID - Provider ID.

providerRole - Provider Role.

request - HTTP servlet request.

Returns:

the TerminationDonePageURL from the provider ID.

getTerminationURL

public static java.lang.String getTerminationURL(java.lang.String providerID,
                                                 java.lang.String providerRole,
                                                 javax.servlet.http.HttpServletRequest request)

Returns Termination URL.

Parameters:

providerID - Provider ID.

providerRole - Provider Role.

request - HTTP servlet request.

Returns:

Termination URL.

getNameRegistrationURL

public static java.lang.String getNameRegistrationURL(java.lang.String providerID,
                                                      java.lang.String providerRole,
                                                      javax.servlet.http.HttpServletRequest request)

Returns NameRegistrationURL.

Parameters:

providerID - Provider ID.

providerRole - Provider Role.

request - HTTP servlet request.

Returns:

NameRegistrationURL.

getErrorPageURL

public static java.lang.String getErrorPageURL(java.lang.String providerId,
                                               java.lang.String providerRole,
                                               javax.servlet.http.HttpServletRequest request)

Returns the provider's error page.

Parameters:

providerId - Provider ID.

providerRole - Provider Role.

request - HTTP servlet request.

Returns:

the provider's error page.

getFederationHandlerURL

public static java.lang.String getFederationHandlerURL(javax.servlet.http.HttpServletRequest request)

Returns the FederationHandler.

Parameters:

request - HTTP servlet request

Returns:

the FederationHandler.

getConsentHandlerURL

public static java.lang.String getConsentHandlerURL(javax.servlet.http.HttpServletRequest request)

Returns the ConsentHandler.

Parameters:

request - HTTP servlet request.

Returns:

the ConsentHandler.

isLogoutSuccess

public static boolean isLogoutSuccess(javax.servlet.http.HttpServletRequest request)

Returns true if logout succeeded.

Parameters:

request - HTTP servlet request.

Returns:

true if logout succeeded.

isTerminationSuccess

public static boolean isTerminationSuccess(javax.servlet.http.HttpServletRequest request)

Returns true if Termination succeeds.

Parameters:

request - HTTP servlet request.

Returns:

true if Termination succeeds.

isFederationCancelled

public static boolean isFederationCancelled(javax.servlet.http.HttpServletRequest request)

Returns true if Federation is cancelled.

Parameters:

request - HTTP servlet request.

Returns:

true if Federation is cancelled.

isTerminationCancelled

public static boolean isTerminationCancelled(javax.servlet.http.HttpServletRequest request)

Returns true if termination is cancelled.

Parameters:

request - HTTP servlet request.

Returns:

true if termination is cancelled.

getNewRequest

public static java.lang.String getNewRequest(javax.servlet.http.HttpServletRequest request)

Creates New Request ID from the HttpRequestServlet.

Parameters:

request - HTTP servlet request.

Returns:

New Request ID from the HttpRequestServlet.

newAuthnRequest

public static FSAuthnRequest newAuthnRequest(javax.servlet.http.HttpServletRequest request,
                                             java.lang.String hostedProviderID)

creates new authentication request, this method can only be used inside the same FM web application.

Parameters:

request - Http Servlet request

hostedProviderID - provider ID for this hosted SP

Returns:

FSAuthnRequest the created request object

sendAuthnRequest

public static void sendAuthnRequest(javax.servlet.http.HttpServletRequest request,
                                    javax.servlet.http.HttpServletResponse response,
                                    FSAuthnRequest authnRequest,
                                    java.lang.String remoteIDPProviderID)
                             throws FederationException

sends the authentication request to the IDP, user will be redirected to the single-sign-on URL on the IDP side. This method can only be used inside the same FM web application.

Parameters:

request - HttpServletRequest

response - HttpServletResponse

authnRequest - authentication request, this one must be created using LibertyManager.newAuthnRequest() method

remoteIDPProviderID - provider ID for the remote IDP

Throws:

FederationException - if failed to send the authnRequest

cleanQueryString

public static java.lang.String cleanQueryString(javax.servlet.http.HttpServletRequest request)

getSuccintID

public static java.lang.String getSuccintID(java.lang.String providerID,
                                            java.lang.String providerRole)

Returns succinct ID of a provider.

Parameters:

providerID - provider ID.

providerRole - provider role.

Returns:

succinct ID of a provider.

getRegisteredProviders

public static java.util.Set getRegisteredProviders(java.lang.String userName,
                                                   java.lang.String hostProviderId,
                                                   java.lang.String providerRole)

Returns registered providers of an user.

Parameters:

userName - user ID.

hostProviderId - Hosted provider ID.

providerRole - Hosted Provider Role.

Returns:

registered providers.

getNameRegistrationProviderIDKey

public static java.lang.String getNameRegistrationProviderIDKey()

Returns name registration provider ID key.

Returns:

name registration provider ID key.

isNameRegistrationCancelled

public static boolean isNameRegistrationCancelled(javax.servlet.http.HttpServletRequest request)

Returns true if name registration is cancelled.

Parameters:

request - HTTP servlet request.

Returns:

true if name registration is cancelled.

isNameRegistrationSuccess

public static boolean isNameRegistrationSuccess(javax.servlet.http.HttpServletRequest request)

Returns true if name registration succeeds.

Parameters:

request - HTTP servlet request.

Returns:

true if name registration succeeds.

getNameRegistrationDonePageURL

public static java.lang.String getNameRegistrationDonePageURL(java.lang.String providerID,
                                                              java.lang.String providerRole,
                                                              javax.servlet.http.HttpServletRequest request)

Returns the Name RegistrationDonePageURL from the providerID.

Parameters:

providerID - provider ID.

providerRole - Provider Role.

request - HTTP servlet request.

Returns:

the Name RegistrationDonePageURL from the providerID.

getAuthnRequestEnvelope

public static java.lang.String getAuthnRequestEnvelope(javax.servlet.http.HttpServletRequest request)

Gets Authentication Request Envelope from a HTTP servlet request.

Parameters:

request - a HTTP servlet request

Returns:

Authentication Request Envelope in String

isLECPProfile

public static boolean isLECPProfile(javax.servlet.http.HttpServletRequest request)

Determines if a HTTP servlet request is Liberty-enabled client and proxy profile.

Parameters:

request - a HTTP servlet request

Returns:

true if it is Liberty-enabled client and proxy profile

getLECPHeaderName

public static java.lang.String getLECPHeaderName()

Gets Liberty-enabled client and proxy profile HTTP header name.

Returns:

header name

getLECPContentType

public static java.lang.String getLECPContentType()

Gets Liberty-enabled client and proxy profile HTTP content type

Returns:

content type

getDiscoveryBootStrapResourceOfferings

public static org.w3c.dom.NodeList getDiscoveryBootStrapResourceOfferings(javax.servlet.http.HttpServletRequest request,
                                                                          java.lang.String providerID,
                                                                          java.lang.String providerRole)

Gets the Discovery Service Resource Offerings nodes in an attribute statement. After a single sign-on with an Identity Provider, a service provider may get Discovery Service Resource Offerings through a SAML assertion. This APIs helps in retrieving the resource offerings if the user has been authenticated through the liberty SSO. It will need to have a valid single sign on token (generated through the liberty SSO).

Parameters:

request - HttpServletRequest associated with a user session.

providerID - Hosted Provider ID

providerRole - Hosted Provider Role

Returns:

NodeList Discovery Resource Offering Nodes, null if there is any failure or if there is not one

getDiscoveryBootStrapCredentials

public static java.util.List getDiscoveryBootStrapCredentials(javax.servlet.http.HttpServletRequest request,
                                                              java.lang.String providerID,
                                                              java.lang.String providerRole)

Gets the Discovery Service Credentials in the Advice element. After a single sign-on with an Identity Provider, a service provider may get Discovery Service Resource Offerings and Credentials through a SAML assertion. This APIs helps in retrieving the Credentials if the user has been authenticated through the liberty SSO. It will need to have a valid single sign on token (generated through the liberty SSO).

Parameters:

request - HttpServletRequest associated with a user session.

providerID - Hosted Provider ID

providerRole - Hosted Provider Role

Returns:

List of SecurityAssertions, null if there is any failure or if there is not one