Cygor

Descripción General

Cygor es un framework modular de descubrimiento de activos que reúne escaneo, análisis y enumeración de servicios en un solo flujo de trabajo. Reemplaza el mosaico de herramientas separadas por un proceso automatizado que gestiona el descubrimiento, el enriquecimiento y la enumeración dirigida sin fricciones, reduciendo la carga manual y permitiéndote centrarte en los resultados en lugar de en la gestión de herramientas.

La interfaz web de Cygor toma el caos de los datos de escaneo sin procesar y lo organiza en un único centro de mando visual. En lugar de revisar interminables XML, JSON o texto plano, los resultados se analizan, enriquecen y muestran automáticamente en un espacio diseñado para una clasificación rápida y la toma de decisiones.

Impulsado por FastAPI y Bootstrap 5, el panel facilita:

• Ver el panorama general de un vistazo: contadores y resúmenes revelan distribuciones de servicios, tendencias de códigos de estado y huellas de sistemas operativos.
• Profundizar al instante: pasar de métricas de alto nivel a detalles por host, puertos y resultados de módulos con un solo clic.
• Visualizar la exposición: uno de los módulos de Cygor, llamado Lockon, captura capturas de pantalla de los servicios web activos y los resultados se incrustan directamente, ofreciendo contexto inmediato sin salir del panel.
• Mantener la organización durante la clasificación: marcar hallazgos revisados frente a no revisados, filtrar y ordenar resultados, y centrarse en los objetivos de mayor valor.

La interfaz web no es solo para la presentación: se trata de eficiencia y claridad. Al reunir todos los datos recopilados en un único espacio de trabajo interactivo, reduce el tiempo dedicado a analizar archivos o conciliar salidas y permite a los evaluadores centrarse en lo que importa: comprender el entorno y actuar en consecuencia.

¿Por qué se llama Cygor?

Muchas de las herramientas, técnicas y procedimientos que creo están inspirados en el Universo Spawn. Si nunca has leído un cómic de Spawn, no pasa nada, porque compartiré algo de información sobre por qué elegí a este personaje como nombre de esta herramienta.

El nombre Cygor proviene de Cy-Gor, un trágico antihéroe del universo Spawn. Antaño Michael Konieczny —un operativo gubernamental y amigo cercano de Al Simmons— intentó exponer la corrupción tras el asesinato de Simmons. Sin embargo, fue capturado y obligado a participar en el Proyecto Sim, los experimentos simiescos del Dr. Frederick Willheim, donde el cuerpo de un gorila se fusionó con la mente de Konieczny mediante cibernética invasiva. El resultado fue la bestia conocida como Cy-Gor, abreviatura de Gorila Cibernético.

Tras escapar del cautiverio, Cy-Gor protagonizó violentos desmanes, llegando incluso a arrasar centros de datos gubernamentales en ataques de confusión y furia. Aunque fue cazado y recapturado en múltiples ocasiones, finalmente se rebeló contra los sistemas que buscaban controlarlo: eliminó los implantes de seguimiento y se liberó para forjar su propio camino, dividido entre la máquina, la bestia y el hombre.

• Referencia: https://www.spawnworld.com/encyclopedia/cygor.htm

¿Quién debería usar Cygor?

• Equipos rojos y pentesters: automatizar el descubrimiento, agilizar la enumeración y mantener el contexto en proyectos de gran envergadura.
• Equipos azules y administradores de sistemas: descubrir activos desconocidos, validar inventarios y detectar malas configuraciones que amplían la superficie de ataque.
• Investigadores de seguridad: analizar y procesar rápidamente datos de escaneo para identificar tendencias, servicios pasados por alto y anomalías con patrones.
• Estudiantes e instructores: aprender técnicas reales de reconocimiento y enumeración en un entorno estructurado y repetible.

Herramientas que usa Cygor:

• Nmap: detección fiable de servicios y versiones; la salida XML se analiza y se convierte en datos estructurados de hosts y servicios.
• Masscan: escaneo de puertos de alta velocidad para el descubrimiento rápido en grandes redes.
• Naabu: escáner de puertos TCP simple y rápido que complementa los flujos de trabajo de Masscan/Nmap.
• Playwright: motor de automatización de navegadores que Lockon utiliza para capturar capturas de pantalla web.
• Descubrimiento de contenido web: ffuf, feroxbuster, gobuster y dirsearch se orquestan en paralelo mediante el módulo webenum (solo se ejecutan las herramientas instaladas).
• Herramientas de enumeración de servicios: rpcclient/polenum (MSRPC), ldapsearch/ldapdomaindump (LDAP), snmpwalk/onesixtyone (SNMP), dig/dnsrecon (DNS) y showmount (NFS) respaldan los módulos exploradores; cada módulo se omite limpiamente si su herramienta no está presente.
• Bibliotecas de Python: (requests, colorama, SQLModel, etc.) para análisis, enriquecimiento, formato de salida y gestión de bases de datos.

Instalación de Cygor

Hay varios métodos compatibles para instalar Cygor: pip, pipx, uv y docker.

Instalación con pipx

Algunas dependencias (por ejemplo, gssapi para Kerberos/WinRM) compilan extensiones de C, así que instala primero el conjunto de herramientas de compilación y los encabezados de Kerberos:

# Debian/Ubuntu/Kali:
sudo apt install -y build-essential python3-dev libkrb5-dev

# Stable version:
pipx install cygor

# Install from source:
git clone https://github.com/tjnull/cygor
cd cygor
pipx install .

Despliegue de Cygor con Docker

La configuración de Docker de Cygor incluye tanto la aplicación como un servicio de base de datos PostgreSQL. El sistema recurre automáticamente a SQLite si PostgreSQL no está disponible.

Inicio rápido

Producción (recomendado):

# Option 1: Use the wrapper script (automatically handles port conflicts)
./docker-compose-up.sh up --build

# Option 2: Direct docker compose (uses default ports)
docker compose up --build

Desarrollo (con el código fuente montado):

# Option 1: Use the wrapper script (automatically handles port conflicts)
./docker-compose-up.sh dev up --build

# Option 2: Direct docker compose (uses default ports)
docker compose -f docker-compose-dev.yaml up --build

Servicios de Docker Compose

La configuración de Docker Compose incluye:

• Servicio PostgreSQL: base de datos configurada automáticamente (recurre a SQLite si no está disponible)
• Servicio Cygor: interfaz web y aplicación
• Detección automática de puertos: comprueba conflictos de puertos y utiliza puertos alternativos si es necesario
• Volúmenes persistentes:
  • results/: salidas de escaneo, resultados de credrecon y archivos de base de datos
  • cygor-config/: volumen de configuración local (creado automáticamente)

Configuración de puertos

Por defecto:

• Producción: PostgreSQL expuesto en el puerto 5432 del host (si está disponible)
• Desarrollo: PostgreSQL expuesto en el puerto 5434 del host (si está disponible)
• Interno: los contenedores siempre usan el puerto 5432 internamente (red de Docker)

Si los puertos están en uso, puedes:

1. Usar el script contenedor (recomendado: detecta automáticamente los puertos disponibles):

   ./docker-compose-up.sh up --build
   

2. Establecer el puerto manualmente:

   export POSTGRES_HOST_PORT=5435
   docker compose up --build
   

3. Eliminar la asignación de puertos (si no necesitas acceso externo a PostgreSQL): comenta la sección ports: en docker-compose.yaml

Compilación manual de Docker

Para compilar la imagen de Docker manualmente:

docker build -t cygor .

Ejecutar un solo contenedor (sin el servicio PostgreSQL):