Modify login page

You can customize the IBM® Security Verify login page for your business.

To update the login page, download the compressed theme file, decompress the theme file, and edit the page as needed. Compress the theme file with the updated page and upload theme file back to your tenant. See Updating a theme for more details.

Note: If the tenant enabled multiple login options for the user, then the combined login selection page is shown. If the tenant only the Cloud directory login page option available, then the Cloud directory login page is shown.
Modify multiple login options page

The multiple login options page is displayed when identity source selection authentication is configured.

The identity source selection page file is located in the templates\authentication\login\identity_source\identity_source_selection\default\combined_login_selection.html directory.

Update the combined_login_selection.html file to modify the page.

The following labels are available on the combined login selection page. To update the text on these labels, see Customizing labels.
  • $LOGIN_TITLE$
  • $LOGIN_USER_NAME$
  • $LOGIN_PASSWORD$
  • $LOGIN_WITH_FORGOT_USERNAME$
  • $LOGIN_WITH_FORGOT_PASSWORD$
  • $LOGIN_BUTTON$
  • $SOCIAL_LOGIN_ALTERNATE_SIGNIN$
  • $SHOW_PASSWORD_HELP_TXT$

The macros for this page are shown in the following table.

Table 1. Macro definitions
Macro Value that replaces the macro
@ID_SOURCES@ A JSON representation of the id sources to display.
@LOCALE@ The locale of the current template page.
@LOGIN_ERROR_MESSAGE@ An error message that is returned from the login provider.
@LOGIN_HINT@ The login hint.
@LOGIN_USER_NAME@ The login user name.
@PAGE_FOOTER@ The HTML that contains the footer of the page. This code can be modified by customizing the footer.html common template.
@PAGE_HEADER@ The HTML that contains the header of the page. This code can be modified by customizing the header.html common template.
@THEME_ID@ The ID of the registered template theme.

For more information on how to customize different types of login pages, see Modify identity source pages

Modify Cloud directory login page

The IBM Security Verify Cloud directory login page is available in the templates\authentication\login\cloud_directory\user_login\default\cloud_directory_login.html file within the compressed theme file

The login page is displayed to the user when they open a browser to your tenant. Update the cloud_directory_login.html file to modify the page. Text changes can be made to the page by using HTML markup.

The following labels are available on this page. To update the text on these labels, see Customizing labels.
  • $LOGIN_TITLE$
  • $LOGIN_USER_NAME$
  • $LOGIN_PASSWORD$
  • $LOGIN_WITH_FORGOT_PASSWORD$
  • $LOGIN_BUTTON$

The login page also contains the macros shown in the following table. Macros are characters between the @ symbol where the data is rendered at run time. Do not change the macros in the file.

Table 2. Macro definitions
Macro Value that replaces the macro
@ACTION@ The action that is taken.
@ERROR_MESSAGE@ An error message that is specific to the action in the page.
@PAGE_FOOTER@ The HTML that contains the footer of the page. This code can be modified by customizing the footer.html common template.
@PAGE_HEADER@ The HTML that contains the header of the page. This code can be modified by customizing the header.html common template.
@SHOW_FORGOT_PASSWORD_LINK@ Flag to show forgot password.
@THEME_ID@ The ID of the registered template theme.
@USERNAME@ The username of the user.

Modify Cloud directory login password warning page

The password warning page is available in the /authentication/login/cloud_directory/password/password_intelligence_warning.html file within the compressed theme file.

This password warning page is displayed to the user when the admin has enabled the password intelligence on the tenant and chose the WARN config. In that case, user will be alerted about the weak / bad password set on the account of user being logged-in or is trying to change the password. This page appeals user to set strong password and secure the account by not using commonly known or easily compromised passwords. Update the password_intelligence_warning.html file to modify the page. Text changes can be made to the page by using HTML markup.

The following labels are available on this page. To update the text on these labels, see Customizing labels.

  • $PASSWORD_INTELLIGENCE_WARNING_TITLE$
  • $PASSWORD_INTELLIGENCE_WARNING_HEADING$
  • $PASSWORD_INTELLIGENCE_WARNING_NOTE$
  • $PASSWORD_INTELLIGENCE_WARNING_CHANGE_PASSWORD_LABEL$
  • $PASSWORD_INTELLIGENCE_WARNING_CONTINUE_LABEL$

This password warning page also contains the macros shown in the following table. Macros are characters between the @ symbol where the data is rendered at run time. Do not change these macros in the file.

Table 3. Macro definitions
Macro Value that replaces the macro
@PAGE_FOOTER@ The HTML that contains the footer of the page. This code can be modified by customizing the footer.html common template.
@PAGE_HEADER@ The HTML that contains the header of the page. This code can be modified by customizing the header.htmlcommon template.
@ACTION@ The action that is taken. Value should not be altered.
@USERNAME@ The username of the user. Value should not be altered.
@OLDPASSWORD@ The password with which user authenticated successfully and which should be changed. Value should not be altered.
@NEWPASSWORD@ The new password that user want to set. Value should not be altered.

To change the page header, footer, and style, see Create common branding.