yanglittlecat/blackbox-pentest

Que fait blackbox-pentest ?

Compétence Codex pour les tests de pénétration en boîte noire autorisés et les workflows de bug bounty.

Aperçu

Cette compétence fournit un ensemble d'outils et de directives pour réaliser des tests de pénétration en boîte noire de manière éthique et structurée. Elle est conçue pour être utilisée avec Codex CLI ou tout terminal AI compatible, en se concentrant sur l'automatisation des tâches de reconnaissance, d'exploitation et de rapport.

Fonctionnalités

• Reconnaissance passive : Découverte de sous-domaines, collecte d'informations via OSINT, analyse des en-têtes HTTP.
• Scan actif : Scanning de ports, identification de services, détection de vulnérabilités courantes.
• Exploitation contrôlée : Utilisation de payloads et techniques d'exploitation sur cibles autorisées uniquement.
• Génération de rapports : Création de rapports techniques détaillés au format Markdown.
• Workflows reproductibles : Scripts shell et commandes automatisés pour les étapes communes.

Utilisation

1. Prérequis : Avoir un accès autorisé à la cible et disposer de curl, nmap, dig, python3 et jq dans le PATH.
2. Configuration : Copier le fichier .env.example en .env et définir les variables nécessaires (triages scope, tokens API si besoin).
3. Workflow typique :
   • codex run recon-sous-domaines example.com
   • codex run scan-ports -target 192.168.1.0/24
   • codex run analyse-vuln-web -url https://example.com
   • codex run generer-rapport -output rapport.md
4. Respect des limites : Tester uniquement les cibles spécifiquement autorisées dans votre scope de bug bounty ou contrat.

Exemple de workflow automatisé

# Explorer les sous-domaines
codex run recon-pasive example.com --stdout > sous-domaines.txt

# Scanner les sous-domaines trouvés
for sous-domaine in $(cat sous-domaines.txt); do
    codex run scan-ports -target $sous-domaine
done

# Analyser les vulnérabilités web
codex run check-headers -f sous-domaines.txt | tee headers.txt
codex run test-sqli -f sous-domaines.txt 2>/dev/null

Éthique et conformité

Cette compétence est destinée exclusivement à des tests autorisés. L'utilisateur est responsable de s'assurer que toute action entreprise respecte les termes du programme bug bounty, le contrat de test d'intrusion, ou toute autre autorisation écrite. N'utilisez jamais cette compétence sur des cibles sans consentement explicite.

Dépendances

• curl (requis)
• nmap (requis pour le scan actif)
• dig (requis pour la reconnaissance DNS)
• python3 (requis pour les scripts d'analyse avancée)
• jq (recommandé pour le traitement JSON)

Contribution

Les contributions sont les bienvenues ! Veuillez soumettre une pull request avec vos modifications, en veillant à respecter les principes éthiques et la documentation existante.

Licence

MIT