- Related Products
- ADAudit Plus
- ADSelfService Plus
- EventLog Analyzer
- Exchange Reporter Plus
- AD360
- Log360
Integrate ADManager Plus with your enterprise applications that support REST API or SOAP API to manage the identities in those applications. ADManager Plus comes with prebuilt applications. If the application you want to integrate is not found on the list, follow the steps below to integrate that application with ADManager Plus.
Select No Auth as the authorization type if your request doesn't require authorization. On doing this, the authorization details will not be shared with the API client.
If you select API Key as the authorization type,
If you select OAuth 2.0 as the authorization type, specify the following:
For example: http://{hostname}/OAuthCode.do. The hostname will be the machine on which the ADManager Plus instance is installed.
While integrating a new application, this should be configured in the API provider's OAuth configuration.
To import the object data from any enterprise application, we need the API endpoints to obtain all the details of the objects that have to be imported. We can find the required API information in the application's API documentation or contact the support team of the application being integrated. Perform the steps given in the following sections after you complete the Authorization configuration.
Before proceeding to setup the endpoints, it's important to know that there are two types of endpoint configuration in ADManager Plus such as:
Depending on your organizational goals, you can configure anyone or both.
This enables the transfer of data from the custom application to ADManager Plus. To configure this:
Note: Follow these steps to configure advanced settings.
Note: Click Add New Naming Format to create a new naming format for the user naming attributes in the custom application.
After configuring the inbound webhook, you can use it as a data source by clicking the Select More option under Select objects section of the automation in scheduled automations for different identity management actions from ADManager Plus.This enables us to perform the desired action available in automation on the list of objects imported through the inbound webhooks either once or periodically.
For some API configurations we may have to configure multiple endpoints where the endpoints are dependent on others. For example, the first endpoint fetches all employee IDs in an organization and we need to hit another API for each employee ID received in the response to fetch the employee's details. In cases like these, configure the first API as a base endpoint (default type) and the second endpoint as dependent endpoint using the Advanced option.
Toggle the Advanced button to on under the API Endpoint Configuration to fill in information when the endpoint is dependent on the previous API endpoint.
You have to follow all the steps as mentioned in the inbound webhook configuration section except for this step. When the message type is set to XML, ADManager Plus requires the Response Parser CSV file. This file helps in filtering only the required data from the endpoint's XML response. The filtered attributes can then be linked to the AD LDAP attributes.
The CSV should have three columns as given below:
For example, as shown in the below images, value for the columnName Worker ID as highlighted in the sample CSV file is extracted from the attribute Worker_ID(value:100001) as highlighted in the sample XML response file. This value can be later mapped to the AD LDAP attribute employee ID.
Sample CSV file:
Sample XML response:
Outbound webhook enables you to send the changes made in AD using ADManager Plus to the custom application. To configure outbound webhooks,
After you configure an outbound webhook for the required action, use it as a block in an orchestration template. The configured orchestration template can be executed using event-driven automation, scheduled automations, automation policies, and can also be applied directly on the desired users to perform a sequence of actions on them (Management > Advanced Management > Orchestration).