Modify identity source pages
You can customize the IBM® Security Verify identity source pages for your business.
For more information about identity source authentication, see Managing identity providers.
To update the identity source pages, download the compressed theme file. Edit the pages as needed and then upload the updated themes file back to your tenant. For more information, see Updating a theme.
Text changes can be made to the pages by using HTML markup. The HTML 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 identity source pages are located in the templates\authentication\login\identity_source\ directory within the themes compressed file.
The following identity source pages are available for customization:
The identity linking pages are displayed to the user when linking to a specific identity source for authentication.
The identity linking pages are located in the templates\authentication\login\identity_source\identity_linking\default directory.
The identity linking pages are:
This page is displayed during one-time password authentication. Update the ask_for_otp_id.html file to modify the page.
- $LOGIN_TITLE$
- $IDL_ENTER_OTP_LABEL$
- $IDL_SUBMIT_BUTTON$
- $IDL_RESEND_OTP_LINK$
The macros for this page are shown in the following table.
Macro | Value that replaces the macro |
---|---|
@ERRMSG@ | An error message that is specific to the action in the page. |
@IDENTITYLINKING_FORM_ACTION_URL@ | A label for the missing Unique User Identifier. |
@OTP_CORRELATION_ID@ | The correlation ID for the one-time password. |
@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. |
@RESEND_OTP_URL@ | Resend the URL for the one-time password. |
@THEME_ID@ | The ID of the registered template theme. |
@VERIFICATION_ID@ | The verification ID for the one-time password. |
The page is displayed when a SAML unique user identifier authentication is used. Update the ask_for_unique_id.html file to modify the page.
- $LOGIN_TITLE$
- $IDL_UNIQUE_ID_PHONE_LABEL$
- $IDL_SUBMIT_BUTTON$
The macros for this page are shown in the following table.
Macro | Value that replaces the macro |
---|---|
@ATTRVALUE@ | The attribute value. |
@ERRMSG@ | An error message that is specific to the action in the page. |
@IDENTITYLINKING_FORM_ACTION_URL@ | A label for the missing Unique User Identifier. |
@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. |
To change the page header, footer, and style on the identity source pages, see Create common branding.