Generating an Authentication Key

When you want to install or uninstall software applications and log help desk requests as tickets using ServiceDesk Plus, you are required to generate and enter an authentication key while integrating Desktop Central with ServiceDesk Plus. You must make the following settings to generate an authentication key:

  1. Create a role in ServiceDesk Plus with permission to do the following: 

    1. Install or uninstall software applications using Desktop Central

    2. Log help desk requests
       

  1. Assign the role, you created, to a technician
     

  2. Generate an API key
     

This section will explain you the steps involved in generating authentication key for users. Authentication key can be created for new users and existing users

Generate Authentication Key for 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 of the role
    2. Enter a description about the role
    3. In the Advance Permission section, you have to enable required permissions
      1. To enable auto-ticketing, select the Add checkbox available under Requests.
      2. To enable Software Deployment, select the Install/Uninstall Software checkbox available under Assets
    4. Click Save
  4. Assigning the role that was created to a technician and generating the Authentication Key
    1. Login to the ServiceDesk Plus console
    2. Click the Admin tab
    3. In the Users section, click Technicians 
    4. Click Add New Technician 
    5. Enter the following information about the technician:
      1. Personal details
      2. Contact information
      3. Cost details
      4. Department details
    6. Assign the required groups for the technician

      The groups that you assign to the technician should have ticket-creation permission in ServiceDesk Plus.


      1. Select the required permissions
      2. Check the Enable login for this technician checkbox. Enter the following details for the technician:
        1. Login name
        2. Password
        3. Domain name
      3. Select Enable Custom Privileges 
      4. Assign the role you created
  5. Under Select Permissions enable the checkbox " Enable login for this technician" and provide the essential details
  6. Under API Key Details, click Generate/Regenerate  to generate the authentication Key

    This key is entered when a technician key is required for Web service API requests.

You have successfully generated the authentication key, which should be copied and pasted in the Desktop Central server.

Generate  Authentication Key for Existing User

  1. Go to Admin tab in ServiceDesk Plus
  2. Under Users, select Technicians
  3. Choosing the Technician who has a login name, click edit icon
  4. Under API Key Details, click Generate/Regenerate   to generate the authentication Key

You have successfully generated the authentication key for the existing users.

Generate Authentication Key for logged in User

  1. Login in to ServiceDesk Plus
  2. Click Personalize
  3. Choose API Key Generation tab
  4. Click Generate/Regenerate to generate the key.

You have successfully generated an authentication key for the user who has currently logged on. The Authentication key that you have generated should be updated in the Desktop Central server. Follow the steps mentioned below:

  1. Login to the Desktop Central server
  2. Click the Admin tab
  3. In the Global Settings section, click ServiceDesk Plus Settings 
  4. In the Authentication Details section, enter the API key you generated in the ServiceDesk Plus console
  5. Click Save

You have generated the API key using the ServiceDesk Plus console and entered it in the ServiceDesk Plus settings in the Desktop Central server.

Copyright © 2005-2014, ZOHO Corp. All Rights Reserved.
ManageEngine