Table of Contents
Advertisement
RenewalNotificationJob Plug-in Module
Jobs are implemented as Java classes, which are then registered with Certificate
Management System as plug-in modules. You can use a given implementation of a
job module and configure multiple instances of it. Each instance must have a
unique name (an alphanumeric string with no spaces) and can contain different
input parameter values to apply to different jobs.
Note that the name of the Java class for a job plug-in module is in this format:
com.netscape.certsrv.jobs.<plugin_name>
where
is the name of a plug-in module. For example, the Java class
<plugin_name>
for the
module would be:
RenewalNotificationJob
com.netscape.certsrv.jobs.RenewalNotificationJob
RenewalNotificationJob Plug-in Module
When a certificate is about to expire, the owner of the certificate needs to renew it.
Using the Jobs Scheduler, you can configure a Certificate Manager or Registration
Manager to automatically send email-based renewal notices to users whose
certificates are about to expire or have expired. You can also configure these
subsystems to send one or more administrators or issuing agents a summary of
users who have received these reminders.
The
plug-in module is a schedulable job. When an
RenewalNotificationJob
instance of the job is enabled, it checks for certificates that are about to expire in the
internal database. When it finds one, it automatically emails the certificate's owner
and continues sending email reminders for a configured period of time, or until the
certificate is renewed. The job also collects a summary of all such renewal
notifications and mails the summary to one or more agents or administrators.
The job determines the email address to which to send the notification using an
email resolver, which you can customize. By default, the email address is found in
the certificate itself or in the certificate's associated enrollment request.
The email notification message, as well as the summary message, are constructed
using a template found in the configured directory. This directory has the
following default location:
<server_root>/cert-<instance_id>/emails
You can configure both the path and filenames of the template files for each job and
modify the templates to customize the contents and appearance of the messages.
Messages can be sent as HTML or plain text. For customization information, see
"Customizing Notification Messages" on page 79.
Chapter 2
Job Plug-in Modules
67
Advertisement
Table of Contents
