Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

AD-Descript0r

AD-Descript0r is a Python tool for Active Directory reconnaissance.
It connects to a Domain Controller with given credentials, retrieves all usernames and their descriptions, and presents the results in a clean table with colored output. There's often juicy information in there like Passwords or hints.


✨ Features

  • Reads all Active Directory users with their description using LDAP paging.
  • Clears the screen and shows ASCII art
  • Prompts for username, password, and DC IP/hostname (with validation)
  • Shows a progress bar while fetching
  • Prints a colored ASCII table to the console
  • Saves a plain ASCII table to ad_descriptions.txt (or anon... if empty, though AD bind needs a user)

⚙️ Requirements

  • Python 3.8+
  • Packages:
    • ldap3
    • tabulate

Install dependencies via:

pip install ldap3 tabulate

📥 Installation

Clone the repository and install requirements:

git clone https://github.com/BenjaminIheukumere/ad_descript0r.git
cd ad_descript0r
chmod +x ad_descript0r.py
pip install -r requirements.txt

▶️ Usage

Run the script with Python 3:

ad_descript0r.py

You will then be prompted for:

  • Username (format: DOMAIN\user or user@domain.fqdn)
  • Password
  • Domain Controller IP

Screenshot of AD Descript0r in action

AD Descript0r in action

About

AD-Descript0r is a Python tool for Active Directory reconnaissance. It authenticates against a Domain Controller, retrieves all usernames and their descriptions, and displays the results in a clean table with colored output

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages