hash-sentinel latest

🔒 Hash Sentinel

Hash Sentinel is a handy and efficient Crystal tool designed to quickly identify users in an Active Directory environment who share identical NT hashes (passwords). It's a powerful addition to a penetration tester's toolkit, especially useful during post-exploitation phases, domain takeovers, and password policy assessments.

---

📖 Introduction

When conducting penetration tests, especially after compromising a Windows domain environment, it's crucial to analyze password usage across domain accounts. Identifying users with identical passwords helps assess password hygiene, detect shared administrative passwords, and pinpoint critical security issues.

After you've successfully taken control of an Active Directory domain (for example, by obtaining Domain Admin credentials), you typically extract the NTDS database dump. Here's a typical scenario to generate such a dump with Impacket's secretsdump.py:

secretsdump.py DOMAIN/Administrator:'Password123'@192.168.0.10 -outputfile full_domain_dump.txt -user-status

After obtaining the dump, you can filter out enabled users and exclude machine accounts with:

cat full_domain_dump.txt.ntds | grep 'status=Enabled' | cut -d " " -f 1 | grep -v '\$' > enabled_users_dump.ntds

Now, to detect users sharing the same password efficiently, Hash Sentinel helps you analyze this filtered data quickly and effortlessly.

---

🚀 Installation

Option 1: Download Precompiled Binary (Recommended)

The fastest way to get started is to download the precompiled binary from GitHub releases:

# Download the latest binary
wget https://github.com/evait-security/hash-sentinel/releases/download/latest/hash-sentinel

# Make it executable
chmod +x hash-sentinel

# Run it
./hash-sentinel -f enabled_users_dump.ntds

This binary is automatically built using GitHub Actions and is available for Linux systems.

Option 2: Build from Source

If you prefer to build from source, ensure Crystal is installed (https://crystal-lang.org/install/).

Clone this repository:

git clone https://github.com/evait-security/hash-sentinel.git
cd hash-sentinel
shards install

Then follow the build instructions below.

Option 3: AUR (Arch Linux User Repository)

For Arch Linux users, Hash Sentinel is available in the AUR:

# Install using your preferred AUR helper
paru -S hash-sentinel

# Or with yay
yay -S hash-sentinel

Package link: https://aur.archlinux.org/packages/hash-sentinel

😎 Note: No packages for other distros yet because real pentesters use Arch Linux anyway 😉

---

🔧 Building from Source

Build the executable binary with the following command:

crystal build --release src/hash_sentinel.cr -o hash-sentinel

Now, the binary hash-sentinel will be created in your project directory.

---

▶️ Running the Binary

After obtaining the binary (either by downloading it or building it), you can easily analyze your NT hash dumps. Run it using the following command structure:

./hash-sentinel -f enabled_users_dump.ntds

Command Line Parameters

---

📌 Usage Example

🔹 Input File Example (enabled_users_dump.ntds):

john.doe:1000:aad3b435b51404eeaad3b435b51404ee:88e4d9fabaecf3dec18dd80905521b29:::
jane.smith:1001:aad3b435b51404eeaad3b435b51404ee:e52cac67419a9a224a3b108f3fa6cb6d:::
mark.brown:1002:aad3b435b51404eeaad3b435b51404ee:88e4d9fabaecf3dec18dd80905521b29:::

🔹 Command:

./hash-sentinel -f enabled_users_dump.ntds

🔹 Output Example:

🔍 Analyzing NT hashes...

⚠️ Duplicate password found: john.doe, mark.brown

---

🛡️ Why Use Hash Sentinel?

• Quickly identifies weak password policies.
• Detects password reuse across user accounts.
• Facilitates security reporting and actionable recommendations.
• Simplifies large-scale password audits.

---

📚 Practical Workflow Example

A full practical example of a penetration testing workflow with hash-sentinel:

Step 1: Extract NTDS dump using Impacket (requires Domain Admin privileges):

secretsdump.py DOMAIN/Admin:'Passw0rd!'@10.10.10.100 -outputfile domain_dump.txt -user-status

Step 2: Extract only enabled user accounts (excluding machine accounts):

cat domain_dump.txt.ntds | grep 'status=Enabled' | cut -d " " -f 1 | grep -v '\$' > enabled_users_dump.ntds

Step 3: Run hash-sentinel:

./hash-sentinel -f enabled_users_dump.ntds

---

📝 License

MIT License

---

Happy Hacking! 🚀