https://github.com/ignacypolak1/tr4pnode

Infrastructure for cybersecurity research, based on Cowrie honeypot, with real-time connections visualization
https://github.com/ignacypolak1/tr4pnode

Last synced: 2 months ago
JSON representation

Infrastructure for cybersecurity research, based on Cowrie honeypot, with real-time connections visualization

• Host: GitHub
• URL: https://github.com/ignacypolak1/tr4pnode
• Owner: ignacypolak1
• License: mit
• Created: 2025-03-23T13:06:11.000Z (3 months ago)
• Default Branch: master
• Last Pushed: 2025-04-08T16:15:17.000Z (2 months ago)
• Last Synced: 2025-04-08T17:26:59.585Z (2 months ago)
• Language: TypeScript
• Homepage:
• Size: 247 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 🌍 Tr4pNode – Cyberthreat Research Platform (WIP)

Tr4pNode is a lightweight, hackable, and open-source honeypot platform built for real-time cyberthreat research and visualization. Designed with modularity and education in mind, it empowers users to analyze malicious activity, experiment with DevSecOps practices, and showcase attack data in public demonstrations.

Under the hood, Tr4pNode combines Cowrie for SSH honeypot logging, MongoDB for structured data storage, and Grafana (enhanced with the Infinity plugin) for flexible dashboard-based data exploration. You can inspect session metadata through custom dashboards or watch attacks unfold live on a sleek, animated 3D globe – turning raw intrusion logs into powerful visual insights.

---

## 🔥 What It Does?

- Captures unauthorized SSH activity via **Cowrie** and stores data in **MongoDB**

- Visualizes sessions as animated arcs between attacker and honeypot server location on a **3D globe** using **three-globe**

- Uses **Grafana dashboards** for session metadata visualization and research purposes

Offers full flexibility for research, visualization, and educational use cases

---

## 📡 MVP Components

- Cowrie (SSH Honeypot) – exposes fake SSH services to attract and log attackers

- MongoDB – stores structured logs for both visualization and analytics

- Backend (Python + FastAPI) – handles API for Grafana and WebSocket data stream for the frontend

- Frontend (React + TypeScript + TailwindCSS) – renders the animated globe and real-time session events

- Grafana – provides powerful dashboards using Infinity plugin connected to backend API (MongoDB data)

---

## 🖥️ Architecture

![Globe Preview](img/structure.png)

---

## 🛰️ Live Sessions Geolocation View

![Globe Preview](img/globe.gif)

---

## ⚠️ Legal Disclaimer

This project is provided **for educational and research purposes only**.  

The authors and contributors take **no responsibility** for any use of this software.  

Do not deploy this in environments where it could interfere with production systems or violate legal boundaries.

This system is a research-oriented honeypot. All connections are automatically logged for the sole purpose of statistical and cybersecurity analysis.

No effort is made to identify individuals. The tool does not associate IP addresses with any user accounts, names, or personal information.

IP-based data is used solely for research, geolocation-based visualization, and threat intelligence.

---

## 🧩 Built With / Credits

Tr4pNode is built using a combination of powerful and open-source technologies:

- [**Cowrie**](https://github.com/cowrie/cowrie) – SSH and Telnet honeypot used for logging unauthorized access attempts.

- [**MongoDB**](https://www.mongodb.com/) – NoSQL document database for storing structured honeypot session data.

- [**FastAPI**](https://github.com/tiangolo/fastapi) – High-performance web framework powering the backend and WebSocket API.

- [**Motor**](https://github.com/mongodb/motor) – Asynchronous MongoDB driver for Python.

- [**httpx**](https://github.com/encode/httpx) – Async HTTP client used for IP geolocation.

- [**React**](https://react.dev/) + [**TypeScript**](https://www.typescriptlang.org/) – Modern frontend for the globe visualization.

- [**TailwindCSS**](https://tailwindcss.com/) – Utility-first CSS framework for clean, responsive UI.

- [**three-globe**](https://github.com/vasturiano/three-globe) – WebGL globe visualization for animated session arcs.

- [**three.js**](https://threejs.org/) – Core 3D rendering engine powering the globe.

- [**Grafana**](https://grafana.com/) – Interactive dashboard and observability platform.

- [**Grafana Infinity Plugin**](https://github.com/yesoreyeram/grafana-infinity-datasource) – JSON/CSV backend API visualizations without database drivers.

- [**Docker**](https://www.docker.com/) + [**Docker Compose**](https://docs.docker.com/compose/) – Containerized deployment of all services.

- [**Terraform**](https://www.terraform.io/) – Infrastructure-as-code for automated deployments.

- [**Nginx**](https://www.nginx.com/) – Reverse proxy for frontend/backend communication.

- [**Vite**](https://vitejs.dev/) – Fast build tool and dev server for frontend development.

- [**Python**](https://www.python.org/) – Core programming language powering the backend and data processing.

## Special thanks to all contributors and maintainers of these tools – you're the real MVPs 🙏