Note:

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.

Templates can include any javascript, graphics, CSS or other scripts included in theme.zip, using relative links, as in the following example.
<link rel="stylesheet" media="all" type="text/css" href="css/screen.css ">
<script src=" assets/js/script.js "></script>
Note:

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.

<form method="POST" action="$action$"> </form>
$error$

Replaced by error message text.

$if(error)$ $endif$

Renders a conditional block of markup if an error occurs.

$if(error)$
<div>$error$</div>
$endif$
$username$

Attach to the username input field to retain the username value if an error occurs.

<input id="username" type="text" size="36" name="ad.username" value="$username$"/>
$username$_url

Replaced by the URL for the change password page.

<a href="$changepassword_url$">Change my password</a>

error.html

Substitution symbol Description Syntax
$errormessage$

Replaced with error description.

<font face="Arial">$errormessage$</font>

changepassword.html

Substitution symbol Description Syntax
$action$

Replaced with the AD Connect URL where form data is posted for authentication.

<form method="POST" action="$action$"> </form>
$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.

$if(error)$
<div>$error$</div>
$endif$
$msg$

Replaced by success message text.

$if(msg)$ $endif$

Renders a conditional block of markup after a successful operation.

$if(msg)$
<div>$msg$</div>
$endif$
$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.

$if(cancel_url)$
<a href="$cancel_url$" title="Cancel">Cancel</a>
$endif$

passwordchanged.html

Substitution symbol Description Syntax
$resume_url$

Replaced by a URL that the user is directed to when they click Continue.

<a href="$resume_url$" class="button normal allow" title="Continue">Continue</a>

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.