Le couteau suisse du pentester.

Fonctionnalités • Commandes prises en charge • Installation • Utilisation • Documentation • Rejoignez-nous sur Discord !

secator est un exécuteur de tâches et de workflows utilisé pour les évaluations de sécurité. Il prend en charge des dizaines d'outils de sécurité bien connus et est conçu pour améliorer la productivité des pentesters et des chercheurs en sécurité.

Fonctionnalités

• Liste organisée de commandes

• Options d'entrée unifiées

• Schéma de sortie unifié

• Utilisation en CLI et en tant que bibliothèque

• Options distribuées avec Celery

• Complexité allant de tâches simples à des workflows complexes

• Personnalisable

Outils pris en charge

secator intègre les outils suivants :

N'hésitez pas à demander l'ajout de nouveaux outils en ouvrant une issue, mais veuillez vérifier au préalable que l'outil respecte nos critères de sélection. Si ce n'est pas le cas mais que vous souhaitez tout de même l'intégrer dans secator, vous pouvez le brancher (voir le guide développeur).

Installation de secator

bash -c "$(curl -fsSL https://raw.githubusercontent.com/freelabz/secator/main/scripts/install_universal.sh)"

pipx install secator

pip install secator

docker run -it --rm --net=host -v ~/.secator:/root/.secator freelabz/secator --help

alias secator="docker run -it --rm --net=host -v ~/.secator:/root/.secator freelabz/secator"

secator --help

git clone https://github.com/freelabz/secator
cd secator
docker-compose up -d
docker-compose exec secator-client secator --help

Note : Si vous avez choisi les méthodes d'installation Docker ou Docker Compose, vous pouvez passer les sections suivantes et aller directement à Utilisation.

Utilisation

secator --help

Exemples d'utilisation

Pour obtenir une antisèche complète de ce que vous pouvez faire avec secator, veuillez lire la sortie de :

secator cheatsheet

Lancer une tâche de fuzzing (ffuf) :

secator x ffuf http://testphp.vulnweb.com/FUZZ

Lancer un workflow de crawl d'URL :

secator w url_crawl http://testphp.vulnweb.com

Lancer un scan d'hôte :

secator s host mydomain.com

Pour lister toutes les tâches / workflows / scans que vous pouvez utiliser :

secator x --help
secator w --help
secator s --help

Pour savoir quels langages ou outils sont installés sur votre système (ainsi que leur version) :

secator health

Requêtes

secator vous permet d'interroger tous les rapports précédents avec la commande secator query (ou secator q), et de réutiliser des requêtes.

secator q <arg> résout son argument en trois étapes :

1. Nom de requête sauvegardée — si <arg> correspond à une requête sauvegardée, son expression est utilisée.
2. Expression de filtre — si <arg> ressemble à un filtre (contient ==, <, ~=, &&, …), il est passé directement.
3. Langage naturel — sinon, il est envoyé au chat IA (secator x ai --mode chat).

# Exécuter des expressions brutes directement
secator q "vulnerability.tags ~= 'kev' && vulnerability.confidence == 'high'"                                                     # vulns KEV (Vulnérabilités Connues Exploitées) + haute confiance
secator q "vulnerability.severity == 'critical' && vulnerability.tags ~= 'exploitable' && vulnerability.confidence == 'high'"     # vulns critiques + exploitables + haute confiance
secator q "vulnerability.severity_nb < 2 && vulnerability.confidence == 'high'"                                                   # vulns sévérité > haute + haute confiance
secator q "exploit.cves  ~= 'CVE-2021-44521'"                                                                                       # exploits trouvés pour la vuln CVE-2021-44521
secator q "port" -f "{host} {port} {service_name}" | cut -d " " -f2 | sort | uniq -c | sort -nr | head -n 15                      # top 15 ports
secator q "port" -f "{host} {port} {service_name}" | cut -d " " -f3,4,5,6 | awk 'NF > 0' | sort | uniq -c | sort -nr | head -n 15 # top 15 services
secator q "technology" -f "{product}/{version}" | sort | uniq -c | sort -nr | head -n 15                                          # top 15 technologies
secator q "port.state == 'open'" -rf scans/23,tasks/10                                                                            # seulement les résultats du scan 23 et de la tâche 10

# Sauvegarder une requête et l'exécuter
secator c set queries.critical_vulns "vulnerability.severity_nb < 2"          # sauvegarder une requête
secator c get queries                                                         # lister les requêtes sauvegardées
secator q critical_vulns -f "{vulnerability.matched_at}" -ws secator.cloud    # exécuter une requête sauvegardée sur un workspace + extraire les cibles

# Poser une question en langage naturel (lance la tâche de chat IA)
secator q "Analyze my workspace data"

secator q accepte les mêmes options que secator r show (-o/--output, -d/--time-delta, -f/--format, -w/-ws/--workspace, --driver, --dedupe), plus -rf/--report-filter pour limiter la requête à des chemins d'exécution spécifiques (l'équivalent de l'argument REPORT_QUERY de r show). Sur le chemin du chat IA, seuls le workspace et le prompt sont utilisés.

Autocomplétion du shell

secator prend en charge l'autocomplétion du shell pour bash, zsh et fish. Cela fournit l'auto-complétion pour :

• Les noms de tâches (ex. : nmap, httpx, nuclei)
• Les noms de workflows (ex. : url_crawl, subdomain_recon)
• Les noms de scans (ex. : host, domain, network)
• Les options CLI comme --profiles, --workspace, --driver, --output

Pour installer l'autocomplétion du shell :

Bash :

secator util completion --shell bash --install
source ~/.bashrc

Zsh :

secator util completion --shell zsh --install
source ~/.zshrc

Fish :

secator util completion --shell fish --install

Après installation, vous pouvez utiliser la complétion par tabulation :

secator x n<TAB>     # complète en nmap, naabu, nuclei, etc.
secator w url_<TAB>     # complète en url_crawl, url_fuzz, url_dirsearch, etc.
secator x nmap --profiles ag<TAB>  # complète en aggressive

Installation des outils

secator installe automatiquement les outils lors de leur première utilisation. Vous pouvez empêcher ce comportement en définissant security.autoinstall_commands à false en utilisant soit secator config set security.autoinstall_commands false soit SECATOR_SECURITY_AUTOINSTALL_COMMANDS=0.

Pour installer tous les outils, vous pouvez toujours exécuter :

secator install tools

Installation des addons

Des addons sont disponibles pour secator, veuillez consulter notre documentation pour les détails.

Par exemple, l'utilisation de l'addon mongodb vous permet d'envoyer les résultats du runner vers MongoDB.

En savoir plus

Pour approfondir avec secator, consultez :

• Notre documentation complète
• Notre vidéo tutoriel pour commencer
• Notre article Medium
• Suivez-nous sur les réseaux sociaux : @freelabz sur Twitter et @FreeLabz sur YouTube

Statistiques