Integration of Key Manager Plus with ServiceDesk Plus

ManageEngine Key Manager Plus is a web-based key management solution that helps you consolidate, control, manage, monitor, and audit the entire life cycle of SSH (Secure Shell) keys and SSL (Secure Sockets Layer) certificates. To learn more about the features and functionalities of Key Manager Plus, click here.

Integration of Key Manager Plus with ServiceDesk Plus allows you to automatically log requests based on the alerts raised in Key Manager Plus for certificate expiry or vulnerability. You can remotely deploy certificates, renew certificates, or perform vulnerability scan on certificates directly from ServiceDesk Plus. Also, you can sync certificates from CMDB in ServiceDesk Plus with Key Manager Plus.
 

• Configuring the Integration
  • Prerequisites 
    • Obtaining Auth Token from Key Manager Plus
    • Obtaining Auth Token from ServiceDesk Plus
• Configuring the Integration in Key Manager Plus
• Configuring the Integration in ServiceDesk Plus
• Deploy, Renew, and Scan Certificates
   

Configuring the Integration

Integration of Key Manager Plus with ServiceDesk Plus requires a two-way configuration depending on the requirements. Configuring integration in ServiceDesk Plus only allows you to access Key Manager Plus  via a quick-link button. For enabling actions such as deployment, renewal, and scanning that can be performed directly from ServiceDesk Plus, the integration must be configured in both applications.

Prerequisites

The integration of Key Manager Plus with ServiceDesk Plus relies on auth tokens from Key Manager Plus and ServiceDesk Plus. To obtain it, follow the steps below.

Obtaining Auth Token from Key Manager Plus

1. Log in to Key Manager Plus

2. Navigate to Settings >> General Settings >>API Key.

3. Select Enable for API Key Access and click Generate.
    

Obtaining Auth Token from ServiceDesk Plus

1. Log in to ServiceDesk Plus.

2. Click the user profile icon on the top-right and click Generate API Key.

3. In the popup that appears, select your preferred expiry status and click Generate.
    

Configuring the Integration in Key Manager Plus

For raising tickets in ServiceDesk Plus

1. Go to Setting >> Ticketing System.

2. Choose Enable under Ticketing Systems and select ServiceDesk Plus under Help Desks.

3. Provide the Technician Key and Server URL as obtained from ServiceDesk Plus. 

4. Select the types of tickets that need to be logged in to ServiceDesk Plus as required:

• Create ticket for SSL certificate expiry

• Create ticket for SSL vulnerabilities

5. Finally, click Save.
   
   
   

For enabling deployment, renewal, syncing, and scanning of certificates with ServiceDesk Plus

1. Go to Settings >> ServiceDesk Plus.

2. Under the Server Configuration tab, provide the Technician Key and Server URL as obtained from ServiceDesk Plus.

     
       3.Navigate to the CMDB tab, select Enable for Certificates Sync and choose and configure the CI Type.

• Create New CI Type

1. Provide CI Type and Parent CI Type.

• Use Existing CI Type

1. Provide existing CI Type and click Fetch Attributes.
2. Map the certificate fields with CI attributes as required.
   
    

4. Finally, click Save.

Configuring the Integration in ServiceDesk Plus

1. Go to Admin >> Integrations >> Key Manager Plus.

2. Provide KMP Hosted URL and Auth Token.
   
   
   

3. Configuring Actions (optional): To configure or edit the actions Deploy Certificate, Renew Certificate, and Scan Vulnerability, click the name of the action or the edit icon against it, and do the following.

1. Provide Action Name and Description.
2. Associate Roles: Choose any of the following as required.
   All Roles - Select this to associate all roles with this action.
   Select Roles - To associate specific roles, select this and add your preferred role using the combo box.
3. Associate Roles: Choose any of the following as required.
   All Templates - To associate all incident and service templates with this action
   All Incident Templates - To associate all incident templates with this action.
   All Service Templates- To associate all service templates with this action.
   Select Templates - To associate specific templates, select this and choose your preferred incident or service templates from the multi-select picklist.
   Click Update.
4. Finally, click Save.

Deploy, Renew, and Scan Certificates

You can perform various actions namely deploy or renew certificates and scan vulnerabilities in certificates directly from ServiceDesk Plus. These actions will be available under Custom Actions in the request details page of tickets logged in from Key Manager Plus.