Skip to content

Commit 2ad9a1b

Browse files
committed
readme updated
1 parent ce91a87 commit 2ad9a1b

File tree

2 files changed

+43
-2
lines changed

2 files changed

+43
-2
lines changed

README.md

Lines changed: 43 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,43 @@
1-
# cs-discovery
2-
Finding CobalStrike fingerprint on the targets
1+
# Cobalt Strikes Discovery
2+
> Cobalt Strike is a commercial penetration testing tool, which gives security testers access to a large variety of attack capabilities.
3+
> This tool aims to detect Cobalt Strike servers by sending an encoded byte in the request to the server itself and, if the response is satisfactory, collects the server's JARM and looks for evidence of the target on the internet.
4+
> The construction of this project was based on a report prepared by MDSec named "How I Meet Your Beacon - Cobalt Strike".
5+
> The report can be seen [here](https://www.mdsec.co.uk/2022/07/part-2-how-i-met-your-beacon-cobalt-strike/)
6+
7+
## 👨‍💻 Installing
8+
9+
Clone the repository:
10+
```bash
11+
git clone https://github.com/eremit4/cs-discovery.git
12+
```
13+
Optional - Create a virtualenv before install the dependencies
14+
> Note: The use of virtual environments is optional, but recommended. In this way, we avoid possible conflicts in different versions of the project's dependencies.
15+
> Learn how to install and use virtualenv according to your OS [here](https://virtualenv.pypa.io/en/latest/)
16+
17+
Install the dependencies:
18+
```bash
19+
pip install -r requirements.txt
20+
```
21+
22+
## 🥷️ Using
23+
24+
Discovering the project capabilities:
25+
```bash
26+
python cs_discovery.py --help
27+
```
28+
29+
Running against a single target:
30+
```bash
31+
python cs_discovery.py --url <target>
32+
```
33+
34+
Running against multiple targets
35+
```bash
36+
python cs_discovery.py --file <filepath>
37+
```
38+
39+
## 🔮️ Demo
40+
![](./readme_demo.gif)
41+
42+
## 📝 License
43+
This project is under the [MIT License](LICENSE).

readme_demo.gif

26.5 MB
Loading

0 commit comments

Comments
 (0)