Skip to content
KitploitKITPLOIT
ToolsExploitsBlog
Log in
Submit
ToolsExploitsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

FeedsContactPrivacy© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
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. | Kitploit
Tools/GitHubGitHub/megamansec/ldap-monitoring-watchdog
Authentication & AuthorizationDefensive ToolsIdentity ManagementConfiguration AuditingInformation GatheringIncident ResponseLog Analysis
GitHub
Share
megamansec/ldap-monitoring-watchdog

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.

View RepositoryWebsite
194164211 days agoReviewed by Kitploit

LDAP Watchdog

Overview

LDAP Watchdog is a tool designed to monitor record changes in an LDAP directory in real-time. It provides a mechanism to track and visualize modifications, additions, and removals to user and group entries, allowing users to correlate expected changes with actual changes and identify potential security incidents. It was created with OpenLDAP and Linux in mind, and needs a server that gives every entry an entryUUID (RFC 4530), so Active Directory, which uses objectGUID instead, is not supported. It is written in Python and requires the ldap3 library, plus requests for Slack notifications.

This software was written by Joshua Rogers.

If you're interested in any of the following, then LDAP Watchdog is for you:

  • Know what's going on in your LDAP directory on-demand with Slack webhook integration.
  • See new hires, leavers, and promotions as they appear in LDAP.
  • Monitor when and what HR is doing.
  • Detect unauthorized changes in LDAP.
  • Monitor for accidentally leaked data.
  • Detect when users are logging in and out of LDAP.

In addition to monitoring for modifications, additions, and removals in an LDAP directory, it can be configured to ignore specific attributes, or even fine-tuned to ignore fine-grained attributes depending on their old/new values.

Changes are always printed to the terminal, and are also forwarded to a Slack webhook if one is configured. Colored output can be turned off.

Previously named LDAP-Stalker (because monitoring changes of an LDAP directory is an excellent way to stalk changes in a company: learn about promotions before they're announced, new hires, leavers, etc.), a blog post about the details and history of this project can be found here.

Examples (No Filtering)

Note: in the below examples, changes to entryCSN and modifyTimestamp on existing entries can be ignored by setting LDAP_WATCHDOG_IGNORED_ATTRIBUTES=entryCSN,modifyTimestamp.

Terminal (with color) output:

Example of the output from LDAP Watchdog

Slack output:

Example of the output from LDAP Watchdog in Slack

Features

  1. Real-time Monitoring: LDAP Watchdog continuously monitors an LDAP directory for changes in user and group entries.

  2. Change Comparison: The tool compares changes between consecutive LDAP searches, highlighting additions, modifications, and deletions.

  3. Control User Verification: LDAP Watchdog supports a control user mechanism, triggering an error if the control user's changes are not found.

  4. Flexible LDAP Filtering: Users can customize LDAP filtering using the LDAP_WATCHDOG_SEARCH_FILTER environment variable to focus on specific object classes or attributes.

  5. Slack Integration: Receive real-time notifications on Slack for added, modified, or deleted LDAP entries.

  6. Customizable Output: Console output provides clear and colored indications of additions, modifications, and deletions for easy visibility.

  7. Ignored Entries and Attributes: Users can specify UUIDs and attributes to ignore when comparing changes to existing entries.

  8. Conditional Ignored Attributes: Users can ignore changes to an attribute only when they involve specific values, such as one group in memberOf.

Requirements

  • Python 3.10+.
  • The ldap3 package. If using a Slack webhook, the requests package is also required.

Installation

PyPI

pip install LDAP-Monitor

To include Slack webhook support:

pip install "LDAP-Monitor[slack]"

Docker

docker pull megamansec/ldap-monitor

Or from GitHub Container Registry:

docker pull ghcr.io/megamansec/ldap-monitoring-watchdog

From Source

git clone https://github.com/MegaManSec/LDAP-Monitoring-Watchdog.git
cd LDAP-Monitoring-Watchdog
pip install ".[slack]"

Upgrading

From 1.x: Since 2.0.0, LDAPS connections verify the server certificate and that it matches the host name or IP address in LDAP_WATCHDOG_SERVER; 1.0.0 checked neither. Before upgrading, set LDAP_WATCHDOG_CA_CERTS_FILE if the certificate is self-signed or from a private CA, and if it does not match that name, use a matching certificate or set LDAP_WATCHDOG_TLS_VERIFY=false (see the TLS notes under Configuration). The release notes list the other changes.

From 1.x or 2.0.0: Since 2.0.1, boolean settings only accept the values listed under Configuration. Earlier versions read anything other than true, 1 or yes as false. Now an unrecognized value stops the process at startup, an empty value means the default, and on or a quoted "true" means true. For example, an empty LDAP_WATCHDOG_USE_SSL with a bare host name now connects with LDAPS on port 636 instead of plain LDAP on port 389.

Usage

Running with pip install

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

Or using python -m:

python -m ldap_watchdog

Running with Docker

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

Systemd Installation (Debian-based)

A Debian-based installation script, install.sh, is provided. It needs Python 3.10 or later and the python3-venv package. When run as root from a clone of this repository, this script:

  1. Creates (if necessary) a Python virtual environment in /opt/ldap-watchdog.
  2. Installs LDAP Watchdog from the clone into that virtual environment, with the dependency versions pinned in requirements.txt.
  3. Creates an environment file at /etc/ldap-watchdog.env for configuration, unless one already exists.
  4. Installs, enables and starts a systemd service (/etc/systemd/system/ldap-watchdog.service) that runs ldap-watchdog in the background as an unprivileged dynamic user, so a CA bundle must be world-readable.
  5. Configures logging to /var/log/ldap-watchdog.log and /var/log/ldap-watchdog-error.log.
  6. Sets up log rotation in /etc/logrotate.d/ldap-watchdog.

Rerunning the script from an updated clone upgrades the installation.

You may optionally pass a single argument to install.sh to set the SLACK_WEBHOOK_URL when the environment file is first created:

sudo ./install.sh "https://hooks.slack.com/services/[...]"

After installation, edit /etc/ldap-watchdog.env to configure the LDAP connection settings (the service fails until then), then restart the service:

sudo systemctl restart ldap-watchdog

Configuration

All configuration is done via environment variables; an empty value is the same as an unset one, except for LDAP_WATCHDOG_SLACK_BULLETPOINT. The following variables are supported:

General Settings

Download Tool

Most Popular

View all →

Discover the most used tools by our community.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 The ultimate OSINT toolkit: investigation graph, confidence scoring, alias families, map, timeline and reports. 49 modules, 400+ sites, no API keys required.

    977
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock One-Tap Execution App (CVE-2026-43499)

    564
  • 3

    looking-glass

    anonghosty/looking-glass

    CSIRT platform that ingests Shadowserver reports into MongoDB and replays them as interactive maps, analysis, findings, advisories and executive dashboards.

    352
  • 4

    redforge

    cybersecurity91/redforge

    Browser-side red team toolkit with 102 offline tools for recon, payload generation, credential attacks, crypto, encoding and engagement reporting.

    344
  • 5

    ARTEX

    baarai/artex

    LLM multi-agent autonomous penetration testing platform with planner/worker agents, asset and exploration graphs, MITM traffic recording, and vulnerability retesting.

    322
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    The system of action for AI-native cybersecurity—where intent becomes governed execution, evidence becomes operational memory, and every operation improves the next.

    308

Explore all tools

Browse our collection of tools

View all tools →