Configurar LDAPS

Last published : Nov 13, 2026
LDAP seguro (LDAPS) le permite habilitar el Protocolo ligero de acceso a directorios seguro para sus dominios administrados de Active Directory para proporcionar comunicaciones a través de SSL (Secure Socket Layer)/TLS (Transport Layer Security).
De forma predeterminada, las comunicaciones LDAP entre las aplicaciones cliente y servidor no están cifradas. LDAP mediante SSL/TLS (LDAPS) le permite proteger el contenido de las consultas LDAP entre el VDA de Linux y los servidores LDAP.
Los siguientes componentes del VDA de Linux tienen dependencias de LDAPS:
  • Agente de intermediación: Registro del VDA de Linux con un Delivery Controller™
  • Servicio de directivas: Evaluación de directivas
La configuración de LDAPS implica:
  • Habilitar LDAPS en el servidor de Active Directory (AD)/LDAP
  • Exportar la CA raíz para uso del cliente
  • Habilitar/inhabilitar LDAPS en el VDA de Linux
  • Configurar LDAPS para plataformas de terceros
  • Configurar SSSD
  • Configurar Winbind
  • Configurar Centrify
  • Configurar Quest
Related information
Configurar el VDA de Linux

Habilitar LDAPS en el servidor AD/LDAP

Puede habilitar LDAP a través de SSL (LDAPS) instalando un certificado con el formato adecuado de una autoridad de certificación (CA) de Microsoft o de una CA que no sea de Microsoft.
Sugerencia:
LDAP a través de SSL/TLS (LDAPS) se habilita automáticamente al instalar una CA raíz empresarial en un controlador de dominio.
Para obtener más información sobre cómo instalar el certificado y verificar la conexión LDAPS, consulte Cómo habilitar LDAP a través de SSL con una autoridad de certificación de terceros en el sitio de soporte de Microsoft.
Cuando tiene una jerarquía de autoridad de certificación de varios niveles (como de dos o tres niveles), no dispone automáticamente del certificado adecuado para la autenticación LDAPS en el controlador de dominio.
Para obtener información sobre cómo habilitar LDAPS para controladores de dominio mediante una jerarquía de autoridad de certificación de varios niveles, consulte el artículo Certificado LDAP a través de SSL (LDAPS) en el sitio de Microsoft TechNet.

Habilitar la autoridad de certificación raíz para uso del cliente

El cliente debe usar un certificado de una CA en la que confíe el servidor LDAP. Para habilitar la autenticación LDAPS para el cliente, importe el certificado de la CA raíz a un almacén de claves de confianza.
Para obtener más información sobre cómo exportar la CA raíz, consulte Cómo exportar el certificado de la autoridad de certificación raíz en el sitio web de soporte de Microsoft.

Habilitar o inhabilitar LDAPS en el VDA de Linux

Para habilitar o inhabilitar LDAPS en el VDA de Linux, ejecute el siguiente script (mientras haya iniciado sesión como administrador):
La sintaxis de este comando incluye lo siguiente:
  • Habilitar LDAP a través de SSL/TLS con el certificado de CA raíz proporcionado:
    /opt/Citrix/VDA/sbin/enable_ldaps.sh -Enable pathToRootCA
  • Habilitar LDAP a través de SSL/TLS con enlace de canal:
    /opt/Citrix/VDA/sbin/enable_ldaps.sh -Enablecb pathToRootCA
    Nota:
    El certificado de CA raíz para el enlace de canal debe estar en formato PEM. Si la habilitación de LDAPS no crea correctamente un entorno virtual de Python3, créelo manualmente siguiendo las instrucciones en Crear un entorno virtual de Python3.
  • Volver a LDAP sin SSL/TLS
/opt/Citrix/VDA/sbin/enable_ldaps.sh -Disable
El almacén de claves de Java dedicado a LDAPS se encuentra en /etc/xdl/.keystore. Las claves de registro afectadas incluyen:
HKLM\Software\Citrix\VirtualDesktopAgent\ListOfLDAPServers

HKLM\Software\Citrix\VirtualDesktopAgent\ListOfLDAPServersForPolicy

HKLM\Software\Citrix\VirtualDesktopAgent\UseLDAPS

HKLM\Software\Policies\Citrix\VirtualDesktopAgent\Keystore

HKLM\Software\Citrix\VirtualDesktopAgent\EnableChannelBinding

Configurar LDAPS para plataformas de terceros

Además de los componentes de Linux VDA, varios componentes de software de terceros que se adhieren al VDA también pueden requerir LDAP seguro, como SSSD, Winbind, Centrify y Quest. Las siguientes secciones describen cómo configurar LDAP seguro con LDAPS, STARTTLS o SASL sign and seal.
Sugerencia:
No todos estos componentes de software prefieren usar el puerto SSL 636 para garantizar un LDAP seguro. Y la mayoría de las veces, LDAPS (LDAP sobre SSL en el puerto 636) no puede coexistir con STARTTLS en el puerto 389.

SSSD

Configure el tráfico LDAP seguro de SSSD en el puerto 636 o en el puerto 389 según las opciones. Para obtener más información, consulte la página man de SSSD LDAP para Linux.

Winbind

La consulta LDAP de Winbind utiliza el método ADS. Winbind solo admite el método StartTLS en el puerto 389. Los archivos de configuración afectados son ldap.conf en /etc/openldap/ldap.conf y smb.conf en /etc/samba/smb.conf. Cambie los archivos de la siguiente manera:
ldap.conf:

TLS_REQCERT never

smb.conf:

ldap ssl = start tls
ldap ssl ads = yes
client ldap sasl wrapping = plain
Alternativamente, el LDAP seguro se puede configurar mediante SASL GSSAPI sign and seal, pero no puede coexistir con TLS/SSL. Para usar el cifrado SASL, cambie la configuración de smb.conf:
smb.conf:

ldap ssl = off
ldap ssl ads = no
client ldap sasl wrapping = seal

Centrify

Centrify no admite LDAPS en el puerto 636. Sin embargo, proporciona cifrado seguro en el puerto 389. Para obtener más información, consulte el sitio de Centrify.

Quest

Quest Authentication Service no admite LDAPS en el puerto 636, pero proporciona cifrado seguro en el puerto 389 utilizando un método diferente.

Solución de problemas

Los siguientes problemas pueden surgir al utilizar esta función:
  • Disponibilidad del servicio LDAPS
    verificar que la conexión LDAPS esté disponible en el servidor AD/LDAP. El puerto es 636 de forma predeterminada.
  • Error en el registro de Linux VDA cuando LDAPS está habilitado
    verificar que el servidor LDAP y los puertos estén configurados correctamente. Compruebe primero el certificado de CA raíz y asegúrese de que coincida con el servidor AD/LDAP.
  • Cambio de registro incorrecto por accidente
    Si las claves relacionadas con LDAPS se actualizaron por accidente sin usar enable\_ldaps.sh, podría romperse la dependencia de los componentes LDAPS.
  • El tráfico LDAP no está cifrado mediante SSL/TLS desde Wireshark o cualquier otra herramienta de supervisión de red
    De forma predeterminada, LDAPS está deshabilitado. Ejecute /opt/Citrix/VDA/sbin/enable\_ldaps.sh para forzarlo.
  • No hay tráfico LDAPS desde Wireshark o cualquier otra herramienta de supervisión de red
    El tráfico LDAP/LDAPS se produce cuando se realizan el registro de Linux VDA y la evaluación de directivas de grupo.
  • No se pudo verificar la disponibilidad de LDAPS ejecutando ldp connect en el servidor AD
    Utilice el FQDN de AD en lugar de la dirección IP.
  • No se pudo importar el certificado de CA raíz ejecutando el script /opt/Citrix/VDA/sbin/enable\_ldaps.sh
    Proporcione la ruta completa del certificado de CA y verificar que el certificado de CA raíz sea del tipo correcto. Se supone que es compatible con la mayoría de los tipos de Java Keytool admitidos. Si no aparece en la lista de soporte, puede convertir el tipo primero. Recomendamos el formato PEM codificado en base64 si encuentra un problema de formato de certificado.
  • No se pudo mostrar el certificado de CA raíz con Keytool -list
    Cuando habilita LDAPS ejecutando /opt/Citrix/VDA/sbin/enable_ldaps.sh, el certificado se importa a /etc/xdl/.keystore, y la contraseña se establece para proteger el almacén de claves. Si olvida la contraseña, puede volver a ejecutar el script para crear un almacén de claves.