An open API service indexing awesome lists of open source software.

https://github.com/adscanpro/adscan

ADscan is a pentesting tool focused on automating collection, enumeration and common attack paths in Active Directory. It provides an interactive CLI with a wide range of commands to streamline internal audits and AD-focused pentests.
https://github.com/adscanpro/adscan

active-directory adscan bloodhound pentest-tool pentesting

Last synced: about 2 months ago
JSON representation

ADscan is a pentesting tool focused on automating collection, enumeration and common attack paths in Active Directory. It provides an interactive CLI with a wide range of commands to streamline internal audits and AD-focused pentests.

Awesome Lists containing this project

README

          

adscan_wordmark_horizontal_transparent_cropped

[![Version](https://img.shields.io/badge/version-5.1.3--lite-blue.svg)](https://github.com/ADscanPro/adscan/releases)
[![downloads](https://static.pepy.tech/badge/adscan)](https://pepy.tech/projects/adscan)
[![License: BSL 1.1](https://img.shields.io/badge/license-BSL%201.1-blue.svg)](https://github.com/ADscanPro/adscan/blob/main/LICENSE)
[![Platform](https://img.shields.io/badge/platform-Linux-lightgrey.svg)](https://github.com/ADscanPro/adscan)
[![Discord](https://img.shields.io/discord/1355089867096199300?color=7289da&label=Discord&logo=discord&logoColor=white)](https://discord.com/invite/fXBR3P8H74)

**Automate Active Directory pentesting. From DNS to Domain Admin.**

**[Docs](https://adscanpro.com/docs?utm_source=github&utm_medium=readme&utm_campaign=docs_cta)** | [Discord](https://discord.com/invite/fXBR3P8H74) | [Website](https://adscanpro.com)

---

## ๐ŸŽฌ Demo

[![asciicast](https://asciinema.org/a/734180.svg)](https://asciinema.org/a/734180?autoplay=1)

_Auto-pwns **HTB Forest** in ~3 minutes_

---

## ๐Ÿš€ Quick Start

```bash
pipx install adscan
adscan install
adscan start
```

> **Full installation guide & docs** at [adscanpro.com/docs](https://adscanpro.com/docs?utm_source=github&utm_medium=readme&utm_campaign=install_cta)

## ๐Ÿงช Developer Setup (uv)

For local development in this repository:

```bash
uv sync --extra dev
uv run adscan --help
uv run adscan version
```

Quality checks:

```bash
uv run ruff check adscan_core adscan_launcher adscan_internal
uv run pytest -m unit
uv run python -m build
```

---

## โœจ Features

### LITE (Free, Source Available)

**Everything a pentester could do manually, 10x faster:**
- โœ… Three operation modes (automatic/semi-auto/manual)
- โœ… DNS, LDAP, SMB, Kerberos enumeration
- โœ… AS-REP Roasting & Kerberoasting
- โœ… Password spraying
- โœ… BloodHound collection & analysis
- โœ… Credential harvesting (SAM, LSA, DCSync)
- โœ… ADCS detection & template enumeration
- โœ… GPP passwords & CVE enumeration
- โœ… Export to TXT/JSON
- โœ… Workspace & evidence management

### PRO

**What nobody can do manually in reasonable time:**
- ๐ŸŽฏ Algorithmic attack graph generation
- ๐ŸŽฏ Auto-exploitation chains (DNS to DA)
- ๐ŸŽฏ ADCS ESC1-13 auto-exploitation
- ๐ŸŽฏ MITRE-mapped Word/PDF reports
- ๐ŸŽฏ Multi-domain trust spidering
- ๐ŸŽฏ Advanced privilege escalation chains
- ๐ŸŽฏ Priority enterprise support

[Full comparison](https://adscanpro.com/docs/lite-vs-pro) | [Learn more](https://adscanpro.com?utm_source=github&utm_medium=readme&utm_campaign=pro_cta)

---

## ๐Ÿ“‹ Requirements

| | |
|---|---|
| **OS** | Linux (Debian/Ubuntu/Kali) |
| **Docker** | Docker Engine + Compose |
| **Privileges** | `docker` group or `sudo` |
| **Network** | Internet (pull images) + target network |

---

## ๐Ÿ“œ License

Source available under the [Business Source License 1.1](LICENSE).

- **Use freely** for pentesting (personal or paid engagements)
- **Read, modify, and redistribute** the source code
- **Cannot** create a competing commercial product
- **Converts to Apache 2.0** on 2029-02-01

---

## ๐Ÿ’ฌ Community

[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/fXBR3P8H74)
[![GitHub Issues](https://img.shields.io/badge/GitHub-Report%20Bug-black?style=for-the-badge&logo=github)](https://github.com/ADscanPro/adscan/issues)

Enterprise support: [hello@adscanpro.com](mailto:hello@adscanpro.com)

---

(c) 2024-2026 Yeray Martin Dominguez | [adscanpro.com](https://adscanpro.com)