Cygor

Présentation générale

Cygor est un framework modulaire de découverte d'actifs qui réunit le scan, l'analyse et l'énumération de services dans un seul flux de travail. Il remplace la juxtaposition d'outils séparés par un processus automatisé qui gère la découverte, l'enrichissement et l'énumération ciblée de manière fluide — réduisant la charge manuelle et vous permettant de vous concentrer sur les résultats plutôt que sur la gestion des outils.

L'interface Web de Cygor transforme le chaos des données de scan brutes en un centre de commandement visuel unique. Au lieu de parcourir d'innombrables fichiers XML, JSON ou texte brut, les résultats sont automatiquement analysés, enrichis et affichés dans un espace unique conçu pour un tri rapide et une prise de décision efficace.

Propulsé par FastAPI et Bootstrap 5, le tableau de bord permet facilement de :

• Voir la vue d'ensemble en un coup d'œil — les compteurs et résumés révèlent les distributions de services, les tendances des codes de statut et les empreintes OS.
• Plonger en profondeur instantanément — passer des métriques globales aux détails par hôte, ports et résultats de modules en un simple clic.
• Visualiser l'exposition — L'un des modules de Cygor, appelé Lockon, prend des captures d'écran des services Web actifs et les résultats sont intégrés directement, offrant un contexte immédiat sans quitter le tableau de bord.
• Rester organisé pendant le tri — marquer les résultats examinés ou non, filtrer et trier les résultats, et cibler les actifs à plus forte valeur.

L'interface Web n'est pas seulement une question de présentation — elle vise l'efficacité et la clarté. En regroupant toutes les données collectées dans un espace de travail interactif unique, elle réduit le temps passé à analyser des fichiers ou à recouper les sorties, et permet aux testeurs de se concentrer sur l'essentiel : comprendre l'environnement et agir en conséquence.

Pourquoi ce nom, Cygor ?

Une grande partie des outils, techniques et méthodes que je crée est inspirée de l'univers Spawn. Si vous n'avez jamais lu de comics Spawn, pas de souci : je vais vous expliquer pourquoi j'ai choisi ce personnage pour nommer cet outil.

Le nom Cygor s'inspire de Cy-Gor, un anti-héros tragique de l'univers Spawn. Anciennement Michael Konieczny — un agent gouvernemental et ami proche d'Al Simmons — il a tenté de révéler la corruption après le meurtre de Simmons. Cependant, il a été capturé et contraint de participer au projet Sim, les expériences simiennes du Dr Frederick Willheim, où le corps d'un gorille a été fusionné à l'esprit de Konieczny grâce à des cybernétiques invasives. Le résultat fut la bête connue sous le nom de Cy-Gor — abréviation de Cybernetic Gorilla.

Après s'être échappé de sa captivité, Cy-Gor s'est livré à des raids violents, dévastant même des centres de données gouvernementaux dans des accès de confusion et de rage. Bien qu'il ait été traqué et repris à plusieurs reprises, il a finalement riposté contre les systèmes qui cherchaient à le contrôler — retirant ses implants de localisation et s'affranchissant pour tracer sa propre voie, déchiré entre la machine, la bête et l'homme.

• Référence : https://www.spawnworld.com/encyclopedia/cygor.htm

Qui devrait utiliser Cygor ?

• Équipes rouges & pentesteurs – Automatisez la découverte, rationalisez l'énumération et conservez le contexte lors de grandes missions
• Équipes bleues & administrateurs systèmes – Découvrez des actifs inconnus, validez les inventaires et repérez les erreurs de configuration qui élargissent la surface d'attaque.
• Chercheurs en sécurité – Analysez et traitez rapidement les données de scan pour identifier les tendances, les services négligés et les anomalies récurrentes.
• Étudiants & formateurs – Apprenez les techniques réelles de reconnaissance et d'énumération dans un environnement structuré et reproductible.

Outils utilisés par Cygor :

• Nmap – Détection fiable des services et versions ; la sortie XML est analysée en données structurées hôtes/services.
• Masscan – Scan de ports à haute vitesse pour une découverte rapide sur de grands réseaux.
• Naabu – Scanner de ports TCP simple et rapide qui complète les flux de travail Masscan/Nmap.
• Playwright – Moteur d'automatisation de navigateur utilisé par Lockon pour capturer des captures d'écran Web.
• Découverte de contenu Web – ffuf, feroxbuster, gobuster et dirsearch sont orchestrés en parallèle par le module webenum (seuls les outils installés sont exécutés).
• Outils d'énumération de services – rpcclient/polenum (MSRPC), ldapsearch/ldapdomaindump (LDAP), snmpwalk/onesixtyone (SNMP), dig/dnsrecon (DNS) et showmount (NFS) alimentent les modules explorateurs ; chaque module s'ignore proprement si son outil est absent.
• Bibliothèques Python – (requests, colorama, SQLModel, etc.) pour l'analyse, l'enrichissement, le formatage des sorties et la gestion de la base de données.

Installer Cygor

Plusieurs méthodes sont prises en charge pour installer Cygor : pip, pipx, uv et docker.

Installation avec pipx

Certaines dépendances (par exemple gssapi pour Kerberos/WinRM) compilent des extensions C, installez donc d'abord la chaîne d'outils de compilation et les en-têtes 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 .

Déployer Cygor avec Docker

L'installation Docker de Cygor comprend à la fois l'application et un service de base de données PostgreSQL. Le système bascule automatiquement vers SQLite si PostgreSQL n'est pas disponible.

Démarrage rapide

Production (recommandé) :

# 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

Développement (avec le code source monté) :

# 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

Services Docker Compose

La configuration Docker Compose comprend :

• Service PostgreSQL : Base de données configurée automatiquement (bascule sur SQLite si indisponible)
• Service Cygor : Interface Web et application
• Détection automatique des ports : Vérifie les conflits de ports et utilise des ports alternatifs si nécessaire
• Volumes persistants :
  • results/ : Sorties de scan, résultats credrecon et fichiers de base de données
  • cygor-config/ : Volume de configuration local (créé automatiquement)

Configuration des ports

Par défaut :

• Production : PostgreSQL exposé sur le port hôte 5432 (si disponible)
• Développement : PostgreSQL exposé sur le port hôte 5434 (si disponible)
• Interne : Les conteneurs utilisent toujours le port 5432 en interne (réseau Docker)

Si les ports sont déjà utilisés, vous pouvez :

1. Utiliser le script wrapper (recommandé - détecte automatiquement les ports disponibles) :

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

2. Définir le port manuellement :

   export POSTGRES_HOST_PORT=5435
   docker compose up --build
   

3. Supprimer le mappage de ports (si vous n'avez pas besoin d'un accès PostgreSQL externe) : Commentez la section ports: dans docker-compose.yaml

Construction manuelle de l'image Docker

Pour construire l'image Docker manuellement :

docker build -t cygor .

Exécutez un conteneur unique (sans service PostgreSQL) :