Eruditus - Discord CTF helper bot

项目说明

Eruditus - CTF helper bot

<p align="center">
<a href=" src=" alt="Python 3.12+"></a>
<a href=" src=" alt="Discord Slash Commands"></a>
<a href=" src=" alt="CI Status"></a>
<a href=" src=" alt="pre-commit"></a>
<a href=" src=" alt="MIT License"></a>
</p>
<br/>
<p align="center">
<img src=" alt="Logo" width="200">
<h3 align="center">Eruditus - CTF helper bot</h3>
</p>

About

Eruditus is a Discord CTF helper bot built with Python, it was initially designed to be
used internally within the CyberErudites CTF team in order to make team work as efficient
as possible.
The bot implements a bunch of useful features and uses Discord's Slash commands to
make its usage as intuitive as possible.

Features

Core functionalities

Manage channels and their permissions

Create Discord scheduled events for upcoming CTF competitions

Track CTFs progress

Track members' participation in challenges

Announcements upon solving a challenge

Flag submission from within the Discord guild

and more.

Miscellaneous

Provides a utility to lookup system calls from a specific architecture

Provides a utility for basic encoding schemes

Provides a utility for classic ciphers

Provides a reverse shell payload generator

Supported platforms

As you already read this bot can interact with the CTF platforms, meaning that you can:

Submit your flags within the bot

Observe the leaderboard

Automatically parse challenges from the platform

Automatically create team accounts on the platform (or use already existing ones)

And many more

Currently, Eruditus supports these platforms:

CTFd

rCTF

_You can check out our abstract interfaces if you wish to add support for a new platform_

Usage

Here's a list of the currently supported commands:

Installation

Before proceeding with the installation, you may want to setup a repository to host Discord chat logs for archived CTFs that you no longer want to have on your Discord guild. Follow these instructions if you wish to do so:
1. Create a private GitHub repository to host your chat logs.
2. Clone this project into your pre created GitHub repository.
3. Modify line 37 of the Dockerfile to point to your private GitHub repository that will host the chat logs.
4. Prepare an SSH key pair to access your private GitHub repository, and put the private key under .ssh/privkey.pem. As for the public key, under your repository settings in the Deploy keys section, click on Add deploy key and paste your SSH public key (make sure to tick the Allow write access box).

The sample GitHub repository already has a workflow for publishing the website to Azure App Service, but you're free to host it somewhere else, or simply keep it in the GitHub repository. If you're willing to use Azure, make sure to add the necessary secrets and referenced inside the workflow.

---

Follow the instructions below to deploy the bot:

1. Go to the Discord De Portal.
2. Create a new application.
3. Go to the Bot pane and add a bot for your application.
4. Enable Ser Intent and Message Content Intent under
Pri Gateway Intents.
5. Put your configuration to the eruditus/.env file by using the .en template.
6. Deploy the bot using docker-compose up -d --build.
7. Go to the OAuth2 URL Generator pane, tick bot and applications.commands
under the Scopes section, tick Administrator under the Bot Permissions
section and copy the generated link.
8. Invite your bot to the guild using the generated link.
9. Enjoy.

Contribution Guidelines

Please consider reading our Contribution Guidelines before
making a contribution.

License

Distributed under the MIT License. See LICENSE for more information.

项目信息

开发语言：Python

Star 数：78

技术要点

该项目属于CTF思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Discord CTF helper bot展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。