Download for Windows · Sample report · Control catalog · Security
ADitor reads a domain’s Group Policy over LDAP and SYSVOL, checks it against a versioned catalog of hardening controls, and writes a report you can hand to someone. Run it again next month and diff the two scans to see what your fixes changed and whether anything regressed. It never writes to the directory.
ADitor doesn’t replace PingCastle or Purple Knight. Use them for a broad assessment of your Active Directory security. ADitor complements them for the hardening work that follows: it checks specific Group Policy and directory settings against a catalog of sourced controls, tells you what order to change them in, and compares scans so you can see what each change did.
From the sample report, rendered from synthetic data.
scan.json and report.html contain GPO names,
registry values and DNs from your domain.Windows builds are on the Releases page:
ADitor.exe: the desktop app. It needs WebView2, which is already on
Windows 10 and 11.aditor-cli.exe: the command line, for scheduled tasks and Server Core.SHA256SUMS.txt: checksums. Check one with
Get-FileHash .\ADitor.exe -Algorithm SHA256 in PowerShell.The executables are not code-signed yet, so Windows SmartScreen will warn the first time you run one (More info → Run anyway). If that’s a problem where you work, build from source instead (below).
See the code signing policy for how releases are signed.
The Windows downloads carry their own Python, so there’s nothing else to install. You need:
For macOS or Linux, or if you’d rather not run an unsigned executable. This needs Python 3.12 and uv (or pip).
git clone https://github.com/alexlinos/ADitor.git
cd ADitor
uv venv --python 3.12
source .venv/bin/activate
uv pip install -e ".[smb]" # add ,gui for the desktop app
cp ad-config/config.example.json ad-config/config.json
chmod 600 ad-config/config.json
{
"active_directory": {
"server": "ldaps://dc.example.com:636",
"domain": "example.com",
"base_dn": "DC=example,DC=com",
"bind_dn": "EXAMPLE\\svc-aditor",
"password": "${AD_MCP_PASSWORD}"
},
"security": {
"validate_certificate": true
}
}
Use ldaps:// (port 636). ADitor binds with a simple bind and doesn’t use
STARTTLS, so with plain ldap:// the bind password crosses the network in clear
text; ADitor allows it but warns every time.
The password field supports ${ENV_VAR} expansion, so the secret can be supplied
at runtime rather than stored on disk. If it is unset and you run aditor scan
from a terminal, you are prompted for it. config.json is gitignored.
On macOS, scan_keychain.sh pulls the password from the
Keychain (service admcp-ldap) and runs a scan with it.
With the Windows download, use aditor-cli.exe wherever this says aditor,
for example .\aditor-cli.exe scan --config config.json --out C:\scans.
aditor scan --config ad-config/config.json --out ~/scans
aditor diff ~/scans/2026-08-20T193156Z-26f204f6 ~/scans/2026-08-24T184004Z-9d7d8ba2
| Exit code | Meaning |
|---|---|
| 0 | Nothing needs attention |
| 1 | The scan has a fail or error finding, or the diff has a regression |
| 2 | The command could not run (config, connection, or a refused file); nothing was written |
The exit codes let it run unattended from a scheduled task or an RMM agent.
aditor scanRuns the scan once and writes one dated folder:
<out>/2026-08-20T162647Z-b288e925/
scan.json <- the payload (source of truth)
report.html <- the rendered document
Both files come from the same scan, so they carry the same scan_id,
timestamp and findings. The folder name is the scan’s own timestamp plus a
scan_id prefix, with no colon so it is legal on Windows. An existing folder is
never overwritten, and a failed write leaves no folder behind.
Each finding carries a result, a rollout state (not started / audit / enforced, so a domain correctly mid-rollout does not read as failing), and evidence: the expected value next to every value found, with the source GPO and its link path. Controls come from the Devore AD Hardening Series, and each one cites its article. Most read Group Policy; a few read the directory itself (service accounts without AES, built-in privileged groups that should be empty, and unconstrained delegation), with read-only LDAP queries. Policy precedence is not resolved: GPOs that disagree are reported as conflicts. Controls whose exact expected value the source does not state are reported but never scored or guessed.
The report is one self-contained HTML file (inline CSS, no scripts, no network)
that opens from a file:// path and prints to PDF from a browser. It opens with
a “Start here” box (where you stand, and the first few things to do) and groups
findings by what you do with them: Fix, Check by hand, Not covered
yet and Good. Each finding shows found versus target, the fix and the safe
rollout order up front, with the evidence one click away. A warning about
unreadable GPOs always comes first. See the sample report,
rendered from synthetic data.
Both files contain directory content — GPO display names, registry values and DNs. Treat them accordingly when sharing.
The scan reads Group Policy, not event logs, so it can’t see which machines and accounts still use NTLMv1. A read-only PowerShell script collects that:
aditor ntlm-script > export.ps1 # list your DCs and servers in it, then run it
aditor ntlm-check ntlmv1-evidence.csv
aditor scan --config ad-config/config.json --ntlm-evidence ntlmv1-evidence.csv
The script reads two sources:
It writes one CSV, which holds account and machine names. Run it as a member of Event Log Readers on each host; it doesn’t need Domain Admin.
NTLMv1 is logged on the server being signed in to, so include every server, not just the domain controllers. ADitor only calls it clear when every host’s logs cover 14 days with logon auditing on. An empty list on its own proves nothing.
aditor diff OLD NEWCompares two scans, given as scan.json files or snapshot folders. It reads two
files and touches no directory.
It says first whether a difference is the domain’s or the tool’s. If
the two scans ran different catalog or engine versions, every difference may be
the scanner rather than the domain, and the diff says so before anything else.
This is not hypothetical: one control here went fail → pass between two real
scans only because the scanner learned to read Group Policy Preferences.
Regressions are listed before improvements. A rollout moving backwards
(enforced → audit) counts as a regression even when the result stays pass.
A control added to or removed from the catalog is never counted as either.
For an administrator who would rather not use a terminal. On Windows, run
ADitor.exe. From source:
uv pip install -e ".[gui,smb]"
python -m aditor.app
| Screen | What it does |
|---|---|
| Connection | Enter and test read-only credentials. On failure it shows the actual LDAP error, and helps establish LDAPS certificate trust. |
| Scan | One button. Runs the same scan as aditor scan, shows its progress and counts, and opens the report. |
| History | The snapshot archive. Open a report, or pick two scans and diff them, with an ambiguous attribution shown as a warning. |
Credentials. The bind password is never written to disk. It goes to the OS
credential store — Windows Credential Manager or the macOS Keychain, under the
same admcp-ldap service name scan_keychain.sh uses — and the app’s config
file holds the ${AD_MCP_PASSWORD} placeholder. That file has the same shape
aditor scan --config reads. If no OS credential store is available, the app
says so and refuses to save.
pywebview is an optional extra (gui); the aditor command installs and runs
without it.
It works, but run it from an admin workstation where you can. A DC is a Tier 0 host, and ADitor is an unsigned new executable that only needs a read-only account and network access to a DC. If you do run it on one:
aditor-cli.exe.aditor-cli.exe with the
password supplied at run time.The certificate helper’s Download the issuing CA certificate works well on a DC: it looks in the machine’s own certificate stores first, and it never sends a credential to find the file.
pytest
src/aditor/
cli.py # the aditor command: scan, diff
hardening/ # catalog, collection, evaluator, report, snapshot, diff
gpo/ # pure GPO parsers (Registry.pol, GptTmpl.inf, Registry.xml)
core/ # LDAP connection manager, logging
config/ # configuration models and loader
app/ # the desktop app
tests/
docs/ # design docs and the hardening control catalog
Issues and pull requests are welcome. Every pull request runs the test suite on
Windows. A new control goes in src/aditor/hardening/controls.json, with a
source for its expected value and a test that fails without it.
Don’t put real domain data in an issue, a test fixture or a screenshot. Use
example.com and made-up names. To report a vulnerability, see
SECURITY.md.
Free code signing provided by SignPath.io, certificate by SignPath Foundation.
Signing starts with the first release after SignPath approves the project. Until then, the downloads are unsigned.
Only the executables built from this repository by its GitHub Actions workflow are signed, and only for a tagged release.
| Role | Who |
|---|---|
| Committers and reviewers | Alex Linos |
| Approvers | Alex Linos |
Privacy. This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. ADitor connects only to the domain controller you configure and, if you choose Download the issuing CA certificate, to the certificate URL printed in that domain controller’s certificate. See What it touches.
MIT, see LICENSE. ADitor began as a fork of ActiveDirectoryMCP by Alperen Adalar (MIT), whose copyright is kept in the license file. The MCP server and its directory-management tools were removed.
Copyright © 2026 Alex Linos.