**API-first design** - intégration avec n'importe quelle pile de sécurité.

</td>
</tr>
</table>



---


## 🔄 Comment ça fonctionne

<div align="center">

### Le pipeline de détection en quatre étapes

</div>

<details> 
<summary><b>🎨 Cliquez ici pour développer le diagramme interactif</b></summary>```mermaid
flowchart TD
    Start([🌐 Incoming Request]) --> Stage0{🔓 Stage 0<br/>Whitelist Check}
    
    Stage0 -->|✅ Whitelisted IP/Path| Allow[✅ ALLOW<br/>Pass to Backend]
    Stage0 -->|❌ Not Whitelisted| Stage1{⚡ Stage 1<br/>Local Rules}
    
    Stage1 -->|🎯 Attack Pattern Match| Honeypot[🍯 HONEYPOT<br/>Deceptive Response]
    Stage1 -->|❓ Unknown Pattern| Stage2{💾 Stage 2<br/>Database Patterns}
    
    Stage2 -->|📚 Known Attack| Honeypot
    Stage2 -->|🆕 Novel Attack| Stage3{🤖 Stage 3<br/>LLM Analysis}
    
    Stage3 -->|🚨 Attack Confirmed| Honeypot
    Stage3 -->|✅ Legitimate| Allow
    
    Honeypot --> TI[🔍 Threat Intelligence<br/>Enrichment]
    TI --> Notify[📢 Notifications<br/>If Rules Match]
    Notify --> Learn[📖 Learn & Store<br/>Pattern]
    
    Allow --> Backend[🎯 Your Application]
    Backend --> Response[📦 Real Response]
    
    Learn --> LogAttack[(📊 Attack Database)]
    
    style Start fill:#4c6ef5,stroke:#364fc7,stroke-width:3px,color:#fff
    style Stage0 fill:#7950f2,stroke:#5f3dc4,stroke-width:2px,color:#fff
    style Stage1 fill:#7950f2,stroke:#5f3dc4,stroke-width:2px,color:#fff
    style Stage2 fill:#7950f2,stroke:#5f3dc4,stroke-width:2px,color:#fff
    style Stage3 fill:#7950f2,stroke:#5f3dc4,stroke-width:2px,color:#fff
    style Allow fill:#51cf66,stroke:#2f9e44,stroke-width:3px,color:#fff
    style Honeypot fill:#ff6b6b,stroke:#c92a2a,stroke-width:3px,color:#fff
    style TI fill:#ff922b,stroke:#e8590c,stroke-width:2px,color:#fff
    style Notify fill:#fab005,stroke:#f08c00,stroke-width:2px,color:#fff
    style Learn fill:#20c997,stroke:#12b886,stroke-width:2px,color:#fff
    style Backend fill:#339af0,stroke:#1c7ed6,stroke-width:2px,color:#fff
    style Response fill:#51cf66,stroke:#2f9e44,stroke-width:2px,color:#fff
    style LogAttack fill:#868e96,stroke:#495057,stroke-width:2px,color:#fff

---


## 🎛️ Deux Modes de Détection

<div align="center">

Choisissez votre philosophie de sécurité : **faire confiance mais vérifier** vs **zéro confiance**

</div>

<table>
<tr>
<th width="50%">🔍 Mode Détection (Par défaut)</th>
<th width="50%">🛡️ Mode Liste d'autorisation (Zéro confiance stricte)</th>
</tr>

<tr>
<td valign="top">

### Philosophie
> **« Faire confiance, mais vérifier »** - Analyser tout intelligemment

### Configuration```json
{
  "detection": {
    "mode": "detection",
    "enable_local_rules": true,
    "enable_llm": true,
    "whitelist_ips": [],      // Optional
    "whitelist_paths": []     // Optional
  }
}

### Idéal pour
- ✅ Applications web exposées au public
- ✅ API REST avec clients inconnus
- ✅ Plateformes e-commerce
- ✅ Produits SaaS
- ✅ Diffusion de contenu
- ✅ Sites web marketing

### Avantages
- ✅ Détection intelligente des menaces
- ✅ Apprend de tout le trafic
- ✅ Adaptatif aux nouvelles attaques
- ✅ Fonctionne avec des utilisateurs dynamiques
- ✅ Construit une base de données d'intelligence

### Inconvénients
- ⚠️ Nécessite un réglage pour les faux positifs
- 🤖 Dépend de la précision de l'IA
- ⏱️ Période d'apprentissage initiale

</td>

<td valign="top">

### Philosophie
> **« Refuser par défaut »** - Seule la confiance explicite passe.

### Configuration```json
{
  "detection": {
    "mode": "allowlist",
    "whitelist_ips": [
      "192.168.1.100",
      "10.0.0.0/24"
    ],
    "whitelist_paths": [
      "/health",
      "/metrics"
    ]
  }
}

### Idéal pour
- ✅ Panneaux d'administration
- ✅ Tableaux de bord internes
- ✅ Services VPN uniquement
- ✅ API backend (privées)
- ✅ Outils de gestion de base de données
- ✅ Webhooks CI/CD

### Avantages
- 🔒 Sécurité maximale
- ⚡ Latence zéro (pas d'IA)
- 🎯 Zéro faux positifs
- 💰 Zéro coût d'API
- 🛡️ Parfait pour les cibles de haute valeur

### Inconvénients
- ❌ Nécessite des IP/chemins connus
- 📋 Gestion manuelle de la liste blanche
- 🚫 Bloque les inconnus légitimes
- 🔧 Moins flexible

</td>
</tr>

<tr>
<td colspan="2" align="center">

### 💡 **Conseil Pro :** Approche hybride

Commencez par le **Mode d'Onboarding** (7 jours) pour découvrir automatiquement les modèles légitimes, puis passez à votre mode préféré :

</td>
</tr>
<tr>
<td colspan="2" align="left">

<pre><code>{
  "execution_mode": {
    "mode": "onboarding",              // Auto-learn for 7 days
    "onboarding_duration_days": 7,
    "onboarding_auto_whitelist": true  // Auto-add to whitelist
  }
}</code></pre>

</td>
</tr>
<tr>
<td colspan="2" align="center">

Après l'onboarding → Passez au **Mode Détection** ou au **Mode Liste blanche** selon vos besoins

</td>
</tr>

</table>

**🎬 Modes d'exécution :**

| Mode | Objectif | Blocage | Apprentissage | Durée |
|------|----------|---------|---------------|--------|
| **🎓 Onboarding** | Apprendre le trafic légitime | ❌ Non | ✅ Oui | 7 jours (par défaut) |
| **🛡️ Détection** | Protection complète | ✅ Oui | ✅ Oui | Production |

Voir [DETECTION_MODES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/DETECTION_MODES.md) pour une comparaison détaillée et des cas d'utilisation.



---


## 📊 Tableau de bord & Gestion

<div align="center">

### 🎯 Tableau de bord d'intelligence en temps réel

Accès à **`http://localhost:8443/`** avec authentification par jeton API

</div>

**Aperçu du tableau de bord :**

Le tableau de bord IFRIT offre une visibilité en temps réel sur votre posture de sécurité avec :

- **📊 Distribution des niveaux de menace** - Répartition visuelle des menaces CRITIQUE/HAUTE/MOYENNE/BASSE
- **🎯 Meilleurs attaquants risqués** - Classement en temps réel avec scores de risque, pays et drapeaux (Tor, VPN, Hébergement)
- **⚡ Performance du pipeline de détection** - Métriques étape par étape montrant l'efficacité du cache
- **📈 Tendances des attaques** - Répartition des types d'attaques sur 24 heures avec barres visuelles
- **🌍 Aperçus géographiques** - Emplacements des sources d'attaques avec drapeaux


### ⌨️ Gestion en ligne de commande

Contrôle complet en ligne de commande de votre intelligence de sécurité :

<table>
<tr>
<td width="50%" valign="top">

#### 🚨 Intelligence des attaques```bash
# View recent attacks
./ifrit-cli attack list

# Detailed analysis
./ifrit-cli attack view 42

# Statistics
./ifrit-cli attack stats

# Filter by source
./ifrit-cli attack by-ip 45.67.89.1

# Filter by target
./ifrit-cli attack by-path /api/users

# Export to JSON
./ifrit-cli attack export \
  --format json \
  --output attacks.json

</td>
<td width="50%" valign="top">

#### 👤 Profils d'attaquant```bash
# List all attackers
./ifrit-cli attacker list

# Profile details
./ifrit-cli attacker view 5

# Search by IP
./ifrit-cli attacker search 45.67.89.1

# Top attackers
./ifrit-cli attacker top 10

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 🔍 Renseignement sur les menaces```bash
# Recent threat intel
./ifrit-cli threat list

# IP details
./ifrit-cli threat view 45.67.89.1

# Top risky IPs
./ifrit-cli threat top 10

# Statistics
./ifrit-cli threat stats

# Force re-enrich IP
./ifrit-cli threat enrich 45.67.89.1

**🔄 Indépendant de la base de données :** Les mêmes commandes fonctionnent pour SQLite et PostgreSQL !

</td>
</tr>
</table>



### 🔌 REST API

<div align="center">

**JSON API pour une intégration transparente avec votre security stack**

</div>

Intégrez IFRIT avec les SIEM, les outils de surveillance ou les tableaux de bord personnalisés grâce à notre API REST complète.

#### 🔐 Authentification

Tous les points de terminaison de l'API nécessitent une authentification via un jeton API :```bash
# Include in every request
curl -H "X-API-Token: YOUR_TOKEN_HERE" \
  http://localhost:8443/api/...