Determine External User Details

Details for an external user are retrieved by calling the getLoginDetails() method of the curam.util.security.ExternalAccessSecurity interface. These details are returned directly after authentication to direct the external user to the correct application homepage.

/**
 * The implementation of this method should retrieve the
 * details of the user required to redirect them to the correct
 * application page. This information includes the name of the
 * application home page for the user, the default locale for
 * the user and a list of warnings/messages for the user.
 *
 * @param identifier The identifier of the external user.
 *
 * @return The user details, including the application
 *         home page.
 *
 * @throws AppException Generic Exception Signature.
 * @throws InformationalException Generic Exception Signature.
 */
UserLoginDetails getLoginDetails(String identifier)
  throws AppException, InformationalException;

An instance of the curam.util.security.UserLoginDetails class must be created and returned from this method. The following information should be returned using this class:

• UserLoginDetails . setApplicationCode(String code)

  The code corresponding to the application homepage for the external user.

  This must be a valid entry in the APPLICATION_CODE codetable.

• UserLoginDetails . setDefaultLocale(String defaultLocale)

  The default locale for the external user.

  This is the locale the application will be displayed in by default for the external user.

• UserLoginDetails . addInformationals(InformationalManager informationalManager)

  Any informationals that must be displayed to the external user.

  The curam.util.exception.InformationalManager class can be used to create a number of informational or warning messages that will be displayed when the external user logs in. For example, a warning to let the external user know that their password is due to expire.