
Analyse de triage à haute intensité
[][docs]
[
][tests]
[
][codecov]
[
][pypi]
__ __ High Octane Triage Analysis __
|| _||______ __ __________ _____ ||
|| \||___ \__| ____/ ______/___ / ____\ ||
==||=====|| | __/ |/ \ /==| / __ \ __\===]|
'======|| | \ | | \_ _| \ ___/| | ||
||____ /__|___|__/ / | \____]| | ||
=========''====\/=========/ /==|__|=====|__|======'
\ /
\/
Binary Refinery™ est une collection de scripts Python qui implémentent des transformations de données binaires telles que la compression et le chiffrement.
Nous y ferons souvent référence simplement par refinery, qui est aussi le nom du paquet correspondant.
Les scripts sont conçus pour lire exclusivement l'entrée depuis stdin et écrire la sortie vers stdout.
La philosophie principale est que chaque script doit être une unité, en ce sens qu'il effectue une tâche,
et que les unités individuelles peuvent être combinées en pipelines avec l'opérateur de pipe | en ligne de commande pour réaliser des tâches plus complexes.
L'objectif principal du projet est le triage de logiciels malveillants,
et il s'agit d'une tentative d'implémenter quelque chose comme CyberChef en ligne de commande.
Créez un environnement virtuel Python. Vous avez besoin de Python 3.11 ou ultérieur. Installez refinery comme ceci :
python -m pip install -U pip
python -m pip install -U --no-cache-dir binary-refinery[extended]
Exécutez les unités avec -h pour apprendre comment elles fonctionnent, parcourez la [documentation][] avec grep ou utilisez la commande binref pour les trouver.
Regardez [une vidéo récente][VOD3] si vous voulez la voir en action.
Mais aussi, lisez le reste de ce readme.
Il n'y a pas de calendrier de publication, mais les versions sortent très fréquemment et il est recommandé de mettre à jour périodiquement. Les corrections de bugs ne sont pas documentées en dehors de GIT, mais toutes les autres modifications (c'est-à-dire les nouvelles fonctionnalités) sont documentées dans le changelog. Suivez-moi sur [Mastodon][] pour les mises à jour concernant les versions particulièrement importantes.
Le texte d'aide affiché lors de l'exécution d'une unité avec le commutateur -h ou --help constitue sa documentation principale.
La [documentation générée automatiquement][docs] contient une compilation de cette sortie pour chaque unité au niveau supérieur,
mais contient également la spécification des trois concepts fondamentaux de la boîte à outils :
[le framing][frame], [les arguments multibin][argformats] et [les méta-variables][meta].
Une recherche en texte intégral de la description et du texte d'aide de chaque unité est également disponible en ligne de commande,
via la commande binref fournie. Reconnaissant le fait que la documentation de référence peut être quelque peu aride,
un effort continu est mené pour produire une série de tutoriels ; je recommande vivement de les consulter.
En plus de cela, je rassemble ci-dessous des ressources supplémentaires (y compris certaines produites par des tiers).
[!NOTE]
Refinery est encore en alpha et l'interface peut parfois changer, c'est-à-dire que des unités et des paramètres peuvent être supprimés ou renommés. Par conséquent, il peut arriver que des lignes de commande spécifiques issues d'anciennes vidéos et d'anciens articles de blog ne fonctionnent plus.
2021/08] [OALabs][OA] a eu la gentillesse de me laisser [faire une démo de la boîte à outils dans une vidéo dédiée][VOD1].
Dans la vidéo, je parcours essentiellement le contenu de
le premier tutoriel.2021/11] [Johannes Bader][JB] a écrit un excellent [article de blog][BLOG] sur l'analyse de malspam avec binary refinery.2024/03] [Malware Analysis For Hedgehogs][MH] a réalisé [une vidéo sur le déballage d'un échantillon XWorm][VOD2] à l'aide de refinery.2024/11] [the CyberYeti][CY] m'a invité [en stream pour présenter refinery][VOD3].2025/06] J'étais [de nouveau en stream][VOD4] avec [the CyberYeti][CY], celui-ci est un peu plus brut.
Tous les bugs que vous pouvez voir ici ont été corrigés. 😉Les démonstrations incluent à nouveau des échantillons de la section d'exemples ci-dessous et des tutoriels.
The Binary Refinery est (c) 2019 Jesko Hüttenhain, et publié sous une [licence BSD à 3 clauses][license]. Ce dépôt contient également une copie du texte intégral de la licence. Si vous souhaitez en faire quelque chose qui n'est pas couvert par cette licence, n'hésitez pas à contacter l'auteur.
Refinery nécessite au moins Python 3.11. Il est recommandé de l'installer dans son propre [environnement virtuel][venv] : le paquet peut tirer un grand nombre de dépendances, et l'installer dans votre Python global est quelque peu sujet aux conflits de versions. De plus, comme la boîte à outils introduit un grand nombre de nouvelles commandes, il y a de bonnes chances que certaines d'entre elles entrent en conflit sur certains systèmes, et les garder dans leur propre environnement virtuel séparé est un moyen de l'éviter.
Si vous voulez avoir toutes les commandes de refinery disponibles dans votre shell à tout moment (c'est-à-dire sans avoir à basculer vers un environnement virtuel personnalisé),
vous avez également la possibilité de choisir un préfixe pour l'installation,
qui sera placé devant chaque shim de commande installé.
Par exemple, si vous choisissez r. comme préfixe, alors l'unité [emit][] sera installée en tant que commande r.emit.
Un avantage supplémentaire est que vous pouvez taper r. et appuyer deux fois sur Tab pour obtenir une liste de toutes les commandes refinery disponibles.
Notez cependant qu'aucun préfixe n'est supposé dans la documentation et que c'est un objectif de développement de refinery de ne pas entrer en conflit sur la plupart des systèmes.
L'auteur n'utilise pas de préfixe et propose cette option comme filet de sécurité.
Le moyen le plus simple d'installer et de mettre à jour refinery est via pip. Assurez-vous d'abord d'exécuter la version la plus récente :
python -m pip install -U pip
Ensuite, il suffit d'installer le paquet refinery :
pip install -U --no-cache-dir binary-refinery
Si vous souhaitez choisir un préfixe pour toutes les unités, vous pouvez le spécifier via la variable d'environnement REFINERY_PREFIX.
Par exemple, la commande suivante installera refinery dans l'environnement Python actuel avec le préfixe r. sous Linux :
REFINERY_PREFIX=r. pip install -U --no-cache-dir binary-refinery
Sous Windows, vous devriez exécuter les commandes suivantes :
set REFINERY_PREFIX=r.
pip install -U --no-cache-dir binary-refinery
Spécifier le préfixe spécial ! aura pour effet qu'aucune commande shell ne sera créée du tout,
et binary refinery sera installé uniquement en tant que bibliothèque.
Définissez REFINERY_NO_EXTENSIONS=1 pour installer sans les extensions Cython ;
refinery utilisera alors des implémentations Python pures (beaucoup plus lentes) de plusieurs algorithmes.