https://github.com/kyle6012/bluex
A safe educational framework for learning Bluetooth pentest workflows.
https://github.com/kyle6012/bluex
bash bluetooth ethical-hacking python red-teaming
Last synced: 10 months ago
JSON representation
A safe educational framework for learning Bluetooth pentest workflows.
- Host: GitHub
- URL: https://github.com/kyle6012/bluex
- Owner: Kyle6012
- License: mit
- Created: 2025-09-08T07:29:14.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-08T07:34:32.000Z (10 months ago)
- Last Synced: 2025-09-08T09:26:25.169Z (10 months ago)
- Topics: bash, bluetooth, ethical-hacking, python, red-teaming
- Language: Python
- Homepage:
- Size: 36.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Blue-X Safe Simulation Pack
**Author:** Meshack Bahati Ouma
**Purpose:** A _safe_ educational framework for learning Bluetooth pentest workflows.
This package intentionally avoids radio transmissions or exploit code. It provides:
- A smart installer that maps packages per distro and installs only benign dependencies.
- Simulation modules that emulate MITM, pairing, and fuzzing flows and generate JSON/CSV session reports.
- A simple Flask-based HTML dashboard to view session reports.
- `--safe` mode and clear warnings.
Use this in classrooms and labs to practice workflows, reporting, and analysis. Do NOT use on real targets without authorization.
## Instructor Lock Setup
To set the instructor password (required to enable Attack Mode helper):
```
python3 tools/instructor_manage.py
```
To check a password:
```
python3 tools/instructor_manage.py check
```
All Attack Mode uses are audited to `sessions/audit.log`.
## New Features: Per-org dashboards, SIEM export scheduling, LDAP/SSSD guide
See docs/deployment_guide.md and docs/ldap_sssd_ad.md