Managing certificates

When you use webhooks in CES to communicate with BMC Mainframe products such as Code Pipeline and Abend-AID, you might want to configure security certificates for those webhooks. When the webhooks communicate with third-party applications such as Jenkins, you can use the certificates to secure that communication.

To use the Certificates feature, you must have the Common Enterprise Service Certificates rights assigned to your user role.

You can use the Certificates page to upload and manage security certificates for Code Pipeline and Abend-AID webhooks. You can associate one certificate to multiple webhooks.

The Certificates page lists all the certificates uploaded and indicates which of them are currently in active use.

Related topics

Getting-started

Adding-a-webhook

Managing-security-roles

You can also perform the following actions:

Purpose

Action

Add a certificate.

Click Upload. In the Upload Certificate dialog box, perform the following steps:

  1. Specify a unique Certificate name.
  2. Click Browse to navigate to a valid certificate file (.pfx) and click Choose certificate to upload. The system validates the uploaded file.
  3. Specify a Certificate password. You must secure certificates with a password before you import them into CES.
  4. Specify the TrustStore location on the CES server and the TrustStore password. The TrustStore file must contain the trust authorities to authorize the certificate with the respective server.
  5. Click Upload.

The uploaded certificate appears in the Certificates table in the Not used status until it is associated with a webhook. For more information about associating the certificate with a webhook, see Adding-a-webhook.

Edit a certificate.

Click Edit Edit.pngin the relevant row.

If a previously uploaded certificate file has expired, you can edit the corresponding certificate details to replace the old certificate file with a new certificate file. If this certificate is associated with a webhook, the newly uploaded certificate file is automatically updated and mapped to that webhook.

Delete a certificate.

Click Delete Delete.pngin the relevant row.

Important

You cannot delete a certificate that is currently in use and associated with a webhook.

Sort the order in a column.

Click SortArrow.png(Sort arrow) in the column header.

Sort the order in multiple columns.

Perform the following steps:

  1. Click SortArrow.png(Sort arrow) in the column header in a column.
  2. To select more columns, perform one of the following options:
    • Press the ctrl (or command) key and click the sort arrow in the required column headers.
    • Click 3-dots.pngin the required column headers.
  3. For each selected column, go to the 3-dots.pngmenu, select Ascending or Descending, and select the desired Sort order.
    When you select a sort order, the column header displays a number to indicate the priority of the column in the sort sequence. The direction of the sort arrow indicates if the column is sorted in the ascending or descending order.

Thus, the table displays values sorted column-wise, one after the other, such that the previous sort order is not distorted by the next sort order.

From the 3-dots.pngoptions, you can also perform the following actions:

  • Change or swap the Sort order as required.
  • Remove a column from the multi-sort sequence by selecting Remove from current sort.
  • Remove all sorting by selecting Clear all sorting.

Search within the table.

In the Search field, enter the search criteria.

Filter the details at the column level.

In the Filter field, specify filter criteria.

For example, to view a specific list of certificates by a particular string in the certificate name and those currently not in use, enter Not used in the In Use - Filter field. Then, enter the specific string in the File name - Filter field. The UI dynamically populates and displays only the desired list of certificates.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*