red-cadets/beard

Attack/Defense CTF scoreboard parser

Beard - Attack/Defense CTF scoreboard parser

Language: English | Русский

Beard - a comfortable way to track progress of your team during A/D competitions

✨ Features

• Parsing of supported scoreboards (hackerdom/forcad)
• Score graph of all teams with automatic scaling for your team
• Primitive prediction of the score graph
• Flag loss graph for each service
• Graph of receiving flags for each service (similar to the effectiveness of exploits)
• Telegram alerts about flag loss, service status, place changing (use courier)

🛠 Supported scoreboards

A/D framework	Link	Status	Description
ForcAD	https://github.com/pomo-mondreganto/ForcAD	✅
HackerDom checksystem	https://github.com/HackerDom/checksystem	✅	parsing old-style view at /board

🙋 Table of Contents

• 📖 Fast Installation Guide
  • 🐋 Docker Usage
• 🖼️ Gallery
• 🎪 Community
• 📝 TODO

📖 Fast Installation Guide

🐳 Docker

Clone repository

git clone https://github.com/Red-Cadets/beard.git

Go to folder:

cd beard

Change .env with your settings:

• SCOREBOARD - Scoreboard location. Example: http://6.0.0.1/board
• TEAM - Team name or team IP to display information about. Example: Red Cadets or 10.10.1.15
• TYPE - Scoreboard type. Example: forcad or hackerdom
• BOT_URL - Telegram bot api address (webhook) for notification. For easy bot integration, use courier. Message format:

{
    "message": "Notification here",
    "type": "markdown",
    "id": "parser",
    "to": "tg chat id here"
}

• ROUND_TIME - Round time in seconds. For example: 120
• EXTEND_ROUND - The number of rounds to predict future graph. The prediction is based on the points of the last 5 rounds. For example: 10
• MONGO_USER - DB username. Например: parser
• MONGO_PASS - DB password. Например: parser Run docker-compose:

docker-compose up -d

and go to URL

http://127.0.0.1:65005/

🖼️ Gallery

Graph of scores of all teams on the scoreboard
Flag loss graph
Graph of receiving flags
Telegram alerts

🎪 Community

If you have any feature suggestions or bugs, leave a Github issue. Open to pull requests and other forms of collaboration!

We communicate over Telegram. Click here to join our Telegram community!

📝 TODO

Open to ideas!

❤️ Thanks to

Hackerdom parser is based on https://github.com/Vindori/hackerdom-board-parser

beard's Issues

Add the board

Please add a board to the beard using forcad board style
Also it will be good if you will use header style too