https://github.com/Sentinel-One/CobaltStrikeParser

https://github.com/Sentinel-One/CobaltStrikeParser

Last synced: 21 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/Sentinel-One/CobaltStrikeParser
• Owner: Sentinel-One
• License: other
• Created: 2020-05-05T08:04:43.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-12-19T13:26:51.000Z (12 months ago)
• Last Synced: 2024-08-05T17:36:45.847Z (4 months ago)
• Language: Python
• Size: 961 KB
• Stars: 978
• Watchers: 37
• Forks: 190
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-hacking-lists - Sentinel-One/CobaltStrikeParser - (Python)

README

        
# CobaltStrikeParser

Python parser for CobaltStrike Beacon's configuration

## Description

Use `parse_beacon_config.py` for stageless beacons, memory dumps or C2 urls with metasploit compatibility mode (default true).  

Many stageless beacons are PEs where the beacon code itself is stored in the `.data` section and xored with 4-byte key.  

The script tries to find the xor key and data heuristically, decrypt the data and parse the configuration from it.

This is designed so it can be used as a library too.

The repo now also includes a small commuincation module (comm.py) that can help with communcating to a C2 server as a beacon.  

## Usage

```

usage: parse_beacon_config.py [-h] [--json] [--quiet] [--version VERSION] beacon

Parses CobaltStrike Beacon's configuration from PE, memory dump or URL.

positional arguments:

  beacon             This can be a file path or a url (if started with http/s)

optional arguments:

  -h, --help         show this help message and exit

  --json             Print as json

  --quiet            Do not print missing or empty settings

  --version VERSION  Try as specific cobalt version (3 or 4). If not specified, tries both.

```

## Extra

To use the communication poc copy it to the main folder and run it from there.

For installing the M2Crypto library (a requirement for the poc) on Windows, it's easiest with installers found online, and not through pip.