
Hochoktanige Triage-Analyse
[][docs]
[
][tests]
[
][codecov]
[
][pypi]
__ __ High Octane Triage Analysis __
|| _||______ __ __________ _____ ||
|| \||___ \__| ____/ ______/___ / ____\ ||
==||=====|| | __/ |/ \ /==| / __ \ __\===]|
'======|| | \ | | \_ _| \ ___/| | ||
||____ /__|___|__/ / | \____]| | ||
=========''====\/=========/ /==|__|=====|__|======'
\ /
\/
Binary Refinery™ ist eine Sammlung von Python-Skripten, die Transformationen binärer Daten wie Komprimierung und Verschlüsselung implementieren.
Wir werden es oft einfach als Refinery bezeichnen, was auch der Name des entsprechenden Pakets ist.
Die Skripte sind so konzipiert, dass sie ausschließlich Eingaben von stdin lesen und Ausgaben nach stdout schreiben.
Die Grundphilosophie besteht darin, dass jedes Skript eine Einheit sein sollte, in dem Sinne, dass es eine Aufgabe erfüllt,
und einzelne Einheiten können auf der Kommandozeile mit dem Pipe-Operator | zu Pipelines kombiniert werden, um komplexere Aufgaben auszuführen.
Der Hauptfokus des Projekts liegt auf Malware-Triage
und ist der Versuch, so etwas wie CyberChef auf der Kommandozeile zu implementieren.
Erstellen Sie eine Python-virtuelle Umgebung. Sie benötigen Python 3.11 oder höher. Installieren Sie Refinery wie folgt:
python -m pip install -U pip
python -m pip install -U --no-cache-dir binary-refinery[extended]
Führe Units mit -h aus, um zu erfahren, wie sie funktionieren, durchsuche die [Dokumentation][docs] mit grep oder verwende den Befehl binref, um sie zu finden.
Sieh dir [ein aktuelles Video][VOD3] an, wenn du es in Aktion sehen möchtest.
Aber lies auch den Rest dieser Readme.
Es gibt keinen Veröffentlichungsplan, aber Releases erscheinen sehr häufig, und es wird empfohlen, regelmäßig zu aktualisieren. Bugfixes werden außerhalb von GIT nicht dokumentiert, aber alle anderen Änderungen (d. h. neue Funktionen) sind im Changelog dokumentiert. Folge mir auf [Mastodon][] für Updates zu besonders wirkungsvollen Releases.
Der Hilfetext, der angezeigt wird, wenn eine Unit mit dem Schalter -h oder --help ausgeführt wird, ist ihre Hauptdokumentation.
Die [automatisch generierte Dokumentation][docs] enthält eine Zusammenstellung dieser Ausgabe für jede Unit auf oberster Ebene,
aber auch die Spezifikation für die drei grundlegenden Konzepte des Toolkits:
[Framing][frame], [Multibin-Argumente][argformats] und [Meta-Variablen][meta].
Eine Volltextsuche in der Beschreibung und dem Hilfetext für jede Unit ist auch auf der Kommandozeile verfügbar,
über den bereitgestellten Befehl binref. In Anbetracht der Tatsache, dass Referenzdokumentation etwas trocken sein kann,
gibt es eine laufende Bemühung, eine Reihe von Tutorials zu erstellen; ich empfehle sehr, sie anzuschauen.
Darüber hinaus sammle ich unten zusätzliche Ressourcen (einschließlich einiger von Dritten erstellter).
[!NOTE]
Refinery befindet sich noch in der Alpha-Phase, und die Schnittstelle kann sich manchmal ändern, d. h. Units und Parameter können entfernt oder umbenannt werden. Daher kann es vorkommen, dass bestimmte Kommandozeilen aus älteren Videos und Blogbeiträgen nicht mehr funktionieren.
2021/08] [OALabs][OA] war so freundlich, mich [das Toolkit in einem Feature-Video vorzustellen][VOD1].
Im Video arbeite ich im Wesentlichen den Inhalt von
dem ersten Tutorial durch.2021/11] [Johannes Bader][JB] schrieb einen großartigen [Blogbeitrag][BLOG] über die Analyse von Malspam mit binary refinery.2024/03] [Malware Analysis For Hedgehogs][MH] erstellte [ein Video über das Entpacken einer XWorm-Sample][VOD2] mit refinery.2024/11] [the CyberYeti][CY] hatte mich [im Stream, um refinery vorzustellen][VOD3].2025/06] Ich war [erneut im Stream][VOD4] mit [the CyberYeti][CY], dieser ist etwas roher.
Alle Bugs, die du hier sehen kannst, wurden behoben. 😉Zu den Showcases gehören wiederum Samples aus dem Beispielabschnitt unten und die Tutorials.
Binary Refinery ist (c) 2019 Jesko Hüttenhain und veröffentlicht unter einer [3-Clause BSD License][license]. Dieses Repository enthält auch eine Kopie des vollständigen Lizenztextes. Wenn du etwas damit tun möchtest, das nicht von dieser Lizenz abgedeckt ist, kannst du dich gerne an den Autor wenden.
Refinery erfordert mindestens Python 3.11. Es wird empfohlen, es in einer eigenen [virtuellen Umgebung][venv] zu installieren: Das Paket kann viele Abhängigkeiten mitbringen, und die Installation in dein globales Python ist etwas anfällig für Versionskonflikte. Da das Toolkit außerdem eine große Anzahl neuer Befehle einführt, besteht eine gute Chance, dass einige davon auf manchen Systemen kollidieren, und sie in ihrer eigenen separaten virtuellen Umgebung zu halten, ist eine Möglichkeit, das zu verhindern.
Wenn du alle refinery-Befehle jederzeit in deiner Shell verfügbar haben möchtest (d. h. ohne in eine benutzerdefinierte virtuelle Umgebung wechseln zu müssen),
hast du auch die Möglichkeit, ein Präfix für die Installation zu wählen,
das vor jeden installierten Befehl-Shim gesetzt wird.
Wenn du zum Beispiel r. als Präfix wählst, dann wird die [emit][]-Unit als Befehl r.emit installiert.
Ein zusätzlicher Vorteil ist, dass du r. tippen und zweimal Tab drücken kannst, um eine Liste aller verfügbaren refinery-Befehle zu erhalten.
Beachte jedoch, dass in der Dokumentation kein Präfix angenommen wird und es ein Entwicklungsziel von refinery ist, auf den meisten Systemen nicht zu kollidieren.
Der Autor verwendet kein Präfix und bietet diese Option als Sicherheitsnetz an.
Der einfachste Weg, refinery zu installieren und zu aktualisieren, ist über pip. Stellen Sie zunächst sicher, dass Sie die neueste Version ausführen:
python -m pip install -U pip
Dann installieren Sie einfach das Refinery-Paket:
pip install -U --no-cache-dir binary-refinery
Wenn Sie ein Präfix für alle Units festlegen möchten, können Sie es über die Umgebungsvariable REFINERY_PREFIX angeben.
Der folgende Befehl installiert refinery beispielsweise mit dem Präfix r. in der aktuellen Python-Umgebung unter Linux:
REFINERY_PREFIX=r. pip install -U --no-cache-dir binary-refinery
Unter Windows müssten Sie die folgenden Befehle ausführen:
set REFINERY_PREFIX=r.
pip install -U --no-cache-dir binary-refinery
Die Angabe des speziellen Präfixes ! hat zur Folge, dass überhaupt keine Shell-Befehle erstellt werden
und binary refinery nur als Bibliothek installiert wird.
Setzen Sie REFINERY_NO_EXTENSIONS=1, um ohne Cython-Erweiterungen zu installieren;
refinery verwendet dann (deutlich langsamere) reine Python-Implementierungen mehrerer Algorithmen.