Difference between revisions of "Phpldapadmin"

Revision as of 19:11, 4 September 2014

Back to: LDAP

Procedure to add a new LDAP server to phpldapadmin.

To add a new LDAP server to phpldapadmin the file config.php must be modified. In a default debian setup it should be found on:

/etc/phpldapadmin/config.php.

Normally, config.php is generated from an example file included with the installation:

/usr/share/phpldapadmin/config/config.php.example

For the procedure to include the first ldap server in a phpldapadmin setup please refer to http://phpldapadmin.sourceforge.net/wiki/index.php/Config and the comments inside the example file.

To add a new server go to the end of the file config.php, where there is a section with the following header (around line number 500):

File: /etc/phpldapadmin/config.php

...
"/**************************************************************************
  * If you want to configure additional LDAP servers, do so below.         *
  * Remove the commented lines and use this section as a template for all  *
  * your other LDAP servers.                                               *
  **************************************************************************/"

Each server template comes with all the instructions required to set it up commented. e.g:

File: /etc/phpldapadmin/config.php

...
/*
$servers->newServer('ldap_pla');
$servers->setValue('server','name','LDAP Server');
$servers->setValue('server','host','127.0.0.1');
$servers->setValue('server','port',389);
$servers->setValue('server','base',array(''));
$servers->setValue('login','auth_type','cookie');
$servers->setValue('login','bind_id','');
$servers->setValue('login','bind_pass','');
$servers->setValue('server','tls',false);
*/

1. It's mandatory that each server definition starts with a call to newServer. What this means is that all the setup lines of a given server must appear after a line like '$servers->newServer('ldap_pla');', and of course before a similar line.

2. The 'name' clausule in '$servers->setValue('server','name','LDAP Server');' is a familiar, human readable, name, that will appear in the site to identify the server. An example could be "new ldap server" or "myldap".

3. The 'base' clausule represents the descriptors (dc) required to identify the server instance to manage. The dc are stored in the array of the third parameter. E.g: 'array('dc=uis,dc=edu,dc=co')'.

4. Se selecciona un solo tipo de ingreso y autenticación ('login', 'auth_type'), en '$servers->setValue('login','auth_type','cookie');'. Se deben consultar los comentarios del archivo de ejemplo para ver cuales opciones existen. 5. En '$servers->setValue('login','bind_id',);' se debe colocar como tercer parámetro el distinguished name del usuario admin, o algún usuario con capacidad de escribir en el directorio ldap.

--- Con estas opciones se puede configurar un nuevo servidor ldap para ser administrado via phpldapadmin. Existen opciones avanzadas no cubiertas por este instructivo que pueden ser accedidas en los comentarios del archivo de ejemplo entregado en la instalación, o en la documentación en http://phpldapadmin.sourceforge.net/wiki/index.php/Main_Page. Además se incluye el archivo de configuración actualmente en uso en griduis (solo en el wiki privado).

Cualquier sugerencia o consulta favor hacerla a grid.uis@gmail.com, sc3@uis.edu.co o en los teléfonos de contacto de la unidad de Supercomputación y Cálculo Científico de la Universidad Industrial de Santander.

Autor: Sergio Augusto Gélvez Cortés Contacto del Autor: sergio.gelvez@gmail.com Fecha de creación del documento: 12.05.2014

Realizado por personal de la unidad de Supercomputación y Cálculo Científico de la Universidad Industrial de Santander. MMXIV (c) Bucaramanga, Colombia

Last edit (text): 12.05.2014 by Sergio Augusto Gelvez Cortés.

@@ Line 39: / Line 39: @@
 </nowiki></pre>}}
-. It's mandatory that each server definition starts with a call to newServer.
+. It's mandatory that each server definition starts with a call to newServer. What this means is that all the setup lines of a given server must appear after a line like '$servers->newServer('ldap_pla');', and of course before a similar line.
-Es obligatorio que cada definición de servidor comience con un llamado a newServer.  Es decir, toda la configuración de un servidor debe aparecer después de una línea como '$servers->newServer('ldap_pla');', y se entiende que va hasta la aparición de una nueva, donde empezaría la configuración de un nuevo servidor.
-. La clausula 'name' en '$servers->setValue('server','name','LDAP Server');' es un nombre familiar, que aparecerá en el sitio web para identificarlo.  Un ejemplo podría ser "nuevo servidor ldap" o "ldap principal".
+. The 'name' clausule in '$servers->setValue('server','name','LDAP Server');' is a familiar, human readable, name, that will appear in the site to identify the server.  An example could be "new ldap server" or "myldap".
-. La clausula 'base' representa los dc necesario para identificar la instancia del servidor a manejar.  Los dc se ponen dentro del array en el tercer parámetro. Ej: 'array('dc=uis,dc=edu,dc=co')'.
+. The 'base' clausule represents the descriptors (dc) required to identify the server instance to manage. The dc are stored in the array of the third parameter. E.g: 'array('dc=uis,dc=edu,dc=co')'.
 . Se selecciona un solo tipo de ingreso y autenticación ('login', 'auth_type'), en '$servers->setValue('login','auth_type','cookie');'.  Se deben consultar los comentarios del archivo de ejemplo para ver cuales opciones existen.
 . En '$servers->setValue('login','bind_id','');' se debe colocar como tercer parámetro el distinguished name del usuario admin, o algún usuario con capacidad de escribir en el directorio ldap.