Add custom branding, styles, and destinations to PingOne windows using a custom theme file.
These specifications apply only to installations of AD Connect with IIs. To customize branding and styles for standard AD Connect installations, see Assign AD Connect branding and designs.
C:\Program Files (x86)\Ping Identity\ADconnect\Examples\Default\theme.zip contains the HTML and related media files for PingOne login and error windows. The archive folder structure is unrestricted. The only required files for theme.zip are:
- login.html
- error.html
- changepassword.html
- passwordchanged.html
These files must all be present in the Theme.zip root.
<link rel="stylesheet" media="all" type="text/css" href="css/screen.css ">
<script src=" assets/js/script.js "></script>
All image name references must be in lower case.
Templates must use substitution symbols to render dynamic content generated by AD Connect.
The login.html template must use the following names for authentication form fields:
- ad.username for username
- ad.password for password
The changepassword.html template must use the following names for form fields:
- ad.username for username
- ad.password for current password
- ad.newpassword for new password
- ad.confirmpasswaord for new password confirmation
The substitution symbols and syntax for each required template file are listed in the following tables.
login.html
Substitution symbol | Description | Syntax |
---|---|---|
$action$ |
Replaced with the actual AD Connect URL where form data is posted for authentication. |
|
$error$ |
Replaced by error message text. |
|
$if(error)$ $endif$ |
Renders a conditional block of markup if an error occurs. |
|
$username$ |
Attach to the username input field to retain the username value if an error occurs. |
|
$username$_url |
Replaced by the URL for the change password page. |
|
error.html
Substitution symbol | Description | Syntax |
---|---|---|
$errormessage$ |
Replaced with error description. |
|
changepassword.html
Substitution symbol | Description | Syntax |
---|---|---|
$action$ |
Replaced with the AD Connect URL where form data is posted for authentication. |
|
$username$ |
Attach to the username input field to retain the usernamevalue if an error occurs. |
|
$error$ |
Replaced by error message text. |
|
$if(error)$ $endif$ |
Renders a conditional block of markup if an error occurs. |
|
$msg$ |
Replaced by success message text. |
|
$if(msg)$ $endif$ |
Renders a conditional block of markup after a successful operation. |
|
$cancel_url$ |
Replaced by a URL that the user is directed to when they click Cancel. |
|
$if(cancel_url)$ $endif$ |
Renders a conditional block of markupif cancellation is possible. |
|
passwordchanged.html
Substitution symbol | Description | Syntax |
---|---|---|
$resume_url$ |
Replaced by a URL that the user is directed to when they click Continue. |
|
To install the customization archive, copy the updated theme.zip file into the single sign-on (SSO) application folder.
The default folder location is C:\Program Files (X86)\Ping Identity\ADConnect\SSO.