**Дизайн с приоритетом API** - интегрируйте с любым стеком безопасности.

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



---


## 🔄 Как это работает

<div align="center">

### Четырехэтапный конвейер обнаружения

</div>

<details> 
<summary><b>🎨 Нажмите здесь, чтобы развернуть интерактивную диаграмму</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

---

## 🎛️ Два режима обнаружения

<div align="center">

Выберите свою философию безопасности: **доверяй, но проверяй** vs **нулевое доверие**

</div>

<table>
<tr>
<th width="50%">🔍 Режим обнаружения (по умолчанию)</th>
<th width="50%">🛡️ Режим разрешённого списка (строгое нулевое доверие)</th>
</tr>

<tr>
<td valign="top">

### Философия
> **"Доверяй, но проверяй"** - Анализировать всё разумно

### Конфигурация```json
{
  "detection": {
    "mode": "detection",
    "enable_local_rules": true,
    "enable_llm": true,
    "whitelist_ips": [],      // Optional
    "whitelist_paths": []     // Optional
  }
}

### Лучше всего подходит для
- ✅ Веб-приложения, доступные извне
- ✅ REST API с неизвестными клиентами
- ✅ Платформы электронной коммерции
- ✅ SaaS-продукты
- ✅ Доставка контента
- ✅ Маркетинговые сайты

### Преимущества
- 🎯 Умное обнаружение угроз
- 📊 Обучение на всем трафике
- 🔄 Адаптация к новым атакам
- 🌐 Работает с динамическими пользователями
- 📈 Создает базу данных аналитики

### Недостатки
- ⚠️ Требует настройки для ложных срабатываний
- 🤖 Зависит от точности ИИ
- ⏱️ Начальный период обучения

</td>

<td valign="top">

### Философия
> **"Запретить по умолчанию"** — пропускать только явное доверие

### Конфигурация```json
{
  "detection": {
    "mode": "allowlist",
    "whitelist_ips": [
      "192.168.1.100",
      "10.0.0.0/24"
    ],
    "whitelist_paths": [
      "/health",
      "/metrics"
    ]
  }
}

### Лучше всего подходит для
- ✅ Панели администрирования
- ✅ Внутренние дашборды
- ✅ VPN-сервисы
- ✅ Бэкенд API (приватные)
- ✅ Инструменты управления БД
- ✅ Вебхуки CI/CD

### Преимущества
- 🔒 Максимальная безопасность
- ⚡ Нулевая задержка (без ИИ)
- 🎯 Ноль ложных срабатываний
- 💰 Нулевые затраты на API
- 🛡️ Идеально для ценных целей

### Недостатки
- ❌ Требует известных IP/путей
- 📋 Ручное управление белым списком
- 🚫 Блокирует легитимные неизвестные запросы
- 🔧 Менее гибкий

</td>
</tr>

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

### 💡 **Совет:** Гибридный подход

Начните с **режима ввода** (7 дней) для автоматического обнаружения легитимных паттернов, затем переключитесь на нужный режим:

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

<pre><code>{
  "execution_mode": {
    "mode": "onboarding",              // Автообучение в течение 7 дней
    "onboarding_duration_days": 7,
    "onboarding_auto_whitelist": true  // Автоматическое добавление в белый список
  }
}</code></pre>

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

После ввода → Переключитесь на **режим обнаружения** или **режим белого списка** в зависимости от ваших потребностей

</td>
</tr>

</table>

**🎬 Режимы выполнения:**

| Режим | Назначение | Блокировка | Обучение | Длительность |
|------|------------|------------|----------|--------------|
| **🎓 Ввод** | Изучение легитимного трафика | ❌ Нет | ✅ Да | 7 дней (по умолчанию) |
| **🛡️ Обнаружение** | Полная защита | ✅ Да | ✅ Да | Продакшн |

Подробное сравнение и варианты использования см. в [DETECTION_MODES.md](https://github.com/0tsystemspublicrepos/ifritproxy/blob/HEAD/docs/DETECTION_MODES.md).



---

## 📊 Панель управления и администрирование

<div align="center">

### 🎯 Информационная панель в реальном времени

Доступ по адресу **`http://localhost:8443/`** с аутентификацией по API-токену

</div>

**Обзор панели:**

Панель IFRIT обеспечивает видимость безопасности в реальном времени с помощью:

- **📊 Распределение уровней угроз** — визуальная разбивка угроз CRITICAL/HIGH/MEDIUM/LOW
- **🎯 Топ наиболее опасных атакующих** — рейтинг в реальном времени с оценками риска, странами и флагами (Tor, VPN, хостинг)
- **⚡ Производительность конвейера обнаружения** — поэтапные метрики, показывающие эффективность кэширования
- **📈 Тенденции атак** — разбивка типов атак за 24 часа с визуальными полосами
- **🌍 Географическая аналитика** — местоположения источников атак с флагами


### ⌨️ Управление через CLI

Полное управление разведкой безопасности из командной строки:

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

#### 🚨 Разведка атак```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">

#### 👤 Профили атакующих```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">

#### 🔍 Разведка угроз```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

**🔄 Агностик базы данных:** Те же команды работают как с SQLite, так и с PostgreSQL!

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



### 🔌 REST API

<div align="center">

**JSON API для бесшовной интеграции с вашим стеком безопасности**

</div>

Интегрируйте IFRIT с SIEM, инструментами мониторинга или пользовательскими панелями с помощью нашего всеобъемлющего REST API.

#### 🔐 Аутентификация

Все конечные точки API требуют аутентификации с помощью API-токена:```bash
# Include in every request
curl -H "X-API-Token: YOUR_TOKEN_HERE" \
  http://localhost:8443/api/...