This wizard helps you to create a new connection to a LDAP directory.
To start the wizard choose one of the following options:
In the Connections view select the
New Connection...
button or select
New Connection...
from the context menu.
In the Workbench window's toolbar, activate the drop-down menu on the New Wizard button and select LDAP Connection
In the Workbench menu bar select File > New > LDAP Connection .
The creation of a new LDAP connection is a tree-step process:
The first page allows you to enter a connnection name and the network parameters.
| Option | Description | Default |
|---|---|---|
| Connection name | The name of the connection. In the Connections view the connection is listed with this name. The name must be unique. | empty |
| Hostname | The hostname or IP address of the LDAP server. A history of recently used hostnames is available through the drop-down list. | empty |
| Port | The port of the LDAP server. The default port for non-encyrpted connections is 389. The default port for ldaps:// connections is 636. A history of recently used ports is available through the drop-down list. | 389 |
| Encryption method | The encryption to use. Possible values are 'No encrypton', 'ldaps://' and 'StartTLS extension'. Pay attention for the warning: The current version doesn't support certificate validation! | No encryption |
| Check network parameter | Use this function if you want to attempt a connection to the host upon completion of the wizard to validate that the entered information is correct. | - |
| Open connection on finish | If checked the connection is opened when finishing the wizard. | checked |
On the second page you could specify the authentication parameters.
| Option | Description | Default |
|---|---|---|
| Anonymous Authentication | Uses anonymous authentication, no authentication parameters required. | not checked |
| Simple Authentication | Uses simple authentication, requires authenticaton parameters. | checked |
| Bind DN | The distinguished name used to bind. Previously entered DNs could be selected from drop-down list. | empty |
| Bind Password | The password used to bind. | empty |
| Save password | If checked the password will be saved in configuration. If not checked you have to enter the password whenever you connect to the server. Warning: The password is saved as plain text! | checked |
| Check Authentication | Use this function if you want to attempt a connection plus a bind to the host upon completion of the wizard to validate that the entered information is correct. | - |
On the third page you could enter additional connection parameters.
| Option | Description | Default |
|---|---|---|
| Get base DNs from Root DSE | If checked the base DNs are fetched from namingContexts attribute of the Root DSE. | checked |
| Fetch Base DNs | Use this function to get the namingContext values from the root DSE. The returned values will appear in the 'Base DN' drop-down list. | - |
| Base DN | The base DN to use. You may enter a DN manually or you may select one from the drop-down list. This field is only enabled if the option 'Get base DNs from root DSE' is off. | empty |
| Count Limit | Maximum number of entries returned from server when browsing the directory, it is also used as default value when searching the directory. A value of 0 means no count limit. Note that this value is a client-side value, its possible that also a server-side limit is used. | 1000 |
| Time Limit | The maximum time in milliseconds the server searches for results. This is used as default value when browsing or searching the directory. A value of 0 means no limit. Note that this value is a client-side value, its possible that also a server-side limit is used. | 0 |
| Alias Dereferencing | Specifies whether aliases should be derefenced while finding the search base entry or when performing the search or both. | Both finding and searching |
| Referrals Handling | Specifies the referral handling. Ignore means that referrals returned from server are ignored, Follow means that the LDAP Browser will follow referrals returned from server. | Follow |