MANSPIDER

Parcourez les partages SMB à la recherche d'informations intéressantes. Recherche dans le contenu des fichiers + regex pris en charge !

---

Nouveautés de la v2.0

Manspider 2.0 est disponible ! Cette version apporte des améliorations significatives :

• Extraction de texte améliorée propulsée par Kreuzberg - prend désormais en charge PDF, DOCX, XLSX, PPTX, images avec OCR, et bien d'autres formats
• Gestion moderne des paquets avec uv pour des installations plus rapides et plus fiables
• Prise en charge de Python 3.14 - prêt pour les dernières versions de Python
• Filtrage par date - recherchez des fichiers par date de modification avec --modified-after et --modified-before
• Tests unitaires complets - fiabilité et stabilité améliorées

---

Types de fichiers pris en charge :

• PDF
• DOCX
• XLSX
• PPTX
• tout format basé sur du texte
• et bien d'autres encore !!

MANSPIDER parcourra chaque partage sur chaque système cible. Si les identifiants fournis ne fonctionnent pas, il passera en mode « invité », puis en session nulle.

Installation

Exécution rapide avec uvx (recommandé)

# Exécution directe sans installation
uvx --from git+https://github.com/blacklanternsecurity/MANSPIDER manspider --help

Installation avec uv

# Installation globale
uv tool install git+https://github.com/blacklanternsecurity/MANSPIDER

# Exécution
manspider --help

Installation avec pipx

pipx install git+https://github.com/blacklanternsecurity/MANSPIDER

Dépendances optionnelles

Manspider utilise Kreuzberg pour l'extraction de texte à partir de divers formats de fichiers. Certains formats nécessitent des dépendances système supplémentaires :

# Pour l'extraction OCR à partir d'images (PNG, JPEG, etc.)
sudo apt install tesseract-ocr

# Pour la prise en charge des formats Microsoft Office hérités (.doc, .xls)
# Kreuzberg utilise LibreOffice pour la conversion
sudo apt install libreoffice

Sans ces dépendances : Manspider fonctionnera toujours pour les fichiers PDF, DOCX, XLSX, PPTX et texte, mais ignorera l'OCR sur images et les formats Office hérités.

Installation (Docker)

docker run --rm -v ./manspider:/root/.manspider blacklanternsecurity/manspider --help

Notez qu'il existe également un script d'aide manspider.sh qui montera automatiquement les volumes pour les répertoires loot et logs de manspider, ce qui rend son exécution plus pratique :

./manspider.sh --help

Exemple n°1 : Recherche sur le réseau de noms de fichiers pouvant contenir des identifiants

REMARQUE : les fichiers correspondants sont automatiquement téléchargés dans $HOME/.manspider/loot ! (-n pour désactiver)

$ manspider 192.168.0.0/24 -f passw user admin account network login logon cred -d evilcorp -u bob -p Passw0rd

Exemple n°2 : Recherche de feuilles de calcul contenant "password" dans le nom de fichier

$ manspider share.evilcorp.local -f passw -e xlsx csv -d evilcorp -u bob -p Passw0rd

Exemple n°3 : Recherche de documents contenant des mots de passe

$ manspider share.evilcorp.local -c passw -e xlsx csv docx pdf -d evilcorp -u bob -p Passw0rd

Exemple n°4 : Recherche d'extensions de fichiers intéressantes

$ manspider share.evilcorp.local -e bat com vbs ps1 psd1 psm1 pem key rsa pub reg pfx cfg conf config vmdk vhd vdi dit -d evilcorp -u bob -p Passw0rd

Exemple n°5 : Recherche de fichiers liés à la finance

Cet exemple recherche dans les répertoires à consonance financière les noms de fichiers contenant 5 chiffres consécutifs ou plus (ex : 000202006.EFT)

$ manspider share.evilcorp.local --dirnames bank financ payable payment reconcil remit voucher vendor eft swift -f '[0-9]{5,}' -d evilcorp -u bob -p Passw0rd

Exemple n°6 : Recherche de clés SSH par nom de fichier

$ manspider share.evilcorp.local -e ppk rsa pem ssh rsa -o -f id_rsa id_dsa id_ed25519 -d evilcorp -u bob -p Passw0rd

Exemple n°7 : Recherche de clés SSH par contenu

$ manspider share.evilcorp.local -e '' -c 'BEGIN .{1,10} PRIVATE KEY' -d evilcorp -u bob -p Passw0rd

Exemple n°8 : Recherche de fichiers de gestionnaires de mots de passe

# .kdbx - KeePass Password Database (KeePass, KeePassXC)
# .kdb - KeePass Classic Database (KeePass 1.x)
# .1pif - 1Password Interchange Format (1Password)
# .agilekeychain - Agile Keychain Format (1Password, deprecated)
# .opvault - OPVault Format (1Password)
# .lpd - LastPass Data File (LastPass)
# .dashlane - Dashlane Data File (Dashlane)
# .psafe3 - Password Safe Database (Password Safe)
# .enpass - Enpass Password Manager Data File (Enpass)
# .bwdb - Bitwarden Database (Bitwarden)
# .msecure - mSecure Password Manager Data File (mSecure)
# .stickypass - Sticky Password Data File (Sticky Password)
# .pwm - Password Memory Data File (Password Memory)
# .rdb - RoboForm Data File (RoboForm)
# .safe - SafeInCloud Password Manager Data File (SafeInCloud)
# .zps - Zoho Vault Encrypted Data File (Zoho Vault)
# .pmvault - SplashID Safe Data File (SplashID Safe)
# .mywallet - MyWallet Password Manager Data File (MyWallet)
# .jpass - JPass Password Manager Data File (JPass)
# .pwmdb - Universal Password Manager Database (Universal Password Manager)
$ manspider share.evilcorp.local -e kdbx kdb 1pif agilekeychain opvault lpd dashlane psafe3 enpass bwdb msecure stickypass pwm rdb safe zps pmvault mywallet jpass pwmdb -d evilcorp -u bob -p Passw0rd

Exemple n°9 : Recherche de certificats

$ manspider share.evilcorp.local -e pfx p12 pkcs12 pem key crt cer csr jks keystore key keys der -d evilcorp -u bob -p Passw0rd

Exemple n°10 : Recherche de fichiers modifiés récemment

$ manspider share.evilcorp.local -e docx xlsx pdf --modified-after 2026-01-01 -d evilcorp -u bob -p Passw0rd

Astuce n°1 :

Vous pouvez exécuter plusieurs instances de manspider en même temps. Cela est utile lorsqu'une instance est déjà en cours d'exécution et que vous souhaitez rechercher dans ce qu'elle a téléchargé (similaire à grep -R). Pour ce faire, spécifiez le mot-clé loot comme cible, ce qui recherchera les fichiers téléchargés dans $HOME/.manspider/loot.

Astuce n°2 :

Des valeurs par défaut raisonnables aident à éviter des scénarios indésirables comme rester bloqué sur une seule cible. Toutes peuvent être modifiées :

• profondeur par défaut : 10 (modifier avec -m)
• taille maximale par défaut : 10 Mo (modifier avec -s)
• threads par défaut : 5 (modifier avec -t)
• partages exclus : C$, IPC$, ADMIN$, PRINT$ (modifier avec --exclude-sharenames)

Astuce n°3 :

Manspider accepte toute combinaison des éléments suivants comme cibles :

• adresses IP
• noms d'hôtes
• sous-réseaux (format CIDR)
• fichiers contenant l'un des éléments ci-dessus
• dossiers locaux contenant des fichiers

Par exemple, vous pouvez spécifier tout ou partie de ces éléments :

• 192.168.1.250
• share.evilcorp.local
• 192.168.1.0/24
• smb_hosts.txt
• loot (pour rechercher dans les fichiers déjà téléchargés)
• /mnt/share (pour rechercher récursivement dans un répertoire)
  • REMARQUE : lors de la recherche de fichiers locaux, vous devez spécifier un répertoire, pas un fichier individuel