Customize HTTP authentication pages

Summary

This document will guide you through the steps to customize pages used during HTTP authentication.

Create custom template

Select authenticator template to modify located in folder <PHENIX_ROOT>//mods/com.phenixidentity~auth-http~<version>/templates/.

Please view the manual <version> Authenticators if you need to find out which template each authenticator use.

Duplicate the template to use. Example: login.template is duplicated as login_custom.template

Modify custom template

Open login_custom.template file in a text editor of your choice and modify the template according to your needs.

NOTE: Texts within {{ }} are fetched from translation files. Please follow this guide to change/add texts.

Replace template in authenticator configuration

Login to configuration manager and open the advanced tab.

Locate the HTTP Authenticator to modify and add/configure "loginTemplate" to point to your newly customized template.

<p>{
  "name" : "PostUidAndPasswordSAML",
  "id" : "unpwsaml",
  "alias" : "unpwsaml",
  "displayName" : "Username Password",
  "configuration" : {
    "idpID" : "MyIDP",
    "pipeID" : "UserLookupAndAuthWithLDAPSAML",
    "loginTemplate" : "login_custom.template"
  }
}</p>
Click to copy

Upgrade

  • Make sure to have a backup before starting
  • Follow the product upgrade instruction
  • Check if there are any differences between the updated default template file and the old version default template file.
  • If no differences were found, just copy the "login_custom.template" from the old version.
  • If differences were found, locate the differences between the customized template and the original template. Apply customizations to the new version of the template.