Overview
Freshservice is an intuitive cloud IT service management tool that supports several features such as service tickets handling, incident management, project management and more, to centralize IT administration. IT admins can integrate Freshservice with ADManager Plus to simplify the cumbersome process of managing it's user identities in Active directory, Microsoft 365 and Google Workspace. They can create event-driven automations and automate various identity management processes such as enabling users, modifying their attributes, moving them across groups, revoking Microsoft 365 licenses, etc., from one place.Admins can automate the below listed actions in ADManager Plus.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Steps to integrate Freshservice with ADManager Plus
Log in to ADManager Plus > Automation > Application Integrations
Click the Freshservice tile under the Enterprise Applications and toggle the Enable Freshservice Integration button on.
Freshservice uses Basic Authentication as the Authorization type. Provide the API key as the Username and X as the Password.
Figure 1. Authorization details
Click Configure and proceed further.
Under the Freshservice Endpoint Configuration tab, Freshservice Requester Endpoint and Freshservice Agents Endpoint details will be auto-populated.
Figure 2. Freshservice requesters endpoint configuration
Figure 3. Freshservice agents endpoint configuration
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.
Click Test & Save and view the displayed response schema.
Figure 4. Response schema
Click Proceed.
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
Login to your Freshservice dashboard and click your profile picture as shown in the image below.
Now click the Profile Settings.
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