Pourquoi Hayabusa ?
Lorsqu’un poste ou un serveur Windows est compromis, ses journaux d’événements (fichiers .evtx) racontent souvent toute l’histoire : ouvertures de session suspectes, créations de services, exécutions PowerShell, effacement de journaux… Le problème, c’est le volume : plusieurs gigaoctets et des millions d’entrées, impossibles à parcourir à la main dans l’Observateur d’événements au milieu d’une crise. Hayabusa répond précisément à ce besoin : il passe ces journaux au crible de milliers de règles de détection et produit en quelques minutes une chronologie (timeline) exploitable, classée par niveau de gravité.
Hayabusa (« faucon pèlerin » en japonais) est développé par Yamato Security, une communauté japonaise de spécialistes de la sécurité. L’outil est écrit en Rust, un langage sûr pour la mémoire, et publié en open source sous licence GNU AGPLv3 ; ses règles de détection sont distribuées sous Detection Rule License (DRL) 1.1. La version 4.4.0 est parue le 10 novembre 2026.
Qu’est-ce que Hayabusa ?
Hayabusa se définit comme un générateur de timeline forensique rapide et un outil de chasse aux menaces (threat hunting) pour les journaux d’événements Windows. Il couvre quatre usages :
Détection : il revendique une prise en charge complète du format Sigma, y compris les règles de corrélation de Sigma v2, en plus de ses propres règles Hayabusa.
Timeline : il consolide les événements d’un seul hôte ou de milliers de systèmes dans une chronologie unique au format CSV, JSON ou JSONL.
Analyse : des commandes de statistiques (
eid-metrics,computer-metrics,log-metrics), un résumé des ouvertures de session (logon-summary), une recherche par mot-clé ou expression régulière (search) et l’extraction des chaînes base64 (extract-base64).Modes d’exécution : en direct sur une machine, hors ligne sur des journaux collectés, ou à l’échelle de tout un parc grâce à Velociraptor, qui propose un artefact dédié (
Windows.EventLogs.Hayabusa).
Architecture et fonctionnement
Hayabusa est un binaire autonome, sans dépendance à installer, et multithread pour exploiter tous les cœurs de la machine d’analyse. Il lit directement les fichiers .evtx (ou des journaux déjà exportés en JSON avec l’option -J), applique les règles du dossier rules et attribue à chaque alerte un niveau : informational, low, medium, high ou critical. Les règles sont synchronisées depuis le dépôt GitHub hayabusa-rules grâce à la commande update-rules.
La qualité des résultats dépend directement de la journalisation en place. Un poste qui ne conserve que les journaux par défaut livrera bien moins d’indices qu’une machine équipée de Sysmon et d’une stratégie d’audit avancée : Hayabusa embarque d’ailleurs un jeu de règles dédié aux événements Sysmon (dossier rules\hayabusa\sysmon).
Côté sortie, plusieurs profils déterminent les colonnes produites (list-profiles les affiche ; par exemple verbose, super-verbose ou timesketch). L’outil peut aussi générer un rapport de synthèse HTML (-H), enrichir les adresses IP avec des données GeoIP MaxMind (-G) et récupérer des enregistrements dans l’espace résiduel des fichiers .evtx (-x, désactivé par défaut).
Installation
Yamato Security publie des binaires signés sur la page Releases du dépôt GitHub : Windows (x64 et ARM64, avec des paquets « live-response » destinés à l’exécution sur une machine en production), Linux (x64 et ARM64, en versions glibc et musl) et macOS (Intel et Apple Silicon), ainsi qu’une archive regroupant toutes les plateformes. Il suffit de décompresser l’archive ; l’exécutable fourni porte le nom de la version et de la plateforme, que vous pouvez renommer pour simplifier. La première commande à lancer est la mise à jour des règles.
# Windows (PowerShell) - archive téléchargée depuis la page Releases officielle
Expand-Archive .\hayabusa-4.4.0-win-x64.zip -DestinationPath C:\Outils\hayabusa
cd C:\Outils\hayabusa
# (renommer l'exécutable fourni en hayabusa.exe pour simplifier)
.\hayabusa.exe update-rules
.\hayabusa.exe help
# Linux x64 (glibc)
unzip hayabusa-4.4.0-lin-x64-gnu.zip -d ~/hayabusa && cd ~/hayabusa
chmod +x ./hayabusa # après renommage de l'exécutable
./hayabusa update-rules Utilisation au quotidien
Le scénario type est l’analyse hors ligne : vous collectez le dossier C:\Windows\System32\winevt\Logs de la machine suspecte (en conservant une empreinte des fichiers), puis vous lancez Hayabusa sur une station d’analyse. La commande centrale est csv-timeline (ou json-timeline pour du JSON/JSONL). Sans l’option -w, un assistant vous demande quelles règles charger ; avec -w, Hayabusa analyse tous les événements et toutes les alertes sans poser de question, ce qui convient aux scripts.
-dpointe vers un dossier de fichiers.evtx,-fvers un seul fichier, et-lanalyse directement les journaux de la machine locale (privilèges administrateur requis).-mfixe le niveau minimal des règles chargées : commencer par-m mediumou-m highpermet d’aller droit aux alertes les plus graves.-Uexprime les horodatages en UTC, indispensable pour corréler plusieurs machines ;-Hproduit un rapport HTML de synthèse.
Le CSV obtenu s’ouvre dans LibreOffice Calc ou dans Timeline Explorer, puis se filtre par niveau, par ordinateur ou par titre de règle. Pour aller plus vite, les commandes d’analyse donnent une vue d’ensemble avant même la timeline : répartition des ID d’événements, résumé des connexions réussies et échouées, ou liste de mots-clés suspects sur lesquels pivoter.
# Timeline CSV d'un dossier de journaux collectés, alertes medium et plus, en UTC, avec rapport HTML
hayabusa.exe csv-timeline -d C:\Collecte\PC042\Logs -m medium -U -o pc042.csv -H pc042.html -w
# Triage en direct sur la machine (console administrateur) : alertes de niveau low et plus
hayabusa.exe csv-timeline -l -m low
# Export JSONL (pour Elastic Stack, jq...) et import Timesketch
hayabusa.exe json-timeline -d C:\Collecte\PC042\Logs -L -o pc042.jsonl -w
hayabusa.exe csv-timeline -d C:\Collecte\PC042\Logs --RFC-3339 -o timesketch-import.csv -p timesketch -U
# Vues d'ensemble et recherche
hayabusa.exe eid-metrics -f Security.evtx
hayabusa.exe logon-summary -d C:\Collecte\PC042\Logs -o logon-summary.csv
hayabusa.exe search -d C:\Collecte\PC042\Logs -k "mimikatz"
hayabusa.exe pivot-keywords-list -d C:\Collecte\PC042\Logs -m critical -o keywords Trois cas d’usage concrets
Réponse à incident : un serveur présente un comportement anormal. En quelques minutes, la timeline fait ressortir les alertes critiques (création de service inattendue, effacement du journal Sécurité, outil de vol d’identifiants) et leur horodatage, ce qui permet de reconstituer la chronologie de l’attaque et de délimiter la période à investiguer.
Compromission de comptes : la commande
logon-summaryliste les connexions réussies et échouées par compte et par source, utile pour repérer une attaque par force brute ou une connexion depuis une machine inhabituelle.Chasse aux menaces proactive : sur un échantillon de postes, une analyse régulière avec
-m highpermet de vérifier qu’aucun signal faible n’est passé sous le radar, et de mesurer au passage les lacunes de journalisation (journaux trop petits, audit incomplet).
Pour exploiter des timelines volumineuses, Yamato Security propose également Takajo, un outil compagnon qui analyse les résultats de Hayabusa ; pour la collaboration entre analystes, l’import dans Timesketch ou dans une pile Elastic reste la voie la plus confortable.
Hayabusa face aux alternatives
Chainsaw (WithSecure) : également écrit en Rust et compatible Sigma, c’est l’outil le plus proche dans l’esprit. Hayabusa se distingue par sa prise en charge des corrélations Sigma v2 et par ses nombreuses commandes d’analyse et profils de sortie.
DeepBlueCLI : un script PowerShell dont les détections sont codées en dur. Pratique pour un tri rapide, mais bien moins extensible qu’un moteur de règles Sigma.
Zircolite : un outil Python qui applique les règles Sigma via SQLite et accepte aussi d’autres formats de journaux ; plus souple, mais généralement moins rapide sur de gros volumes de
.evtx.EvtxECmd (Eric Zimmerman) : il normalise les
.evtxen CSV pour Timeline Explorer, sans moteur de détection Sigma.SIEM et EDR : Wazuh ou une collecte via Winlogbeat surveillent en continu. Hayabusa ne les remplace pas : c’est un outil ponctuel d’investigation et de chasse, idéal quand les journaux n’ont jamais été centralisés ou pour vérifier une machine précise.
Bonnes pratiques
Travaillez sur des copies : collectez les
.evtx, calculez leurs empreintes et analysez-les sur une station dédiée ; réservez l’option-lau triage d’urgence.Mettez à jour les règles avec
update-rulesavant chaque investigation, et adaptez les niveaux à votre contexte aveclevel-tuning.Prévoyez l’antivirus : les fichiers de règles contiennent des chaînes caractéristiques d’outils offensifs et peuvent être signalés ; une station d’analyse dédiée évite les mauvaises surprises.
Améliorez la journalisation en amont : stratégie d’audit avancée, journalisation des blocs de script PowerShell, Sysmon et taille de journaux suffisante. Sans événements, aucune règle ne peut détecter quoi que ce soit.
Passez à l’échelle avec Velociraptor pour exécuter Hayabusa sur tout un parc, et envoyez les sorties JSONL vers votre plateforme d’analyse.
Respectez la licence : l’AGPLv3 ne pose pas de difficulté pour un usage interne, mais impose des obligations si vous intégrez l’outil dans un service proposé à des tiers.
Conclusion
Hayabusa transforme des millions d’événements Windows bruts en une chronologie hiérarchisée, prête à être lue par un analyste en quelques minutes. Gratuit, rapide, compatible Sigma et sans installation, il mérite une place dans toute trousse de réponse à incident, en complément d’un SIEM et d’un outil de collecte comme Velociraptor. Commencez par l’essayer sur les journaux d’une machine de test : la richesse des résultats vous dira aussi beaucoup sur la qualité de votre politique de journalisation.
À lire aussi : TheHive : faire face aux menaces numériques · MISP : la plateforme open source de partage du renseignement sur les menaces


