Moteur d'orchestration de scans OXO

OXO est un framework de scan de sécurité conçu pour la modularité, l'évolutivité et la simplicité. Il est open source et maintenu par Ostorlab.

Le moteur OXO combine des outils spécialisés qui travaillent de manière cohérente pour trouver des vulnérabilités et effectuer des actions telles que la reconnaissance, l'énumération et le fingerprinting.

Main oxo

Fonctionnalités clés

Modulaire et évolutif : Combinez facilement plusieurs agents spécialisés pour effectuer des scans complets.
Prise en charge étendue des actifs : Scannez tout, des adresses IP et domaines aux applications mobiles (Android, iOS, HarmonyOS) et aux schémas d'API.
Agent Store : Accédez à une bibliothèque croissante d'agents communautaires et officiels pour les outils de sécurité populaires.
Extensible : Prise en charge intégrée pour créer et publier vos propres agents à l'aide d'un framework Python simple.
API First : Dispose d'une API GraphQL pour une intégration facile dans les pipelines CI/CD et autres workflows automatisés.

Prérequis

Docker est requis pour exécuter des scans localement. Pour installer Docker, veuillez suivre ces instructions.

Installation

OXO est distribué sous forme de package Python sur PyPI. Pour l'installer, exécutez simplement la commande suivante si vous avez déjà pip installé.

pip install -U ostorlab

Démarrage

OXO est livré avec un store qui compte des dizaines d'agents, allant des agents de scan réseau comme Nmap, Nuclei ou Tsunami, aux scanners web comme ZAP, aux outils de fingerprinting web comme WhatWeb et Wappalyzer, aux outils de brute-force DNS comme Subfinder et Dnsx, au scan de fichiers malveillants comme VirusTotal, et bien plus encore.

Pour exécuter n'importe lequel de ces outils combinés, exécutez simplement la commande suivante :

La CLI OXO est accessible via les commandes oxo ou ostorlab.

oxo scan run --install --agent agent/ostorlab/nmap --agent agent/ostorlab/tsunami --agent agent/ostorlab/nuclei ip 8.8.8.8

Cette commande téléchargera et installera les agents de scan suivants :

Elle scannera l'adresse IP cible 8.8.8.8.

Les agents sont livrés sous forme d'images Docker standard.

Gestion des scans

Pour vérifier l'état du scan, exécutez :

oxo scan list

Une fois le scan terminé, pour accéder aux résultats du scan, exécutez :

oxo vulnz list --scan-id <scan-id>
oxo vulnz describe --vuln-id <vuln-id>

Pour arrêter un scan en cours, exécutez :

oxo scan stop --scan-id <scan-id>

Image Docker

Pour exécuter oxo dans un conteneur, vous pouvez utiliser l'image publiquement disponible et exécuter la commande suivante :

docker run -v /var/run/docker.sock:/var/run/docker.sock ostorlab/oxo:latest scan run --install --agent agent/ostorlab/nmap ip 8.8.8.8

Remarques :

La commande commence directement par : scan run, car l'image ostorlab/oxo a oxo comme entrypoint.
Il est important de monter le socket Docker afin qu'OXO puisse créer des agents sur la machine hôte.

Journaux du scanner on-prem

Lors de l'exécution d'OXO en tant que scanner on-prem, utilisez --persist-logs pour écrire les journaux du scanner sur le disque :

oxo scanner --scanner-id <scanner-uuid> --persist-logs

Par défaut, les journaux sont écrits dans ~/.ostorlab/scanner.log. Pour choisir un autre fichier :

oxo scanner --scanner-id <scanner-uuid> --persist-logs --log-file /var/log/ostorlab/scanner.log

Pour modifier la verbosité des journaux persistés :

oxo scanner --scanner-id <scanner-uuid> --persist-logs --log-level DEBUG

Actifs

OXO prend en charge le scan de plusieurs types d'actifs, permettant une couverture de sécurité complète sur différentes plateformes et protocoles.

Catégorie	Actif	Description
Réseau	`ip`	Adresse IP ou plage d'adresses IP (v4 et v6).
	`domain-name`	Nom de domaine.
Web	`link`	Lien web, acceptant une URL, une méthode, des en-têtes et un corps de requête.
	`api-schema`	Schéma d'API (OpenAPI, GraphQL, etc.).
Mobile	`android-apk` / `android-aab`	Fichiers de package Android (.APK, .AAB).
	`android-store`	Application Android dans le Google Play Store.
	`ios-ipa`	Fichier de package iOS (.IPA).
	`ios-store`	Application iOS dans l'Apple App Store.
	`ios-testflight`	Application iOS dans TestFlight.
	`harmonyos-apk` / `harmonyos-hap`	Fichiers de package HarmonyOS.
Autre	`file`	Fichier générique.
	`phone-number`	Numéro de téléphone.
	`agent`	Méta-scan d'un agent.

Le Store

OXO répertorie tous les agents sur un store public où vous pouvez rechercher et également publier vos propres agents.

Store

Publier votre premier agent

Pour écrire votre premier agent, vous pouvez consulter un tutoriel complet ici.

Les étapes sont essentiellement les suivantes :

Clonez un agent modèle avec tous les fichiers déjà configurés.
Modifiez le fichier template_agent.py pour ajouter votre logique.
Modifiez le Dockerfile en ajoutant les étapes de build supplémentaires nécessaires.
Modifiez le ostorlab.yaml en ajoutant les sélecteurs, la documentation, l'image et la licence.
Publiez-le sur le store.

Une fois votre agent écrit, vous pouvez le publier sur le store pour que d'autres puissent l'utiliser et le découvrir. Le store gérera la construction de l'agent et récupérera automatiquement les nouvelles versions depuis votre dépôt Git.

Build

Idées d'agents à construire

Implémentations d'outils populaires tels que :

oxo

Populaires