gchq/cyberchefDas Cyber Swiss Army Knife - eine Web-App für Verschlüsselung, Kodierung, Komprimierung und Datenanalyse
# CyberChef
[](https://github.com/gchq/CyberChef/actions?query=workflow%3A%22Master+Build%2C+Test+%26+Deploy%22)
[](https://www.npmjs.com/package/cyberchef)
[](https://github.com/gchq/CyberChef/blob/master/LICENSE)
[](https://gitter.im/gchq/CyberChef?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
#### *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](#official-website)
- [Lokale Ausführung](#running-locally)
- [Mit Docker](#with-docker)
- [Aus dem Quellcode](#from-source)
- [So funktioniert es](#how-it-works)
- [Funktionen](#features)
- [Deep Linking](#deep-linking)
- [Browserunterstützung](#browser-support)
- [Node.js-Unterstützung](#nodejs-support)
- [Sicherheit](#security)
- [Mitwirken](#contributing)
- [Lizenz](#licencing)
## Offizielle Website
[Die offizielle Website von CyberChef findest du hier][1] - 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](https://www.docker.com/products/docker-desktop/)
- Docker Desktop muss auf deinem Rechner geöffnet sein und laufen.
#### Option 1: Erstelle das Docker-Image selbst
1. Erstelle das Docker-Image
```bash
docker build --tag cyberchef --ulimit nofile=10000 .
```
2. Führe den Docker-Container aus
```bash
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.
```bash
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](https://github.com/gchq/cyberchef/blob/master/.github/workflows/releases.yml) 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](https://nodejs.org/) `v24` (siehe [Node.js-Unterstützung](#nodejs-support))
> [!NOTE]
> Du kannst [nvm](https://github.com/nvm-sh/nvm) zum Verwalten von Node.js-Versionen verwenden und die aktuelle Entwicklungsversion aus [diesem Projekt](https://github.com/gchq/cyberchef/blob/master/.nvmrc) nutzen, um Konflikte mit anderen Projekten auf deinem Rechner zu vermeiden.
**Einrichtung**
```bash
git clone https://github.com/gchq/CyberChef.git
cd CyberChef
npm install
```
**Häufige Aufgaben**
| Befehl | Beschreibung |
| --- | --- |
| `npm start` | Startet den Entwicklungsserver mit Live-Reload unter `http://localhost:8080`. |
| `npm run build` | Erzeugt einen Produktions-Build im Verzeichnis `build/prod`. |
| `npm test` | Führt die Node.js- und Operationstest-Suiten aus. |
| `npm run testui` | Führt die Browser-Tests (UI) aus. |
| `npm run lint` | Prüft den Code gegen die Linting-Regeln. |
| `npm run newop` | Erstellt eine neue Operation über das interaktive Quickstart-Skript. |
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 **Eingabe**feld oben rechts, in das du den zu verarbeitenden Text oder die zu verarbeitende Datei einfügen, eingeben oder hineinziehen kannst.
2. Das **Ausgabe**feld unten rechts, in dem das Ergebnis deiner Verarbeitung angezeigt wird.
3. Die **Operations**liste 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][2]
- [Ein Datum und eine Uhrzeit in eine andere Zeitzone umrechnen][3]
- [Eine Teredo-IPv6-Adresse parsen][4]
- [Daten aus einem Hexdump konvertieren und dann dekomprimieren][5]
- [Shellcode entschlüsseln und disassemblieren][6]
- [Mehrere Zeitstempel als vollständige Datumsangaben anzeigen][7]
- [Unterschiedliche Operationen an Daten verschiedener Typen durchführen][8]
- [Teile der Eingabe als Argumente für Operationen verwenden][9]
- [Eine AES-Entschlüsselung durchführen und den IV vom Anfang des Cipher-Streams extrahieren][10]
- [Eine einfachere Möglichkeit, dieselbe AES-Entschlüsselung durchzuführen][13]
- [Automagisch mehrere Ebenen verschachtelter Kodierung erkennen][12]
## 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](https://github.com/gchq/CyberChef/wiki/Automatic-detection-of-encoded-data-using-CyberChef-Magic), 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][11]).
- 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.
- CyberChef ist vollständig clientseitig
- Es sollte beachtet werden, dass keine deiner Recipe-Konfigurationen oder Eingaben (weder Text noch Dateien) jemals an den CyberChef-Webserver gesendet werden - die gesamte Verarbeitung erfolgt in deinem Browser, auf deinem eigenen Computer.
- Aufgrund dieser Funktion kann CyberChef heruntergeladen und lokal ausgeführt werden. Du kannst den Link in der oberen linken Ecke der App verwenden, um eine vollständige Kopie von CyberChef herunterzuladen und sie in eine virtuelle Maschine zu legen, mit anderen zu teilen oder in einem geschlossenen Netzwerk zu hosten.
## 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](https://github.com/gchq/CyberChef/wiki/Node-API)
## Sicherheit
Bitte beachte die [Sicherheitsrichtlinie von CyberChef](https://github.com/gchq/cyberchef/blob/master/SECURITY.md).
## 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](https://github.com/gchq/CyberChef/wiki/Contributing).
- 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](https://cla-assistant.io/gchq/CyberChef) ü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](https://www.apache.org/licenses/LICENSE-2.0) veröffentlicht und unterliegt dem [Crown Copyright](https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/).
[1]: https://gchq.github.io/CyberChef
[2]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[3]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[4]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[5]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[6]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[7]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[8]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[9]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[10]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[11]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[12]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1
[13]: https://gchq.github.io/CyberChef/#recipe=From_Base64('A-Za-z0-9%2B/%3D',true)&input=VTI4Z2JHOXVaeUJoYm1RZ2RHaGhibXR6SUdadmNpQmhiR3dnZEdobElHWnBjMmd1