Cygor

Allgemeine Übersicht

Cygor ist ein modulares Asset-Discovery-Framework, das Scannen, Parsen und Service-Enumeration in einem Workflow vereint. Es ersetzt das Flickwerk separater Tools durch einen automatisierten Prozess, der Discovery, Anreicherung und gezielte Enumeration nahtlos handhabt – so wird manueller Aufwand reduziert und Sie können sich auf Ergebnisse statt auf Tool-Verwaltung konzentrieren.

Die Web-Oberfläche von Cygor nimmt das Chaos roher Scandaten und organisiert es in einer einzigen, visuellen Kommandozentrale. Anstatt endlose XML-, JSON- oder Klartextdateien durchzugehen, werden Ergebnisse automatisch geparst, angereichert und in einem Bereich angezeigt, der für schnelle Triage und Entscheidungsfindung ausgelegt ist.

Angetrieben von FastAPI und Bootstrap 5 macht das Dashboard Folgendes einfach:

• Das große Ganze auf einen Blick erkennen – Zähler und Zusammenfassungen zeigen Service-Verteilungen, Statuscode-Trends und OS-Fingerabdrücke.
• Sofort tief eintauchen – von hochrangigen Metriken zu detaillierten Host-Details, Ports und Modulergebnissen mit nur einem Klick wechseln.
• Gefährdung visualisieren – Eines der Cygor-Module namens Lockon macht Screenshots von aktiven Webdiensten und die Ausgaben werden direkt eingebettet, sodass sofortiger Kontext entsteht, ohne das Dashboard verlassen zu müssen.
• Während der Triage organisiert bleiben – überprüfte vs. ungeprüfte Ergebnisse markieren, Ergebnisse filtern und sortieren und sich auf die wertvollsten Ziele konzentrieren.

Die Web-Oberfläche dient nicht nur der Präsentation – sie dient der Effizienz und Klarheit. Indem alle gesammelten Daten in einem einzigen, interaktiven Arbeitsbereich zusammengeführt werden, reduziert sie die Zeit, die für das Parsen von Dateien oder das Abgleichen von Ausgaben aufgewendet wird, und ermöglicht es Testern, sich auf das Wesentliche zu konzentrieren: das Verständnis der Umgebung und das Handeln darin.

Warum heißt es Cygor?

Viele Tools, Techniken und Vorgehensweisen, die ich erstelle, sind vom Spawn-Universum inspiriert. Falls du noch nie einen Spawn-Comic gelesen hast, ist das in Ordnung – ich werde einige Informationen dazu geben, warum ich den Charakter als Namen für dieses Tool ausgewählt habe.

Der Name Cygor leitet sich von Cy-Gor ab, einem tragischen Antihelden im Spawn-Universum. Einst war er Michael Konieczny – ein Regierungsagent und enger Freund von Al Simmons –, der versuchte, Korruption aufzudecken, nachdem Simmons ermordet worden war. Er wurde jedoch gefangen genommen und in Project Sim gezwungen, die Affenexperimente von Dr. Frederick Willheim, bei denen ein Gorillakörper mit Koniecznys Geist durch invasive Kybernetik verschmolzen wurde. Das Ergebnis war die Bestie namens Cy-Gor – kurz für Cybernetic Gorilla (Kybernetischer Gorilla).

Nach der Flucht aus der Gefangenschaft begab sich Cy-Gor auf gewalttätige Amokläufe und riss sogar Regierungsrechenzentren in Anfällen von Verwirrung und Wut nieder. Obwohl er mehrfach gejagt und wieder eingefangen wurde, wehrte er sich schließlich gegen die Systeme, die ihn kontrollieren wollten – entfernte Tracking-Implantate und befreite sich, um seinen eigenen Weg zu gehen, zerrissen zwischen Maschine, Bestie und Mensch.

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

Wer sollte Cygor verwenden?

• Red Teams & Pentester – Automatisieren Sie Discovery, optimieren Sie die Enumeration und behalten Sie den Kontext bei großen Engagements.
• Blue Teams & Systemadministratoren – Entdecken Sie unbekannte Assets, validieren Sie Inventare und erkennen Sie Fehlkonfigurationen, die die Angriffsfläche vergrößern.
• Sicherheitsforscher – Parst und analysieren Sie Scandaten schnell, um Trends, übersehene Dienste und gemusterte Anomalien zu identifizieren.
• Studierende & Ausbilder – Lernen Sie reale Recon- und Enumerationstechniken in einer strukturierten, wiederholbaren Umgebung.

Tools, die Cygor verwendet:

• Nmap – Zuverlässige Dienst- und Versionserkennung; XML-Ausgabe wird in strukturierte Host-/Dienst-Daten geparst.
• Masscan – Hochgeschwindigkeits-Portscan für schnelle Discovery in großen Netzwerken.
• Naabu – Einfacher, schneller TCP-Portscanner, der Masscan-/Nmap-Workflows ergänzt.
• Playwright – Browser-Automatisierungs-Engine, die von Lockon zum Erfassen von Web-Screenshots genutzt wird.
• Web-Content-Discovery – ffuf, feroxbuster, gobuster und dirsearch werden parallel vom Modul webenum orchestriert (nur die installierten Tools werden ausgeführt).
• Service-Enumeration-Tools – rpcclient/polenum (MSRPC), ldapsearch/ldapdomaindump (LDAP), snmpwalk/onesixtyone (SNMP), dig/dnsrecon (DNS) und showmount (NFS) unterstützen die Explorer-Module; jedes Modul überspringt sauber, wenn sein Tool fehlt.
• Python-Bibliotheken – (requests, colorama, SQLModel usw.) für Parsing, Anreicherung, Ausgabeformatierung und Datenbank-Handling.

Installation von Cygor

Es gibt mehrere unterstützte Methoden, um Cygor zu installieren: pip, pipx, uv und Docker.

Installation mit pipx

Einige Abhängigkeiten (z. B. gssapi für Kerberos/WinRM) bauen C-Erweiterungen, also installieren Sie zuerst das Build-Toolchain und die Kerberos-Header:

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

# Stabile Version:
pipx install cygor

# Installation aus dem Quellcode:
git clone https://github.com/tjnull/cygor
cd cygor
pipx install .

Bereitstellung von Cygor mit Docker

Das Docker-Setup von Cygor umfasst sowohl die Anwendung als auch einen PostgreSQL-Datenbankdienst. Das System fällt automatisch auf SQLite zurück, wenn PostgreSQL nicht verfügbar ist.

Schnellstart

Produktion (empfohlen):

# Option 1: Verwenden Sie das Wrapper-Skript (behandelt automatisch Portkonflikte)
./docker-compose-up.sh up --build

# Option 2: Direktes docker compose (verwendet Standard-Ports)
docker compose up --build

Entwicklung (mit eingebundenem Quellcode):

# Option 1: Verwenden Sie das Wrapper-Skript (behandelt automatisch Portkonflikte)
./docker-compose-up.sh dev up --build

# Option 2: Direktes docker compose (verwendet Standard-Ports)
docker compose -f docker-compose-dev.yaml up --build

Docker-Compose-Dienste

Das Docker-Compose-Setup umfasst:

• PostgreSQL-Dienst: Automatisch konfigurierte Datenbank (fällt auf SQLite zurück, wenn nicht verfügbar)
• Cygor-Dienst: Web-Oberfläche und Anwendung
• Automatische Port-Erkennung: Prüft auf Portkonflikte und verwendet bei Bedarf alternative Ports
• Persistente Volumes:
  • results/: Scan-Ergebnisse, credrecon-Ergebnisse und Datenbankdateien
  • cygor-config/: Lokales Konfigurations-Volume (wird automatisch erstellt)

Port-Konfiguration

Standardmäßig:

• Produktion: PostgreSQL auf Host-Port 5432 freigegeben (falls verfügbar)
• Entwicklung: PostgreSQL auf Host-Port 5434 freigegeben (falls verfügbar)
• Intern: Container verwenden immer Port 5432 intern (Docker-Netzwerk)

Wenn Ports bereits belegt sind, können Sie:

1. Das Wrapper-Skript verwenden (empfohlen - erkennt automatisch verfügbare Ports):

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

2. Den Port manuell setzen:

   export POSTGRES_HOST_PORT=5435
   docker compose up --build
   

3. Port-Mapping entfernen (wenn Sie keinen externen PostgreSQL-Zugriff benötigen): Kommentieren Sie den Abschnitt ports: in docker-compose.yaml aus

Manueller Docker-Build

So erstellen Sie das Docker-Image manuell:

docker build -t cygor .

Einen einzelnen Container ausführen (ohne PostgreSQL-Dienst):

docker run --rm -v ./results:/opt/cygor/results \
  -e CYGOR_RESULTS_DIR=/opt/cygor/results \
  cygor web --host 0.0.0.0 --port 8080 --load-dir /opt/cygor/results