TrueNAS SCALETrueNAS SCALE Version Documentation
This content follows the TrueNAS SCALE 24.04 (Dragonfish) releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Configuring LDAP

TrueNAS has an Open LDAP client for accessing the information on an LDAP server. An LDAP server provides directory services for finding network resources like users and their associated permissions.

You can have either Active Directory or LDAP configured on SCALE but not both.

Does LDAP work with SMB? LDAP authentication for SMB shares is disabled unless you configured and populated the LDAP directory with Samba attributes. The most popular script for performing this task is smbldap-tools. TrueNAS needs to be able to validate the full certificate chain (no self-signed certificates). TrueNAS does not support non-CA certificates.

Configuring LDAP

To configure SCALE to use an LDAP directory server:

  1. Go to Credentials > Directory Services and click Configure LDAP.

    LDAPBasicOptionsSettings

  2. Enter your LDAP server host name. If using a cloud service LDAP server, do not include the full URL.

  3. Enter your LDAP server base DN. This is the top of the top level of the LDAP directory tree to use when searching for resources.

  4. Enter the bind DN (administrative account name for the LDAP server) and the bind password.

  5. Select Enable to activate the server

  6. Click Save.

If you want to further modify the LDAP configuration, click Advanced Options. See the LDAP UI Reference article for details about advanced settings.

Disabling LDAP

To disable LDAP but not remove the configuration, clear the Enable checkbox. The main Directory Services screen returns to the default view showing the options to configure Active Directory or LDAP. To enable LDAP again, click Configure LDAP to open the LDAP screen with your saved configuration. Select Enable again to reactivate your LDAP directory server configuration.

Removing LDAP from SCALE

To remove the LDAP configuration, click Settings to open the LDAP screen. Clear all settings and click Save.