LDAP-Monitoring-Watchdog

LDAP Watchdog: A real-time linux-compatible LDAP monitoring tool for detecting directory changes, providing visibility into additions, modifications, and deleti

What is LDAP-Monitoring-Watchdog?

LDAP Watchdog: A real-time linux-compatible LDAP monitoring tool for detecting directory changes, providing visibility into additions, modifications, and deletions for administrators and security researchers.

Overview of LDAP-Monitoring-Watchdog

What it is

LDAP Watchdog is a real-time monitoring tool for LDAP directories, designed to track changes such as additions, modifications, and deletions of user and group entries. It is written in Python and requires the ldap3 library, with optional Slack webhook support via the requests library. The tool was created for OpenLDAP and Linux environments and requires that every entry has an entryUUID (RFC 4530); Active Directory (which uses objectGUID) is not supported. It provides visibility into directory changes for administrators and security researchers.

Key features

  • Real-time monitoring of LDAP directory changes - Change comparison between consecutive searches, highlighting additions, modifications, and deletions - Control user verification: triggers an error if the control user's changes are not found - Slack integration for real-time notifications of added, modified, or deleted entries - Customizable console output with colored indications (can be disabled)
  • Ability to ignore specific entries (by UUID) and attributes when comparing changes - Conditional ignored attributes: ignore changes to an attribute only when they involve specific values

Use cases

  • Monitoring HR actions such as new hires, leavers, and promotions as they appear in LDAP - Detecting unauthorized changes in the LDAP directory - Identifying accidentally leaked data - Correlating expected changes with actual changes for security incident detection - Tracking user login and logout events in LDAP

Getting started

Install via pip: bash pip install LDAP-Monitor For Slack support: bash pip install 'LDAP-Monitor[slack]' Basic usage requires setting environment variables for the LDAP server, base DN, username, and password, then running: bash 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 Docker images are also available: megamansec/ldap-monitor or ghcr.io/megamansec/ldap-monitoring-watchdog.

License and pricing

Licensed under GPL-3.0. Open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/megamansecldap-monitoring-watchdog.svg)](https://yunodb.com/tools/megamansecldap-monitoring-watchdog?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/megamansecldap-monitoring-watchdog?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/megamansecldap-monitoring-watchdog.svg" alt="Featured on YunoDB" height="20"></a>