Customize the Login Page

About this task

The default Login page is a simple page with no logo information and prompts the user to provide a user ID and password. This default page contains a link that can be used if the user forgets his user ID or password.

You can customize a Login page to define how you want the page to look and what information to include on the page. You can customize this page by modifying the labels or replacing the entire page.

Before you modify the Login page, gather the following information:

Provide a value for each Secure Proxy feature listed. Fields listed in the worksheet are required.
Accept default values for fields not listed.
Note the Configuration Manager field where you will specify the value.


Configuration Manager Field	Feature	Value
Name	Name to assign to the Secure Proxy configuration
SSP Internal Portal
Login Page	Custom page to display for the Secure Proxy single sign-on Login page.
Login Directory Name	Custom directory in the engine installation directory where the HTML files that support single sign-on are stored.
Login Page Charset	Character encoding used to create the Secure Proxy Login page. This value is sent to the browser as part of the content-type header with the Login page.
Login Page Media Type	Media type value sent to the browser in the content-type header with the Login page. Default is text/html.

To customize the Secure Proxy Login page:

Procedure

From IBM Sterling Secure Proxy, select Advanced from the left hand-side navigation panel.
Select SSO Configurations to display SSO Configurations page.
To create a new SSO configuration:
1. Click Add new + to display SSO Configuration page.
2. Type an SSO configuration name in the Name field.
To edit an existing SSO configuration:
1. Click Add new + to display SSO Configuration page.
2. Type an SSO configuration name in the Name field.
On the Logon Portal tab, select SSP Internal Portal.
Change one or more of the following fields to customize the Login page:
- Login Page
- Login Directory Name
- Login Page Charset
- Login Page Media Type
Click Save.
To change the text or graphics on the Login page, open the \install_dir\signon directory and modify the login .html file as required.
Note: If you modify the login .html file, do not modify the following lines:
```
var ssoMsgText=”#{ssoMsgText}”; 
var ssoMsgTitle=”#{ssoMsgTitle}”; 
var ssoMsgType=”#{ssoMsgType}”; 
var ssoMsgOnly=”#{ssoMsgOnly}”;
```
If you modify the login .html file, create a copy of the \install_dir\Signon directory.

Making a copy of the directory prevents the custom attributes from being overwritten if you upgrade the software or apply a patch.