From OCS Inventory NG
Jump to: navigation, search

Manage authentification with LDAP

It is possible to delegate authentication to the administration console of OCS Inventory NG to an annex database. Some modules have already been developed and are available natively in version 2.0. So we will see how to delegate the connection to the OCSInventory NG GUI to LDAP.

Note: For this documentation, we set up an LDAP from the following documentation : and we kept the default configuration.

Note: Don't forget to install php-ldap module otherwise you'll have this message in apache error log file "PHP Fatal error: Call to undefined function ldap_connect() in /usr/share/ocsinventory-reports/ocsreports/backend/AUTH/methode/ldap.php on line 124, referer: http://ocsserver/ocsreports/index.php".

Connection to OCS Inventory NG management console with administrator account

Click on LDAP configuration tab.

Error creating thumbnail: File missing

First configuration fields concern the way to connect to the LDAP

Error creating thumbnail: File missing

For our exemple :

  • database is on local
  • administrator account is admin
  • password admin is secret
  • database listen on defaut port
  • login connection will be based on the uid field

The remaining configuration fields concern rights of the user on administration console of OCS Inventory NG.

Doc gui adminldap03.jpeg

For our exemple :

  • if the user whitch connects through the LDAP to title fiels to System Administrator, it will automatically Super Administrator rights profile.
  • if the value of this field is Employee, it has the rights of the Local Administrator profile. .
  • in other cases, LDAP users will have no OCS profile assigned

It only remains to modify the connection method to the administration console of OCS Inventory NG. To do this, you will have to edit two files in the directory / ocsreports.

Modification of /backend/AUTH/auth.php file

Doc gui adminldap04.jpeg

For this file, several options  :

  • Modify the connection type to have only LDAP authentication. For this, comment the line :

and uncomment bottom line


By cons, if you want to couple the LDAP connection to standard connection (mysql database ocsweb), you have to modify the line as this :


Modification of connection form

If you don't modify the line


then you will keep the "classic " login page.

Error creating thumbnail: File missing

However, if you replace html by SSO


the request for username / password will be in this form

Doc gui adminldap06.jpeg

Note: In this caseDans ce cas, the choice of language will no longer directly available. You will need to choose it and freeze it in the var.php file.

Modification of backend/identity/identity.php file

Doc gui adminldap07.jpeg

This file allow to define rights that the account logged will have into the administration console of OCS Inventory NG. In order to delegate those rights to a schedule base, in our case an LDAP, you have to change the line




It is also possible to keep the 2 ways to connect to the administration console by changing the line


In this case, rights will be retrieve in the LDAP, and will be completed by those found locally.

Exemple & practice

Based on the LDAP database created at the beginning, and having made changes outlined in preceding paragraphs, so we can connect with the user John/password.

Error creating thumbnail: File missing

On connection, he will have automatically rights of Super administrator profile.

His account will be created directly in the ocsweb database LDAP information. His Password will not be stored.

Error creating thumbnail: File missing

However, the user george, may well identify but can not connect directly. Indeed, we have assigned by default a Local Administrator profile, which has a limited view of the park of machines. So, after the connection of that user, it will have the following message:

Error creating thumbnail: File missing

For that user can access the administration console of OCS Inventory NG, it will take aSuper Administrator gives it access to TAG witch interested it.

Error creating thumbnail: File missing