Giter Site home page Giter Site logo

discordgo's Introduction

DiscordGo

Version Language Go Report Card nil

Discord C2 for Redteam engagement....Need a better name. If you can think of one, please tell me. :)

Not to be confused with DiscordGo library which I use for the backend.

Why I made this

During Blue-Red Team competition, I needed an easy and fast way to keep connected and a way for mutiple redteamer to run commands, hence DiscordGo. Since Discord is getting popular, why not use the platorm as a c2. That's what this project is about.

Installation

To use DiscordGo, you need to create a Discord bot and a Discord server. After that, invite the bot to your server.

Click here to learn how to create a server and here to create a bot. And finally, learn to invite the bot to your server with this.

When creating the bot, you need it give it some permission. For testing, I gave the bot full administrative permission. But the required permission are as follow:

  • Send Messages
  • Read Messages
  • Attach Files
  • Manage Server

Usage

Edit this file pkg/util/variables.go with your BotToken and ServerID. Or create the file if not there

The bot token can be found on discord developer dashboard where you created the bot. To get your server ID, go to your server setting and click on widget. On the right pane, you see the your ID.

An example configuration file looks like this:

var ServerID = "XXXXXXXXXXX"
var BotToken = "XXXXXXXXXXX"

After that is done, all you have to do is run make. That will create 3 binaries.

- linux-agent
- windows-agent.exe
- macos-agent

Organizer Bot

When you have target connecting back to your discord server, channels are created by their ip addresses. This can quickly get hard to manage. Solution: Another bot to organize the targets channels.

To use the organizer bot, run the csv generator script in the scripts folder:

$ pip3 install -r requirements.txt
$ python3 csv_generator.py

This will create a csv like this:

192168185200,team01,hostname1,windows
192168185201,team02,hostname2,linux

To start the organizer bot: go run cmd/organizer/main.go -f <csv_filename>.csv

Run clean in any channel to organize bots into their respective categories.

Feature

  • Cross-platform
  • Organozer(talk about and intergration to pwnboard)

WIP (Work in Progress)

  • Cross-platform
  • File upload
  • File download
  • Agent grouping(by hostname like web hosts and so on, slash command)
  • Group commands
  • Add logging to organizer
  • Comp CSV Generation file
  • Integrate with pwndrop

Screenshots

Co-Authors

Disclamers

The author is in no way responsible for any illegal use of this software. It is provided purely as an educational proof of concept. I am also not responsible for any damages or mishaps that may happen in the course of using this software. Use at your own risk.

Every message on discord are saved on Discord's server, so be careful and not upload any sensitive or confidential documents.

Used Libraries

Inspired by SierrOne

Logo by @BradHacker(https://github.com/BradHacker)

discordgo's People

Contributors

emmaunel avatar frybin avatar d3adzo avatar smash8tap 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.