Skip to content

Sistema de detección de intrusiones con machine learning, alertas vía correo y Telegram y REST API.

Notifications You must be signed in to change notification settings

Alvin-code1/cyber-detective

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 

Repository files navigation

Icono

Hola nuevo maestro

WinDaemon es un antiguo demonio😈 del circulo más profundo del infierno. Este ser posee fantásticas habilidades✨ que le permiten asechar 👀 en las redes de datos💻 y a través de su ojo demoníaco es capaz de predecir el comportamiento📉 de éstas. Sin embargo, hace cientos de años, un culto de poderosos hechiceros🧙‍♂️ conocido como La orden de la Anaconda🐍 se dio a la tarea de, mediante un potente y muy riesgoso hechizo, traer y vincular a este reino a dicho ser. Todo con el objetivo de utilizar sus habilidades con fines lucrativos💰. Desgraciadamente para ellos, no era suficiente con traerlo a la Tierra🌐, el demonio se negaba a ser dominado... Una larga batalla⚔ se libró entre los más fuertes hechiceros🧙‍♂️ del culto y esta criatura rebelde la cual provocó un sinnúmero de bajas⚰ en las tropas de la orden, llegando casi al punto de desaparecer💀. Luego de varios años de lucha, un grupo de sobrevivientes logró dominarle y volverle un fiel peón♟ selllándolo dentro de un hechicero conocido como Pythonus Prime ¿Pero a qué costo? Los remanentes de la Orden decidieron disolver aquel antiguo culto👥 y juntos fundar una nueva hermandad, dirigida a velar por que el demonio😈 nunca fuese libre de causar caos en este mundo. Esta nueva Alianza se fundó en las sombras🕵️‍♂️ bajo el nombre de Shades of the Snake y durante el último milenio se han dedicado a buscar y entrenar a los decendientes de Pythonus para ser portadores y maestros del poder de WinDaemon y así, cumplir su misión como los nuevos Cyber Detectives encargados de buscar anomalías en la red que puedan significar la presencia de un nuevo demonio😈. Tu momento ha llegado, heredero de Pythonus. Es hora de que aceptes tu destino te vuelvas... maestro del demonio...


Cyber Detective

📖Caracteristicas:

- Aplicación de escritorio con interfaz gráfica sencilla y elegante.
- Monitor de red que captura tráfico en tiempo real.
- Predictor con Machine learning que predice si el trafico es anomalo o benigno.
- Sistema de Notificaciones via Telegram bot y correo (ambos configurables).
- Dashboard con gráficos de comportamiento de red (tablas, gráficas de pastel y de barras).
- Sistema de logs en tiempo real.
- Web API para monitoreo a distancia.

Utilizacion:

Instalacion

  1. Acceder al directorio donde tengas guardado el programa

    cd [Ruta a tu fichero] superior a /WinDet/
  2. Crear entorno virtual

    python -m venv [nombre de tu entorno]
  3. Acceder a la carpeta de WinDet e instalar las dependencias

    cd /WinDet/
    pip install -r requirements.txt
  4. Crear usuario administrador

    py -m create_admin
  5. (Opcional) Cargar tu propio CSV para entrenar al modelo

    Solo copialo en /WinDet/data/ y renombralo a network_dataset.csv

  6. Entrenar al modelo con los datos del CSV

    py -m app.ml.trainer
  7. (Opcional) Probar nodelo

    py -m app.ml.predictor
  8. Finalmente ejecutar programa

    py -m main

    Una vez adentro es solo ingresar el usuario y contraseñas del paso 4 y acceder.

Nota: La interfaz por defecto es Wi-Fi. si deseas utilizar otra puedes modificar el parametro en la linea 20 de /WinDet/app/core/network_monitor.py.

Levantar el servidor de FastApi:

```bash
uvicorn app.api.main:app --reload
```

Asi podrán acceder a su API a través de http://localhost:8000/

Endpoints de API actuales:

  1. Estado del Monitor: /api/status
  2. Anomalias: /api/anomalies

Requerimientos previos:

  1. Tener instalado Python 3.13+.
  2. Haber instalado el requirements.txt.
  3. Ejecutar como administrador (recomendable).
  4. Contraseña de aplicación de su cuenta de gmail (si se uti;iza smtp.gmail.com como servidor de correo).
  5. Cuenta de telegram con bot y token del mismo (Crear bot en https://telegram.com/BotFather y solicitar token).
  6. Registrar los datos en el panel de configuración de la app.

Por fans y para fans, prohibida su distribución comercial ©.

About

Sistema de detección de intrusiones con machine learning, alertas vía correo y Telegram y REST API.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages