Skip to content

Commit

Permalink
v2.0
Browse files Browse the repository at this point in the history
  • Loading branch information
capt-meelo committed Aug 10, 2021
1 parent 4da0c78 commit 98aa5c6
Show file tree
Hide file tree
Showing 14 changed files with 259 additions and 57 deletions.
70 changes: 58 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,33 +5,79 @@
[![stars](https://img.shields.io/github/stars/capt-meelo/Beaconator)](/~https://github.com/capt-meelo/Beaconator/stargazers)
[![forks](https://img.shields.io/github/forks/capt-meelo/Beaconator?color=yellow)](/~https://github.com/capt-meelo/Beaconator/network)

Beaconator is an aggressor script for Cobalt Strike used to generate a raw **stageless** shellcode and packing the generated shellcode using [PEzor](/~https://github.com/phra/PEzor).
Beaconator is an aggressor script for Cobalt Strike used to generate either **staged** or **stageless** shellcode and packing the generated shellcode using your tool of choice.

Currently, it supports the following tools:

## How to Use
**Installing PEzor**
**Staged Beacon Generator**
- [Alaris](/~https://github.com/cribdragg3r/Alaris)

[PEzor](/~https://github.com/phra/PEzor) is required so install it first using the following:
**Stageless Beacon Generator**
- [PEzor](/~https://github.com/phra/PEzor)
- [ScareCrow](/~https://github.com/optiv/ScareCrow)



# How to Use
## Beaconator
1. Load the `beaconator.cna` file via `Cobalt Strike > Script Manager`.
2. Access Beaconator from the menu bar by clicking the `Generate Beacon` menu.

## Staged Beacon Generator
### Alaris
1. Clone the repo.
```
git clone /~https://github.com/cribdragg3r/Alaris.git
```
2. Open `beaconator.cna` and change the value of the `$ALARIS_DIR` variable and point it to where **Alaris** is located.


## Stageless Beacon Generator
### PEzor
1. Install **PEzor** using the following:
```
git clone /~https://github.com/phra/PEzor.git
cd PEzor
./install.sh
```
> ***NOTE:** Make sure to add PEzor's `$PATH` variable in your `~/.profile` or `~/.bashrc` (if using Bash), **OR** `~/.zprofile` or `~/.zshrc` (if using ZSH).*
2. Add PEzor's `$PATH` variable in your `~/.profile` or `~/.bashrc` (if using Bash), **OR** `~/.zprofile` or `~/.zshrc` (if using ZSH).

### ScareCrow
1. Install the dependencies.
```
sudo apt update -y && sudo apt install -y openssl osslsigncode mingw-w64
go get github.com/fatih/color
go get github.com/yeka/zip
go get github.com/josephspurrier/goversioninfo
```
2. Clone the repo and build ScareCrow.
```
git clone /~https://github.com/optiv/ScareCrow.git
cd ScareCrow
go build ScareCrow.go
```
3. Open `beaconator.cna` and change the value of the `$SCARECROW_DIR` variable and point it to where **ScareCrow** is located.

**Running Beaconator**

1. Load the `beaconator.cna` file via `Cobalt Strike > Script Manager`.
2. Access Beaconator from the menu bar.

# Screenshots
### Beaconator
![option-staged.png](./images/option-staged.png "Staged Option") ![option-stageless.png](./images/option-stageless.png "Stageless Option")

## Screenshots
### Alaris
![alaris-options.png](./images/alaris-options.png "Alaris Options")
![alaris-console.png](./images/alaris-console.png "Alaris Console Output")

![options.png](./images/options.png "Pop Up Menu")
### PEzor
![pezor-options.png](./images/pezor-options.png "PEzor Options")
![pezor-console.png](./images/pezor-console.png "PEzor Console Output")

![script-console.png](./images/script-console.png "Script Console Output")
### ScareCrow
![scarecrow-options.png](./images/scarecrow-options.png "ScareCrow Options")
![scarecrow-console.png](./images/scarecrow-console.png "ScareCrow Console Output")


## Credits
- To **Francesco Soncina** ([@phraaaaaaa](https://twitter.com/phraaaaaaa)) for developing the awesome [PEzor](/~https://github.com/phra/PEzor).
- [@JFaust_](https://twitter.com/JFaust_) for developing [Alaris](/~https://github.com/cribdragg3r/Alaris).
- [@phraaaaaaa](https://twitter.com/phraaaaaaa/) for developing [PEzor](/~https://github.com/phra/PEzor).
- [@Tyl0us](https://twitter.com/Tyl0us) for developing [ScareCrow](/~https://github.com/optiv/ScareCrow).
Loading

0 comments on commit 98aa5c6

Please sign in to comment.