Configuración y ajustes

Sincronización de directorio AD / LDAP

Sincronización de directorio AD / LDAP

lazyit puede importar personas desde tu Active Directory local (o cualquier directorio LDAP) para que no tengas que cargar tu equipo en lazyit a mano. Apuntas lazyit a tu directorio en Configuración → Directorio AD/LDAP (solo administradores; en el menú lateral de Configuración está bajo Integraciones). Está desactivada hasta que la actives, y el encabezado de la página muestra Activado o Desactivado para la sincronización programada. Un Miembro o Lector al que le diste Cambiar la configuración de la instancia puede ver la conexión, pero solo un administrador puede guardarla o ejecutar Sincronizar ahora: para cualquier otra persona el formulario y Sincronizar ahora quedan bloqueados, con una nota que explica por qué.

Qué hace — y qué deliberadamente no hace

La sincronización de directorio es de solo lectura y en un solo sentido. lazyit se conecta a tu directorio con una cuenta de servicio de solo lectura, busca en un subárbol que elijas y crea una “persona de directorio” sin acceso en lazyit por cada entrada coincidente. Eso es toda la función.

  • Nunca escribe nada de vuelta en tu directorio. lazyit solo lee.
  • No es una forma de iniciar sesión. Una persona de directorio no tiene contraseña ni inicio de sesión único — importar a alguien no le permite entrar. Es un registro de una persona (un nombre y correo a los que puedes asignar activos, conceder acceso y hacer seguimiento), no una cuenta. Para dar un inicio de sesión real a una persona importada, abre su perfil en Usuarios: con cuentas locales, dala de alta con una contraseña temporal; con tu propio proveedor OIDC, créala en el proveedor con el mismo correo verificado y su primer inicio de sesión vincula ambas.
  • No cambia cómo funcionan los permisos. Todas las personas importadas son de nivel visor. Los grupos del directorio (memberOf) se registran solo como referencia y no otorgan nada.

Las personas de directorio son usuarios normales en lazyit, mezcladas en la lista de Usuarios y marcadas con una insignia Directorio — el mismo tipo de persona sin acceso que crea la importación masiva.

Configurar la conexión

La sección Conexión tiene estos campos. Cada uno guarda su explicación larga tras el ? junto a su etiqueta, y toda la sección se guarda junta con Guardar configuración:

  • Sincronización programada — el interruptor del encabezado de la sección, el interruptor principal de la importación automática y periódica. Mientras está desactivada, lazyit solo importa cuando pulsas Sincronizar ahora (ver más abajo). Se aplica al guardar, como el resto de los campos.
  • Host del directorio y Puerto — la dirección de tu servidor de directorio (por ejemplo dc01.corp.example.com, puerto 636).
  • Seguridad del transporte — cómo se protege la conexión:
    • LDAPS (recomendado, normalmente puerto 636) — cifrado desde el primer byte.
    • StartTLS (normalmente puerto 389) — conecta en texto plano y luego actualiza a TLS.
    • Texto plano (puerto 389) — sin cifrado. La contraseña de conexión viaja en claro, así que úsalo solo en un segmento interno de confianza. La página repite esta advertencia bajo el campo mientras Texto plano esté seleccionado.
  • Verificar certificado TLS — activado por defecto (seguro). Desactívalo solo si tu servidor usa un certificado autofirmado de confianza. No aplica a una conexión en texto plano.
  • Base de búsqueda (base DN) — el subárbol donde lazyit busca, por ejemplo OU=People,DC=corp,DC=example,DC=com.
  • DN de conexión (bind DN) — la cuenta de servicio de solo lectura con la que lazyit se conecta, por ejemplo CN=svc-lazyit,OU=Service,DC=corp,DC=example,DC=com. Identifica la credencial; no es el secreto en sí.
  • Contraseña de conexión — la contraseña de la cuenta de servicio. Es de solo escritura: una vez guardada, lazyit solo muestra que hay una contraseña configurada y no la vuelve a mostrar. Deja el campo en blanco al editar para conservar la contraseña guardada; escribe un valor nuevo solo para cambiarla.
  • Filtro de búsqueda — el filtro LDAP que selecciona qué entradas importar, por ejemplo (&(objectClass=user)(objectCategory=person)). Se ejecuta literalmente — lazyit nunca sustituye nada en él por usuario.
  • Margen de baja — el número de “Desactivar a una persona tras [7] días sin aparecer en el directorio”: cuántos días puede faltar una persona en el directorio antes de que lazyit la desactive (ver más abajo). 0 la desactiva en la primera sincronización que ya no la encuentre.
  • Mapeo de atributos — qué atributo del directorio rellena cada campo de lazyit. Escribe el nombre del atributo del directorio junto a cada campo de lazyit (los nombres típicos de Active Directory son givenName, sn, mail, sAMAccountName). Deja un campo en blanco para omitirlo.

La contraseña de conexión se guarda cifrada en reposo. Guardar una contraseña requiere que la clave de servidor DIRECTORY_SECRET_KEY esté configurada. Si no lo está, se rechaza el guardado completo: no se almacena nada, ni siquiera los demás campos, y lazyit te pide configurar la clave primero. Una instalación guiada crea esa clave por ti, y volver a ejecutar el script de arranque en un despliegue más antiguo la añade; si no, tu administrador debe añadirla a la configuración de entorno del servidor y reiniciar la API. Mientras tanto, puedes guardar el resto de los ajustes dejando Contraseña de conexión en blanco.

Ejecutar una sincronización y leer el resultado

Usa Sincronizar ahora, en su propia sección debajo del formulario, para importar de inmediato con la configuración guardada — así que guarda primero, luego sincroniza. Sincronizar ahora funciona incluso con la sincronización programada desactivada, así que sirve también como prueba de conexión: si la conexión o la búsqueda fallan, lazyit muestra un error breve y sin datos sensibles (por ejemplo “bind failed” o “host unreachable”).

Después de cada ejecución — manual o programada — esa sección muestra el estado y la hora de la última ejecución y un recuento de lo ocurrido:

  • Creadas — nuevas personas de directorio añadidas.
  • Actualizadas — personas existentes cuyos campos mapeados se refrescaron.
  • Dadas de baja — personas desactivadas porque habían faltado en el directorio más allá del margen. Es una desactivación suave (pasan a inactivas, conservando su historial), nunca un borrado definitivo. Si una persona vuelve a aparecer en una sincronización posterior, lazyit la reactiva automáticamente. Una persona que un administrador desactivó sigue inactiva aunque vuelva a aparecer en el directorio; solo un administrador puede reactivarla. Del mismo modo, una persona que un administrador reactiva sigue activa aunque todavía falte en el directorio: la sincronización no la toca hasta que vuelve a aparecer, y solo la da de baja otra vez si luego vuelve a faltar más allá del margen. En una instancia con cuentas locales, a una persona con inicio de sesión se le cierran las sesiones en todos sus dispositivos cuando la sincronización la da de baja, y debe volver a iniciar sesión cuando la reactiva.
  • Omitidas — entradas que quedaron sin tocar (por ejemplo una entrada que no se puede identificar, o una cuyo correo coincide con una cuenta con inicio de sesión real).
  • La sincronización nunca da de baja al último administrador activo. Si el único administrador activo que queda falta en el directorio más allá del margen, lazyit lo mantiene activo hasta que exista otro administrador, para que la instancia nunca quede sin nadie que pueda gestionarla. Se cuenta en Omitidas, y el log del servidor registra en cada sincronización una advertencia directory.offboard_skipped … reason=last-active-admin. Promueve a otro usuario a administrador y la siguiente sincronización lo dará de baja como siempre.

Revisar las personas importadas

Al final de la página, Personas del directorio para revisar muestra una vista previa de las importadas más recientemente. Cada una enlaza a su perfil, donde puedes editarla, darle un inicio de sesión o darla de baja. Usa Ver todas en Usuarios para abrir la lista completa y con búsqueda filtrada a las personas de directorio.

Actualizar una instancia existente

La sincronización de directorio está desactivada por defecto y no añade nada hasta que un administrador la configure, así que actualizar una instancia existente de lazyit no cambia nada por sí solo. Actívala solo después de haber configurado la clave de servidor DIRECTORY_SECRET_KEY y completado la conexión.