Pupy

Installation simple

pip3 install pipx
pipx ensurepath
pipx install git+https://github.com/n1nj4sec/pupy@nextgen

pupysh

Si vous souhaitez des informations plus détaillées Reportez-vous au wiki

Installation de développement

git clone https://github.com/n1nj4sec/pupy
cd pupy
git checkout nextgen
git submodule init
git submodule update

pip install venv
python3 -m venv pupyvenv
source pupyvenv/bin/activate
pip install -r requirements.txt

exécutez pupysh à partir de l'installation de développement :

source pupyenv/bin/activate
python3 -m pupy.cli

Description

Pupy est un outil C2 et de post-exploitation multi-fonctions et multiplateforme principalement écrit en Python. Il suit un principe d'exécution entièrement en mémoire et laisse une très faible empreinte. Pupy peut communiquer via de multiples transports, migrer dans des processus par injection réflective, et charger du code Python distant, des paquets Python et des extensions C Python depuis la mémoire.

Fonctionnalités

• La charge utile Windows peut charger l'intégralité de l'interpréteur Python depuis la mémoire à l'aide d'une DLL réflective.

  • Pupy ne touche pas au disque.

• Peut être empaqueté en un seul fichier .py et exécuté sans aucune dépendance autre que la bibliothèque standard Python sur tous les systèmes d'exploitation.

  • PyCrypto est remplacé par des implémentations AES et RSA pures en Python lorsqu'il est indisponible.

• Migrer par réflexion dans d'autres processus.

• Importer à distance des paquets Python purs (.py, .pyc) et des extensions C Python compilées (.pyd, .so) depuis la mémoire.

  • Les modules Python importés ne touchent pas au disque.

• Facilement extensible, les modules sont simples à écrire et sont triés par système d'exploitation et catégorie.

• Les modules peuvent accéder directement aux objets Python sur le client distant en utilisant rpyc.

• Accéder de manière interactive aux objets distants depuis le shell pupy et bénéficier de l'auto-complétion des attributs distants.

• Les transports de communication sont modulaires et empilables. Exfiltrer des données en utilisant HTTP sur HTTP sur AES sur XOR, ou toute combinaison des transports disponibles.

• Communiquer en utilisant les transports enfichables d'obfsproxy.

• Exécuter des commandes non interactives sur plusieurs hôtes à la fois.

• Les commandes et scripts exécutés sur les hôtes distants sont interruptibles.

• Auto-complétion pour les commandes et les arguments.

• Une configuration personnalisée peut être définie : alias de commandes, modules à exécuter automatiquement à la connexion, etc.

• Ouvrir des shells Python interactifs avec auto-complétion sur l'interpréteur Python distant entièrement en mémoire.

• Des shells interactifs (cmd.exe, /bin/bash, etc.) peuvent être ouverts à distance.

  • Les shells distants sur les clients Unix et Windows disposent d'un vrai tty avec tous les signaux clavier fonctionnant comme un shell SSH.

• Exécuter un exécutable PE à distance et depuis la mémoire.

• Générer des charges utiles dans divers formats :

• Déployer en mémoire à partir d'une seule ligne de commande en utilisant des one-liners Python ou PowerShell.

• Intégrer des "scriptlets" dans les charges utiles générées pour effectuer certaines tâches "hors ligne" sans nécessiter de connectivité réseau (ex : démarrer un keylogger, ajouter une persistance, exécuter un script Python personnalisé, check_vm, etc.)

• Plusieurs plateformes cibles :

Documentation

Toute la documentation se trouve sur le wiki.

Reportez-vous au wiki

FAQ

Le serveur fonctionne-t-il sous Windows ?

Pupy n'a pas été testé sous Windows. Théoriquement, il devrait fonctionner sur toute plateforme prenant en charge Docker et Docker Compose. Cependant, vous devrez adapter les instructions d'installation de Docker Compose pour la plateforme Windows.

Je n'arrive pas à installer Pupy. L'installation échoue.

1. Veuillez vous référer au wiki. Il est possible que votre réponse s'y trouve.
2. Recherchez dans les issues Github et voyez si votre problème a déjà été résolu.
3. Si votre problème n'est pas résolu, ouvrez une nouvelle issue en suivant les directives pour les issues.

Si vous ne suivez pas ces étapes, votre issue sera fermée.

Les charges utiles et modules Android et/ou Mac OSX ne fonctionnent pas.

Pupy offre un support limité pour Android et OSX. Ces plateformes peuvent ne pas être bien maintenues et peuvent se casser par intermittence. Certains modules (par exemple, le keylogger) peuvent manquer pour ces plateformes.

Développement

Si certains d'entre vous souhaitent participer au développement de pupy, n'hésitez pas ! Toute aide est grandement appréciée et toutes les pull requests seront examinées.

Il existe également une petite note sur le développement. Veuillez exécuter flake8 avant de faire des commits. Le fichier de configuration est ici.

Contact

Ce projet est un développement personnel, veuillez respecter sa philosophie et ne pas l'utiliser à des fins malveillantes !

Remerciements spéciaux

Un grand merci à tous les contributeurs et supporters qui aident à améliorer pupy et à en faire un meilleur outil ! :)