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.
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.
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:
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.
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. |
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. |
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.
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. |
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. |
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.
Macro | Value that replaces the macro |
---|---|
@LOGIN_PAGE_LINK@ | The Verify tenant URL sent to allow the user to login. |
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. |
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.
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. |
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.