ad-kit is an automation toolkit designed to make Active Directory (AD)
assessments more efficient.
It combines tool management, environment preparation, AD enumeration, domain data collection, NTDS extraction, and common security checks into a single command-line interface.
The toolkit is intended to provide a repeatable methodology for conducting AD security reviews and generating consistent assessment output.
- Tool installation and status verification
- Domain and Domain Controller enumeration
- Assessment session tracking and engagement metadata
netexecaudit mode configuration- Standard User and Domain Admin credential validation
- BloodHound data collection via
rusthound-ce - NTDS extraction via Impacket
secretsdump - SCP command generation for artefact retrieval
- Automated Active Directory security assessment checks
- Markdown finding generation with supporting evidence
# Install UV
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install ad-Kit
uv tool install git+https://github.com/CSpanias/ad-kit
# Verify installation
ad-kit -h
# Update
uv tool upgrade ad-kitA typical Active Directory assessment using ad-kit follows the workflow below:
Install Required Tools (`tools`)
|
v
Enumerate Environment (`enum`)
|
+--> Session Metadata
+--> Domain Users
+--> Domain Controllers
+--> Credential Validation
+--> BloodHound Collection
+--> NTDS Extraction
|
v
Security Assessment Checks (`check`)
|
+--> Findings
+--> Evidence
+--> Markdown Reports
|
v
Continue EngagementThe generated artefacts can be consumed by other assessment tooling. For
example, exported BloodHound collections (.zip) and NTDS dumps (.ntds) can
be processed directly using password-audit.
$ ad-kit -h
Usage: ad-kit [OPTIONS] COMMAND [ARGS]...
Active Directory Assessment Toolkit.
╭─Options──────────────────────────────────────────────────────────────────────╮
│ --help -h <bool> Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─Commands─────────────────────────────────────────────────────────────────────╮
│ enum Perform basic domain enumeration: │
│ tools Manage assessment tools. │
│ check Execute assessment checks. │
╰──────────────────────────────────────────────────────────────────────────────╯
Examples:
ad-kit tools install all
ad-kit tools install certipy
ad-kit tools status
ad-kit enum
ad-kit check all
ad-kit check ldap
ad-kit check run ldap pass-poltools displays all tools registered in AD-Kit and their installation source:
$ ad-kit tools -h
Usage: ad-kit tools [OPTIONS]
Display all tools registered in ad-kit and their installation source. enum bootstraps an AD assessment:
$ ad-kit enum -h
Usage: ad-kit enum [OPTIONS]
Perform basic domain enumeration:
• Discover the target domain
• Enumerate domain controllers
• Configure NetExec\'s audit mode
• Validate a standard user account
• Validate a Domain Admin account
• Create user and machine account lists
• Collect BloodHound data using RustHound-CE
• Dump NTDS using secretsdump
╭─Options──────────────────────────────────────────────────────────────────────╮
│ --help -h <bool> Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯check executes one or more AD assessment modules and generates Markdown
findings with supporting evidence:
$ ad-kit check -h
Usage: ad-kit check [OPTIONS] COMMAND [ARGS]...
Execute assessment checks.
╭─Commands─────────────────────────────────────────────────────────────────────╮
│ all Execute all assessment checks. │
│ ldap Execute ldap assessment checks. │
│ tombstone Execute tombstone assessment checks. │
│ smb Execute smb assessment checks. │
│ asreproast Execute asreproast assessment checks. │
│ pass-pol Execute pass-pol assessment checks. │
│ password-not-required Execute password-not-required assessment checks. │
│ password-never-expires Execute password-never-expires assessment checks. │
│ maq Execute maq assessment checks. │
│ dns Execute dns assessment checks. │
│ pre2k Execute pre2k assessment checks. │
│ nopac Execute nopac assessment checks. │
│ scriptPath Execute scriptPath assessment checks. │
│ privileged Execute privileged assessment checks. │
│ delegation Execute delegation assessment checks. │
│ kerberoast Execute kerberoast assessment checks. │
│ adcs Execute adcs assessment checks. │
│ local-admin Execute local-admin assessment checks. │
│ ldap-info Execute ldap-info assessment checks. │
│ coercion Execute coercion assessment checks. │
│ run Execute selected assessment modules. │
╰─────────────────────────────────────────────────────────────────────────────╯