Claude-AD README

The project's README from github.com/ADScanPro/Claude-AD. As one markdown file: README.md.

Claude-AD

Active Directory pentest methodology for Claude Code.

License: MIT Claude Code plugin Version Techniques

Skills, agents and commands that give Claude the playbook for an internal Active Directory assessment: the phase order, the environment constraints that break your tooling, the telemetry each technique leaves behind, and how a finding maps to a compliance control. It drives standard tooling (netexec, impacket, certipy, bloodyAD, BloodHound CE). You still run the engagement; Claude carries the method.


What this is

Every AD assessment follows the same spine: map before you exploit, harvest the easy credentials before you spray, collect the graph before you reason about paths. That spine, plus the hundred small constraints a hardened domain throws at you (NTLM disabled, AES-only Kerberos, LDAP channel binding, SPNs that must be FQDNs), is what separates an operator who finishes the engagement from one who spends a day debugging invalidCredentials.

Claude-AD encodes that method as Claude Code skills so Claude runs the standard tools in the right order, reads the environment correctly, and tells you what each step will look like to a defender.

It covers:

It orchestrates third-party tools. BloodHound CE (Apache-2.0), impacket, certipy, netexec and bloodyAD do the work; Claude-AD is the method that drives them.

Install

Claude-AD is a Claude Code plugin. From inside Claude Code:

/plugin marketplace add ADScanPro/Claude-AD
/plugin install claude-ad@claude-ad

The first line registers this repo as a marketplace; the second installs the plugin. Once installed, the skills load automatically when you work on an AD engagement, and the commands (/ad-scope, /ad-recon, /ad-attack-paths) are available.

Layout

Claude-AD/
├── skills/
│   ├── ad-methodology/          # phase order and why
│   ├── ad-environment-constraints/  # what breaks your tooling in a hardened domain
│   ├── ad-opsec-telemetry/      # Event IDs and MDI alerts per technique
│   ├── kerberos-attacks/        # Kerberoasting, AS-REP, delegation
│   ├── adcs-attacks/            # ESC1-ESC17 with certipy
│   ├── acl-abuse/               # GenericAll, WriteDACL, replication rights
│   ├── coercion-ntlm-relay/     # PetitPotam/PrinterBug/DFSCoerce + ntlmrelayx
│   └── compliance-mapping/      # conceptual technique -> DORA/NIS2/ENS control
├── agents/
│   ├── ad-enumerator.md         # runs collection with standard tooling
│   ├── ad-attack-planner.md     # reasons low-priv -> Domain Admin paths
│   └── ad-exploit-operator.md   # executes one step, with a human gate
└── commands/
    ├── ad-scope.md
    ├── ad-recon.md
    └── ad-attack-paths.md

Scope and ethics

This is for authorized engagements only: your own lab, a domain you are contracted to test, a CTF. The exploitation agents ask for confirmation before any action that modifies the directory (a password reset, a group add, an RBCD write), and note where rollback applies. Use it where you have permission to.

Where Claude-AD ends and ADscan begins

Claude-AD gives you the method. It tells Claude what to run, in what order, what each technique looks like on the wire, and which compliance control it touches. You still drive every tool by hand and read every result yourself.

ADscan is the engine. It runs the whole chain from a low-privilege user to Domain Admin on its own, on-prem, with guardrails and rollback, and turns the result into a report with control IDs a DORA, NIS2 or ENS auditor will accept. Where this repo hands Claude the playbook, ADscan is the tool that executes it end to end and writes the evidence.

ADscan is free and source-available. If the manual method here is useful and you want it run and mapped for you, that is what it is for.

Prior art and references

Claude-AD stands on the shoulders of the community. The techniques it encodes are documented in depth at The Hacker Recipes, the reference every skill here points back to for exact syntax. It sits alongside the growing set of Claude Code security collections (Claude-OSINT, Claude-BugHunter, claude-pentest), filling the Active-Directory-internal gap those bundles leave open. The tooling it drives (BloodHound CE, impacket, certipy, netexec, bloodyAD) is the work of their respective authors.

Contributing

New techniques, sharper detection guidance, corrections to the compliance mapping: open an issue or a PR. Keep it AD-internal and keep the commands real.

License

MIT. See LICENSE. ADscan itself is a separate product under the Business Source License 1.1 (source-available).


Keywords: Active Directory penetration testing · Claude Code skills · red team · Kerberoasting · AS-REP roasting · ADCS ESC1-ESC17 · DCSync · ACL abuse · NTLM relay & coercion (PetitPotam, PrinterBug, DFSCoerce) · Kerberos delegation · BloodHound CE attack paths · OPSEC & MDI telemetry · DORA / NIS2 / ENS compliance mapping · netexec · impacket · certipy · bloodyAD.

Claude-AD (ADScanPro/Claude-AD)

Searching Database…

Что это?Claude-AD — это плагин Claude Code, дающий Claude методологию внутреннего пентеста Active Directory: навыки, агенты и слэш-команды, покрывающие Kerberoasting, ADCS ESC1-17, DCSync, злоупотребление ACL, NTLM relay и злоупотребление делегированием, каждое с заметками по OPSEC и телеметрии.
Это сам инструмент сканирования или то, что подсказывает Claude, что запускать?Это не сканер — это методология, закодированная как навыки Claude Code. Claude подсказывает порядок фаз и нужную команду, но запускать netexec, impacket, certipy, bloodyAD и BloodHound CE и читать результаты по-прежнему вам самим.
Какие инструменты нужно иметь уже установленными, чтобы реально выполнять атаки?Стандартный набор инструментов AD-пентеста нужно установить самостоятельно: netexec, impacket, certipy, bloodyAD и BloodHound CE. Claude-AD их не упаковывает в себя и не заменяет, он лишь подсказывает, какой запустить и как.
Автоматизирует ли это саму цепочку атак за меня?Нет, Claude-AD даёт только метод: порядок действий, заметки по OPSEC, события обнаружения. Автоматический прогон цепочки от начала до конца — от малопривилегированного пользователя до Domain Admin — это отдельный продукт под названием ADscan.
Где это работает?Он работает везде, где работает Claude Code, то есть на macOS, Linux и Windows, поскольку устанавливается как плагин Claude Code, а не отдельное приложение.
Лицензия одинакова для всего проекта?Этот репозиторий лицензирован под MIT, но связанный продукт полной автоматизации ADscan — отдельный инструмент под Business Source License 1.1 (source-available), а не MIT.
Какие техники атак на AD он покрывает?Kerberoasting и AS-REP roasting, ADCS от ESC1 до ESC17, злоупотребление ACL (GenericAll/WriteDACL/права репликации), принуждение и NTLM relay (PetitPotam, PrinterBug, DFSCoerce), а также злоупотребление делегированием Kerberos.
Для чего нужна функция сопоставления с комплаенсом?Каждая техника концептуально соотносится с семейством средств контроля, которого она касается, по регламентам DORA, NIS2 и ENS, превращая техническую находку в заметку о соответствии, готовую к аудиту.
Он не даёт случайно сломать что-то в домене?Да, агенты эксплуатации запрашивают подтверждение перед любым изменяющим каталог действием вроде сброса пароля, добавления в группу или записи RBCD, и указывают, где применим откат.
В чём разница между этим репозиторием и ADscan?Claude-AD — это ручная методология, которой вы управляете руками; ADscan — отдельный движок с доступным исходным кодом (source-available), который выполняет ту же цепочку атак от начала до конца автоматически и выдаёт отчёт, готовый для аудитора.
Creator
ADScanPro
Size
<0.1 MB
Stars
211
Updated
CommitAug 24
Age
1mo
Commits · 90 Days