Sincroniza los usuarios de Active Directory con ONLYOFFICE DocSpace a través de LDAP.

Para sincronizar cuentas LDAP o de Microsoft Active Directory con ONLYOFFICE DocSpace, habilite la autenticación LDAP en Configuración > Integración > Configuración LDAP, introduzca los parámetros de conexión y búsqueda del directorio, y guarde y confirme la importación. A continuación, habilite la sincronización automática para que los cambios en el directorio se reflejen en DocSpace sin necesidad de repetir la configuración inicial.

Este procedimiento se aplica a la integración LDAP de DocSpace, no a un servidor de edición de documentos ONLYOFFICE Docs independiente. Para ONLYOFFICE Workspace, la configuración equivalente se encuentra en Panel de control > Configuración del portal > LDAP. Según la documentación actual de ONLYOFFICE (consultada en octubre de 2026), LDAP es una función Business de pago en la oferta SaaS de DocSpace; consulte las capacidades de su edición autohospedada por separado. Consulte la referencia oficial de DocSpace LDAP y las instrucciones del servidor Workspace .

Primero, planifique una pequeña importación de directorios.

Escenario ilustrativo: Acme Corp tiene un dominio de Active Directory llamado acme.local. Su administrador de TI desea una cuenta de DocSpace para cada empleado en la unidad organizativa (OU) Empleados, e importar opcionalmente grupos de seguridad desde una OU Grupos independiente. Los nombres, rutas y ejemplos de cuentas que se muestran a continuación son valores de configuración hipotéticos, no resultados de un entorno implementado.

Antes de usar DocSpace, confirme que su servidor puede conectarse a un controlador de dominio, determine qué cuentas deben incluirse y configure una cuenta de directorio con acceso de lectura. Utilice una identidad de servicio dedicada de solo lectura en lugar de un administrador de dominio. Registre los nombres distintivos (DN) LDAP exactos, que identifican las ubicaciones de los directorios, así como los atributos de inicio de sesión y correo electrónico que ya se utilizan en Active Directory.

Usuarios y equipos de Active Directory que muestran el dominio de ejemplo acme.local con las unidades organizativas de Empleados y Grupos.
El árbol de Active Directory de ejemplo ayuda a identificar las bases de búsqueda de empleados y grupos antes de importar las cuentas.

La base de búsqueda de ejemplo de Acme es OU=Employees,DC=acme,DC=local. Comenzar en esta OU reduce la posibilidad de importar cuentas de servicio o usuarios no relacionados. Para un portal existente con usuarios o documentos, cree una copia de seguridad adecuada y verifique los procedimientos de recuperación antes de cambiar los filtros LDAP: ONLYOFFICE advierte que los cambios en la configuración de búsqueda del servidor, usuario o grupo pueden afectar a las cuentas importadas previamente y sus datos. Revise su documentación de copia de seguridad y restauración .

Conectar DocSpace al directorio

1. Abra la configuración de LDAP y habilite la autenticación.

Inicie sesión como administrador de DocSpace. En el menú de opciones de la esquina inferior izquierda, seleccione Configuración y, a continuación, abra Integración > Configuración de LDAP . Active la autenticación LDAP ; si el formulario de configuración está contraído, utilice Mostrar para expandirlo. No confunda la página de inicio de sesión único SAML independiente con la sincronización LDAP.

Navegación de Configuración de ONLYOFFICE DocSpace con Integración seleccionada y Configuración de LDAP resaltada
Abra Integración y seleccione Configuración LDAP en DocSpace antes de habilitar la autenticación de directorio.

2. Seleccione un transporte LDAP protegido.

Seleccione Habilitar StartTLS para una conexión LDAP actualizada a TLS, normalmente en el puerto TCP 389, o Habilitar SSL para LDAPS, normalmente en el puerto TCP 636. Para el escenario Acme, supongamos que su controlador de dominio está configurado para LDAPS con un certificado de servidor válido: use LDAPS://dc1.acme.localy 636. Elija un método seguro compatible; no envíe contraseñas de enlace a través de LDAP no protegido.

Autenticación LDAP habilitada junto con una dirección de servidor LDAP puerto 389 y la configuración Habilitar StartTLS
El área de configuración LDAP muestra la opción StartTLS y el puerto predeterminado correspondiente, el 389.

LDAPS en un controlador de dominio de Active Directory requiere un certificado adecuado, un nombre DNS coincidente y acceso a la red. Microsoft documenta estos requisitos en Configurar certificados para LDAP sobre SSL . Resuelva los problemas de confianza de certificados en el servidor en lugar de debilitar la validación TLS.

3. Introduzca las credenciales del servidor y de enlace.

Configure el servidor con la URL de LDAP o LDAPS y el número de puerto con el puerto seleccionado. Active la opción de autenticación del formulario cuando se necesite una cuenta de directorio para leer los registros de usuarios y grupos, e introduzca el nombre de usuario y la contraseña autorizados. La identidad de servicio de ejemplo podría ser svc_docspace@acme.local; utilice el formato de enlace aceptado por su directorio. Nunca incluya contraseñas ni nombres de cuenta reales en una guía o captura de pantalla publicada.

Formulario de configuración LDAP que muestra un ejemplo de la dirección base del servidor de directorio (DN) y una contraseña de cuenta de servicio enmascarada.
Revise la dirección del servidor y las credenciales de enlace de ejemplo sin exponer la contraseña real de una cuenta de servicio.

Elige exactamente qué usuarios importar

4. Defina la base de búsqueda y el filtro.

Introduzca OU=Employees,DC=acme,DC=localel DN de usuario . Para Active Directory, el filtro inicial recomendado por ONLYOFFICE es (userPrincipalName=*). Este filtro selecciona registros con un nombre principal de usuario dentro del ámbito de búsqueda seleccionado; no garantiza, por sí solo, que cada resultado corresponda a un empleado humano habilitado. Revise el contenido de la OU o utilice un filtro validado cuidadosamente si su organización requiere una membresía más restringida.

Panel de búsqueda de directorio LDAP con campos de filtro de usuario User DN y userPrincipalName.
Configure el DN de búsqueda de usuarios y un filtro de usuario de Active Directory para limitar los registros que se pueden importar.

En un directorio OpenLDAP, los valores predeterminados documentados son diferentes: uno (uid=*)para el filtro de usuario y otro uidpara el atributo de inicio de sesión. No copie esos valores predeterminados sin modificarlos en una implementación de Active Directory.

5. Configure el atributo de inicio de sesión y asigne los datos del perfil.

Para AD, configure el atributo de inicio de sesiónsAMAccountName como se indica en las instrucciones de ONLYOFFICE. El atributo de inicio de sesión configurado determina lo que los usuarios escriben en la página de inicio de sesión de DocSpace; los formatos admitidos incluyen el inicio de sesión simple, el inicio de sesión más el dominio LDAP y el inicio de sesión con barra invertida del dominio. Pruebe el formato con una cuenta de empleado que no sea administrador después de la importación.

El campo de atributo de inicio de sesión LDAP de ONLYOFFICE está configurado en sAMAccountName.
El valor sAMAccountName es el atributo de inicio de sesión inicial documentado para Active Directory.

En Asignación de atributos , asigne Nombre a givenName, Apellido a sny Correo electrónico a mailcuando esos campos existan en su esquema de AD. Estas son asignaciones de ejemplo para verificar con su directorio real, no valores supuestos para cada entorno. El correo electrónico importa: ONLYOFFICE indica que la asignación de Correo electrónico se usa para la dirección de correo electrónico de DocSpace; la falta de datos de correo electrónico puede generar una dirección derivada del inicio de sesión y del dominio LDAP, lo que puede impedir que las notificaciones lleguen al usuario.

Campos de asignación de atributos ONLYOFFICE que muestran givenName sn y mail
Asocie los campos de nombre, apellido y correo electrónico con los atributos LDAP correspondientes.

Importa los grupos y luego activa la sincronización continua.

6. Configurar la pertenencia opcional al grupo

Si Acme también necesita grupos de directorio, habilite la pertenencia a grupos . En este ejemplo, use OU=Groups,DC=acme,DC=localpara el DN del grupo y (objectClass=group)para el filtro de grupo. La asignación de AD documentada por ONLYOFFICE usa distinguishedNamecomo atributo de usuario y membercomo atributo de grupo; use el atributo de nombre de grupo existente apropiado para el directorio.

Configuración de usuarios y grupos LDAP de ONLYOFFICE que muestra la sincronización de grupos habilitada y un DN base de grupo.
Configure la pertenencia a grupos opcionales solo después de confirmar que los usuarios previstos pertenecen a los grupos correspondientes.

Verifique la pertenencia antes de guardar: ONLYOFFICE indica explícitamente que habilitar la importación de grupos restringe los usuarios importados a aquellos que pertenecen al menos a un grupo coincidente. Si los empleados piloto de Acme no pertenecen a los grupos seleccionados, desactive la importación de grupos inicialmente o corrija el ámbito del directorio antes de la importación. No extienda el filtro de grupos a todo el dominio solo para aumentar el número de usuarios.

7. Guarda la configuración y confirma la importación.

Revise las bases de búsqueda, las asignaciones de cuentas y la pertenencia al directorio prevista, y haga clic en Guardar . En el cuadro de diálogo Confirmación de importación , seleccione Aceptar para comenzar. Espere a que se complete la búsqueda e importación del directorio; la duración depende del entorno. Para una implementación de AD de gran tamaño, la documentación de ONLYOFFICE indica un límite de 1000 entradas por consulta. Coordine cualquier cambio en la paginación o el límite del directorio con el administrador de AD en lugar de modificar la configuración del controlador de dominio sin revisarla previamente.

Verifique las cuentas importadas en Cuentas ; los perfiles vinculados a LDAP tienen un indicador LDAP en la vista de administrador. Mantenga la primera ejecución deliberadamente limitada para que se pueda corregir un filtro, una asignación de correo o una regla de grupo incorrectos antes de agregar la organización completa. Evite afirmar que un guardado exitoso demuestra que los usuarios pueden autenticarse.

8. Programar la sincronización automática y ejecutar una sincronización manual.

De vuelta en Configuración de LDAP, habilite la sincronización automática y seleccione un intervalo compatible con su versión de DocSpace: cada hora, diariamente, semanalmente o mensualmente. Guarde la programación. Para una actualización inmediata, seleccione Sincronizar usuarios en la parte inferior de la página de LDAP. ONLYOFFICE también documenta las actualizaciones por usuario después de que un usuario de LDAP inicie sesión; este comportamiento de inicio de sesión no sustituye la sincronización regular de todo el directorio cuando es necesario actualizar los grupos y los registros de cuentas.

Verificar el inicio de sesión y la próxima actualización

Utilice una cuenta de empleado piloto para iniciar sesión con sus credenciales de Active Directory y, a continuación, confirme que el perfil de DocSpace muestre el nombre y la dirección de correo electrónico esperados. Si se habilitaron grupos, verifique que el empleado pertenezca a un grupo importado y que solo pueda acceder a las salas concedidas mediante los permisos de DocSpace. Por último, modifique un campo de directorio no crítico en la cuenta piloto, ejecute la sincronización de usuarios y compruebe que su perfil de DocSpace refleje el cambio.

  • No aparecen usuarios: vuelva a comprobar el DN del usuario, el filtro, el acceso de lectura de la cuenta de servicio y si la activación de la pertenencia al grupo excluyó a los usuarios piloto.
  • Fallo de autenticación: confirme el atributo de inicio de sesión, el estado del directorio de la cuenta, el acceso a la red y la confianza del certificado TLS.
  • Los nombres o las direcciones de correo electrónico son incorrectos: compare los atributos LDAP asignados con el registro de directorio real antes de modificar un ámbito de búsqueda establecido.
  • Los cambios posteriores no aparecen: verifique que la sincronización automática se haya guardado, ejecute la sincronización de usuarios manualmente y compruebe si la cuenta modificada permanece dentro de los filtros configurados.

La configuración se confirma únicamente cuando se importan los usuarios seleccionados, un usuario piloto puede autenticarse con credenciales de directorio, se aplican las restricciones de grupo previstas y al menos un cambio de perfil posterior se sincroniza correctamente.

Dejar un comentario

Automatice las copias de seguridad consistentes de Nextcloud con Restic y Cron.

Automatice las copias de seguridad consistentes de Nextcloud con Restic y Cron.

Realice copias de seguridad de los archivos de Nextcloud y MariaDB conjuntamente, programe instantáneas Restic cifradas con cron y verifique la recuperación sin poner en riesgo el servidor en producción.

Permitir que los usuarios autorizados creen salas de Jitsi con inicio de sesión de Keycloak.

Permitir que los usuarios autorizados creen salas de Jitsi con inicio de sesión de Keycloak.

Permitir únicamente que las cuentas autorizadas inicien salas de Jitsi Meet mediante Keycloak y autenticación por token, manteniendo la opción de unirse como invitado cuando sea necesario.

Copia de seguridad y restauración de un buzón de correo de Zimbra CE mediante exportaciones TGZ

Copia de seguridad y restauración de un buzón de correo de Zimbra CE mediante exportaciones TGZ

Exporta un buzón individual de Zimbra Community Edition, valida su copia de seguridad TGZ y restaura los elementos que falten sin sobrescribir el correo existente.

Sincroniza los usuarios de Active Directory con ONLYOFFICE DocSpace a través de LDAP.

Sincroniza los usuarios de Active Directory con ONLYOFFICE DocSpace a través de LDAP.

Conecte ONLYOFFICE DocSpace a Active Directory u OpenLDAP, importe usuarios y grupos de forma segura, asigne campos de cuenta y programe una sincronización fiable.

Debian 12 en un VPS con poca RAM: Cómo reducir los fallos por falta de memoria de MySQL

Debian 12 en un VPS con poca RAM: Cómo reducir los fallos por falta de memoria de MySQL

Diagnosticar errores de memoria insuficiente (OOM kills) en MySQL en Debian 12, comprobar los límites de memoria del VPS, configurar el espacio de intercambio y ajustar la memoria y la concurrencia de la base de datos sin prometer una solución universal.

Agregar fuentes al servidor de documentos ONLYOFFICE: Docker vs Linux

Agregar fuentes al servidor de documentos ONLYOFFICE: Docker vs Linux

Instale fuentes personalizadas en ONLYOFFICE Document Server, compare los montajes persistentes de Docker con las copias directas, reconstruya la lista de fuentes y verifique el resultado.

Coloca ONLYOFFICE Docs detrás de HAProxy sin interrumpir la edición.

Coloca ONLYOFFICE Docs detrás de HAProxy sin interrumpir la edición.

Configure HAProxy HTTPS, el reenvío de encabezados, los tiempos de espera de WebSocket y las comprobaciones de estado para ONLYOFFICE Docs, y luego verifique la edición y el guardado.

Instalar y firmar módulos de kernel personalizados en SLES 15 Secure Boot

Instalar y firmar módulos de kernel personalizados en SLES 15 Secure Boot

Cargue un módulo de kernel SLES 15 personalizado sin deshabilitar el arranque seguro. Asegúrese de que el kernel en ejecución coincida, firme el archivo .ko, registre una clave MOK y verifique la carga.

Reenvío seguro de Syslog de SLES con rsyslog y TLS mutuo

Reenvío seguro de Syslog de SLES con rsyslog y TLS mutuo

Envía los registros del sistema SLES a un recolector rsyslog remoto a través de TLS autenticado, con comprobaciones de certificados, almacenamiento en búfer de interrupciones y pruebas de entrega.

Cómo iniciar Ubuntu Server en modo de emergencia: Guía de recuperación paso a paso

Cómo iniciar Ubuntu Server en modo de emergencia: Guía de recuperación paso a paso

Diagnostica de forma segura el modo de emergencia de Ubuntu Server. Lee los registros de arranque, comprueba los puntos de montaje raíz y fstab, repara una unidad defectuosa, gestiona los errores del sistema de archivos y verifica un reinicio correcto.