niota

fascinating. logical.

User Tools

Site Tools


niota-docs:niota_system_config_ldap

This is an old revision of the document!


Table of Contents

configure LDAP authentication

Prerequisitions

Configuration file ldap.conf must be created as a simple text file in the following folder

“c:\openldap\sysconf\ldap.conf”

This file path is hardcoded in the ldap related dll file of the php installation, therefore there is no soultion to place the ldap.conf file in any other place.

In the file ldap.conf the certificate-folder and certificate-file path can be set. The client certificate checking method can be specified as well. These can be set with the next three directives what you can define in the ldap.conf file:

TLS_REQCERT
This directive specifies which checks to perform on client certificates in an incoming TLS session, if any.

Accepted values are:

  • never
  • allow
  • try
  • demand

In the case of self-signed certificates it is recommended to use the never or the allow setting.

E.g.:

TLS_REQCERT allow

Important
Even if the setting is set to never the certificate must exist and the path must be set correctly! The setting does not mean that you do not have to own the certificate.

TLS_CACERT
Certificate file path. The certificate must not be placed in the same folder as the ldap.conf file but it is also not a problem to place it into the folder c:\openldap\sysconf

Example 1

TLS_CACERT c:\path\to\certification_dir\file.cer

Example 2

TLS_CACERT c:\openldap\sysconf\certificate.cer

Important
The certification file content must be in Base64 format. You can check it for example by opening the certificate in Notepad. Content should look like this example:

-----BEGIN CERTIFICATE-----
MIIDqjCCApKgAwIBAgIJAPsChKSq04oyMA0GCSqGSIb3DQEBCwUAMGYxCzAJBgNV
BAYTAkFVMRMwEQYDVQQIDApTb21lLVN0YXRlMSEwHwYDVQQKDBhJbnRlcm5ldCBX
...
-----END CERTIFICATE-----
niota-docs/niota_system_config_ldap.1637518402.txt.gz · Last modified: 2025/07/17 14:11 (external edit)