IfritProxy

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

### 🗄️ **Produktionsreifer Speicher**

Datenbankflexibilität für jede Größenskala:

- **📦 SQLite** - Null Konfiguration, perfekt für einzelne Server
- **🐘 PostgreSQL** - Unternehmensgröße, Cluster-Bereitstellungen
- **🔌 Provider-Abstraktion** - Wechsel nur mit Konfiguration
- **🛠️ Einheitliche CLI** - Gleiche Befehle, jede Datenbank```bash
# Works with both!
./ifrit-cli attack list
./ifrit-cli pattern add sql_injection

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

### 📢 **Intelligentes Warnsystem**

Mehrkanal-Benachrichtigungen ohne Ermüdungserscheinungen:

- **📧 E-Mail** - SMTP (Gmail, SendGrid, benutzerdefiniert)
- **💬 Slack** - Webhook mit farbcodiertem Schweregrad
- **📱 SMS** - Twilio nur für kritische Bedrohungen
- **🔗 Webhooks** - Benutzerdefiniertes JSON mit Wiederholungslogik

**Regelbasierte Filterung:**```json
"rules": {
  "alert_on_critical": true,   // ✅ Always
  "alert_on_high": false,      // 🔇 Quiet
  "alert_on_medium": false,    // 🔇 Quiet
  "alert_on_low": false        // 🔇 Quiet
}
```
</td>
<td width="50%" valign="top">

### 📊 **Vollständige Transparenz**

Echtzeit-Intelligenz auf einen Blick:

- **🎯 Live-Dashboard** - Bedrohungsstufen, Top-Angreifer, Statistiken
- **🔌 REST-API** - JSON-Endpunkte für SIEM-Integration
- **⌨️ CLI-Tools** - Vollständige Kommandozeilenverwaltung
- **📈 Analysen** - Angriffszeitlinien, Angreiferprofile```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** – Integration in jede Sicherheitsumgebung.

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



---


## 🔄 Wie es funktioniert

<div align="center">

### Die vierstufige Erkennungspipeline

</div>

<details> 
<summary><b>🎨 Klicken Sie hier, um das interaktive Diagramm zu erweitern</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
```
</details>


### 🎯 Was passiert nach der Erkennung?
</br>
<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/9318/267273e580b8ba7e204c0143355ee44616af19be04d4232ca4831563e0dc1280.png" alt="Was passiert nach der Erkennung" width="650">
</div>


### 🔬 Pipeline zur Anreicherung von Bedrohungsdaten

Jeder erkannte Angriff löst **paralleles Sammeln von Bedrohungsdaten** im Hintergrund aus:
</br>
<div align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/9318/a0d1c286f17eeaa17f08371e683b9abc632c851cd664e931da99d1b344584ae8.png" alt="Pipeline zur Anreicherung von Bedrohungsdaten" width="650">
</div>





**Leistungsmerkmale:**

| Szenario | Verhalten | Latenz | Kosten |
|----------|----------|---------|------|
| **Erster Angriff von IP** | Alle 3 APIs aufgerufen | ~500ms | $0.003 |
| **Wiederholter Angriff (< 24h)** | Cache-Treffer, keine APIs | <10ms | $0.00 |
| **Nach 24h** | Erneute Anreicherung, Cache aktualisieren | ~500ms | $0.003 |

**💡 Ergebnis:** 90%+ Cache-Trefferquote = minimale API-Kosten + schnelle Abfragen



### 💰 Lernökonomie: Kostenoptimierung

IFRIT lernt aus jedem Angriff und senkt die Betriebskosten drastisch:

<table>
<tr>
<th width="50%">⏰ Stunde 1: Anfängliche Lernphase</th>
<th width="50%">🚀 Stunde 2: Optimierter Betrieb</th>
</tr>
<tr>
<td valign="top">

**Erstkontakt**```
📊 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
```
**Was geschah:**
- ✅ Alle Angriffe erkannt
- ✅ Muster gelernt
- ✅ Erkenntnisse zwischengespeichert
- ✅ Angreifer getäuscht

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

**Zwischengespeicherte Erkenntnisse**```
📊 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
```
**Was passiert ist:**
- ✅ 100 % Cache-Trefferquote
- ✅ 90 ms → 10 ms Latenz
- ✅ **100 % Kosteneinsparungen!**
- ✅ Gleiches Schutzniveau

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

**📊 Praxisnahes Szenario (30 Tage):**```
Day 1:  5,000 attacks, 200 unique → $6.00 in API costs
Day 2:  5,000 attacks, 150 new    → $4.50 in API costs
Day 3:  5,000 attacks, 100 new    → $3.00 in API costs
...
Day 7:  5,000 attacks,  50 new    → $1.50 in API costs
Day 14: 5,000 attacks,  20 new    → $0.60 in API costs
Day 30: 5,000 attacks,  10 new    → $0.30 in API costs

Total: 150,000 attacks handled
Cost without caching: ~$450.00
Cost with IFRIT learning: ~$45.00
💰 Savings: $405.00 (90% reduction!)
```
---

## 🎛️ Zwei Erkennungsmodi

<div align="center">

Wählen Sie Ihre Sicherheitsphilosophie: **Vertrauen, aber überprüfen** vs **Nullvertrauen**

</div>

<table>
<tr>
<th width="50%">🔍 Erkennungsmodus (Standard)</th>
<th width="50%">🛡️ Zulassungslistenmodus (Striktes Nullvertrauen)</th>
</tr>

<tr>
<td valign="top">

### Philosophie
> **„Vertrauen, aber überprüfen“** - Analysieren Sie alles intelligent

### Konfiguration```json
{
  "detection": {
    "mode": "detection",
    "enable_local_rules": true,
    "enable_llm": true,
    "whitelist_ips": [],      // Optional
    "whitelist_paths": []     // Optional
  }
}
```
### Wie es funktioniert```
Incoming Request
    │
    ├─ Whitelisted? ──▶ ✅ ALLOW
    │
    ├─ Stage 1 Match? ──▶ 🍯 HONEYPOT
    │
    ├─ Stage 2 Match? ──▶ 🍯 HONEYPOT
    │
    ├─ Stage 3 LLM? ────▶ 🍯 or ✅
    │
    └─ Default: Analyze with AI
```
### Am besten geeignet für
- ✅ Öffentlich zugängliche Webanwendungen
- ✅ REST-APIs mit unbekannten Clients
- ✅ E-Commerce-Plattformen
- ✅ SaaS-Produkte
- ✅ Content-Delivery
- ✅ Marketing-Websites

### Vorteile
- 🎯 Intelligente Bedrohungserkennung
- 📊 Aus dem gesamten Datenverkehr lernen
- 🔄 Anpassungsfähig an neue Angriffe
- 🌐 Funktioniert mit dynamischen Benutzern
- 📈 Aufbau einer Wissensdatenbank

### Nachteile
- ⚠️ Erfordert Optimierung für falsch positive Ergebnisse
- 🤖 Hängt von der KI-Genauigkeit ab
- ⏱️ Anfängliche Einlernphase

</td>

<td valign="top">

### Philosophie
> **"Standardmäßig verweigern"** - Nur explizites Vertrauen wird durchgelassen

### Konfiguration

</td>```json
{
  "detection": {
    "mode": "allowlist",
    "whitelist_ips": [
      "192.168.1.100",
      "10.0.0.0/24"
    ],
    "whitelist_paths": [
      "/health",
      "/metrics"
    ]
  }
}
```
### Wie es funktioniert```
Incoming Request
    │
    ├─ Whitelisted IP? ─▶ ✅ ALLOW
    │
    ├─ Whitelisted Path? ─▶ ✅ ALLOW
    │
    └─ Everything Else ──▶ 🚫 BLOCK
    
No AI analysis needed
No learning phase
Instant block
```
### Am besten geeignet für
- ✅ Admin-Panels
- ✅ Interne Dashboards
- ✅ VPN-Only-Dienste
- ✅ Backend-APIs (privat)
- ✅ Datenbankverwaltungstools
- ✅ CI/CD-Webhooks

### Vorteile
- 🔒 Maximale Sicherheit
- ⚡ Keine Latenz (keine KI)
- 🎯 Keine Fehlalarme
- 💰 Keine API-Kosten
- 🛡️ Perfekt für hochwertige Ziele

### Nachteile
- ❌ Erfordert bekannte IPs/Pfade
- 📋 Manuelle Whitelist-Verwaltung
- 🚫 Blockiert legitime Unbekannte
- 🔧 Weniger flexibel

</td>
</tr>

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

### 💡 **Profi-Tipp:** Hybrider Ansatz

Starten Sie mit dem **Onboarding-Modus** (7 Tage), um automatisch legitime Muster zu erkennen, und wechseln Sie dann zu Ihrem bevorzugten Modus:

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

<pre><code>{
  "execution_mode": {
    "mode": "onboarding",              // Automatisches Lernen für 7 Tage
    "onboarding_duration_days": 7,
    "onboarding_auto_whitelist": true  // Automatisch zur Whitelist hinzufügen
  }
}</code></pre>

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

Nach dem Onboarding → Wechseln Sie je nach Bedarf in den **Erkennungsmodus** oder **Allowlist-Modus**

</td>
</tr>

</table>

**🎬 Ausführungsmodi:**

| Modus | Zweck | Blockierung | Lernen | Dauer |
|-------|-------|-------------|--------|-------|
| **🎓 Onboarding** | Legitimen Traffic lernen | ❌ Nein | ✅ Ja | 7 Tage (Standard) |
| **🛡️ Erkennung** | Vollständiger Schutz | ✅ Ja | ✅ Ja | Produktion |

Siehe [DETECTION_MODES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/DETECTION_MODES.md) für detaillierten Vergleich und Anwendungsfälle.



---


## 📊 Dashboard & Verwaltung

<div align="center">

### 🎯 Echtzeit-Intelligenz-Dashboard

Zugriff unter **`http://localhost:8443/`** mit API-Token-Authentifizierung

</div>

**Dashboard-Übersicht:**

Das IFRIT-Dashboard bietet Echtzeit-Einblicke in Ihre Sicherheitslage:

- **📊 Bedrohungsstufen-Verteilung** - Visuelle Aufschlüsselung von CRITICAL/HIGH/MEDIUM/LOW-Bedrohungen
- **🎯 Top-Risiko-Angreifer** - Echtzeit-Ranking mit Risikobewertungen, Ländern und Flags (Tor, VPN, Hosting)
- **⚡ Erkennungspipeline-Leistung** - Stufenweise Metriken mit Cache-Effizienz
- **📈 Angriffstrends** - Aufschlüsselung der Angriffstypen über 24 Stunden mit visuellen Balken
- **🌍 Geografische Einblicke** - Angriffsquellorte mit Flags


### ⌨️ CLI-Verwaltung

Vollständige Befehlszeilensteuerung Ihrer Sicherheitsintelligenz:

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

#### 🚨 Angriffs-Intelligenz```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
```
#### 🧬 Pattern-Verwaltung```bash
# List learned signatures
./ifrit-cli pattern list

# View specific pattern
./ifrit-cli pattern view 15

# Add custom pattern
./ifrit-cli pattern add \
  sql_injection \
  "' OR '1'='1"

# Remove pattern
./ifrit-cli pattern remove 15

# Export patterns
./ifrit-cli pattern export
```
</td>
<td width="50%" valign="top">

#### 👤 Angreiferprofile```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
```
#### 🔓 Whitelist/Ausnahmen```bash
# List exceptions
./ifrit-cli exception list

# Add IP exception
./ifrit-cli exception add \
  --ip 10.0.0.1 \
  --reason "Office VPN"

# Add path exception
./ifrit-cli exception add \
  --path /health \
  --reason "Health check"

# Remove exception
./ifrit-cli exception remove 3
```
</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 🔍 Bedrohungsinformationen```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
```
</td>
<td width="50%" valign="top">

#### 💾 Datenbankoperationen```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
```
**🔄 Datenbank-agnostisch:** Dieselben Befehle funktionieren sowohl mit SQLite als auch mit PostgreSQL!

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



### 🔌 REST-API

<div align="center">

**JSON-API für die nahtlose Integration in Ihre Sicherheitsumgebung**

</div>

Integrieren Sie IFRIT mit SIEM, Überwachungstools oder benutzerdefinierten Dashboards mithilfe unserer umfassenden REST-API.

#### 🔐 Authentifizierung

Alle API-Endpunkte erfordern eine Authentifizierung über einen API-Token:```bash
# Include in every request
curl -H "X-API-Token: YOUR_TOKEN_HERE" \
  http://localhost:8443/api/...
```
**API-Tokens generieren:** Konfigurieren in `config/default.json` unter `api.tokens`

---

#### 📡 Verfügbare Endpunkte

<details>
<summary><b>🚨 Angriffsintelligenz</b></summary>```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
```
**Antwortbeispiel:**```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
}
```
</details>

<details>
<summary><b>👤 Angreiferprofile</b></summary>```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"
```
**Antwortbeispiel:**```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
}
```
</details>

<details>
<summary><b>🧬 Gelernte Muster</b></summary>```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>🔍 Bedrohungsinformationen</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
```
**Antwortbeispiel:**```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>📢 Konfiguration der Benachrichtigungen</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
```
</details>

<details>
<summary><b>💾 Cache-Verwaltung</b></summary>```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>

---

**📚 Vollständige API-Dokumentation:** Siehe [API_ENDPOINTS.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/API_ENDPOINTS.md) für die vollständige Referenz inklusive Request/Response-Schemas, Fehlercodes und Ratenbegrenzungen.



---

## 🔐 Datenschutz & Compliance

### Datenanonymisierung

Sensible Daten werden **automatisch geschwärzt**, bevor sie externe LLMs erreichen:

| **Geschwärzt** | **Beibehalten** |
|---|---|
| 🔒 Authentifizierungstokens & Anmeldedaten | ✅ HTTP-Methode/-Pfad |
| 🔒 Sitzungs-Cookies | ✅ Angriffsmuster |
| 🔒 API-Schlüssel | ✅ Content-Type |
| 🔒 E-Mail-Adressen | ✅ User-Agent |
| 🔒 Persönliche Informationen | ✅ Angriffssignaturen |

**Compliance-Abdeckung:**
- ✅ **DSGVO** - Personenbezogene Daten vor externen API-Aufrufen anonymisiert
- ✅ **HIPAA** - Geschützte Gesundheitsinformationen vor Dritten geschützt
- ✅ **PCI-DSS** - Kreditkartendaten geschwärzt
- ✅ **CCPA** - Datenminimierung der Nutzerdaten durchgesetzt

Siehe [ANONYMIZATION_TESTING.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/ANONYMIZATION_TESTING.md) für Details.

---

## ⚙️ Konfiguration

### Multi-LLM-Einrichtung

**Claude (Empfohlen für Sicherheit):**```json
{
  "llm": {
    "provider": "claude",
    "claude": {
      "api_key": "${ANTHROPIC_API_KEY}",
      "model": "claude-sonnet-4-20250514",
      "max_tokens": 4096,
      "temperature": 0.0
    }
  }
}
```
**Gemini (Kostengünstige Alternative):**```json
{
  "llm": {
    "provider": "gemini",
    "gemini": {
      "api_key": "${GOOGLE_API_KEY}",
      "model": "gemini-2.0-flash-exp",
      "max_tokens": 4096,
      "temperature": 0.0
    }
  }
}
```
### Datenbankoptionen

**SQLite (Standard - Keine Konfiguration):**```json
{
  "database": {
    "type": "sqlite",
    "sqlite": {
      "path": "./data/ifrit.db"
    }
  }
}
```
**PostgreSQL (Unternehmensskala):**```json
{
  "database": {
    "type": "postgresql",
    "postgresql": {
      "host": "localhost",
      "port": 5432,
      "user": "ifrit_user",
      "password": "${POSTGRES_PASSWORD}",
      "database": "ifrit",
      "ssl_mode": "require"
    }
  }
}
```
**Wann was verwenden:**
- **SQLite:** Einzelner Server, < 1M Angriffe/Tag, schnelle Einrichtung
- **PostgreSQL:** Cluster, > 1M Angriffe/Tag, Unternehmensanforderungen

### Bedrohungsinformationen

Externe Anreicherung aktivieren:```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
    }
  }
}
```
### Benachrichtigungssystem

Mehrkanal-Benachrichtigungen mit regelbasierter Filterung:```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
    }
  }
}
```
**Profi-Tipp:** Aktivieren Sie zunächst nur KRITISCHE Warnungen, um eine Alarmmüdigkeit zu vermeiden.

---

## 📚 Dokumentation

| Dokument | Beschreibung |
|----------|-------------|
| [START_HERE.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/START_HERE.md) | Navigationsanleitung für alle Dokumente |
| [INSTALLATION.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/INSTALLATION.md) | Detaillierte Einrichtungsanweisungen |
| [DETECTION_MODES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/DETECTION_MODES.md) | Vergleich zwischen Erkennung und Zulassungsliste |
| [THREAT_INTELLIGENCE.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/THREAT_INTELLIGENCE.md) | Leitfaden zur Bedrohungsanalyse |
| [NOTIFICATIONS.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/NOTIFICATIONS.md) | Konfiguration des Alarmsystems |
| [API_ENDPOINTS.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/API_ENDPOINTS.md) | Vollständige REST-API-Referenz |
| [FEATURES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/FEATURES.md) | Vollständige Funktionsliste |
| [DECEPTIVE_PAYLOADS_MANAGEMENT.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/DECEPTIVE_PAYLOADS_MANAGEMENT.md) | Honeypot-Antwortsystem |
| [ANONYMIZATION_TESTING.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/ANONYMIZATION_TESTING.md) | Details zu Datenschutz und Compliance |

---

## 🛣️ Fahrplan

**v0.4.0 - Verbesserte Bedrohungsanalyse** 
- [ ] Integration der Keycloak-Authentifizierung
- [ ] Neugestaltung des Admin-Portals
- [ ] Datenbankgestützte Konfiguration
- [ ] Verbesserungen des maschinellen Lernens bei der Bewertung
- [ ] Angriffsdeduplizierung

**v0.5.0 - Enterprise-Funktionen** 
- [ ] Erweiterte SIEM-Integrationen (Wazuh, Splunk, ELK)
- [ ] MySQL/MariaDB-Unterstützung
- [ ] Clustering & Lastausgleich
- [ ] Benachrichtigungsplanung & Ruhezeiten

**v0.6.0 - Automatisierung** 
- [ ] Automatisierung von Antworten
- [ ] Eskalationsrichtlinien
- [ ] Benachrichtigungsbündelung
- [ ] Erweiterte Bedrohungskorrelation

---

## 🤝 Mitwirken

IFRIT ist Open Source unter der Apache License 2.0. Wir freuen uns über Beiträge!

**Bereiche, in denen Hilfe benötigt wird:**
- 🧠 Neue LLM-Anbieter (GPT, Llama, Mistral)
- 🔗 SIEM-Integrationen (Wazuh, Splunk, ELK)
- 🌐 Anbieter für Bedrohungsinformationen
- 📢 Benachrichtigungskanäle (Discord, Teams, PagerDuty)
- 🎭 Payload-Vorlagen für neue Angriffstypen
- 📖 Verbesserungen der Dokumentation
- 🐛 Fehlerbehebungen und Optimierungen

Siehe [CONTRIBUTING.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/CONTRIBUTING.md) für Richtlinien.

**Kommerzieller Support:**
Für Unternehmensbereitstellungen, kundenspezifische Integrationen oder Beratung:
- E-Mail: [[email protected]](mailto:[email protected])
- Web: [0t.Systems](https://www.0t.Systems)

---

## 📊 Projektstatistiken

<div align="center">

| Metrik | Wert |
|--------|-------|
| **Erkennungsgenauigkeit** | 99.2% |
| **Durchschnittliche Antwortzeit** | < 15ms |
| **Kostenreduzierung** | 90% nach dem Lernen |
| **Unterstützte LLMs** | Claude, Gemini |
| **Datenbankoptionen** | SQLite, PostgreSQL |
| **Bedrohungsanalyse-Quellen** | 3 (AbuseIPDB, VirusTotal, IPInfo) |
| **Benachrichtigungskanäle** | 4 (E-Mail, Slack, SMS, Webhook) |

</div>

---

## 📜 Lizenz

IFRIT Proxy ist lizenziert unter der [Apache License 2.0](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/LICENSE).

**Kommerzieller Support, kundenspezifische Integration oder Beratung:**  
📧 [[email protected]](mailto:[email protected])

---

## 🙏 Danksagungen

Erstellt mit:
- [Go](https://go.dev) - Hochleistungslaufzeit
- [SQLite](https://www.sqlite.org) / [PostgreSQL](https://www.postgresql.org) - Datenpersistenz
- [Anthropic Claude](https://www.anthropic.com) - KI-Sicherheitsanalyse
- [Google Gemini](https://deepmind.google/technologies/gemini/) - Kostengünstige KI-Alternative
- [AbuseIPDB](https://www.abuseipdb.com) - IP-Reputationsinformationen
- [VirusTotal](https://www.virustotal.com) - Malware-Erkennung
- [IPInfo](https://ipinfo.io) - Geolokalisierung & Datenschutzerkennung

**Besonderer Dank an die Sicherheitsgemeinschaft** für Bedrohungsinformationen und Musterbeiträge.

---

<div align="center">

## 🚀 Bereit loszulegen?

**[📦 IFRIT installieren](#-quick-start)** • **[📖 Dokumentation lesen](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/START_HERE.md)** • **[🔌 API-Referenz](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/API_ENDPOINTS.md)**

</div>

---

<div align="center">

### **Erstellt mit 🔥 von [0t.Systems](https://www.0t.Systems)**

*Angreifer in Informationsquellen verwandeln, ein Honeypot nach dem anderen*

**[⬆ Zurück zum Anfang](#-ifrit-proxy)**

---

**Fragen? Probleme? Ideen?**  
📧 E-Mail: [[email protected]](mailto:[email protected])  
🐛 Fehler melden: [GitHub Issues](https://github.com/0tSystemsPublicRepos/IfritProxy/issues)  
💬 Diskussionen: [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>