Skip to Content

LDAP Connector

Summary

The LDAP (Lightweight Directory Access Protocol) connector for Harmony Cloud Studio provides an interface for entering user-provided input such as credentials to create an authenticated LDAP connection. That connection provides the foundation to configure associated LDAP connector activities that interact with the connection. Together, a specific LDAP connection and its activities are referred to as an LDAP endpoint.

Supported API Versions and Prerequisites

The LDAP connector uses the Apache Directory LDAP API version 1.0.1. This API supports all types of LDAP servers, not just ApacheDS. Refer to the Apache LDAP API 1.0.1 Documentation and documentation on the specific LDAP server for information on the schema fields.

The LDAP connector requires the use of an agent version 10.1 or later. These agent versions automatically download the latest version of the connector when required.

Connector Overview

This connector is used to first configure an LDAP connection, establishing access to an LDAP directory server, and then used to configure one or more LDAP activities associated with that connection as a source or target within an operation:

  • Search Entry: Returns entries in an LDAP endpoint and is intended to be used as a source in an operation.

  • Add Entry: Adds entries to an LDAP endpoint and is intended to be used as a target in an operation.

  • Delete Entry: Deletes entries from an LDAP endpoint and is intended to be used as a target in an operation.

  • Modify Entry: Modifies entries in an LDAP endpoint and is intended to be used as a target in an operation.

Note

This connector is a Connector SDK-based connector, which may be referred to by Jitterbit when communicating changes made to connectors built with the Connector SDK.

Accessing the Connector

The LDAP connector is accessed from the design component palette's Connections tab (see Design Component Palette).

Activities

Troubleshooting

If you experience issues with the LDAP connector, these troubleshooting steps are recommended:

  1. Click the Test button in the connection configuration to ensure the connection is successful and to ensure the latest version of the connector is downloaded to the agent (unless using the Disable Auto Connector Update organization policy).

  2. Check the operation logs for any information written during execution of the operation.

  3. Enable operation debug logging (for Cloud Agents or for Private Agents) to generate additional log files and data.

  4. If using Private Agents, you can enable connector verbose logging for this connector using this specific configuration entry of logger name and level:

    <logger name="org.jitterbit.connector.ldap" level="DEBUG"/>

  5. If using Private Agents, you can check the agent logs for more information.