Centralized authentication using OpenLDAP/es

Esta guía presenta las cuestiones básicas de LDAP y le muestra cómo configurar OpenLDAP para realizar tareas de autenticación entre un grupo de computadoras.

¿Qué es LDAP?
LDAP significa Lightweight Directory Access Protocol (Protocolo Ligero de Acceso a Directorio). Está basado en X.500 el cual define la mayoría de sus funciones y carece de algunas funciones esotéricas que tiene X.500. Ahora bien, ¿Qué es X.500 y porqué existe LDAP?

X.500 es un modelo de Servicio de Directorio basado en el concepto OSI (Interconexión de sistemas Abiertos). Contiene definiciones de espacios de nombres y protocolos para consultar y actualizar el directorio. Sin embargo, se ha encontrado en muchos casos que X.500 es demasiado estricto. Mejor entrar en LDAP. Al igual que X.500, proporciona un modelo de datos y espacio de nombres para el directorio y el protocolo. No obstante, LDAP está diseñado para correr directamente sobre la pila TCP/IP. Podemos considerar a LDAP como una versión ligera de X.500.

No lo pillo. ¿Qué es un directorio?
Un directorio es una base de datos especializada diseñada para consultas frecuentes y actualizaciones no tan frecuentes. Al contrario que las bases de datos generalistas, no ofrecen soporte para transacciones o funcionalidad de vuelta atrás (roll-back). Los directorios se replican fácilmente para incrementar disponibilidad y fiabilidad. Cuando se replican los directorios, se permiten inconsistencias temporales siempre que acaben sincronizándose.

¿Cómo se estructura la información?
Toda la información dentro de un directorio está estructurada jerárquicamente. Aún más, si intenta introducir datos en un directorio, éste debe conocer la forma de almacenar estos datos en un árbol. Eche un vistazo a una compañía ficticia y a su organigrama:

Puesto que no puede alimentar la base de datos con este tipo de arte ascii, se debe definir cada nodo de este árbol. Para nombrar estos nodos, LDAP usa un sistema de definición de nombres. La mayor parte de distribuciones de LDAP (incluyendo OpenLDAP) ya contienen un buen número de esquemas predefinidos (y normalmente aprobados), como el inetOrgPerson o un esquema llamado posixAccount utilizado frecuentemente para definir usuarios que los equipos Unix o Linux pueden utilizar. Observe que existen herramientas basadas en GUI para que facilitar la gestión de LDAP. Eche un vistazo a Trabajar con OpenLDAP para una lista exhaustiva.

Se recomienda a los usuarios interesado leer la Guía de Administración de OpenLDAP.

Y bien.. ¿Para qué se utiliza?
Se puede usar LDAP para diferentes propósitos. En este documento se trata la administración centralizada de usuarios, manteniendo todas las cuentas de usuario en una única ubicación LDAP (lo que no significa que esté albergada en un único servidor, puesto que LDAP ofrece soporte a alta disponibilidad y redundancia). Sin embargo, se puede utilizar LDAP para otros fines.


 * Infraestructura de Clave Pública (PKI)


 * Calendario compartido


 * Libreta de direcciones compartida


 * Almacenamiento para DHCP, DNS, ...


 * Directivas de configuración de clases del sistema (manteniendo el seguimiento de varias configuraciones del servidor)


 * Autenticación centralizada (PosixAccount)



Notas comunes
En esta guía utilizamos como ejemplo el dominio genfic.org. Por supuesto, deberá cambiarlo. Sin embargo, asegúrese de que el nodo superior es un dominio oficial de primer nivel (net, com, cc, be, ...).

En primer lugar haga emerge de OpenLDAP. Asegúrese que se usan los ajustes USE berkdb, crypt, gnutls, ipv6, sasl, ssl, syslog, -minimal' y tcpd.

OpenLDAP ofrece soporte para dos mecanismos de autenticación:
 * 1) Contraseña de usuario estándar (en términos de LDAP  user significa binddn) llamada SIMPLE
 * 2) Redirigir las peticiones de autenticación hacia SASL (Simple Authentication and Security Layer)


 * 1) Standard user-password (in LDAP terms user means binddn) named SIMPLE.
 * 2) Proxying authentication requests to SASL (Simple Authentication and Security Layer, see RFC4422 for details).

Aunque por defecto OpenLDAP utiliza SASL, la versión inicial de este artículo utilizaba únicamente la autenticación basada en contraseña. Con el añadido OLC, el artículo comienza a describir la utilización del mecanismo SASL más sencillo llamado EXTERNAL, el cual depende de la autenticación del sistema.

OpenLDAP tiene un usuario principal llamado "rootdn" (Root Distinguished Name o Nombre Distinguido de Root) el cual está definido dentro de la aplicación. Al contrario que el usuario root clásico de Unix, al usuario rootdn se le deben asignar los permisos adecuados. El usuario rootdn solo se puede utilizar en el contexto de la configuración y también en la definición del directorio. En este caso un usuario puede autenticarse a si mismo como rootdn con la contraseña usada en la configuración y la contraseña (basada en el directorio) del árbol.

La contraseñas de usuario (independientemente si son para usuarios rootdn u otros) para propósitos de verificación se pueden almacenar como testo en claro o aplicando un hash. Se dispone de varios algoritmos hash, sin embargo no se recomienda el uso de algoritmos débiles (hasta MD5). Actualmente en criptografía se considera que SHA es suficientemente seguro.

En la orden de abajo, se crea un valor hash para una contraseña dada, el resultado de esta orden se puede utilizar en el fichero de configuración o bien en la definición del directorio interno de un usuario:

Configuración heredada (configuración básica slapd.conf)
Ahora edite la configuración LDAP del servidor en. El fichero que se muestra es de los fuentes originales de OpenLDAP. Abajo se muestra un fichero ejemplo de configuración que se puede utilizar para reemplazarlo de modo que las cosas comiencen a funcionar.

Para un análisis más detallado del fichero de configuración, le sugerimos que acceda a la guía del administrador de OpenLDAP, aunque la información mostrada con puede ser suficiente.

Si no arranca, lo primero que se debe hacer es comprobar el fichero de configuración. Puede hacer esto utilizando la siguiente orden:

Cambie el nivel de depuración (El "-d 1" de arriba) para obtener más información. Si todo va bien se mostrará config file testing succeeded. Si hay un error,  mostrará el número de línea en la cual está el problema (dentro del fichero ).

Por defecto escribe los eventos de registro a la instalación local4 de syslog.

Migración desde slapd.conf a OLC
Si desea poder cambiar la configuración del servidor OpenLDAP necesita definir al menos el acceso de escritura (o normalmente de gestión  ) a.

El ejemplo de abajo muestra como conceder acceso de gestión a OLC (base de datos cn=config) al administrador del sistema (usuario root) añadiendo las líneas adecuadas al final del fichero :

Entonces invocamos a la utilidad con las opciones   y   para convertir el archivo  en un directorio de configuración.

Al lanzar esta orden se transferirá y traducirá la configuración. Después de esto, deberá actualizar la configuración utilizando ficheros ldif especialmente preparados. Si no está familiarizado con el formato de estos ficheros puede editar en primero y después traducir  a. No olvide comprobar los permisos sobre los directorios.

Para más indicaciones lea los comentarios en línea dentro de los ficheros generados.

La línea de abajo habilitará el método de configuración.

Para terminar, cree la estructura :

Configuración inicial con OLC
Se entrega una configuración inicial como un volcado de base de datos estándar LDAP disponible como o.

Se puede cargar (y únicamente cargar, al contrario que las bases de datos LDAP ordinarias) mediante la utilidad :

When using a root account, be sure to correct ownership of the files created by root, as described below in migrate section.

Si necesita permiso para cambiar la base de datos de configuración, deberá ofrecer los permisos apropiados. El ejemplo de abajo muestra cómo se conceden estos privilegios al usuario del sistema :

Leer para obtener más detalles.

Cuando se utilice OLC, no edite jamás los ficheros de configuración. Los ficheros del directorio se pueden utilizar para comprobar la consistencia de la configuración:

Mantener el directorio
Ahora que se han completado los pasos de configuración, arrancar :

La mayoría de los usuarios también querrán que el demonio OpenLDAP arranque de forma automática:

Es posible utilizar el directorio del servidor para autenticar a los usuarios en apache/proftpd/qmail/samba.

El servidor de directorio se puede gestionar con herramientas como, y  del repositorio de ebuilds de Gentoo, o  del recubrimiento (overlay) poly-c disponible a través de Layman.

Gestión del servidor con OLC
Se muestran abajo algunos ejemplos de actualizaciones a la configuración con el estilo OLC.

Por ejemplo, para cambiar la localización del directorio de configuración de OLC (necesario tras cambiar desde un fichero de configuración a un directorio de configuración):

Para cambiar el nivel del registro usado por la instancia OpenLDAP:

Para aplicar los cambios, lance la siguiente orden:

Registro de OpenLDAP
OpenLDAP produce numerosos eventos de registro, los cuales pueden no ser fáciles de interpretar pero necesarios para propósitos de depuración.

Debido a que, por defecto, OpenLDAP escribe la información sobre los eventos en el registro del sistema, se recomienda reconfigurar el registrador del sistema para dirigir los eventos de OpenLDAP a un fichero de registro dedicado.

Se recomienda utilizar el nivel de registro  en OpenLDAP, lo cual resultará en información relacionada con la sesión similar a la siguiente:

Most common errors in server log are :

Which means «invalid credentials» (i.e. wrong password).

And :

Which means «No such object». Usually this error appears when binddn (user) has no permissions on requested object. So either try to do something wrong, or there is a mistake in the set ACLs.

Gestión del acceso (ACLs)
Las autorizaciones y el mecanismo de control de acceso utilizados en OpenLDAP se describen en la página del manual. Su sintaxis base es la siguiente:

La siguiente tabla muestra los niveles de acceso disponibles en OpenLDAP:

Para obtener detalles de los ajustes exactos de los privilegios, leer las páginas del manual y la documentación oficial de OpenLDAP.

Fichero de configuración
Las ACLs se analizan en el orden en el que están dispuestas en la configuración y se aplican basándose en la especificidad (esto significa que, cuando se tiene en cuenta una regla ACL, el resto de las reglas ACL ya no se comprueban). De esta forma, las definiciones más específicas deben ir en primer lugar, antes de listar las más genéricas. Para obtener más información, consultar Access Control Evaluation.

Por ejemplo:

Directorio de configuración
Las ACLs se analizan en el orden en el que están dispuestas en la configuración y se aplican basándose en la especificidad (esto significa que, cuando se tiene en cuenta una regla ACL, el resto de las reglas ACL ya no se comprueban). De esta forma, las definiciones más específicas deben ir en primer lugar, antes de listar las más genéricas. Este orden, cuando se utiliza OLC se gestiona mediante las directivas.

Por ejemplo:

El siguiente ejemplo muestra cómo insertar una nueva ACL en la parte superior, haciendo que las entradas   existentes se desplacen una posición:

Para eliminar una ACL:

Alta disponibilidad
Una configuración de alta disponibilidad común en OpenLDAP es utilizar la replicación de cambios a través de múltiples sistemas LDAP.

La replicación dentro de OpenLDAP se realiza en esta guía utilizando una cuenta de replicación específica la cual ha leído los derechos del servidor LDAP primario y envía los cambios desde el servidor LDAP primario al secundario.

Esta configuración entonces se replica permitiendo al servidor LDAP secundario actuar igual que el primario. Gracias a la estructura interna de OpenLDAP, los cambios no se aplican de nuevo si ya están en la estructura LDAP.

Configurar la replicación
Para configurar la replicación, en primer lugar realice la configuración de un segundo servidor OpenLDAP, del mismo modo que se ha descrito arriba. Sin embargo, tenga cuidado de que, en el fichero de configuración:


 * El proveedor de la sincronización de la replicación apunta al otro sistema


 * El serverID de cada sistema OpenLDAP es diferente

Synchronisation account
A continuación, cree la cuenta de sincronización. Crearemos un fichero LDIF (el formato utilizado como entrada de datos para los servidores LDAP) y lo añadiremos a cada servidor LDAP:

Enabling syncprov overlay
Overlay can be linked statically and dynamically. When it is built dynamically, you'll need to load module. For now in Gentoo it's usually built statically. To ensure type:

Load syncprov module (optional)
To load syncprov module, use the following ldif file:

Setting up replication for database
Next step, mandatory for everybody, is to setup replication for database (must be done on both nodes):

Final configuration
Finally, add replication's definition.

On node 1:

traditionally means the password string.

On node 2:

The only difference is in server's ident (rid) and provider uri.

If LDAP master (mirror node with initially loaded database) is unavailable (slapd daemon not started, or 389/tcp port is blocked by a packet filter) slapd daemon on secondary node fails to start with the following error message:

Almost certainly the database will not fit into default limits. So, you will need to increase 's limits. For example:

Performance tuning
Default daemon settings significantly limits LDAP server performance.

Symptoms
When server load fits system limit client applications fails with different kind of timeout errors.

In server log this produces error messages like following:

Increasing OS limits
First, read system user limits:

The first parameter, you need to increase, is the open files limit.

Maximum available value is described in Documentation/sysctl/fs.txt file of kernel documentation:

PAM system limits are stored in /etc/security/limits.conf file or, optionally, in /etc/security/limits.d/ directory. Daemons, started with init system use these parameters (see  for details), so you need just to put in the file:

And restart daemon.

The next limitation is 's  parameter.

During run time, this value can be updated via:

After verifying new value do not forget to fix it:

And, possibly, some other application-specific parameters.

Configurar las herramientas cliente de OpenLDAP
Edite el fichero de configuración del cliente LDAP. Este fichero lo lee ldapsearch y otras herramientas de línea de órdenes ldap.

Puede comprobar si el servidor está corriendo con la siguiente orden:

Si obtiene un error, intente añadir  para incrementar el nivel de información mostrada y solucionar el problema que tenga.

Configuración del cliente para autenticación centralizada
Existen varios métodos y herramientas que se pueden utilizar para realizar una autenticación remota. Algunas distribuciones incluso disponen de su propia herramienta de configuración de fácil uso. Abajo se muestran algunas (el orden no es importante). Es posible combinar a la vez usuarios locales y cuentas autorizadas centralmente. Estos es importante ya que, por ejemplo, si el servidor LDAP no es accesible, todavía se podrá acceder como root.


 * SSSD (Single Sign-on Services Daemon o Demonio para Servicios de Acceso Sencillo). Su principal función es ofrecer acceso a recursos remotos de identidad y autenticación a través de un marco de trabajo común que puede ofrecer caché y soporte fuera de línea al sistema. Ofrece módulos PAM y NSS. Además, en el futuro, ofrecerá soporte para interfaces D-Bus para información extendida de usuario. También ofrece una base de datos mejorada para almacenar usuarios locales así como datos de usuario extendidos.


 * Utilizar  para acceder al servidor LDAP y autenticarse. Las contraseñas no se envían por la red en texto claro.


 * NSLCD (Name Service Look up Daemon o Demonio de Consulta al Servicio de Nombres). Similar a SSSD pero más antiguo.


 * NSS (Name Service Switch o Conmutador de Nombres de Servicio) usando el módulo tradicional  para obtener los hash de las contraseñas a través de la red. Para permitir que los usuarios actualicen sus contraseñas, este servicio se debe combinar con el método.

Los dos primeros métodos se muestran abajo con las opciones de configuración mínimas para que funcionen.

El método de configuración del cliente PAM con SSSD
Este es el método más directo. Los tres ficheros que se necesitan editar se muestran abajo.

Añada sss al final tal y como se muestra abajo para permitir que la búsqueda la gestione el servicio de sistema sssd. Una vez haya terminado de editar, arranque el demonio sssd.

El último fichero es el más crítico. Abra otro terminal de root como respaldo antes de editarlo. Se han añadido las líneas que acaban en code># para permitir la autenticación remota. Observe el uso de para poder crear los directorios de inicio de los usuarios.

Ahora intente acceder desde otro equipo.

El método de configuración del cliente PAM con el módulo pam_ldap
En primer lugar configuraremos PAM para permitir la autorización LDAP. Instale de modo que PAM ofrezca soporte para la autorización LDAP y  de modo que su sistema pueda trabajar con servidores LDAP para información adicional (usado por ).

El último fichero es el más crítico. Abra algunos terminales de root como respaldo antes de editarlo. Se han añadido las líneas que terminan en  para permitir la autenticación remota.

Ahora cambie para que contenga:

A continuación, copie el fichero (OpenLDAP) desde el servidor al cliente de modo que lo clientes conozcan el entorno LDAP:

Por último configure sus cliente de modo que puedan comprobar el LDAP para las cuentas del sistema:

Si ha observado que alguna de las líneas que pegó en su se ha comentado (la línea  ), no se preocupe, no la necesita a no ser que quiera cambiar la contraseña de un usuario como superusuario. En este caso necesita volcar la contraseña de root a en texto claro. Esto es PELIGROSO y se debe usar chmod para cambiar el acceso a 600. Lo que debería hacer es dejar ese fichero vacía y cuando necesite cambiar la contraseña de algún usuario que está en el LDAP y en, escriba la clave allí y déjela unos diez segundos mientras cambia la contraseña del usuario y elimínela una vez haya terminado.

Convertir la datos base de usuario a LDAP
Configurar OpenLDAP para su administración centralizada y la gestión de elementos Linux/Unix comunes, no es fácil. Gracias a algunas herramientas y guiones disponibles en Internet, la migración desde un punto de vista de un sistema de administración simple a un sistema centralizado y gestionado basado en OpenLDAP no es muy complicado.

Vaya a http://www.padl.com/OSS/MigrationTools.html y obtenga los guiones. Necesitará las herramientas de migración y el guión.

Ahora extraiga y copie el guión dentro de la la localización extraída:

El siguiente paso es migrar la información de su sistema a OpenLDAP. Esto se realiza con el guión una vez le haya proporcionado la información referente a la relacionada con su estructura y entorno LDAP.

En el momento de escribir este documento, las herramientas necesarias requieren las siguientes entradas:

La herramienta también le preguntará qué cuentas y ajustes desea migrar.

Emerge errors after conversion to LDAP
If for any reasons local user accounts (i.e. /etc/passwd /etc/shadow) or groups (i.e. /etc/group) are deleted after converting the file userbase to LDAP, errors may be encountered relating to missing user (or group) while emerging certain packages.

Example of error while emerging due to missing "apache" local user account: Installing build system files make[1]: Leaving directory '/var/tmp/portage/www-servers/apache-2.4.41/work/httpd-2.4.41'              [ ok ] chown: invalid user: ?apache:apache? * ERROR: www-servers/apache-2.4.41::gentoo failed (install phase): *  fowners failed In such cases, a workaround involves emerging the package using FEATURES=-network-sandbox. Doing so has potential security consequences so system users should remain in local files.

Agradecimientos
Nos gustaría dar las gracias a Matt Heler por dejarnos su máquina para realizar esta guía. También queremos agradecer a los tíos simpáticos de en Freenode.net.