Skip navigation links

oracle.security.jps.service.sso
Interface SsoProvider

public interface SsoProvider

This interface defines the SPIs for underlying SSO providers to plug into JPS SSO framework. It is expected that each SSO provider supplies a concrete SsoProvider class and the class name needs to be specified in the jps configuration using property sso.provider.class.

Since:

11gR1+

Method Summary

ResponseDispatcher	getAutoLoginDispatcher(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, java.lang.String endpointUrl, java.lang.Object token, java.lang.String targetUrl, java.util.Map props) Gets the dispatcher used to send the response to an SSO agent to initiate the auto login process.
ResponseDispatcher	getLoginDispatcher(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, java.lang.String endpointUrl, java.lang.String successUrl, java.lang.String cancelUrl, java.util.Map props) Gets the dispatcher used to send the response to an SSO agent to initiate the login process.
ResponseDispatcher	getLogoutDispatcher(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, java.lang.String endpointUrl, java.lang.String targetUrl, java.util.Map props) Gets the dispatcher used to send the response to an SSO agent to initiate the log out process.
void	initialize(SsoServiceConfig serviceConfig) Initializes the SSO Provider.

Method Detail

initialize

void initialize(SsoServiceConfig serviceConfig)
                throws SsoServiceException

Initializes the SSO Provider.

Parameters:

serviceConfig - encapsulates the service settings specified in the JPS configuration

Throws:

SsoServiceException

getLoginDispatcher

ResponseDispatcher getLoginDispatcher(javax.servlet.http.HttpServletRequest request,
                                      javax.servlet.http.HttpServletResponse response,
                                      java.lang.String endpointUrl,
                                      java.lang.String successUrl,
                                      java.lang.String cancelUrl,
                                      java.util.Map props)
                                      throws SsoServiceException

Gets the dispatcher used to send the response to an SSO agent to initiate the login process.

Parameters:

request - the client's request to access a resource which requires authentication to be performed

response - the response associated with the client's request

endpointUrl - the SSO agent's endpoint url for login, it corresponds to the configured login url for a specific auth level with app.context variable substituted if present

successUrl - representing the URL that the user agent must be sent to after successful authentication

cancelUrl - representing the URL that the user agent must be taken to if the user chooses to cancel the login from the login form

props - carries any information relevant to the login process. It is mainly for extensibility

Returns:

the dispatcher used to send the response to initiate the login process

Throws:

SsoServiceException - thrown if failed to create a dispatcher

getAutoLoginDispatcher

ResponseDispatcher getAutoLoginDispatcher(javax.servlet.http.HttpServletRequest request,
                                          javax.servlet.http.HttpServletResponse response,
                                          java.lang.String endpointUrl,
                                          java.lang.Object token,
                                          java.lang.String targetUrl,
                                          java.util.Map props)
                                          throws SsoServiceException

Gets the dispatcher used to send the response to an SSO agent to initiate the auto login process.

Parameters:

request - the client's request which requires automatically logging in the user after self registration

response - the response associated with the client's request

endpointUrl - the SSO agent's endpoint url for auto login

token -

targetUrl - the landing page URL that the user agent must be redirected to upon successful authentication after self-registration

props - carries any information relevant to the auto login process. It is mainly for extensibility

Returns:

the dispatcher used to send the response to initiate the auto login process

Throws:

SsoServiceException

getLogoutDispatcher

ResponseDispatcher getLogoutDispatcher(javax.servlet.http.HttpServletRequest request,
                                       javax.servlet.http.HttpServletResponse response,
                                       java.lang.String endpointUrl,
                                       java.lang.String targetUrl,
                                       java.util.Map props)
                                       throws SsoServiceException

Gets the dispatcher used to send the response to an SSO agent to initiate the log out process.

Parameters:

request - the client's request for logout

response - the response associated with the client's request

endpointUrl - the SSO agent's endpoint url for logout

targetUrl - representing the URL that the user agent must be redirected to upon successful logout

props - carries any information relevant to the logout process. It is mainly for extensibility

Returns:

the dispatcher used to send the response to initiate the logout process

Throws:

SsoServiceException

Skip navigation links