Giter Club home page Giter Club logo

halberd's Introduction

Halberd

Halberd is an open-source security testing tool to proactively assess cloud threat detection by executing a comprehensive array of attack techniques across multiple surfaces.

Leveraging Halberd, security teams can very quickly & easily execute attack techniques to generate telemetry and validate their detection & response capabilities via a simple intuitive web application.

Evaluate defenses across multiple attack surfaces, including Entra ID, M365, Azure and AWS.

Setup

Halberd works on Linux, macOS & Windows and can be setup easily in just a few steps.

Install

$ git clone https://github.com/vectra-ai-research/Halberd.git
$ cd Halberd
$ python3 -m venv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
$ python3 Halberd.py

Checkout detailed instructions in deployment guide.

Usage

Once setup start testing by accessing the Halberd web app in your browser.

Visit: http://127.0.0.1:8050/

Overview

Module details & usage elaborates on specific executable techniques and interesting capabalities of Halberd.

Checkout Testing Use Cases for examples.

  • Entra ID Techniques
  • M365 Techniques
  • Azure Techniques
  • AWS Techniques
  • Advanced Recon Widgets
  • Access Manager
  • Reporting
  • Technique Execution via Intutive Web-App

Note: Halberd is continuously evolving and getting better with more testing techniques, new capabilities & fixes. Try to use the latest version available whenever possible.

Getting Started

Once Halberd is deployed & running, start testing by accessing http://127.0.0.1:8050/ in your browser.

Access

Allows management of access-tokens/clients/sessions and review of current access information for various targets.

Attack

Allows selection and execution of attack techniques. From the Attack view, select Attack Surface > Tactic > Technique > Execute.

Recon

Provides numerous advanced reconnaissance dashboards enabling fast and easy information gathering by automatically executing sequence of reconnaissance in the environment.

Example: Navigate to Recon > Entity Map > Generate Entity Map to generate an interactive graph of access & privileges in the cloud environment.

Trace

Displays log of all executed techniques and allows downloading report.

Note: Different techniques require varying access & privileges for successful execution. Start by establishing relevant access using Initial Access tactic under each attack surface.

Checkout usage for more information on testing with Halberd.

Contribute

  • Thanks for considering contributing to Halberd! Your contributions will make security testing easier & better.
  • Submit bugs & issues here

If you are interested in contributing to Halberd, checkout development focus areas & guidance on contributions.

Contact

If you found this tool useful, want to share interesting use-cases or ideas - reach out & share them!

Inspiration

Halberd is inspired from many amazing ideas and work produced by several talented members/groups of the security community. Checkout some of them here.

halberd's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.