{"id":15063368,"url":"https://github.com/slayingripper/minibox","last_synced_at":"2026-01-28T08:15:21.859Z","repository":{"id":254454431,"uuid":"824705375","full_name":"Slayingripper/MiniBox","owner":"Slayingripper","description":"A Cheap miniture pentest trainer for Beginners ","archived":false,"fork":false,"pushed_at":"2024-12-02T13:49:25.000Z","size":176,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T09:46:41.165Z","etag":null,"topics":["arduino","ctf","cybersecurity","esp8266","hardware"],"latest_commit_sha":null,"homepage":"https://hackaday.io/project/197563-building-the-minibox-ctf-trainer-on-the-esp8266","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Slayingripper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-05T18:28:20.000Z","updated_at":"2024-12-02T13:49:29.000Z","dependencies_parsed_at":"2024-12-03T02:16:23.005Z","dependency_job_id":null,"html_url":"https://github.com/Slayingripper/MiniBox","commit_stats":{"total_commits":14,"total_committers":1,"mean_commits":14.0,"dds":0.0,"last_synced_commit":"a4546ce481c391b72a1859f97c30a29b9545f002"},"previous_names":["slayingripper/minibox"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Slayingripper%2FMiniBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Slayingripper%2FMiniBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Slayingripper%2FMiniBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Slayingripper%2FMiniBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Slayingripper","download_url":"https://codeload.github.com/Slayingripper/MiniBox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248203134,"owners_count":21064522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","ctf","cybersecurity","esp8266","hardware"],"created_at":"2024-09-24T23:55:43.420Z","updated_at":"2026-01-28T08:15:21.768Z","avatar_url":"https://github.com/Slayingripper.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MiniBox CTF Trainer\n![Images/minibox.jpg](Images/minibox.jpg)\n\n\n\nThis project is a Capture the Flag (CTF) training platform designed to run on an ESP8266 microcontroller. It offers a variety of challenges, including web-based puzzles, cryptographic tasks, and wireless network-related challenges. The purpose of this project is to provide an interactive way to practice CTF skills in a small, embedded environment.\n\n## Features\n\n- **LED Control**: Turn the onboard LED on or off via web API.\n- **Client Management**: Display the number of clients connected to the ESP8266 access point.\n- **Wireless Scanning**: Scan for available wireless networks.\n- **Buzzer Control**: Play a melody on a connected buzzer.\n- **Caesar Cipher Challenge**: Respond with a Caesar ciphered flag when accessing a specific endpoint.\n- **HTTP Authentication**: Optionally secure API endpoints with basic HTTP authentication.\n- **Dynamic Challenge Levels**: Switch between easy and hard difficulty levels.\n\n## Hardware Requirements\n\n- ESP8266 (e.g., NodeMCU or Wemos D1 Mini)\n- Buzzer (optional, for the sound challenge)\n- LEDs (optional, for the LED control challenge)\n\n## Software Requirements\n\n- Arduino IDE\n- ESP8266 Board Package for Arduino IDE\n- Libraries:\n  - `ESP8266WiFi.h`\n  - `ESP8266WebServer.h`\n\n## Installation\n\n1. **Clone the Repository**:\n   ```sh\n   git clone https://github.com/yourusername/MiniBox-CTF-Trainer.git\n   cd MiniBox-CTF-Trainer\n   ```\n\n2. Open the Project:\n3. Open the CTF.ino file in the Arduino IDE.\n\n4. Install Required Libraries:\nMake sure the ESP8266 board package and necessary libraries are installed in your Arduino IDE.\n\nUpload the Code:\nConnect your ESP8266 to your computer and upload the code.\n\n5. Connect to the ESP8266:\n\n    After uploading, the ESP8266 will create a Wi-Fi access point named MiniBox-CTF.\n    Connect to the access point using the password yourpassword.\n\nAccess the CTF Platform:\n\n    Open a web browser and navigate to http://192.168.4.1 to access the CTF interface.\n\n## API Endpoints\n/\n\n    Description: Displays the main CTF page with hints and ASCII art.\n    Method: GET\n\n## /api/led/on\n\n    Description: Turns on the onboard LED.\n    Method: GET\n\n## /api/led/off\n\n    Description: Turns off the onboard LED.\n    Method: GET\n\n## /api/clients\n\n    Description: Shows the number of connected clients and their MAC addresses.\n    Method: GET\n\n## /api/scan\n\n    Description: Scans for available Wi-Fi networks.\n    Method: GET\n\n## /api/buzzer/play\n\n    Description: Plays a melody on the buzzer.\n    Method: GET\n\n## /submitFlag\n\n    Description: Submits a CTF flag for validation.\n    Method: POST\n    Request: The flag should be sent in the request body as {\"flag\": \"FLAG_VALUE\"}.\n\n## /TimeNewRoman\n\n    Description: Responds with a Caesar cipher of a flag.\n    Method: GET\n\n## Challenge Levels\n\n    Easy Mode: All API endpoints are accessible without authentication.\n    Hard Mode: Randomized HTTP Basic Authentication is required to access the API endpoints.\n\n## Usage Example\n\n    Turn on the LED:\n        Make a GET request to /api/led/on.\n\n    Submit a Flag:\n        Make a POST request to /submitFlag with a JSON body:\n\n        json\n\n        {\n          \"flag\": \"FLAG_123\"\n        }\n\n    Caesar Cipher Challenge:\n        Access the /TimeNewRoman endpoint to receive a Caesar ciphered flag.\n\nHints\n\n    LED Challenge: Control the LED to solve the challenge.\n    Client Count: Check how many clients are connected. Hidden clues might be embedded in the response.\n    Buzzer Challenge: Listen closely to the melody played by the buzzer. There might be a clue!\n    Caesar Cipher: Try to decode the Caesar cipher to reveal the hidden flag.\n\nContributing\n\nContributions are welcome! Please fork the repository and submit a pull request with your changes.\n\n\n### TODO\n\n- [x] Add README.md\n- [ ] Add more challenges\n- [ ] Improve the web interface\n- [ ] Add a scoring system\n- [ ] refactor the code\n- [ ] inlude Schematic\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslayingripper%2Fminibox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslayingripper%2Fminibox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslayingripper%2Fminibox/lists"}