IfritProxy — IFRIT è un reverse proxy basato sull'intelligenza artificiale che intercetta le richieste in arrivo in tempo reale, classificando ciascuna come legittima o dannosa. Il traffico legittimo viene inoltrato al backend; il traffico dannoso riceve una risposta honeypot personalizzata generata dall'IA che imita la risorsa richiesta con dati fittizi, ingannando gli attaccanti e facendogli sprecare tempo. | Kitploit

🏗️ Architettura di sistema

🎨 Clicca qui per espandere il diagramma interattivo

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

**Flusso semplificato:**

<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/9318/20428ce8d35f40faaa17f7f8c313021a74af35675f384b2db7a60034dbfdcdf2.png" alt="IFRIT Diagramma di flusso semplice" width="650">
</div>

</div>



---


## 🚀 Avvio Rapido

> **Inizia a usarlo in meno di 2 minuti**

### 📦 Installazione

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

![Demo dell'installazione](https://assets.kitploit.com/production/public/readmes/9318/f4e135766f0f7e20b4a176526f104f0b2b7b35ec32f5961529d27fa93e749dd2.gif)

*Installazione in azione: è davvero così semplice!*

</div>

### ⚙️ Configurazione (Setup Rapido)```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

Configurazione minima per iniziare:```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 } }

### 🎬 Avvio

Compila il codice sorgente o installa dai binari disponibili```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

Tutto qui! IFRIT ora protegge la tua applicazione.

✨ Cosa Rende Diverso IFRIT?

💎 Funzionalità Principali

🧠 Intelligenza Multi-AI

Scegli il tuo provider AI o lascia che IFRIT effettui il fallback automatico:

🎯 Claude Sonnet 4 - Analisi della sicurezza all'avanguardia
⚡ Gemini 2.0 Flash - Conveniente, velocissimo
🔄 Fallback Automatico - Passaggio senza interruzioni tra provider
💰 Riduzione dei Costi del 90% - Grazie alla memorizzazione nella cache intelligente```json { "provider": "claude", // or "gemini" "cache_ttl": 86400 // 24h learning }

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

### 🗄️ **Archiviazione di livello produzione**

Flessibilità del database per qualsiasi scala:

- **📦 SQLite** - Zero-config, perfetto per server singoli
- **🐘 PostgreSQL** - Scala enterprise, distribuzioni in cluster
- **🔌 Astrazione del provider** - Cambia con la sola configurazione
- **🛠️ CLI unificata** - Stessi comandi, qualsiasi database```bash
# Works with both!
./ifrit-cli attack list
./ifrit-cli pattern add sql_injection

🎭 Motore di Deception Adattivo

Risposte honeypot intelligenti che apprendono:

🎨 Generato da AI - Dati fittizi realistici che corrispondono alla tua app
📚 Apprendimento dei pattern - Primo attacco = 3s, successivo = 10ms
🎯 Consapevole del contesto - Imita le risorse richieste
⏱️ Spreco di tempo - Tiene gli attaccanti occupati con target fittizi

Esempio: l'iniezione SQL ottiene un database utente falso, il path traversal ottiene elenchi di file falsi.

🔍 Hub di Threat Intelligence

Arricchimento in tempo reale da molteplici fonti:

🚨 AbuseIPDB - Reputazione IP (punteggio 0-100)
🦠 VirusTotal - Rilevamento malware e C2
🌍 IPInfo - Geolocalizzazione, VPN, Tor, hosting
⚖️ Risk Scoring - Formula ponderata → livello di minaccia``` 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">

### 📢 **Sistema di Avvisi Intelligenti**

Notifiche multicanale senza affaticamento:

- **📧 Email** - SMTP (Gmail, SendGrid, personalizzato)
- **💬 Slack** - Webhook con gravità codificata a colori
- **📱 SMS** - Twilio solo per minacce critiche
- **🔗 Webhooks** - JSON personalizzato con logica di retry

**Filtraggio basato su regole:**```json
"rules": {
  "alert_on_critical": true,   // ✅ Always
  "alert_on_high": false,      // 🔇 Quiet
  "alert_on_medium": false,    // 🔇 Quiet
  "alert_on_low": false        // 🔇 Quiet
}

📊 Visibilità Completa

Intelligenza in tempo reale a portata di mano:

🎯 Dashboard Live - Livelli di minaccia, principali attaccanti, statistiche
🔌 API REST - Endpoint JSON per l'integrazione con SIEM
⌨️ Strumenti CLI - Gestione completa da riga di comando
📈 Analisi - Cronologie degli attacchi, profili degli attaccanti```bash

Query your intelligence

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

**Progettazione API-first** - integrarsi con qualsiasi stack di sicurezza.

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



---


## 🔄 Come funziona

<div align="center">

### La pipeline di rilevamento in quattro fasi

</div>

<details> 
<summary><b>🎨 Clicca qui per espandere il diagramma interattivo</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

🎯 Cosa succede dopo il rilevamento?

💾 Operazioni sul database```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

**🔄 Indipendente dal database:** Gli stessi comandi funzionano sia per SQLite che per PostgreSQL!

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



### 🔌 API REST

<div align="center">

**API JSON per un'integrazione perfetta con il tuo stack di sicurezza**

</div>

Integra IFRIT con SIEM, strumenti di monitoraggio o dashboard personalizzate utilizzando la nostra API REST completa.

#### 🔐 Autenticazione

Tutti gli endpoint API richiedono l'autenticazione tramite token API:```bash
# Include in every request
curl -H "X-API-Token: YOUR_TOKEN_HERE" \
  http://localhost:8443/api/...

Generazione di token API: Configura in config/default.json sotto api.tokens

📡 Endpoint Disponibili

🚨 Intelligence sugli Attacchi

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

**Esempio di risposta:**```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
}

⏰ Ora 1: Fase di apprendimento iniziale 🚀 Ora 2: Operazione ottimizzata

Prima esposizione``` 📊 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

**Cosa è successo:**
- ✅ Tutti gli attacchi rilevati
- ✅ Pattern appresi
- ✅ Intelligence memorizzata nella cache
- ✅ Attaccanti ingannati

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

**Intelligence Memorizzata**```
📊 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

Cosa è successo:

✅ 100% tasso di cache hit
✅ 90ms → 10ms di latenza
✅ 100% di risparmio sui costi!
✅ Stesso livello di protezione

---

## 🎛️ Due Modalità di Rilevamento

<div align="center">

Scegli la tua filosofia di sicurezza: **fidati ma verifica** vs **zero trust**

</div>

<table>
<tr>
<th width="50%">🔍 Modalità di Rilevamento (Predefinita)</th>
<th width="50%">🛡️ Modalità Allowlist (Zero Trust Rigoroso)</th>
</tr>

<tr>
<td valign="top">

### Filosofia
> **"Fidati, ma verifica"** - Analizza tutto in modo intelligente

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

### Ideale per
- ✅ Applicazioni web pubbliche
- ✅ API REST con client sconosciuti
- ✅ Piattaforme e-commerce
- ✅ Prodotti SaaS
- ✅ Distribuzione di contenuti
- ✅ Siti web di marketing

### Vantaggi
- 🎯 Rilevamento intelligente delle minacce
- 📊 Impara da tutto il traffico
- 🔄 Adattivo ai nuovi attacchi
- 🌐 Funziona con utenti dinamici
- 📈 Costruisce un database di intelligence

### Svantaggi
- ⚠️ Richiede ottimizzazione per i falsi positivi
- 🤖 Dipende dall'accuratezza dell'AI
- ⏱️ Periodo di apprendimento iniziale

</td>

<td valign="top">

### Filosofia
> **"Rifiuta per impostazione predefinita"** - Solo la fiducia esplicita passa

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

### Ideale per
- ✅ Pannelli di amministrazione
- ✅ Dashboard interne
- ✅ Servizi solo VPN
- ✅ API backend (private)
- ✅ Strumenti di gestione database
- ✅ Webhook CI/CD

### Vantaggi
- 🔒 Massima sicurezza
- ⚡ Latenza zero (niente IA)
- 🎯 Zero falsi positivi
- 💰 Zero costi API
- 🛡️ Perfetto per obiettivi ad alto valore

### Svantaggi
- ❌ Richiede IP/percorsi noti
- 📋 Gestione manuale della whitelist
- 🚫 Blocca gli sconosciuti legittimi
- 🔧 Meno flessibile

</td>
</tr>

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

### 💡 **Consiglio:** Approccio ibrido

Inizia con **Modalità Onboarding** (7 giorni) per scoprire automaticamente i pattern legittimi, poi passa alla tua modalità preferita:

</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">

Dopo l'onboarding → Passa alla **Modalità Rilevamento** o alla **Modalità Allowlist** in base alle tue esigenze

</td>
</tr>

</table>

**🎬 Modalità di esecuzione:**

| Modalità | Scopo | Blocco | Apprendimento | Durata |
|------|---------|----------|----------|----------|
| **🎓 Onboarding** | Apprende il traffico legittimo | ❌ No | ✅ Sì | 7 giorni (predefinito) |
| **🛡️ Detection** | Protezione completa | ✅ Sì | ✅ Sì | Produzione |

Vedi [DETECTION_MODES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/DETECTION_MODES.md) per un confronto dettagliato e casi d'uso.



---


## 📊 Dashboard e Gestione

<div align="center">

### 🎯 Dashboard di intelligence in tempo reale

Accessibile su **`http://localhost:8443/`** con autenticazione tramite token API

</div>

**Panoramica della Dashboard:**

La dashboard IFRIT offre visibilità in tempo reale sulla tua postura di sicurezza con:

- **📊 Distribuzione dei Livelli di Minaccia** - Ripartizione visiva delle minacce CRITICAL/HIGH/MEDIUM/LOW
- **🎯 Attaccanti Più Rischiosi** - Classifica in tempo reale con punteggi di rischio, paesi e bandiere (Tor, VPN, Hosting)
- **⚡ Prestazioni della Pipeline di Rilevamento** - Metriche fase per fase che mostrano l'efficienza della cache
- **📈 Tendenze degli Attacchi** - Ripartizione delle tipologie di attacco nelle 24 ore con barre visive
- **🌍 Approfondimenti Geografici** - Posizioni di origine degli attacchi con bandiere


### ⌨️ Gestione CLI

Controllo completo da riga di comando della tua intelligence di sicurezza:

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

#### 🚨 Intelligence sugli Attacchi```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">

#### 👤 Profili degli Attaccanti```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">

#### 🔍 Intelligence sulle minacce```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

👤 Profili degli Attaccanti

```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"

**Esempio di risposta:**```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
}

🧬 Pattern Appresi

```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>🔍 Intelligence sulle minacce</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

Esempio di risposta:```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>📢 Configurazione delle Notifiche</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

💾 Gestione 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>

---

**📚 Documentazione API completa:** Consulta [API_ENDPOINTS.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/API_ENDPOINTS.md) per il riferimento completo che include schemi di richiesta/risposta, codici di errore e limiti di frequenza.



---

## 🔐 Privacy e Conformità

### Anonimizzazione dei dati

I dati sensibili vengono **automaticamente oscurati** prima di raggiungere LLM esterni:

| **Oscurati** | **Conservati** |
|---|---|
| 🔒 Token di autenticazione e credenziali | ✅ Metodo/percorso HTTP |
| 🔒 Cookie di sessione | ✅ Pattern di attacco |
| 🔒 Chiavi API | ✅ Content-Type |
| 🔒 Indirizzi email | ✅ User-Agent |
| 🔒 Informazioni personali | ✅ Firme di attacco |

**Copertura di conformità:**
- ✅ **GDPR** - PII anonimizzati prima delle chiamate API esterne
- ✅ **HIPAA** - PHI protetti da terze parti
- ✅ **PCI-DSS** - Dati delle carte di credito oscurati
- ✅ **CCPA** - Minimizzazione dei dati utente applicata

Consulta [ANONYMIZATION_TESTING.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/ANONYMIZATION_TESTING.md) per i dettagli.

---

## ⚙️ Configurazione

### Configurazione Multi-LLM

**Claude (Consigliato per la sicurezza):**```json
{
  "llm": {
    "provider": "claude",
    "claude": {
      "api_key": "${ANTHROPIC_API_KEY}",
      "model": "claude-sonnet-4-20250514",
      "max_tokens": 4096,
      "temperature": 0.0
    }
  }
}

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

### Opzioni del database

**SQLite (Predefinito - Zero Configurazione):**```json
{
  "database": {
    "type": "sqlite",
    "sqlite": {
      "path": "./data/ifrit.db"
    }
  }
}

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

**Quando usare quale:**
- **SQLite:** Server singolo, < 1M attacchi/giorno, configurazione rapida
- **PostgreSQL:** Cluster, > 1M attacchi/giorno, esigenze aziendali

### Threat Intelligence

Abilita l'arricchimento esterno:```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
    }
  }
}

Sistema di notifiche

Avvisi multi-canale con filtri basati su regole:```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 } } }

**Pro tip:** Inizia abilitando solo gli avvisi CRITICAL per evitare l'affaticamento da avvisi.

---

## 📚 Documentazione

| Documento | Descrizione |
|----------|-------------|
| [START_HERE.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/START_HERE.md) | Guida alla navigazione per tutta la documentazione |
| [INSTALLATION.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/INSTALLATION.md) | Istruzioni dettagliate di configurazione |
| [DETECTION_MODES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/DETECTION_MODES.md) | Confronto tra rilevamento e lista consentita |
| [THREAT_INTELLIGENCE.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/THREAT_INTELLIGENCE.md) | Guida alla raccolta di intelligence |
| [NOTIFICATIONS.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/NOTIFICATIONS.md) | Configurazione del sistema di avvisi |
| [API_ENDPOINTS.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/API_ENDPOINTS.md) | Riferimento completo dell'API REST |
| [FEATURES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/FEATURES.md) | Elenco completo delle funzionalità |
| [DECEPTIVE_PAYLOADS_MANAGEMENT.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/DECEPTIVE_PAYLOADS_MANAGEMENT.md) | Sistema di risposta honeypot |
| [ANONYMIZATION_TESTING.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/ANONYMIZATION_TESTING.md) | Dettagli su privacy e conformità |

---

## 🛣️ Roadmap


**v0.4.0 - Intelligence potenziata** 
- [ ] Integrazione dell'autenticazione Keycloak
- [ ] Riprogettazione del portale di amministrazione
- [ ] Configurazione archiviata nel database
- [ ] Miglioramenti dello scoring tramite machine learning
- [ ] Deduplicazione degli attacchi

**v0.5.0 - Funzionalità Enterprise** 
- [ ] Integrazioni SIEM avanzate (Wazuh, Splunk, ELK)
- [ ] Supporto MySQL/MariaDB
- [ ] Clustering e bilanciamento del carico
- [ ] Pianificazione delle notifiche e ore di silenzio

**v0.6.0 - Automazione** 
- [ ] Automazione delle risposte
- [ ] Politiche di escalation
- [ ] Raggruppamento delle notifiche
- [ ] Correlazione avanzata delle minacce

---

## 🤝 Contributi

IFRIT è open source con licenza Apache 2.0. Accogliamo con piacere i contributi!

**Aree che necessitano di aiuto:**
- 🧠 Nuovi provider LLM (GPT, Llama, Mistral)
- 🔗 Integrazioni SIEM (Wazuh, Splunk, ELK)
- 🌐 Provider di threat intelligence
- 📢 Canali di notifica (Discord, Teams, PagerDuty)
- 🎭 Template di payload per nuovi tipi di attacco
- 📖 Miglioramenti alla documentazione
- 🐛 Correzioni di bug e ottimizzazioni

Consulta [CONTRIBUTING.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/CONTRIBUTING.md) per le linee guida.

**Supporto commerciale:**
Per distribuzioni enterprise, integrazioni personalizzate o consulenza:
- Email: [[email protected]](mailto:[email protected])
- Web: [0t.Systems](https://www.0t.Systems)

---

## 📊 Statistiche del progetto

<div align="center">

| Metrica | Valore |
|--------|-------|
| **Precisione di rilevamento** | 99.2% |
| **Tempo medio di risposta** | < 15ms |
| **Riduzione dei costi** | 90% dopo l'apprendimento |
| **LLM supportati** | Claude, Gemini |
| **Opzioni di database** | SQLite, PostgreSQL |
| **Fonti di threat intelligence** | 3 (AbuseIPDB, VirusTotal, IPInfo) |
| **Canali di notifica** | 4 (Email, Slack, SMS, Webhook) |

</div>

---

## 📜 Licenza

IFRIT Proxy è rilasciato sotto [Apache License 2.0](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/LICENSE).

**Supporto commerciale, integrazione personalizzata o consulenza:**  
📧 [[email protected]](mailto:[email protected])

---

## 🙏 Riconoscimenti

Creato con:
- [Go](https://go.dev) - Runtime ad alte prestazioni
- [SQLite](https://www.sqlite.org) / [PostgreSQL](https://www.postgresql.org) - Persistenza dei dati
- [Anthropic Claude](https://www.anthropic.com) - Analisi di sicurezza tramite IA
- [Google Gemini](https://deepmind.google/technologies/gemini/) - Alternativa IA conveniente
- [AbuseIPDB](https://www.abuseipdb.com) - Intelligence sulla reputazione IP
- [VirusTotal](https://www.virustotal.com) - Rilevamento malware
- [IPInfo](https://ipinfo.io) - Geolocalizzazione e rilevamento privacy

**Un ringraziamento speciale alla community della sicurezza** per i contributi di threat intelligence e pattern.


---

<div align="center">

## 🚀 Pronto a Iniziare?

**[📦 Installa IFRIT](#-quick-start)** • **[📖 Leggi la Documentazione](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/START_HERE.md)** • **[🔌 Riferimento API](https://github.com/0tsystemspublicrepos/ifritproxy/blob/develop/docs/API_ENDPOINTS.md)**

</div>

---

<div align="center">

### **Creato con 🔥 da [0t.Systems](https://www.0t.Systems)**

*Trasformiamo gli attaccanti in fonti di intelligence, un honeypot alla volta*

**[⬆ Torna in cima](#-ifrit-proxy)**

---

**Domande? Problemi? Idee?**  
📧 Email: [[email protected]](mailto:[email protected])  
🐛 Segnala bug: [GitHub Issues](https://github.com/0tSystemsPublicRepos/IfritProxy/issues)  
💬 Discussioni: [GitHub Discussions](https://github.com/0tSystemsPublicRepos/IfritProxy/discussions)

---

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

</div>

Scenario	Comportamento	Latenza	Costo
Primo attacco dall'IP	Tutte e 3 le API chiamate	~500ms	$0.003
Attacco ripetuto (< 24h)	Cache hit, nessuna API	<10ms	$0.00
Dopo 24h	Ri-arricchisci, aggiorna cache	~500ms	$0.003

Più Popolari

IfritProxy

Informazioni

🔥 Piattaforma di Deception e Intelligence sulle Minacce basata sull'IA

Offerto alla community da

🎯 Cos'è IFRIT?

🏗️ Architettura di sistema

✨ Cosa Rende Diverso IFRIT?

💎 Funzionalità Principali

🧠 Intelligenza Multi-AI

🎭 Motore di Deception Adattivo

🔍 Hub di Threat Intelligence

📊 Visibilità Completa

Query your intelligence

🎯 Cosa succede dopo il rilevamento?

💾 Operazioni sul database```bash

Database statistics

View schema

Vacuum (SQLite only)

Export database

📡 Endpoint Disponibili

Get specific attack

Filter by IP

Filter by date range

Attack statistics

🔬 Pipeline di arricchimento dell'intelligence

💰 Economia dell'apprendimento: Ottimizzazione dei costi

Come Funziona```

Come Funziona```

🧬 Gestione dei Pattern```bash

List learned signatures

View specific pattern

Add custom pattern

Remove pattern

Export patterns

🔓 Whitelist/Eccezioni```bash

List exceptions

Add IP exception

Add path exception

Remove exception