Modify pass-through pages

You can customize the IBM® Security Verify modify pass-through pages for your business.

For more information about pass-through authentication, see Managing identity providers.

To update the pass-through 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 pass-through pages are located in the templates\authentication\login\passthrough\default\ directory within the themes compressed file.

The following pass-through pages are available for customization:

Modify Pass-through login agent bridge page

The page is displayed when pass-through login is configured for an agent bridge. Update the passthrough_login_agent_bridge.html file to modify the page. For example, see IBM Security Verify Bridge.

The following labels are available on the pass-through login agent bridge page. To update the text on these labels, see Customizing labels.
  • $LOGIN_TITLE$
  • $LOGIN_TITLE_ONPREM$
  • $LOGIN_DESC_ONPREM$
  • $LOGIN_USER_NAME$
  • $LOGIN_PASSWORD$
  • $LOGIN_BUTTON$

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

Table 1. 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.
@THEME_ID@ The ID of the registered template theme.
@USERNAME The username of the user.
Modify pass-through login MaaS360® page

The page is displayed when pass-through login is configured forMaaS360. Update the passthrough_login_maas360_ce.html file to modify the page. For example, see Adding a MaaS360 Cloud Extender identity provider.

The following labels are available on the pass-through login MaaS360 page. To update the text on these labels, see Customizing labels.
  • $LOGIN_TITLE$
  • $LOGIN_USER_NAME$
  • $LOGIN_PASSWORD$
  • $LOGIN_BUTTON$

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

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.
@THEME_ID@ The ID of the registered template theme.

To change the page header, footer, and style on the pass-through pages, see Create common branding.