Overview

This integration accelerates the resolution of AD-related tickets raised in ServiceDesk Plus Cloud by automatically executing the requested operations in tickets using ADManager Plus.

Actions supported

 Steps to integrate ADManager Plus and ServiceDesk Plus On-Demand

1. Log into ADManager Plus and navigate to Automation > Configuration > Application Integrations.

2. Under Enterprise applications, click the ServiceDesk Plus Cloud tile.

3. Toggle on the Enable ServiceDesk Plus Cloud Integration option to enable the configuration.

4. Basic details under the Authorization section are pre-filled. OAuth 2.0 is selected as the Authorization Type by default. You only have to provide the Client ID and Client Secret values that you generate in the API console. The remaining details, including Header Prefix, Grant type, etc., are pre-configured.

5. Copy and save the Callback URL, as you will need it while configuring your instance in the API console.

6. In the Access token URL and Auth URL fields, the top-level domain will vary based on the region from which you access the Zoho API console. You'll have to update the URLs accordingly when configuring the Authorization details.                                                                                                                                                                                   For example: The Access token URLs for users in China and India are

   • China: https://accounts.zoho.cn/oauth/v2/auth?access_type=offline

   • India: https://accounts.zoho.in/oauth/v2/auth?access_type=offline

7. Now, click Configure to proceed.
   

8. In the ServiceDesk Plus Cloud Endpoint Configuration section, change the domain name and provide input parameters.
   

• In the Endpoint Configuration tab, replace <SDP_SERVER> with your ServiceDesk Plus Cloud instance in the Endpoint URL field.

Note: To view ServiceDesk Plus Cloud's API references, see this API page.

• In the Parameters field, add the query parameters needed for endpoint configuration as given below.
  

• Construct a JSON input in the format as follows.
  

{"list_info":{"row_count":"100","start_index":1,"fields_required":["udf_fields.udf_char2","udf_fields.udf_char3"],"search_criteria":[{"field":"last_updated_time","condition":"is","value":"$(LAST_24_HRS)"},{"field":"subject","condition":"like","value":"New employee joining the organization","logical_operator":"and"}],"sort_fields":[{"field":"subject","order":"asc"}]}}

1. In the above JSON input, replace the value for fields_required JSON array with the custom attributes created in the ServiceDesk Plus Cloud Request Template.
   

 

Note: "udf_fields.udf_char2","udf_fields.udf_char3" are the AD attributes created as additional fields and added in the ServiceDesk Plus template.

9. Once done, click Test & Save. A response window will display all the requested elements.

10. Click Data Source - LDAP Attribute Mapping to match endpoints and to map the AD LDAP attributes with the application's attributes.

11. Enter the Configuration Name and Description, then select the Automation Category from the drop-down menu.

12. In the Select Endpoint field, select those columns that are unique to users (such as employeeIdenifier and username) but hold the same value in all the endpoints.

13. In the Attribute Mapping field, select the attribute from the LDAP Attribute Name drop-down menu, and map it with the ServiceDesk Plus Cloud application's attributes.

14. Click Save.

While configuring an automation in ADManager Plus, select ServiceDesk Plus Cloud as the Data Source and automate user management. To learn more about automation configuration, see the Configuring automation page. 

Steps to generate the Client ID and Client Secret