Authenticating the Integration


This document will explain you the steps involved in configuring Desktop Central and ServiceDesk Plus integration. The first step in integrating Desktop Central with ServiceDesk Plus is to generate an authentication Key to authenticate the integration. Authentication Key is also called as API Key. Authentication keys should be generated in both the servers, that is Desktop Central and ServiceDesk Plus. The key which is generated in Desktop Central should be entered in ServiceDesk Plus server, and the key which is generated in ServiceDesk Plus, should be updated in the Desktop Central server. All communications between the Desktop Central and the ServiceDesk Plus server will be validated based on these authentication keys.

Authentication Key is mandatory to secure all communications between the Desktop Central and ServiceDesk Plus. Authentication Keys are used to perform the below mentioned operations:

  1. Authentication Key generated in Desktop Central and updated in ServiceDesk Plus is used to:

  2. Authentication Key generated in ServiceDesk Plus and updated in Desktop Central Plus is used to:

Generating Authentication Key in Desktop Central

Note : The following steps are applicable only for customers who are running Desktop Central build # 90109 or later versions and ServiceDesk Plus build # 9033. If you are using Desktop Central running on build number lesser than 90109, or ServiceDesk Plus build number lesser than 9033, then upgrade to  the latest version and follow the steps mentioned below.

Authentication key can be created only for the logged on user and the user should have Administrator privilege. To generate an authentication key, You need to login to Desktop Central web console as the user, with administrator privilege and follow the steps mentioned below:

  1. Click Admin tab on Desktop Central web console
  2. Under Integration, select API Key Generation
  3. Against the user name, under Action, click Generate to generate authentication key
  4. Copy the generated key and click Save to complete the process

You can now update the copied authentication key in the ServiceDesk Plus server, for the integration to work. The API Key that you have generated should be pasted on the SeriveDesk Plus server in the below mentioned location :

  1. Click Admin, tab on ServiceDesk Plus
  2. Under  General, choose ME Integrations
  3. Choose Desktop Central and specify the API Key under Server Configuration.
  4. Click Test Connection and Save  to verify the API key is authentication and communication has been established.

You have successfully generated the API key and established communication with the ServiceDesk Plus server.

Generating Authentication Key in ServiceDesk Plus

To generate an authentication key for ServiceDesk Plus, you should login as a user, with administrator privilege. Follow the steps mentioned below to generate authentication key for a new user.

  1. Go to Admin tab in ServiceDesk Plus
  2. Under Users, select Technician
  3. Click Add New  to create a new technician and fill in the required details.
    1. Enter the name
    2. Enter the required description and specify the privileges required for the technician like, contact information, cost details, department details, assigning the group to technician and select permission.
    3. Check the Enable login for this technician checkbox. Enter the following details for the technician:

      1. Login Name

      2. Password

      3. Re-type Password

      4. Domain

    4. Select Enable Administrator Privileges (SDAdmin) option

    5. Under API Key Details, click Generate/Regenerate  to generate the authentication Key

You have successfully generated the authentication key, which should be copied and pasted in Desktop Central Server -> Admin tab -> Integrations -> ServiceDesk Plus settings -> API key details. You can also generate authentication key for the existing user by editing the Technician details, and click Generate under API Key details. If you wanted to generate authentication key for logged in user, you can click Personalize and generate API key.

Copyright © 2018, ZOHO Corp. All Rights Reserved.