izinscope 0.3.0

**izinscope** est un outil en ligne de commande permettant de vérifier si des adresses IP ou des domaines se trouvent dans un scope défini (IP, CIDR, domaines résolus). Il facilite l’identification des ressources “in-scope” et peut générer des rapports TXT ou CSV.

izinscope

izinscope est un outil en ligne de commande permettant de vérifier si des adresses IP ou des domaines se trouvent dans un “scope” défini (IP, CIDR, domaines résolus). Il facilite l’identification des ressources in-scope et peut générer des rapports en format TXT ou CSV.

---

Installation

Via pipx (recommandé)

Assurez-vous d’avoir pipx installé, puis exécutez :

pipx install git+https://github.com/MahafalyRandriamiarisoa/izinscope.git

Vous pouvez alors utiliser la commande izinscope depuis votre terminal.

Installation locale avec Poetry

1. Cloner le dépôt :

   git clone https://github.com/MahafalyRandriamiarisoa/izinscope.git
   cd izinscope
   

2. Installer les dépendances :

   poetry install
   

3. Lancer la commande en local :

   poetry run izinscope --help
   

---

Utilisation

Vérifier une IP unique

izinscope -s scope.txt -i 192.168.10.5

• -s, --scope : Fichier contenant ton “scope” (CIDR, IP, domaines).
• -i, --single-check : Vérification d’une seule IP.

Vérifier un fichier de domaines

izinscope -s scope.txt -d domains.txt --debug -oT out.txt -oC out.csv

• -d, --domains-to-check : Fichier listant les domaines à vérifier.
• --debug : Active un mode de logs détaillés (fichier log).
• -oT, --output-txt : Nom du fichier de sortie TXT (un domaine par ligne).
• -oC, --output-csv : Nom du fichier de sortie CSV (domaine,ip,ip,...).

Options supplémentaires

• --version : Affiche la version d’izinscope.
• --help : Affiche l’aide.

---

Exemple de fichier scope

192.168.0.0/24
10.0.0.1
example.com

• CIDR : 192.168.0.0/24
• IP unique : 10.0.0.1
• Domaine : example.com (résolution DNS en IPv4/IPv6)

---

Points clés

• Résolution DNS : géré via dnspython, pour couvrir IPv4 et IPv6.
• Multithreading : le script peut résoudre plusieurs domaines en parallèle, accélérant l’analyse de grandes listes.
• Logs : en mode --debug, un fichier de log horodaté est généré pour chaque exécution.
• Rapports : possibilité de générer un fichier CSV (liste de domaines et leurs IP in-scope) et un fichier TXT (domaines in-scope uniquement).

---

Licence

Distribué sous licence MIT. Voir le fichier LICENSE pour plus de détails.

---

Contributions

Les contributions sont les bienvenues sous forme de pull requests. Merci d’ouvrir une issue pour discuter des améliorations ou signaler des bugs avant de proposer un PR.

---

Bon usage !