Customizing The Smart Card Enrollment User Interface - Red Hat CERTIFICATE SYSTEM 8.0 - MANAGING SMART CARDS WITH THE ENTERPRISE SECURITY CLIENT 1-23-2010 Manual

6.4. Customizing the Smart Card Enrollment User Interface

The TPS subsystem uses a generic smart card enrollment page which is opened automatically when
an uninitialized smart card is inserted. There are actually three pages, depending on the mode in
which the client is running:
• /var/lib/pki-tps/cgi-bin/home/Enroll.html for regular enrollments
• /var/lib/pki-tps/cgi-bin/so/Enroll.html for security officer enrollments
• /var/lib/pki-tps/cgi-bin/sow/Enroll.html for security officer workstation enrollments
(users enrolled through the security officer UI)
NOTE
The security officer workstation directory contains other HTML files for other token
operations, such as formats and PIN resets.
There may be even more enrollment pages if there are custom user profiles.
These enrollment pages are basic HTML and JavaScript, which allows them to be easily customized
for both their appearance and functionality. The resources, such as images and JavaScript files,
referenced by the enrollment file are located in the corresponding docroot/ directory, such as /var/
lib/pki-tps/docroot/esc/sow for the security officer enrollment file in /var/lib/pki-tps/
cgi-bin/sow.
There are several ways that the smart card enrollment pages can be customized. The first, and
simplest, is changing the text on the page. The page title, section headings, field names, and
descriptions can all be changed by editing the HTML file, as shown in the extracts in
"Changing Page Text".
<!-- Change the title if desired -->
<title>Enrollment</title>
...
<p class="headerText">Smartcard Enrollment</p>
...
<!-- Insert customized descriptive text here. -->
<p class="bodyText">You have plugged in your smart card!
After answering a few easy questions, you will be able to use your smart card.
</p>
<p class="bodyText">
Now we would like you to identify yourself.
</p>
...
<table>
<tr>
<td><p >LDAP User ID: </p></td>
<td> </td>
<td><input type="text" id="snametf" value=""></td>
</tr>
</table>
Example 6.2. Changing Page Text
The styles of the page can be changed through two files: the style.css CSS style sheet and the
logo image, logo.png.
Customizing the Smart Card Enrollment User Interface
Example 6.2,
63