Overview

Steps to integrate Freshservice with ADManager Plus

1. Log in to ADManager Plus > Automation > Application Integrations.

2. Click the Freshservice tile under the Enterprise Applications and toggle the Enable Freshservice Integration button on.

3. Freshservice uses Basic Authentication as the Authorization type. Provide the API key as the Username and X as the Password.

                                   Figure 1. Authorization details

4. Click Configure and proceed further. 

5. Under the Freshservice Endpoint Configuration tab, Freshservice Requester Endpoint and Freshservice Agents Endpoint details are auto-populated.

                   Figure 2. Freshservice requesters endpoint configuration

               Figure 3. Freshservice agents endpoint configuration

6. In both the sections, the Endpoint URL, Headers, Methods and Parameters fields are pre-configured. You have to replace the {domain} with the subdomain of your Freshservice instance.

Example: The default endpoint URL in ADManager Plus will be  https://{domain}.freshservice.com/api/v2/contacts. If your Freshservice instance is named as admpintegration-help.freshservice.com, then the "{domain}" has to be replaced with "admpintegration-help" as shown in figure 3.

Note: The Repeat calling this Endpoint option will be used to fetch the details of up to 100 users per API call. For more details, refer to this API documentation.

7. Click Test & Save and view the displayed response schema.

                                         Figure 4. Response schema

9. Click Proceed.

10. Now, map the LDAP attributes with the respective Freshservice attributes in the Data Source - LDAP attribute Mapping tab. The attributes that are mapped under this section will be considered as the data source attributes for the automation.

Note: To map a new set of data source attributes depending on your need, click Add New Configuration.

                  Figure 5. Data Source - LDAP attribute Mapping.

 Steps to obtain the API Key value from Freshservice 

1. Login to your Freshservice dashboard and click your profile picture as shown in the image below.
   

2. Now click the Profile Settings.

3. Navigate to the panel in the right and under Delegate Approvals and click View API Key. You can view the API key after completing captcha challenge. Copy this value and use it as username while configuring authorization in ADManager Plus.