Modify user password notification pages

You can customize the IBM Security® Verify user notification pages for your business. User password notification pages are sent to the user when a user’s password expired, is expiring, changed, or was reset.

To update the user password notification pages, download the compressed theme file. Edit the pages as needed and then upload the updated theme files back to your Verify tenant. For more information, see Updating a theme.

Text changes can be made to the pages by using XML markup. The XML files also contain macros. Macros are characters between the @ symbol where the data is rendered at run time. Do not change the macros in the files.

The IBM Security Verify user password notification pages are in the templates/notifications/user_management/login/ directory within the themes compressed file.

email

User password email notifications are available for user password expired, is expiring, changed, or was reset. The pages are in the templates/notifications/user_management/profile/default directory.

Note: Federated users do not get an email notification.

The following label is available on the user password email notification pages. To update the text on these labels, see Customizing labels.

  • $PRODUCT_NAME$

The user password email notifications pages are:

User password expired email page

This email page is sent to the user when the user’s password expires. Update the user_password_expired_email.xml file to modify the page.

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

Note: The user’s ability to reset the password for their account is controlled by the Cloud Directory Identity Provider’s password reset setting.
Note: The page is only supported for the default theme. Pages in the default theme are not specific to an application. They apply to all applications on your Verify tenant.
Table 1. Macro definitions
Macro Value that replaces the macro
@USERNAME@ The user's name.
@RESET_PWD_LINK@ The URL to reset the user’s password if the Cloud Directory Identity Provider’s password reset setting is enabled.
@DISPLAY_RESET_ENABLED@ inherit or none based on the Cloud Directory Identity Provider’s password reset setting.
@DISPLAY_RESET_NOT_ENABLED@ inherit or none based on the Cloud Directory Identity Provider’s password reset setting.
Table 2. Common macro definitions
Common macro Value that replaces the macro
@LANG_QUERY_PARAM@ The preferred language to use for email notification or use for the value of the lang query parameter for Verify APIs.
@TENANT@ The name of the Verify tenant.
@TENANT_URL@ The Verify tenant URL sent to allow the user to login.
@THEME_ID@ The identifier of the theme that you want to apply or use for the value of the themeId query parameter for Verify APIs.
User password expiring email page

This email page is sent to the user when the user’s password is expiring in some number of days. Update the user_password_expiring_email.xml file to modify the page.

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

Note: The user’s ability to reset the password for their account is controlled by the Cloud Directory Identity Provider’s password reset setting.
Note: The page is only supported for the default theme. Pages in the default theme are not specific to an application. They apply to all applications on your Verify tenant.
Table 3. Macro definitions
Macro Value that replaces the macro
@USERNAME@ The user's name.
@CHANGE_PWD_LINK@ The URL to change the user’s password if the user knows their password.
@DAYS_BEFORE_EXPIRE@ The number of days before the user’s password expires.
@RESET_PWD_LINK@ The URL to reset the user’s password if the Cloud Directory Identity Provider’s password reset setting is enabled.
@DISPLAY_RESET_ENABLED@ inherit or none based on the Cloud Directory Identity Provider’s password reset setting.
@DISPLAY_RESET_NOT_ENABLED@ inherit or none based on the Cloud Directory Identity Provider’s password reset setting.
Table 4. Common macro definitions
Common macro Value that replaces the macro
@LANG_QUERY_PARAM@ The preferred language to use for email notification or use for the value of the lang query parameter for Verify APIs.
@TENANT@ The name of the Verify tenant.
@TENANT_URL@ The Verify tenant URL sent to allow the user to login.
@THEME_ID@ The identifier of the theme that you want to apply or use for the value of the themeId query parameter for Verify APIs.
User changed password email pages

These email pages are sent to the user when the user changes their password. Update the user_password_change_show_email.xml and user_password_change_not_show_email.xml files to modify the pages.

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

Table 5. Macro definitions
Macro Value that replaces the macro
@LOGIN_PAGE_LINK@ The Verify tenant URL sent to allow the user to login.
Table 6. Common macro definitions
Common macro Value that replaces the macro
@LANG_QUERY_PARAM@ The preferred language to use for email notification or use for the value of the lang query parameter for Verify APIs.
@TENANT@ The name of the Verify tenant.
@TENANT_URL@ The Verify tenant URL sent to allow the user to login.
@THEME_ID@ The identifier of the theme that you want to apply or use for the value of the themeId query parameter for Verify APIs.
User reset password email pages

These email pages are sent to the user when the user’s password is reset. Update the user_password_reset_email.xml and user_password_reset_not_show_email.xml files to modify the pages.

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

Table 7. Macro definitions
Macro Value that replaces the macro
@LOGIN_PAGE_LINK@ The Verify tenant URL sent to allow the user to login
@PASSWORD@ The user’s temporary password.
Table 8. Common macro definitions
Common macro Value that replaces the macro
@LANG_QUERY_PARAM@ The preferred language to use for email notification or use for the value of the lang query parameter for Verify APIs.
@TENANT@ The name of the Verify tenant.
@TENANT_URL@ The Verify tenant URL sent to allow the user to login.
@THEME_ID@ The identifier of the theme that you want to apply or use for the value of the themeId query parameter for Verify APIs.

See Personalize themes with user attributes to add more customizations to your user email notification pages.