13.5.1 Customizing the Login Page of Web Authentication Events

You can customize the login page of the OAuth 2.0 or Open ID Connect and SAML 2.0 events. To do this, perform the following steps:

  1. Set Use Custom Branding File for Web Authentication to ON.

    By default, this option is set to OFF.

  2. Click Choose File to upload the osp-custom-resources.jar file in the Web Authentication Branding File.

  3. Click Template to download the branding template in the Download Custom Branding Template.

    1. Save the osp-custom-resources.jar file.

    2. Unzip the osp-custom-resources.jar file and in the resources folder open the file that you want to customize as follows:

      • naaf_enduser_custom_resources_<language>.properties - Use this file to customize the text related to the all methods on the login and Chain Selection pages.

        For example, to edit the text on the Authentication Chain Selection page, customize the values of the following parameters in the naaf_enduser_custom_resources_<language>.properties file:

        • NAAFENDUSER.ChainPageHeader: To edit the title

        • NAAFENDUSER.ChainPageSubHeader: To edit the paragraph after the title

        • NAAFENDUSER.ChainSelectChain: To edit the name of chain list drop down

        NOTE:In case, you have customized the messages in the following files:

        • The naaf_enduser_custom_resources_<language>.properties file of osp-custom-resources.jar

        • Policies > Custom Messages

        Depending on the status of Custom Branding, the messages are displayed to end-users as follows:

        • With Use Custom Branding File for Web Authentication set to ON, Web authentication events display the customized messages from the osp-custom-resources.jar file

        • With Use Custom Branding File for Web Authentication is set to OFF, Web authentication events display the messages from Custom Messages policy

      • oidp_enduser_custom_resources_<language>.properties - Use this file to customize css, logo, copyright text and links of the login page.

        For examples, refer to Example of Customizing a Login Page.

        NOTE:Ensure that you edit the attributes in the Login page properties section of the oidp_enduser_custom_resources_<language>.properties file for the custom branding of the login page.

        You must also add your customized .css file in the css folder and required logo to the images folder of the osp-custom-resources.jar file.

    3. After you edit the specific file in the resources folder, zip the file osp-custom-resources.jar.

      NOTE:To avoid the manifest file overwriting, make sure the jar file has been unzipped and zipped instead of opening and closing it with the Java .jar tool. Otherwise use the following command line switch to set the manifest file and make sure the name of the manifest file matches the filename in the template:

      jar -cm <jar file name> <manifest file name>.

  4. (Conditional) To restore the default look and feel of the new Enrollment Portal, Administration Portal, and login page of web authentication events, click Restore adjacent to Restore Default Branding.

  5. Click Save.

The following section describes an example of the customization that you can achieve for the Web authentication.