IfritProxy — IFRIT est un proxy inverse basé sur l'IA qui intercepte les requêtes entrantes en temps réel, classant chacune d'elles comme légitime ou malveillante. Le trafic légitime est transmis au backend ; le trafic malveillant reçoit une réponse honeypot personnalisée générée par l'IA qui imite la ressource demandée avec des données fabriquées, trompant les attaquants en leur faisant perdre du temps dessus. | Kitploit

🏗️ Architecture du système

🎨 Cliquez ici pour agrandir le diagramme interactif

```mermaid graph TB subgraph Internet A[👤 Attacker] L[✅ Legitimate User] end

subgraph "IFRIT Proxy Layer"
    B[🛡️ IFRIT Proxy]
    
    subgraph "AI Detection Engine"
        C1[🤖 Claude Sonnet 4]
        C2[🤖 Gemini 2.0 Flash]
    end
    
    subgraph "Threat Intelligence"
        D1[📊 AbuseIPDB]
        D2[🦠 VirusTotal]
        D3[🌍 IPInfo]
    end
end

subgraph Backend
    E[🎯 Your Application]
end

subgraph "Attacker Receives"
    F[🍯 Fake Data<br/>Honeypot Response]
end

subgraph "User Receives"
    G[📦 Real Data<br/>Protected]
end

A -->|Malicious Request| B
L -->|Normal Request| B

B --> C1
B --> C2

B --> D1
B --> D2
B --> D3

B -->|Attack Detected| F
B -->|Legitimate| E
E -->|Response| G

F -.->|Wasted Time| A
G -->|Secure Access| L

style A fill:#ff6b6b,stroke:#c92a2a,stroke-width:2px,color:#fff
style L fill:#51cf66,stroke:#2f9e44,stroke-width:2px,color:#fff
style B fill:#4c6ef5,stroke:#364fc7,stroke-width:3px,color:#fff
style C1 fill:#845ef7,stroke:#5f3dc4,stroke-width:2px,color:#fff
style C2 fill:#845ef7,stroke:#5f3dc4,stroke-width:2px,color:#fff
style D1 fill:#ff922b,stroke:#e8590c,stroke-width:2px,color:#fff
style D2 fill:#ff922b,stroke:#e8590c,stroke-width:2px,color:#fff
style D3 fill:#ff922b,stroke:#e8590c,stroke-width:2px,color:#fff
style E fill:#20c997,stroke:#12b886,stroke-width:2px,color:#fff
style F fill:#fa5252,stroke:#c92a2a,stroke-width:2px,color:#fff
style G fill:#51cf66,stroke:#2f9e44,stroke-width:2px,color:#fff

</details>

**Flux simplifié :**

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/9318/20428ce8d35f40faaa17f7f8c313021a74af35675f384b2db7a60034dbfdcdf2.png" alt="Diagramme de flux simple d'IFRIT" width="650">
</div>

</div>

---

## 🚀 Démarrage rapide

> **Mettez-vous en route en moins de 2 minutes**

### 📦 Installation

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

**macOS (Apple Silicon)**```bash
curl -L -o ifrit-v0.3.2-darwin-arm64.tar.gz \
  https://github.com/0tSystemsPublicRepos/IfritProxy/releases/download/v0.3.2/ifrit-v0.3.2-darwin-arm64.tar.gz


tar -xzf ifrit-v0.3.2-darwin-arm64.tar.gz
cd ifrit-v0.3.2-darwin-arm64
./install.sh

Linux (x64)```bash curl -LO https://github.com/0tSystemsPublicRepos/\ IfritProxy/releases/download/v0.3.2/
ifrit-v0.3.2-linux-amd64.tar.gz

tar -xzf ifrit-v0.3.2-linux-amd64.tar.gz cd ifrit-v0.3.2-linux-amd64 ./install.sh

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

<div align="center">

![Démonstration d'installation](https://assets.kitploit.com/production/public/readmes/9318/f4e135766f0f7e20b4a176526f104f0b2b7b35ec32f5961529d27fa93e749dd2.gif)

*Installation en action - c'est vraiment simple !*

</div>

### ⚙️ Configuration (Configuration rapide)```bash
# 1. Copy template
cp config/default.json.example config/default.json

# 2. Add your API keys
nano config/default.json  # or use your favorite editor

Configuration minimale pour commencer:```json { "llm": { "provider": "claude", // 👈 Choose: "claude" or "gemini" "claude": { "api_key": "sk-ant-..." // 🔑 Get from console.anthropic.com } }, "proxy": { "listen_port": 8080, "backend_url": "http://localhost:3000" // 🎯 Your app } }

### 🎬 Lancement

Compilez le code source ou installez à partir des binaires disponibles```bash
# Build the binary
go build -o ifrit ./cmd/ifrit
(optional: build ifrit-cli as well)

# Start IFRIT (runs in background)
./ifrit &

# 🎉 You're protected! Access dashboard:
open http://localhost:8443

C'est tout ! IFRIT protège désormais votre application.

✨ Qu'est-ce qui rend IFRIT différent ?

💎 Capacités principales

🧠 Intelligence multi-IA

Choisissez votre fournisseur d'IA ou laissez IFRIT faire le basculement automatique :

🎯 Claude Sonnet 4 - Analyse de sécurité leader du secteur
⚡ Gemini 2.0 Flash - Rentable, ultra-rapide
🔄 Basculement automatique - Changement transparent de fournisseur
💰 Réduction des coûts de 90% - Grâce à un cache intelligent```json { "provider": "claude", // or "gemini" "cache_ttl": 86400 // 24h learning }

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

### 🗄️ **Stockage de qualité production**

Flexibilité de base de données pour toute échelle :

- **📦 SQLite** - Zéro configuration, parfait pour les serveurs uniques
- **🐘 PostgreSQL** - Échelle entreprise, déploiements en cluster
- **🔌 Abstraction de fournisseur** - Changement avec configuration uniquement
- **🛠️ CLI unifiée** - Mêmes commandes, n'importe quelle base de données```bash
# Works with both!
./ifrit-cli attack list
./ifrit-cli pattern add sql_injection

🎭 Moteur de leurre adaptatif

Réponses intelligentes de honeypot qui apprennent :

🎨 Généré par IA - Données fictives réalistes correspondant à votre application
📚 Apprentissage de motifs - Première attaque = 3s, suivante = 10ms
🎯 Sensible au contexte - Imite les ressources demandées
⏱️ Perte de temps - Maintient les attaquants occupés avec des cibles fictives

Exemple : L'injection SQL reçoit une base de données utilisateur fictive, le path traversal reçoit des listes de fichiers fictives.

🔍 Hub de renseignement sur les menaces

Enrichissement en temps réel depuis plusieurs sources :

🚨 AbuseIPDB - Réputation IP (score 0-100)
🦠 VirusTotal - Détection de malwares et C2
🌍 IPInfo - Géolocalisation, VPN, Tor, hébergement
⚖️ Score de risque - Formule pondérée → niveau de menace``` IP: 45.67.89.12 ├─ AbuseIPDB: 87/100 (234 reports) ├─ VirusTotal: 3 malware hits ├─ IPInfo: Russia, Tor exit node └─ Risk: 92 → 🔴 CRITICAL

</td>
</tr>

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

### 📢 **Système d'alerte intelligent**

Notifications multicanal sans lassitude :

- **📧 Email** - SMTP (Gmail, SendGrid, personnalisé)
- **💬 Slack** - Webhook avec code couleur de sévérité
- **📱 SMS** - Twilio pour menaces critiques uniquement
- **🔗 Webhooks** - JSON personnalisé avec logique de réessai

**Filtrage basé sur des règles :**```json
"rules": {
  "alert_on_critical": true,   // ✅ Always
  "alert_on_high": false,      // 🔇 Quiet
  "alert_on_medium": false,    // 🔇 Quiet
  "alert_on_low": false        // 🔇 Quiet
}

📊 Visibilité complète

Intelligence en temps réel à portée de main :

🎯 Tableau de bord en direct - Niveaux de menace, principaux attaquants, statistiques
🔌 API REST - Points de terminaison JSON pour l'intégration SIEM
⌨️ Outils CLI - Gestion complète en ligne de commande
📈 Analyses - Chronologies des attaques, profils d'attaquants```bash

Query your intelligence

./ifrit-cli threat top 10 ./ifrit-cli attacker view 45.67.89.1 ./ifrit-cli attack stats --last-24h

**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

🎯 Que se passe-t-il après la détection ?

💾 Opérations de base de données```bash

Database statistics

./ifrit-cli db stats

View schema

./ifrit-cli db schema

Vacuum (SQLite only)

./ifrit-cli db vacuum

Export database

./ifrit-cli db export backup.sql

**🔄 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/...

Génération des jetons API : Configurez dans config/default.json sous api.tokens

📡 Points d'accès disponibles

🚨 Intelligence des attaques

```bash # Get recent attacks curl -H "X-API-Token: YOUR_TOKEN" \ http://localhost:8443/api/attacks

Get specific attack

curl -H "X-API-Token: YOUR_TOKEN"
http://localhost:8443/api/attacks/42

Filter by IP

curl -H "X-API-Token: YOUR_TOKEN"
"http://localhost:8443/api/attacks?ip=45.67.89.1"

Filter by date range

curl -H "X-API-Token: YOUR_TOKEN"
"http://localhost:8443/api/attacks?from=2024-01-01&to=2024-01-31"

Attack statistics

curl -H "X-API-Token: YOUR_TOKEN"
http://localhost:8443/api/attacks/stats

**Exemple de réponse :**```json
{
  "attacks": [
    {
      "id": 42,
      "timestamp": "2024-01-15T14:23:45Z",
      "source_ip": "45.67.89.1",
      "attack_type": "sql_injection",
      "threat_level": "CRITICAL",
      "risk_score": 92,
      "detection_stage": 3,
      "path": "/api/users",
      "method": "POST"
    }
  ],
  "total": 1865,
  "page": 1
}

Scénario	Comportement	Latence	Coût
Première attaque depuis l'IP	Les 3 API appelées	~500ms	$0.003
Attaque répétée (< 24h)	Cache atteint, aucune API	<10ms	$0.00
Après 24h	Ré-enrichissement, mise à jour du cache	~500ms	$0.003

⏰ Heure 1 : Phase d'apprentissage initial 🚀 Heure 2 : Opération optimisée

Première exposition

``` 📊 Traffic Analysis ├─ 100 requests received ├─ 40 unique attack types │ ├─ 🤖 AI Calls Needed │ ├─ Stage 3 LLM: 40 calls │ └─ Cost: ~$0.12 │ ├─ 🔍 Threat Intel APIs │ ├─ 40 unique IPs │ └─ Cost: ~$0.12 │ └─ 💾 Storage ├─ Learn all 40 patterns ├─ Cache threat intel (24h) └─ Generate honeypots

📈 Total Cost: $0.24

**Ce qui s'est passé :**
- ✅ Toutes les attaques détectées
- ✅ Modèles appris
- ✅ Renseignement mis en cache
- ✅ Attaquants trompés

</td>
<td valign="top">

**Renseignement mis en cache**```
📊 Traffic Analysis
├─ 100 requests received
├─ Same 40 attack types
│
├─ 💾 Database Hits
│  ├─ Stage 2: All 40 matched
│  ├─ Response time: <10ms each
│  └─ Cost: $0.00
│
├─ 💰 Cache Hits
│  ├─ Same 40 IPs
│  ├─ Threat intel from cache
│  └─ Cost: $0.00
│
└─ 🎯 Results
   ├─ Same quality detection
   ├─ Faster responses
   └─ Zero API costs

📉 Total Cost: $0.00

Ce qui s'est passé :

✅ 100% de taux de succès du cache
✅ 90 ms → 10 ms de latence
✅ 100% d'économies de coûts !
✅ Même niveau de protection

---


## 🎛️ 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/develop/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

👤 Profils d'attaquants

```bash # List all attackers curl -H "X-API-Token: YOUR_TOKEN" \ http://localhost:8443/api/attackers

Get specific attacker profile

curl -H "X-API-Token: YOUR_TOKEN"
http://localhost:8443/api/attackers/45.67.89.1

Top attackers

curl -H "X-API-Token: YOUR_TOKEN"
"http://localhost:8443/api/attackers/top?limit=10"

**Exemple de réponse :**```json
{
  "ip": "45.67.89.1",
  "first_seen": "2024-01-10T08:15:30Z",
  "last_seen": "2024-01-15T14:23:45Z",
  "total_attacks": 234,
  "attack_types": ["sql_injection", "path_traversal", "xss"],
  "risk_score": 87,
  "threat_level": "HIGH",
  "country": "CN",
  "is_vpn": false,
  "is_tor": false,
  "is_hosting": true
}

🧬 Patterns appris

```bash # Get all patterns curl -H "X-API-Token: YOUR_TOKEN" \ http://localhost:8443/api/patterns

Get pattern by ID

curl -H "X-API-Token: YOUR_TOKEN"
http://localhost:8443/api/patterns/15

Add new pattern

curl -X POST
-H "X-API-Token: YOUR_TOKEN"
-H "Content-Type: application/json"
-d '{ "attack_type": "sql_injection", "signature": "' OR 1=1--", "confidence": 0.95 }'
http://localhost:8443/api/patterns

</details>

<details>
<summary><b>🔍 Renseignement sur les menaces</b></summary>```bash
# Threat intel statistics
curl -H "X-API-Token: YOUR_TOKEN" \
  http://localhost:8443/api/threat-intel/stats

# Top risky IPs
curl -H "X-API-Token: YOUR_TOKEN" \
  "http://localhost:8443/api/threat-intel/top?limit=10"

# Get IP details
curl -H "X-API-Token: YOUR_TOKEN" \
  http://localhost:8443/api/threat-intel/45.67.89.1

# Force re-enrich IP
curl -X POST \
  -H "X-API-Token: YOUR_TOKEN" \
  http://localhost:8443/api/threat-intel/45.67.89.1/enrich

Exemple de réponse:```json { "ip": "45.67.89.1", "risk_score": 87, "threat_level": "HIGH", "abuseipdb": { "score": 91, "total_reports": 156, "last_reported": "2024-01-14T10:30:00Z" }, "virustotal": { "malicious": 3, "suspicious": 1 }, "ipinfo": { "country": "CN", "city": "Shanghai", "is_vpn": false, "is_proxy": false, "is_tor": false, "is_hosting": true }, "cached_at": "2024-01-15T14:23:45Z" }

</details>

<details>
<summary><b>📢 Configuration des notifications</b></summary>```bash
# Get notification config
curl -H "X-API-Token: YOUR_TOKEN" \
  http://localhost:8443/api/notifications/config

# Update notification rules
curl -X POST \
  -H "X-API-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "alert_on_critical": true,
    "alert_on_high": true,
    "alert_on_medium": false,
    "alert_on_low": false
  }' \
  http://localhost:8443/api/notifications/config/update

# Get notification history
curl -H "X-API-Token: YOUR_TOKEN" \
  http://localhost:8443/api/notifications/history

# Test notifications
curl -X POST \
  -H "X-API-Token: YOUR_TOKEN" \
  http://localhost:8443/api/notifications/test

💾 Gestion du cache

```bash # Get cache statistics curl -H "X-API-Token: YOUR_TOKEN" \ http://localhost:8443/api/cache/stats

Clear threat intel cache

curl -X POST
-H "X-API-Token: YOUR_TOKEN"
http://localhost:8443/api/cache/clear

Clear specific IP from cache

curl -X DELETE
-H "X-API-Token: YOUR_TOKEN"
http://localhost:8443/api/cache/45.67.89.1

</details>

---

**📚 Documentation complète de l'API :** Voir [API_ENDPOINTS.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/API_ENDPOINTS.md) pour une référence complète incluant les schémas requête/réponse, les codes d'erreur et les limites de débit.

---

## 🔐 Confidentialité & Conformité

### Anonymisation des données

Les données sensibles sont **automatiquement expurgées** avant d'atteindre les LLM externes :

| **Expurgé** | **Conservé** |
|---|---|
| 🔒 Jetons d'authentification & identifiants | ✅ Méthode/chemin HTTP |
| 🔒 Cookies de session | ✅ Schémas d'attaque |
| 🔒 Clés API | ✅ Content-Type |
| 🔒 Adresses e-mail | ✅ User-Agent |
| 🔒 Informations personnelles | ✅ Signatures d'attaque |

**Couverture de conformité :**
- ✅ **GDPR** - PII anonymisées avant les appels API externes
- ✅ **HIPAA** - PHI protégées contre les tiers
- ✅ **PCI-DSS** - Données de carte de crédit expurgées
- ✅ **CCPA** - Minimisation des données utilisateur appliquée

Voir [ANONYMIZATION_TESTING.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/ANONYMIZATION_TESTING.md) pour les détails.

---

## ⚙️ Configuration

### Configuration multi-LLM

**Claude (Recommandé pour la sécurité) :**```json
{
  "llm": {
    "provider": "claude",
    "claude": {
      "api_key": "${ANTHROPIC_API_KEY}",
      "model": "claude-sonnet-4-20250514",
      "max_tokens": 4096,
      "temperature": 0.0
    }
  }
}

Gemini (Alternative économique):```json { "llm": { "provider": "gemini", "gemini": { "api_key": "${GOOGLE_API_KEY}", "model": "gemini-2.0-flash-exp", "max_tokens": 4096, "temperature": 0.0 } } }

### Options de base de données

**SQLite (Par défaut - Zéro Configuration) :**```json
{
  "database": {
    "type": "sqlite",
    "sqlite": {
      "path": "./data/ifrit.db"
    }
  }
}

PostgreSQL (Échelle Entreprise):```json { "database": { "type": "postgresql", "postgresql": { "host": "localhost", "port": 5432, "user": "ifrit_user", "password": "${POSTGRES_PASSWORD}", "database": "ifrit", "ssl_mode": "require" } } }

**Quand utiliser lequel :**
- **SQLite :** Serveur unique, < 1M d'attaques/jour, configuration rapide
- **PostgreSQL :** Clusters, > 1M d'attaques/jour, besoins d'entreprise

### Renseignement sur les menaces

Activer l'enrichissement externe :```json
{
  "threat_intelligence": {
    "enabled": true,
    "cache_ttl_hours": 24,
    "enrichment_workers": 3,
    "apis": {
      "abuseipdb": {
        "enabled": true,
        "api_key": "${ABUSEIPDB_API_KEY}"
      },
      "virustotal": {
        "enabled": true,
        "api_key": "${VIRUSTOTAL_API_KEY}"
      },
      "ipinfo": {
        "enabled": true,
        "api_key": "${IPINFO_API_KEY}"
      }
    },
    "threat_level_thresholds": {
      "critical": 80,
      "high": 60,
      "medium": 40,
      "low": 0
    }
  }
}

Système de notification

Alertes multi-canaux avec filtrage basé sur des règles :```json { "notifications": { "enabled": true, "providers": { "email": { "enabled": true, "smtp_host": "smtp.gmail.com", "smtp_port": 587, "smtp_username": "${SMTP_USERNAME}", "smtp_password": "${SMTP_PASSWORD}", "from_address": "[email protected]" }, "slack": { "enabled": true, "webhook_url": "${SLACK_WEBHOOK_URL}" }, "twilio": { "enabled": false, "account_sid": "${TWILIO_ACCOUNT_SID}", "auth_token": "${TWILIO_AUTH_TOKEN}", "from_number": "${TWILIO_FROM_NUMBER}", "to_number": "${TWILIO_TO_NUMBER}" } }, "rules": { "alert_on_critical": true, "alert_on_high": false, "alert_on_medium": false, "alert_on_low": false } } }

**Astuce :** Commencez avec uniquement les alertes CRITIQUES activées pour éviter la lassitude face aux alertes.

---

## 📚 Documentation

| Document | Description |
|----------|-------------|
| [START_HERE.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/START_HERE.md) | Guide de navigation pour tous les documents |
| [INSTALLATION.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/INSTALLATION.md) | Instructions d'installation détaillées |
| [DETECTION_MODES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/DETECTION_MODES.md) | Comparaison détection vs liste blanche |
| [THREAT_INTELLIGENCE.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/THREAT_INTELLIGENCE.md) | Guide de collecte de renseignements |
| [NOTIFICATIONS.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/NOTIFICATIONS.md) | Configuration du système d'alerte |
| [API_ENDPOINTS.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/API_ENDPOINTS.md) | Référence complète de l'API REST |
| [FEATURES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/FEATURES.md) | Liste complète des fonctionnalités |
| [DECEPTIVE_PAYLOADS_MANAGEMENT.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/DECEPTIVE_PAYLOADS_MANAGEMENT.md) | Système de réponse honeypot |
| [ANONYMIZATION_TESTING.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/ANONYMIZATION_TESTING.md) | Détails sur la confidentialité et la conformité |

---

## 🛣️ Feuille de route

**v0.4.0 - Intelligence améliorée** 
- [ ] Intégration de l'authentification Keycloak
- [ ] Refonte du portail d'administration
- [ ] Configuration stockée en base de données
- [ ] Améliorations du scoring par apprentissage automatique
- [ ] Déduplication des attaques

**v0.5.0 - Fonctionnalités entreprise** 
- [ ] Intégrations SIEM avancées (Wazuh, Splunk, ELK)
- [ ] Support MySQL/MariaDB
- [ ] Clustering et équilibrage de charge
- [ ] Planification des notifications et heures de silence

**v0.6.0 - Automatisation** 
- [ ] Automatisation des réponses
- [ ] Politiques d'escalade
- [ ] Regroupement des notifications
- [ ] Corrélation avancée des menaces

---

## 🤝 Contribuer

IFRIT est open source sous licence Apache 2.0. Nous accueillons les contributions !

**Domaines où l'aide est nécessaire :**
- 🧠 Nouveaux fournisseurs LLM (GPT, Llama, Mistral)
- 🔗 Intégrations SIEM (Wazuh, Splunk, ELK)
- 🌐 Fournisseurs de renseignements sur les menaces
- 📢 Canaux de notification (Discord, Teams, PagerDuty)
- 🎭 Modèles de payload pour de nouveaux types d'attaques
- 📖 Améliorations de la documentation
- 🐛 Corrections de bugs et optimisations

Voir [CONTRIBUTING.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/CONTRIBUTING.md) pour les directives.

**Support commercial :**
Pour les déploiements en entreprise, les intégrations personnalisées ou le conseil :
- Email : [[email protected]](mailto:[email protected])
- Web : [0t.Systems](https://www.0t.Systems)

---

## 📊 Statistiques du projet

<div align="center">

| Métrique | Valeur |
|----------|--------|
| **Précision de détection** | 99.2% |
| **Temps de réponse moyen** | < 15ms |
| **Réduction des coûts** | 90% après apprentissage |
| **LLMs supportés** | Claude, Gemini |
| **Options de base de données** | SQLite, PostgreSQL |
| **Sources de renseignements sur les menaces** | 3 (AbuseIPDB, VirusTotal, IPInfo) |
| **Canaux de notification** | 4 (Email, Slack, SMS, Webhook) |

</div>

---

## 📜 Licence

IFRIT Proxy est sous licence [Apache License 2.0](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/LICENSE).

**Support commercial, intégration personnalisée ou conseil :**  
📧 [[email protected]](mailto:[email protected])

---

## 🙏 Remerciements

Construit avec :
- [Go](https://go.dev) - Runtime haute performance
- [SQLite](https://www.sqlite.org) / [PostgreSQL](https://www.postgresql.org) - Persistance des données
- [Anthropic Claude](https://www.anthropic.com) - Analyse de sécurité IA
- [Google Gemini](https://deepmind.google/technologies/gemini/) - Alternative IA économique
- [AbuseIPDB](https://www.abuseipdb.com) - Renseignement sur la réputation IP
- [VirusTotal](https://www.virustotal.com) - Détection de malwares
- [IPInfo](https://ipinfo.io) - Géolocalisation et détection de confidentialité

**Un grand merci à la communauté de la sécurité** pour les contributions en matière de renseignements sur les menaces et de modèles.

---

<div align="center">

## 🚀 Prêt à commencer ?

**[📦 Installer IFRIT](#-quick-start)** • **[📖 Lire la documentation](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/START_HERE.md)** • **[🔌 Référence API](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/API_ENDPOINTS.md)**

</div>

---

<div align="center">

### **Fabriqué avec 🔥 par [0t.Systems](https://www.0t.Systems)**

*Transformer les attaquants en sources de renseignements, un honeypot à la fois*

**[⬆ Retour en haut](#-ifrit-proxy)**

---

**Questions ? Problèmes ? Idées ?**  
📧 Email : [[email protected]](mailto:[email protected])  
🐛 Signaler des bugs : [GitHub Issues](https://github.com/0tSystemsPublicRepos/IfritProxy/issues)  
💬 Discussions : [GitHub Discussions](https://github.com/0tSystemsPublicRepos/IfritProxy/discussions)

---

[![Étoiles GitHub](https://img.shields.io/github/stars/0tSystemsPublicRepos/IfritProxy?style=social)](https://github.com/0tSystemsPublicRepos/IfritProxy)
[![Suivre sur LinkedIn](https://img.shields.io/badge/LinkedIn-Follow-0077B5?style=social&logo=linkedin)](https://www.linkedin.com/company/0t-systems)

</div>

IfritProxy

Populaires

À propos

🔥 Plateforme de déception et de renseignement sur les menaces alimentée par l'IA

Apporté à la communauté par

🎯 Qu'est-ce que IFRIT ?

🏗️ Architecture du système

✨ Qu'est-ce qui rend IFRIT différent ?

💎 Capacités principales

🧠 Intelligence multi-IA

🎭 Moteur de leurre adaptatif

🔍 Hub de renseignement sur les menaces

📊 Visibilité complète

Query your intelligence

🎯 Que se passe-t-il après la détection ?

💾 Opérations de base de données```bash

Database statistics

View schema

Vacuum (SQLite only)

Export database

📡 Points d'accès disponibles

Get specific attack

Filter by IP

Filter by date range

Attack statistics

🔬 Pipeline d'enrichissement du renseignement

💰 Économie d'apprentissage : Optimisation des coûts

Comment ça marche```

Comment ça marche```

🧬 Gestion des motifs```bash

List learned signatures

View specific pattern

Add custom pattern

Remove pattern

Export patterns

🔓 Liste blanche / Exceptions```bash

List exceptions

Add IP exception

Add path exception

Remove exception