Actions supported

Integrating ADManager Plus with ServiceDesk Plus enables IT admins to automate the following tasks:

How to integrate ADManager Plus and ServiceDesk Plus

1. Log in to ADManager Plus.

2. Navigate to the Automation tab and click Application Integrations.

3. Under Enterprise applications, click ServiceDesk Plus.

4. In the Authorization section, paste the API key generated in ServiceDesk Plus in the Value field.

5. Click Configure.

6. In the API Endpoint Configuration section,

• Replace <SDP_SERVER> with your ServiceDesk Plus instance.

• Create <URL encoded input params> and replace in Endpoint URL.

• Enter the headers as below:

• Host : Enter your ServiceDesk Plus instance URL

• authtoken: Token generated in the previous steps

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

8. Click Data Source - LDAP Attribute Mapping to map AD LDAP attributes with the respective attributes in ServiceDesk Plus.

9. Enter the Configuration Name and Description and select the Automation Category from the drop-down menu.

10. In the Select Endpoint field, select a column with unique values for each user (employeeIdenifier, username, etc.).

11. In the Attribute Mapping field, select the attribute from the LDAP Attribute Name drop-down menu and map it with the respective column in ServiceDesk Plus.

12. Click Save.

 Steps to create URL encoded input params 

1. Construct the JSON input with the below format.

{"list_info":{"row_count":"100","start_index":1,"fields_required":["udf_fields.udf_sline_901","udf_fields.udf_sline_301"],"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"}]}}

2. In the above JSON, replace value for fields_required (highlighted text) JSON array with the custom attributes created in the ServiceDesk Plus request template for user creation.

3. Encode the input using an URL encoder and replace in the Endpoint URL instead of "<URL encoded input params>". You can use any online tool to URL encode the input_params like https://www.urlencoder.org/

 Steps to create Additional Fields in ServiceDesk Plus 

1. Click Admin > Customization > Additional Fields.

2. Select New Field, input the attribute name in the Label Name field, and then click Save.

3. Follow step 2 for every AD attribute that needs to be included in the user creation process.

Steps to create onboarding request template using the Additional Fields in ServiceDesk Plus

1. Click Admin > Templates and Forms > Incident Template.

2. Select New Incident Template or Edit the existing onboarding template. On the right side, you will find the created fields listed under Drag & Drop Fields.

3. Place the required fields in the template.

4. Input the subject. For instance: New employee joining the organization (this subject will be utilized as a filter on the ADManager Plus HCM side).

5. Click Save.

Raise request in ServiceDesk Plus 

Raise user onboarding request using the template created in the previous step.

Steps to generate authtoken

Please follow the steps mentioned in the attached link. https://help.servicedeskplus.com/api/rest-api.html$key