Package: little-owl
Little_owlLittle_owlest un outil d’aide à l’administration réseau.
Il permet de découvrir l’environnement réseau local du poste qui l’utilise.
Dans le cas d’un poste connecté à Internet,Little_owlpeut donner l’adresse IP publique ainsi que la liste des routeurs récurantsL’utilisation des droits administrateur (sudo) est nécessaire au bon fonctionnement de l’outil.Little_owlva scanner séparement l’activité des couchesLiaisonetRéseau.
Le protocole IPv4 est pleinement supporté.
Le protocole IPv6 est partiellement supporté, uniquement les informations du poste de travail sont recueillies.Il est possible d’exporter le résultat d’une recherche au format JSON pour pouvoir le consulter ultérieurement sur un autre poste.FonctionnalitésLes fonctionnalités disponibles sont décrites ci-dessous:scanner actifscanner passifscanner de ports TCP (SynScan) / UDPrecherche de voisinsdécouverte dhcpexportation jsonimportation jsonrésolution constructeur MACdécouverte adresse IP publiquedécouverte points de passages obligésInstallationCette section décrit le processus d’installation et de desintallation du programmePré-requisLes modules suivants seront installés pour faire fonctionner l’outil:netifacespsutilscapyL’utilisation descapyrequiert que le programmetcpdumpsoit installé et fonctionnel.A partir de pip3Installation à partir de pip3pip3 install little_owlInstallation à partir du fichier .whl (Remplacer X.Y.Z par la version).pip3 install little_owl-X.Y.Z-py3-none-any.whlA partir des sourcesInstallation à partir des sources (Remplacer X.Y.Z par la version).tar -xzvf little_owl.X.Y.Z.tar.gz
cd little_owl
python3 setup.py installDésintallationCette section décrit la procédure de désinstallationA partir de pip3Avec la commande :pip3 uninstall little_owl

# Supprimer les modules python complémentaires
# Attention, adapter cette commande si d'autres programmes ont besoin de ces modules
pip3 uninstall scapy netifaces psutilA partir des sourcesLa désinstallation des sources doit se faire avec la suppression manuelle des fichiers installer.
Pour ce faire :# récupérer la liste des fichiers installés
python3 setup.py install --record fichiers_lo.txt

# Supprimer les fichiers
xargs rm -rf < fichiers_lo.txt

# Supprimer les modules python complémentaires
# Attention, adapter cette commande si d'autres programmes ont besoin de ces modules
pip3 uninstall scapy netifaces psutilUsageAide à l’usageLes droits administrateurs sont nécessaire à la bonne execution du programme.little_owl -h
usage: little_owl [-h] [-q] [-d SEC] [-l] [-s | -m | -r JSONF] [-e [JSONF]] [-o [FICHIER]] [-p]

Decouverte des reseaux et machines voisines a partir du poste de travail. Scan passif, actif, et des ports ouverts.

optional arguments:
    -h, --help                          show this help message and exit
    -q, --quiet                         l'affichage des infos et erreurs est désactivé
    -d SEC, --duree SEC                 temps en seconde pour le scan passif
    -l, --local                         recherche uniquement les informations des réseaux locaux
    -s, --single-p                      déroulé sequentiel du programme
    -m, --mulpi-p                       réalisation de scans en parallèle (par défaut)
    -r JSONF, --read JSONF              lecture et affichage d'un fichier JSONF de données au format json
    -e [JSONF], --export [JSONF]        fichier JSONF pour l'exportation des données au format json
    -o [FICHIER], --output [FICHIER]    fichier FICHIER de sortie pour l'affichage
    -p, --no-port                       Ne scanne pas les ports ouverts pour les machines détectées

Attention ce programme n'est absolument pas discret, ENJOYSortieLes informations recueillies et mise en forme par le programme sont:les informations sur le poste administrateur:noms des interfaces réseauxadresses MACconstructeurs des interfaces réseauxadresses IP associéeslistes des ports en écoute par adresse IPla listes des machines avec:adresses MAC détectéesadresses IP associées à l’adresse MACliste des ports ouvert TCP/UDP (uniquement pour les adresses IP privées)la liste des réseaux L2 (couche liaision du modèle OSI):liste des machines détectées sur le réseauxInformations DHCPadresse BOOTPCserveur DHCPmasque de sous réseauoffre IPgatewayserveurs DNSdomainela liste des réseaux L3 (couche Réseau)liste des machines détectées sur le réseauxgatewayadresse IP publique avec localisationroute par défaut avec adresse IP et localisationDéroulementlittle_owlrecherche dans un premier temps les informations du postes administrateur.
Pour cela il recherche les interfaces réseaux présentes et “UP”.
Il récupère les adresses MAC et avec sa base de données des constructeurs, il détermine la marque.
Le nombre d’interface réseau découvertes va déterminer le nombre de réseau L2 qui seront créés.
Le nombre de réseaux L3 sera déterminé par le nombre d’adresse IP pour chaque interface réseau.
Le programme utilise également le modulepsutilspour déterminer les ports en écoutes pour chaque adresse IP.Une fois l’ensemble des informations du poste administrateur recueillies,little_owlva écouter passivement toutes ses interfaces réseaux et lancer une requête DHCP.
Si un serveur DHCP est présent les éléments de réponses seront associé au réseau.
Des machines pourront être détectée durant cette phase.Le scan des réseaux L3 se fait de manière active à l’aide d’un ping scan.Une fois l’ensemble des machines découvertes, le programme va rechercher des informations complémentaires
si la connectivité vers Internet est assurée. Il va pouvoir déterminer l’adresse IP publique ainsi que la route par défaut.
Cette route comporte la liste des routeurs qui semblent obligatoire pour rejoindre le WEB.
Pour ce faire plusieurs traceroute sont lancés vers plusieurs sites hébergés dans plusieurs pays.Enfinlittle_owleffectue un scanne basique des ports TCP/UDP ouvert pour chaque machine qui a été détectée.
Ce scanne n’aura lieu pour les adresses IP privées.Informations complémentairesDe la documentation complémentaire sur les modules, les objets et l’utilisation de JSON est disponible dans le dossier :docs/AuteurProgramme écrit part GOEHRY Martial