Search

Data Director Implementation Guide

Data Director Implementation Guide

10.3

Back Next

Custom Login Provider with IDD Login Form

Custom Login Provider with IDD Login Form

If the authentication mechanism uses the IDD Login form for requesting user name and password, then the implementation of Custom Login Provider must use the interface methods listed and described in the following table:

Interface Method Name	Description
initialize	IDD calls this method before any other method of the Login Provider implementation and passes a set of properties that describe the context of execution. In IDD, properties contain the only entry. It can be referenced as LoginProvider. SSO_POST_REDIRECT_PAGE_PROPERTY and contains URL of the JSF page that can POST data to external login provider.
isUseIDDLoginForm	This method must return TRUE.
redirectToProviderLoginPage	This method is not used.
extractLoginCredentials	This method extracts user credentials from an Http Request. If the request contains authentication information, then this method must return LoginCredentials ( com.siperian.bdd.security.LoginCredentials ) instance with properly filled fields. If request does not contain authentication information, then the method must return NULL.
requestLoginCredentials	This method is called after a user submits the filled-in login form. This method is used for sending requests to an external identity provider for authenticating users. Properly filled instances of LoginCredentials are returned on successful authentication. If authentication fails, then com.siperian.bdd.security.LoginProviderException is thrown.
encodeComponentUrl	This method receives ExternalLink URL and can add authentication parameters.
onLogout	This method is called when a user logs out. It can run a logout on external Identity Provider and cleanup parameters defined by the requestLoginCredentials method.
getLogoImageBody	This method returns InputStream with the image file body. You can use this method to display the logo of an external identity provider in the IDD login form. The image format must be PNG, JPEG, or GIF. The image must not exceed a width of 155 pixels and a height of 29 pixels. If this method returns NULL, then IDD uses the predefined image to indicate that the login form is handled by Custom Login Provider.

Implement Custom Login Provider

Watch

Comments

0 COMMENTS

We’d like to hear from you! Log in to comment.