Red Hat CERTIFICATE SYSTEM 7.2 - MIGRATION GUIDE, Administration Manual

Page: 421 / 512

Customizing Notification Messages
401
When the request gets queued for agent approval, a request-in-queue email notification should be
sent. Check the message to see if it contains the configured information.
3. Log into the agent interface, and approve the request.
When the server issues a certificate, the user receive a certificate-issued email notification to the
address listed in the request. Check the message to see if it has the correct information.
4. Log into the agent interface, and revoke the certificate.
The user email account should contain an email message reading that the certificate has been
revoked. Check the message to see if it has the correct information.
17.3. Customizing Notification Messages
The email notifications are constructed using a template for each type of message. Each type
of message has an HTML template and a plain text template associated with it. Messages are
constructed from text, tokens, and, for the HTML templates, HTML markup. Tokens are variables,
identified by a dollar sign (
$
), in the message that are replaced by the current value when the
message is constructed. See
Table 17.3, “Notification Tokens”
for a list of available tokens.
The contents of any message type can be modified by changing the text and tokens in the message
template. The appearance of the HTML messages can be changed by modifying the HTML
commands in the HTML message template.
The default text version of the certificate-issuance-notification message is as follows:
Your certificate request has been processed successfully.
SubjectDN= $SubjectDN
IssuerDN= $IssuerDN
notAfter= $NotAfter
notBefore= $NotBefore
Serial Number= 0x$HexSerialNumber
To get your certificate, please follow this URL:
https://$HttpHost:$HttpPort/displayBySerial?op=displayBySerial&
serialNumber=$SerialNumber
Please contact your admin if there is any problem.
And, of course, this is just a \$SAMPLE\$ email notification form.
This template can be customized as desired, by rearranging, adding, or removing tokens and text, as
shown:
THE EXAMPLE COMPANY CERTIFICATE ISSUANCE CENTER
Your certificate has been issued!
You can pick up your new certificate at the following website:
https://$HttpHost:$HttpPort/displayBySerial?op=displayBySerial&
serialNumber=$SerialNumber
This certificate has been issued with the following information:
Serial Number= 0x$HexSerialNumber
Name of Certificate Holder = $SubjectDN
Name of Issuer = $IssuerDN
Certificate Expiration Date = $NotAfter
Certificate Validity Date = $NotBefore
Contact IT by calling X1234, or going to the IT website http://IT
if you have any problems.