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 Sterling 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 Sterling Secure Proxy configuration
SSP Internal Portal
Login Page	Custom page to display for the Sterling 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 Sterling 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 Sterling Secure Proxy Login page:

Procedure

Click Advanced from the menu bar.
To create a new SSO configuration:
1. Click Actions > New SSO Configuration.
2. Type an SSO configuration name in the Name field.
To edit an existing SSO configuration:
1. From the navigation menu, click SSO Configurations.
2. Click the configuration to modify.
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.