tLDAPConnection - 6.1

Talend Components Reference Guide

Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for Data Quality
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
Talend Studio
Data Governance
Data Quality and Preparation
Design and Development

tLDAPConnection Properties

Component family




Opens a connection to an LDAP Directory server for data transaction.


This component creates a connection to an LDAP Directory server. Then it can be invoked by other components that need to access the LDAP Directory server, e.g., tLDAPInput, tLDAPOutput, etc.

Basic settings

Property type

Either Built-in or Repository.

Since version 5.6, both the Built-In mode and the Repository mode are available in any of the Talend solutions.



Built-in: No property data stored centrally.



Repository: Select the repository file in which the properties are stored. The fields that follow are completed automatically using the data retrieved.



LDAP Directory server IP address.



Listening port number of server.



Select the protocol type on the list.

LDAP: no encryption is used

LDAPS: secured LDAP. When this option is chosen, the Advanced CA check box appears. Once selected, the advanced mode allows you to specify the directory and the keystore password of the certificate file for storing a specific CA. However, you can still deactivate this certificate validation by selecting the Trust all certs check box.

TLS: certificate is used. When this option is chosen, the Advanced CA check box appears and is used the same way as that of the LDAPS type.


Base DN

Path to user's authorized tree leaf.


User and Password

Fill in the User and Password as required by the directory

Note that the login must match the LDAP syntax requirement to be valid. e.g.: "cn=Directory Manager".

To enter the password, click the [...] button next to the password field, and then in the pop-up dialog box enter the password between double quotes and click OK to save the settings.


Alias dereferencing

Select the option on the list. Never improves search performance if you are sure that no aliases is to be dereferenced. By default, Always is to be used:

Always: Always dereference aliases

Never: Never dereferences aliases.

Searching:Dereferences aliases only after name resolution.

Finding: Dereferences aliases only during name resolution


Referral handling

Select the option on the list:

Ignore: does not handle request redirections

Follow:does handle request redirections

Advanced settings

tStatCatcher Statistics

Select this check box to gather the job processing metadata at a job level as well as at each component level.


This component is to be used with other LDAP components, especially with tLDAPInput and tLDAPOutput.


If you are using a subscription-based version of the Studio, the activity of this component can be logged using the log4j feature. For more information on this feature, see Talend Studio User Guide.

For more information on the log4j logging levels, see the Apache documentation at

Related scenarios

This component is closely related to tLDAPInput and tLDAPOutput as it frees you from filling in the connection details repeatedly if multiple LDAP input/output components exist.

For tLDAPConnection related scenarios, see Scenario 1: Inserting data in mother/daughter tables.