Giter Site home page Giter Site logo

tai-rex / exegol Goto Github PK

View Code? Open in Web Editor NEW

This project forked from theporgs/exegol

1.0 0.0 0.0 32.82 MB

Exegol is a fully featured and community-driven hacking environment

License: GNU General Public License v3.0

Dockerfile 5.54% Shell 59.72% Python 34.74%

exegol's Introduction

Exegol

DockerHub build type DockerHub build state image size GitHub code size in bytes Python
current version latest commit on master latest commit on dev



๐Ÿ’ก TL;DR: Exegol is a community-driven hacking environment, powerful and yet simple enough to be used by anyone in day to day engagements.

Exegol is a fully configured docker with many useful additional tools, resources (scripts and binaries for privesc, credential theft etc.) and some configuration (oh-my-zsh, history, aliases, colorized output for some tools). It can be used in pentest engagements, bugbounty, CTF, HackTheBox, OSCP lab & exam and so on. Exegol's original fate was to be a ready-to-hack docker in case of emergencies during engagements.

The main features of Exegol are:

  • ๐Ÿ”ง Tools: many tools that are either installed manually or with apt, pip, go etc. Some of those tools are in kali, some are not. Exegol doesn't come with only ultra-famous tools, you will find ones that the community loves to use, even if it's in dev/new/not famous. Some tools are pre-configured and/or customized (colored output, custom NtChallengeResponse in Responder, custom queries in BloodHound, ...)
  • ๐Ÿ’ก Resources: many resources can be useful during engagements. Those resources are not referred to as "tools" since they need to be run on a pwned target, and not on the attacker machine (e.g. mimikatz, rubeus, ...).
  • ๐Ÿ“œ History: a populated history file that allows exegol users to save time and brain space by not having to remember every tool option and argument or checking the "help" every time.
  • ๐Ÿš€ Aliases: a file containing aliases that can be handful when using manually installed tools, or doing common operations.
  • ๐Ÿ”Ž Usage : a powerful Python3 wrapper used to manage Exegol container and image very easily (handles docker operations like docker pull, docker build, docker run, docker start, docker stop, docker ps, docker rm, docker inspect).

Below is an example of a Zerologon attack operated with Exegol. Example

Below is an example of a ACE abuse/RBCD attack operated with Exegol Example

โฉ Quick start

Bear in mind that the install process can be long as it downloads a ~6GB image.

git clone https://github.com/ShutdownRepo/Exegol
cd Exegol
python3 -m pip install --user --requirement requirements.txt
python3 exegol.py start

Add Exegol to PATH :

sudo ln -s $(pwd)/exegol.py /usr/local/bin/exegol

๐Ÿ”Ž Usage

A powerful Python wrapper allows to manage Exegol without having to know docker-fu.

  • Install (pull or build) an image : exegol install
  • Create/start/enter a container : exegol start
  • Execute a specific command on a container (with stdout / stderr) : exegol start -e bloodhound
  • Execute a specific command on a container as a daemon : exegol exec -e bloodhound
  • Stop a container : exegol stop
  • Remove a container or an image : exegol remove
  • Get help and advanced usage : exegol --help

Example

By default, Exegol will start with display sharing allowing GUI-based programs to run, here is an example with BloodHound.

Example

๐Ÿ” Credentials

Some tools are pre-configured with the following credentials

Element User Password
wso-webshell (PHP) exegol4thewin
neo4j database neo4j exegol4thewin
bettercap ui bettercap exegol4thewin
trilium trilium exegol4thewin

๐Ÿ“Œ Pre-requisites

You need python3, python3-pip, git, docker ๐Ÿณ, and 15GB of free storage (What did you expect? A fully featured pentesting environment for less than 2GB? If you've got ideas I'm all ears).

๐Ÿ”ง Tools

The tools installed in Exegol are mostly installed from sources in order to have the latest version when deploying Exegol. Some installs are made with go, pip, apt, gem etc. You will find most of the tools in /opt/tools.

๐Ÿ’ก Resources

In addition to the many tools pre-installed and configured for some, you will find many useful pre-fetched resources like scripts and binaries in /opt/resources. There some pre-EoP enumeration scripts (EoP: Escalation of Privileges) and other useful binaries like Rubeus or mimikatz.

๐Ÿ“œ History

When I hack, I often rely on my history. I don't have to remember command line options, syntax and such. This history is filled with commands that I used in engagements, bugbounties, ctf, oscp and so on. Of course, the values are placeholders that need to be changed with the appropriate ones in your context. The history is easily usable with oh-my-zsh, zsh-autosuggestions, and fzf

๐Ÿš€ Aliases

Since many tools are manually installed in /opt/tools/, aliases could be heplful to use these without having to change directory manually. Other aliases are set to save time while hacking (http-server, php-server, urlencode,ipa, ...).

๐Ÿ“ข Credits & thanks

Credits and thanks go to every infosec addicts that contribute and share but most specifically to @th1b4ud for the base "Kali Linux in 3 seconds with Docker".

๐ŸŽฅ Introducing Exegol (in french w/ english subs)

exegol's People

Contributors

shutdownrepo avatar mayfly277 avatar dramelac avatar cse-ocd avatar thibaudrobin avatar erk3 avatar snovvcrash avatar wlayzz avatar arnco avatar cyrinux avatar driikolu avatar fisjkars avatar megadose avatar naacbin avatar nodauf avatar p0dalirius avatar

Stargazers

Roman 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.