Une boîte à outils Python éducative pour les tests d'intrusion autorisés : scanner de ports multithread, énumération de sous-domaines et de répertoires, récupérateur de bannières et découverte d'hôtes, avec une interface CLI riche.
Une boîte à outils Python légère et éducative qui automatise les tâches courantes de reconnaissance et d'énumération utilisées dans les tests d'intrusion autorisés. Conçue comme un projet d'apprentissage pour la pratique de la cybersécurité / du hacking éthique.
Cette boîte à outils effectue du scan actif et de l'énumération. L'exécuter contre des systèmes que vous ne possédez pas ou pour lesquels vous n'avez pas la permission écrite explicite de tester peut constituer un crime dans la plupart des juridictions.
Les auteurs déclinent toute responsabilité en cas de mauvaise utilisation.
Ce qui a changé de la v1 → v2 : package modulaire, CLI argparse avec sous-commandes,
scanners multithreadés, une interface propulsée par rich (bannière ASCII, barres de progression en direct et
tableaux de résultats), validation des entrées, une barrière d'autorisation, des tests unitaires et un
pipeline GitLab CI.
# install virtualenv and activate
python3 -m venv venv
. venv/bin/activate
# install packages
pip3 install -r requirements.txt
# run (always from the project root)
python3 main.py --help
python -m venv venv
. .\venv\Scripts\activate # (PowerShell)
. venv/scripts/activate # (Git Shell)
pip install -r requirements.txt
python main.py --help
Exécutez toujours depuis la racine du projet via python main.py … (le package src
contient des modules nommés http et dir, donc exécuter des scripts depuis src/
pourrait masquer la bibliothèque standard).
# Port scan with a custom port set / range
python main.py portscan 192.168.1.10 --ports 22,80,443
python main.py portscan 192.168.1.10 --ports 1-1024
# Banner grab
python main.py banner 192.168.1.10 22
# Directory enumeration (default or custom wordlist)
python main.py dirscan http://target.local
python main.py dirscan http://target.local --wordlist admin login backup api
# Subdomain discovery
python main.py subdomains example.com
# Live-host discovery on a subnet
python main.py netscan 192.168.1.0/24
# HTTP response inspection
python main.py httpprobe http://target.local
# Credential test against a lab login form (authorization required)
python main.py logincheck http://target.local/login \
--users admin user --passwords admin 1234 password
# Global options
python main.py --threads 100 --timeout 1.5 -v portscan 192.168.1.10
# Skip the interactive prompt in scripted, pre-scoped engagements
python main.py --i-am-authorized netscan 10.0.0.0/24
pip install -r requirements-dev.txt # runtime + pytest + ruff
pytest -v # run tests
ruff check . # lint
Les dépendances d'exécution se trouvent dans requirements.txt ; les outils de test/lint se trouvent dans
requirements-dev.txt (qui inclut les dépendances d'exécution), donc les utilisateurs finaux n'installent jamais
pytest.
Le pipeline GitLab (.gitlab-ci.yml) exécute le lint + les tests à chaque push.
simple-pentesting/
├── main.py # entry point (run from here)
├── src/ # the package
│ ├── __init__.py
│ ├── cli.py # argparse CLI
│ ├── config.py # defaults & Settings
│ ├── utils.py # validation helpers
│ ├── ui.py # rich UI: banner, progress, tables, auth prompt
│ ├── port_scanner.py # one file per feature ↓
│ ├── banner.py
│ ├── dir.py
│ ├── subdomain.py
│ ├── netscan.py
│ ├── http.py
│ └── login_check.py
├── tests/ # offline unit tests
├── .gitlab-ci.yml
├── requirements.txt # runtime deps
├── requirements-dev.txt # + pytest, ruff
├── LICENSE
└── .gitignore
| Commande | Ce qu'elle fait |
|---|
portscan | Scan TCP connect concurrent d'un hôte |
banner | Récupère la bannière d'un service sur un port ouvert |
dirscan | Énumère les chemins web à partir d'une wordlist |
subdomains | Résout les sous-domaines candidats |
netscan | Découvre les hôtes actifs sur une plage CIDR |
httpprobe | Inspecte une réponse HTTP (statut, en-têtes, aperçu) |
logincheck | Démo en laboratoire uniquement du risque d'identifiants faibles/par défaut (limité en débit) |