CyberChef

Das Cyber-Schweizer-Taschenmesser

CyberChef ist eine einfache, intuitive Web-App zur Durchführung aller Arten von „Cyber“-Operationen in einem Webbrowser. Zu diesen Operationen gehören einfache Kodierungen wie XOR und Base64, komplexere Verschlüsselungen wie AES, DES und Blowfish, das Erstellen von Binär- und Hexdumps, das Komprimieren und Dekomprimieren von Daten, das Berechnen von Hashes und Prüfsummen, das Parsen von IPv6- und X.509-Daten, das Ändern von Zeichenkodierungen und vieles mehr.

Das Tool ist so konzipiert, dass sowohl technische als auch nicht-technische Analysten Daten auf komplexe Weise manipulieren können, ohne sich mit komplexen Tools oder Algorithmen befassen zu müssen. Es wurde von einem Analysten über mehrere Jahre hinweg in seiner 10-Prozent-Innovationszeit konzipiert, entworfen, gebaut und schrittweise verbessert.

Inhaltsverzeichnis

• Offizielle Website
• Lokale Ausführung
  • Mit Docker
  • Aus dem Quellcode
• So funktioniert es
• Funktionen
• Deep Linking
• Browserunterstützung
• Node.js-Unterstützung
• Sicherheit
• Mitwirken
• Lizenz

Offizielle Website

Die offizielle Website von CyberChef findest du hier - viel Spaß!

Lokale Ausführung

Du kannst CyberChef mit Docker ausführen (keine Toolchain erforderlich) oder es mit Node.js aus dem Quellcode erstellen.

Mit Docker

Voraussetzungen

• Docker
  • Docker Desktop muss auf deinem Rechner geöffnet sein und laufen.

Option 1: Erstelle das Docker-Image selbst

1. Erstelle das Docker-Image

docker build --tag cyberchef --ulimit nofile=10000 .

2. Führe den Docker-Container aus

docker run -it -p 8080:8080 cyberchef

3. Öffne http://localhost:8080 in deinem Browser

Option 2: Verwende das vorgefertigte Docker-Image

Wenn du den Build-Prozess überspringen möchtest, kannst du das vorgefertigte Image verwenden.

docker run -it -p 8080:8080 ghcr.io/gchq/cyberchef:latest

Öffne wie zuvor http://localhost:8080 in deinem Browser.

Dieses Image wird über unsere GitHub Workflows erstellt und veröffentlicht.

Aus dem Quellcode

Wenn du CyberChef weiterentwickeln oder ohne Docker ausführen möchtest, kannst du es direkt mit Node.js erstellen.

Voraussetzungen

• Node.js v24 (siehe Node.js-Unterstützung)

[!NOTE]

Du kannst nvm zum Verwalten von Node.js-Versionen verwenden und die aktuelle Entwicklungsversion aus diesem Projekt nutzen, um Konflikte mit anderen Projekten auf deinem Rechner zu vermeiden.

Einrichtung

git clone https://github.com/gchq/CyberChef.git
cd CyberChef
npm install

Häufige Aufgaben

Wenn beim Erstellen umfangreicher Recipes ein Out-of-Memory-Fehler auftritt, erhöhe die Heap-Größe von Node mit npm run setheapsize.

So funktioniert es

Es gibt vier Hauptbereiche in CyberChef:

1. Das Eingabefeld oben rechts, in das du den zu verarbeitenden Text oder die zu verarbeitende Datei einfügen, eingeben oder hineinziehen kannst.
2. Das Ausgabefeld unten rechts, in dem das Ergebnis deiner Verarbeitung angezeigt wird.
3. Die Operationsliste ganz links, in der du alle Operationen, die CyberChef beherrscht, in kategorisierten Listen oder über die Suche finden kannst.
4. Der Recipe-Bereich in der Mitte, in den du die gewünschten Operationen ziehen und Argumente und Optionen festlegen kannst.

Du kannst beliebig viele Operationen auf einfache oder komplexe Weise verwenden. Hier sind einige Beispiele:

• Base64-kodierten String dekodieren
• Ein Datum und eine Uhrzeit in eine andere Zeitzone umrechnen
• Eine Teredo-IPv6-Adresse parsen
• Daten aus einem Hexdump konvertieren und dann dekomprimieren
• Shellcode entschlüsseln und disassemblieren
• Mehrere Zeitstempel als vollständige Datumsangaben anzeigen
• Unterschiedliche Operationen an Daten verschiedener Typen durchführen
• Teile der Eingabe als Argumente für Operationen verwenden
• Eine AES-Entschlüsselung durchführen und den IV vom Anfang des Cipher-Streams extrahieren
• Eine einfachere Möglichkeit, dieselbe AES-Entschlüsselung durchzuführen
• Automagisch mehrere Ebenen verschachtelter Kodierung erkennen

Funktionen

• Drag & Drop
  • Operationen können in die Recipe-Liste hinein- und herausgezogen oder neu angeordnet werden.
  • Dateien bis zu 2 GB können in das Eingabefeld gezogen werden, um sie direkt in den Browser zu laden.
• Auto Bake
  • Wenn du die Eingabe oder das Recipe änderst, „backt“ CyberChef automatisch für dich und erzeugt die Ausgabe sofort.
  • Dies kann deaktiviert und manuell ausgeführt werden, wenn es die Leistung beeinträchtigt (z. B. bei sehr großen Eingaben).
• Automatische Kodierungserkennung
  • CyberChef verwendet eine Reihe von Techniken, um automatisch zu erkennen, welche Kodierungen auf deine Daten angewendet wurden. Wenn es eine passende Operation findet, die deine Daten verständlich macht, zeigt es das „magic“-Symbol im Ausgabefeld an, das du anklicken kannst, um deine Daten zu dekodieren.
• Haltepunkte
  • Du kannst an jeder Operation in deinem Recipe Haltepunkte setzen, um die Ausführung anzuhalten, bevor die Operation ausgeführt wird.
  • Du kannst das Recipe auch Operation für Operation durchgehen, um zu sehen, wie die Daten in jeder Phase aussehen.
• Recipes speichern und laden
  • Wenn du ein geniales Recipe erstellst, von dem du weißt, dass du es wiederverwenden möchtest, klicke einfach auf „Save recipe“ und füge es deinem lokalen Speicher hinzu. Es wartet beim nächsten Besuch von CyberChef auf dich.
  • Du kannst auch die URL kopieren, die dein Recipe und deine Eingabe enthält, um sie ganz einfach mit anderen zu teilen.
• Suche
  • Wenn du den Namen der gewünschten Operation oder ein damit verbundenes Wort kennst, tippe es einfach in das Suchfeld ein, und alle passenden Operationen werden sofort angezeigt.
• Hervorhebung
  • Wenn du Text in der Eingabe oder Ausgabe hervorhebst, werden die Offset- und Längenwerte angezeigt und, wenn möglich, die entsprechenden Daten in der Ausgabe bzw. Eingabe hervorgehoben (Beispiel: hebe das Wort 'question' in der Eingabe hervor, um zu sehen, wo es in der Ausgabe erscheint).
• In Datei speichern und aus Datei laden
  • Du kannst die Ausgabe jederzeit in einer Datei speichern oder eine Datei laden, indem du sie per Drag & Drop in das Eingabefeld ziehst. Dateien bis zu etwa 2 GB werden unterstützt (abhängig von deinem Browser); bei so vielen Daten kann die Ausführung einiger Operationen jedoch sehr lange dauern.

Deep Linking

Durch Manipulation des URL-Hashs von CyberChef kannst du die Anfangseinstellungen ändern, mit denen die Seite geöffnet wird. Das Format ist https://gchq.github.io/CyberChef/#recipe=Operation()&input=...

Unterstützte Argumente sind recipe, input (Base64-kodiert) und theme.

Browserunterstützung

CyberChef ist darauf ausgelegt, folgende Browser zu unterstützen:

• Google Chrome 50+
• Mozilla Firefox 38+

Node.js-Unterstützung

CyberChef ist darauf ausgelegt, Node.js v24 vollständig zu unterstützen, und wird außerdem bereits gegen Node.js v26 getestet, noch bevor es zum aktiven LTS-Release wird. Weitere Informationen findest du auf der „Node API“-Wiki-Seite

Sicherheit

Bitte beachte die Sicherheitsrichtlinie von CyberChef.

Mitwirken

Eine neue Operation zu CyberChef beizutragen ist super einfach! Das Quickstart-Skript führt dich durch den Prozess. Wenn du grundlegendes JavaScript schreiben kannst, kannst du eine CyberChef-Operation schreiben.

Eine Installationsanleitung, How-to-Guides für das Hinzufügen neuer Operationen und Themes, Beschreibungen der Repository-Struktur, verfügbare Datentypen und Code-Konventionen findest du alles auf der „Contributing“-Wiki-Seite.

• Pushe deine Änderungen auf deinen Fork.
• Reiche einen Pull-Request ein. Wenn du dies zum ersten Mal tust, wirst du aufgefordert, die GCHQ Contributor Licence Agreement über den CLA-Assistant im Pull-Request zu unterzeichnen. Dabei wird auch gefragt, ob du damit einverstanden bist, dass GCHQ dich wegen eines Dankeschöns für deinen Beitrag oder wegen Stellenangeboten bei GCHQ kontaktiert.

Lizenz

CyberChef wird unter der Apache-2.0-Lizenz veröffentlicht und unterliegt dem Crown Copyright.