Cet outil est conçu à des fins de sécurité défensive. Il est destiné à être utilisé par les développeurs et les équipes de sécurité pour auditer leurs propres applications et dépôts Git afin de détecter et de prévenir les fuites de secrets et de clés API.
L'utilisation de cet outil pour scanner, tester ou attaquer des systèmes, applications ou dépôts pour lesquels vous n'avez pas une autorisation explicite est illégale et contraire à l'éthique. Les utilisateurs sont seuls responsables de leurs actions.
Pour installer les dépendances du projet, utilisez votre gestionnaire de paquets Python préféré.
Avec uv
ou pip
:
pip install .
Avec Poetry
:
poetry install
Avant de lancer l'application, vous devez configurer votre clé d'API Google Gemini pour que les validateurs de clés fonctionnent correctement.
- Naviguez vers le dossier
src/apikey_validator/
. - Créez une copie du fichier
config.example.json
et renommez-la enconfig.json
. - Ouvrez
config.json
et remplacez"VOTRE_CLE_API_GEMINI_ICI"
par votre véritable clé d'API.
Le fichier config.json
est ignoré par Git pour garantir la sécurité de votre clé.
Cet outil peut être utilisé via une interface graphique ou en ligne de commande.
Pour lancer l'interface graphique de bureau :
flet run
# ou poetry run flet run
Pour lancer l'interface en tant qu'application web :
flet run --web
# ou poetry run flet run --web
L'outil fournit également une interface en ligne de commande puissante pour l'automatisation et l'intégration dans des scripts.
Utilisation de base :
python -m src.apikey_validator.cli <commande> [options]
Commandes disponibles :
validate
: Valider une clé API complète.brute-force
: Deviner la fin d'une clé incomplète.dictionary
: Attaquer une clé avec une liste de mots.scan
: Scanner un répertoire local à la recherche de clés.scan-git
: Scanner l'historique d'un dépôt Git local.scan-remote-git
: Cloner et scanner un dépôt Git distant.scan-entropy
: Scanner un répertoire pour des chaînes à haute entropie.
Pour obtenir de l'aide sur une commande spécifique, utilisez l'option -h
ou --help
.
python -m src.apikey_validator.cli scan -h
Pour créer un exécutable de l'interface graphique pour votre plateforme, utilisez la commande flet build
.
flet build apk -v
flet build ipa -v
flet build macos -v
flet build linux -v
flet build windows -v