LDAP Watchdog: Una herramienta de monitoreo LDAP en tiempo real compatible con Linux para detectar cambios en el directorio, proporcionando visibilidad sobre adiciones, modificaciones y eliminaciones para administradores e investigadores de seguridad.
LDAP Watchdog es una herramienta diseñada para monitorizar cambios en los registros de un directorio LDAP en tiempo real.
Proporciona un mecanismo para rastrear y visualizar modificaciones, adiciones y eliminaciones de entradas de usuarios y grupos, permitiendo a los usuarios correlacionar los cambios esperados con los cambios reales e identificar posibles incidentes de seguridad.
Fue creada pensando en OpenLDAP y Linux, y necesita un servidor que proporcione a cada entrada un entryUUID (RFC 4530), por lo que Active Directory, que utiliza objectGUID en su lugar, no es compatible.
Está escrita en Python y requiere la librería ldap3, además de requests para las notificaciones de Slack.
Este software fue escrito por Joshua Rogers.
Si te interesa alguno de los siguientes aspectos, entonces LDAP Watchdog es para ti:
Además de monitorizar modificaciones, adiciones y eliminaciones en un directorio LDAP, puede configurarse para ignorar atributos específicos, o incluso ajustarse con precisión para ignorar atributos de grano fino según sus valores antiguos/nuevos.
Los cambios siempre se imprimen en la terminal, y también se reenvían a un webhook de Slack si hay uno configurado. La salida con colores puede desactivarse.
Anteriormente llamado LDAP-Stalker (porque monitorizar los cambios de un directorio LDAP es una forma excelente de acechar los cambios en una empresa: enterarse de las promociones antes de que se anuncien, nuevas incorporaciones, bajas, etc.), aquí se puede encontrar una entrada de blog sobre los detalles y la historia de este proyecto.
Nota: en los ejemplos siguientes, los cambios en entryCSN y modifyTimestamp en entradas existentes pueden ignorarse estableciendo LDAP_WATCHDOG_IGNORED_ATTRIBUTES=entryCSN,modifyTimestamp.


Monitorización en tiempo real: LDAP Watchdog monitoriza continuamente un directorio LDAP en busca de cambios en las entradas de usuarios y grupos.
Comparación de cambios: La herramienta compara los cambios entre búsquedas LDAP consecutivas, resaltando adiciones, modificaciones y eliminaciones.
Verificación del usuario de control: LDAP Watchdog admite un mecanismo de usuario de control, que desencadena un error si no se encuentran los cambios del usuario de control.
Filtrado LDAP flexible: Los usuarios pueden personalizar el filtrado LDAP mediante la variable de entorno LDAP_WATCHDOG_SEARCH_FILTER para centrarse en clases de objetos o atributos específicos.
Integración con Slack: Recibe notificaciones en tiempo real en Slack sobre entradas LDAP añadidas, modificadas o eliminadas.
Salida personalizable: La salida por consola proporciona indicaciones claras y con colores de adiciones, modificaciones y eliminaciones para una fácil visibilidad.
Entradas y atributos ignorados: Los usuarios pueden especificar UUIDs y atributos a ignorar al comparar cambios en entradas existentes.
Atributos ignorados condicionalmente: Los usuarios pueden ignorar cambios en un atributo solo cuando implican valores específicos, como un grupo en memberOf.
ldap3. Si se utiliza un webhook de Slack, también se requiere el paquete requests.pip install LDAP-Monitor
Para incluir compatibilidad con webhooks de Slack:
pip install "LDAP-Monitor[slack]"
docker pull megamansec/ldap-monitor
O desde GitHub Container Registry:
docker pull ghcr.io/megamansec/ldap-monitoring-watchdog
git clone https://github.com/MegaManSec/LDAP-Monitoring-Watchdog.git
cd LDAP-Monitoring-Watchdog
pip install ".[slack]"
Desde 1.x: Desde la versión 2.0.0, las conexiones LDAPS verifican el certificado del servidor y que coincida con el nombre de host o la dirección IP en LDAP_WATCHDOG_SERVER; la versión 1.0.0 no verificaba ninguno de los dos. Antes de actualizar, configure LDAP_WATCHDOG_CA_CERTS_FILE si el certificado es autofirmado o proviene de una CA privada, y si no coincide con ese nombre, utilice un certificado que coincida o configure LDAP_WATCHDOG_TLS_VERIFY=false (consulte las notas sobre TLS en Configuration). Las notas de la versión enumeran los demás cambios.
Desde 1.x o 2.0.0: Desde la versión 2.0.1, las opciones booleanas solo aceptan los valores enumerados en Configuration. Las versiones anteriores interpretaban cualquier valor distinto de true, 1 o yes como falso. Ahora un valor no reconocido detiene el proceso al iniciarse, un valor vacío significa el valor predeterminado, y on o un "true" entre comillas significan verdadero. Por ejemplo, un LDAP_WATCHDOG_USE_SSL vacío con un nombre de host simple ahora se conecta con LDAPS en el puerto 636 en lugar de LDAP simple en el puerto 389.
export LDAP_WATCHDOG_SERVER='ldaps://ldaps.intra.lan'
export LDAP_WATCHDOG_BASE_DN='dc=mouse,dc=com'
export LDAP_WATCHDOG_USERNAME='cn=Emily,ou=People,dc=mouse,dc=com'
export LDAP_WATCHDOG_PASSWORD='qwerty123'
ldap-watchdog
O usando python -m:
python -m ldap_watchdog
docker run -d --restart unless-stopped \
-e LDAP_WATCHDOG_SERVER='ldaps://ldaps.intra.lan' \
-e LDAP_WATCHDOG_BASE_DN='dc=mouse,dc=com' \
-e LDAP_WATCHDOG_USERNAME='cn=Emily,ou=People,dc=mouse,dc=com' \
-e LDAP_WATCHDOG_PASSWORD='qwerty123' \
-e SLACK_WEBHOOK_URL='https://hooks.slack.com/services/[...]' \
-e LDAP_WATCHDOG_IGNORED_ATTRIBUTES='entryCSN,modifyTimestamp,telephoneNumber,roomNumber,gecos' \
-e LDAP_WATCHDOG_DISABLE_COLOR_OUTPUT='true' \
megamansec/ldap-monitor
Se proporciona un script de instalación para sistemas basados en Debian, install.sh. Requiere Python 3.10 o posterior y el paquete python3-venv. Cuando se ejecuta como root desde un clon de este repositorio, este script:
/opt/ldap-watchdog.requirements.txt./etc/ldap-watchdog.env para la configuración, a menos que ya exista uno./etc/systemd/system/ldap-watchdog.service) que ejecuta ldap-watchdog en segundo plano como un usuario dinámico sin privilegios, por lo que un bundle de CA debe ser legible por todos./var/log/ldap-watchdog.log y /var/log/ldap-watchdog-error.log./etc/logrotate.d/ldap-watchdog.Volver a ejecutar el script desde un clon actualizado actualiza la instalación.