Custom Event Handler Operations

Custom event handlers are used by expiration and enrollmentClosed Certificate enrollment refers to the process by which a user requests a digital certificate. The user must submit the request to a certificate authority (CA). alerts (see Alerts) but not by Keyfactor Command workflows (see Workflow).

Tip:  Where to find this in the Management Portal:
System Settings → Event Handler Registration

The built-in event handlers are registered as part of the Keyfactor Command installation. You should only need to use this option if you have a custom event handler.

This option is only supported for Windows installations under IIS.

To register a custom event handler:

  1. Navigate to the ExtensionLibrary folder on your server under the installed folder for Keyfactor Command. By default, this is:

    C:\Program Files\Keyfactor\Keyfactor Platform\ExtensionLibrary

  2. Copy your custom event handler DLL (provided by Keyfactor if the file has been created by Keyfactor) into the ExtensionLibrary folder.

  3. On the Event Handler Registration page, click Analyze Handler File.

    Figure 460: Register a Custom Event Handler

  4. In the Analyze Event Handler Assembly File dialog, enter the file name for the event handler file for analysis and click Save.

To delete an event handler, highlight the row in the grid and click Delete at the top of the grid.

To edit an event handler:

  1. Double-click the event handler or highlight the row in the grid and click Edit at the top of the grid.
  2. In the Event Handler Registration dialog, you can change the Display Name for the event handler, if desired. This name appears in the dropdowns in the expiration, pending request, issued certificate, and denied request alert configuration dialogs. You can also disable the event handler by unchecking the Enabled box. If you disable an event handler, it will not appear in the dropdowns in the alert configuration dialogs.
  3. Click Save.

Figure 461: Event Handler Registration Editor