ManageEngine ServiceDesk Plus

ManageEngine ServiceDesk Plus (MESDPis a comprehensive help desk and asset management software that provides help desk agents and IT managers an integrated console to monitor and maintain the assets and IT requests generated from the users of the IT resources in an organization.

Creating Tokens for ManageEngine ServiceDesk Plus

Before configuring the ManageEngine ServiceDesk Plus connector in Lucidum, you must first create some tokens. Lucidum will use the API key to access the ManageEngine ServiceDesk Plus .

To set up MESDP OAuth authorization for Lucidum connector, follow the steps below (https://www.manageengine.com/products/service-desk/sdpod-v3-api/SDPOD-V3-API.html#oauth-2-0 ):

1. Register a new application at Zoho Developer Console (https://api-console.zoho.com/)

   • Choose “Self Client” type at the Developer Console:

     

   • Click “Create” to create a new client

     

   • Under the “Client Secret” tab, record the Client ID and Client Secret, which will be used later to generate the refresh token (e.g., copy the Client ID and Client Secret and paste them into a text file)

     

   • Under the “Generate Code” tab, fill in the application’s scope information as below:

     • Scope: SDPOnDemand.assets.READ,SDPOnDemand.general.READ

     • Time Duration: 10 minutes

     • Scope Description (optional): Lucidum SDP Connector

       

   • Click “Create” on the “Generate Code” to generate a temporary code. Record/copy this code and paste it into the same text file with the Client ID and Client Secret. Note that this code is valid for only 10 minutes. Therefore, in 10 minutes, a refresh token needs to be generated with this code, the Client ID, and the Client Secret

     

2. Generate access and refresh token by making a POST request to the following URL: it is easier to do the POST request under the Postman tool

   

   CODE

   POST https://accounts.zoho.com/oauth/v2/token?code={code}&grant_type=authorization_code&client_id={client_id}&client_secret={client_secret}&redirect_uri=https://www.zoho.com

   • Replace {code} with the temporary code obtained from Step 1

   • Replace {client_id} with the Client ID obtained from Step 1

   • Replace {client_secret} with the Client Secret obtained from Step 1

3. If the POST request is successful, you will receive one output like this:

   JSON

   { "access_token": "1000.******************",
     "refresh_token": "1000.******************", 
     "token_type": "Bearer", "expires_in": 3600 }

Record the refresh token from the “refresh_token” field.

Configuring the Connector for ManageEngine ServiceDesk Plus

To configure Lucidum to ingest data from ManageEngine ServiceDesk Plus:

1. Log in to Lucidum.

2. In the left pane, click Connector.

3. In the Connector page, click Add Connector.

4. Scroll until you find the Connector you want to configure. Click Connect. The Settings page appears.

5. In the Settings page, enter the following:

   • Host (required): MESDP hostname. For example, sdpondemand.manageengine.com

   • App Refresh Token (required): permanent app refresh token to get access token for new OAuth2 authorization

   • App Client ID (required): app client ID to get access token for new OAuth2 authorization. For example, 1000.KU*******FNA

   • Client Secret (required): app client secret to get access token for new OAuth2 authorization

   • Scopes (optional): app scopes for new OAuth2 authorization. For example, SDPOnDemand.assets.READ,SDPOnDemand.general.READ

   • API Authentication Token (optional): API authentication token for legacy SDP API (new SDP uses OAuth2 instead)

   • OAuth2 Authorization (optional, default is false) - Use new OAuth2 authorization

   • Verify SSL. For future use.

6. To test the configuration, click Test.

   • If the connector is configured correctly, Lucidum displays a list of services that are accessible with the connector.

   • If the connector is not configured correctly, Lucidum displays an error message.

Supported Actions

• Delete a SDP asset: DELETE api/v3/assets/{asset_id}