Skip to content

User Guide

Dave edited this page Jun 5, 2022 · 16 revisions

Using and enjoying ldapinator on your small, home network

Connecting to ldapinator

ldapinator listens on port 3268 by default for unencrypted (http) access to the web interface. 3269 is the encrypted (https) port.

Simple point your web browser to http://<your.host.name>:3268 or http://<your.host.name>:3269

You must configure certificates to enable encrypted communication on port 3269.

Navigating the directory

When you first visit the ldapinator web interface, you'll see a house icon at the top left, along with the top-level distinguished name of your directory tree near the center.

Initial View

An LDAP directory structured around a DNS domain of .home

Click on the house icon to expand the directory. You can also click folders (organizational units) to expand them.

Expanded Directory Tree

LDAP directory tree showing the Groups OU expanded

Any time you click on something in the directory tree on the left side, additional detail is shown to the right. For container objects like the Groups OU, the detail is sparse. But, clicking on a leaf object reveals additional attributes.

For example, clicking on one of the groups under the Groups OU will reveal the group description, its numeric group ID, and a list of members. Clicking on a user reveals attributes associated with the posixUser LDAP class.

Troubleshooting navigation

If you're not seeing your directory, check the config.ini for baseDN under the section heading of structure. It should look like this:

[structure]
baseDN = "dc=home"

Also check your credentials under the heading of bind. At minimum, you will need an LDAP user that can read the directory. If you want to allow modifications, you'll also need an LDAP user with write permission. An example is shown below.

[bind]
readOnlyDN = "cn=search,dc=home"
readOnlyPassword = P@ssw0rd
readWriteDN = "cn=Manager,dc=home"
readWritePassword = P@ssw0rd

If the directory does not expand, open the developer tools for your browser. The console log may offer error messages.

Changing User and Group Attributes

When you click on a posixAccount leaf object, attributes of the user account will appear on the right side.

User Dialog

Clone this wiki locally