SocialFish v3.0

Современный динамический фишинговый набор

SocialFish v3.0 предлагает мощные новые функции для клонирования современных страниц входа, захвата cookie-файлов и перехвата кодов 2FA с помощью панели оператора в реальном времени.

🆕 Что нового в v3.0

Автоматизация браузера Playwright — Клонирование современных страниц входа с большим количеством JavaScript
Полный захват и анализ cookie — Детальные метаданные, атрибуты безопасности, токены аутентификации
Система шаблонов — Сохранение и повторное использование клонов для нескольких жертв
Панель перехвата OTP в реальном времени — Захват и инъекция кодов 2FA в реальном времени
MITM-обратный прокси — Туннелирование через ngrok/cloudflared с автоматической установкой
6 режимов клонирования — Только вход, только cookie или полный захват
Обнаружение многоэтапного входа — Автоматическая эвристика для сложных потоков (Office365 и т.д.)
Уведомления через Webhook — Оповещения в реальном времени в Slack, Discord, пользовательские API
Управление сессиями — Полное отслеживание сессий с экспортом в JSON/CSV
Перехват сетевого трафика — Логирование всех HTTP-запросов/ответов
Отслеживание жертв — Отслеживание кликов, IP-адресов, геолокации, типа устройства

📖 Документация

FEATURES_v3.md — Полное руководство по функциям с описанием рабочих процессов
IMPLEMENTATION_SUMMARY.md — Технические детали реализации
Wiki — Оригинальные руководства по установке и продвинутые инструкции

🚀 Быстрый старт

Вариант 1: Интерактивная установка (рекомендуется)

python setup.py

Это позволит:

Установить все зависимости
Настроить браузеры Playwright
Инициализировать базу данных
Настроить туннелирование (опционально)
Отобразить руководство по быстрому старту

Вариант 2: Ручная установка

pip install -r requirements.txt
playwright install chromium
python SocialFish.py admin password

Затем откройте: http://localhost:5000/neptune

🎯 Базовый рабочий процесс

Создать шаблон

/templates → New Template → Enter target URL

Настроить туннель (опционально, для удаленного тестирования)
```
Click "Tunnel" → Choose ngrok/cloudflared → Authorize
```
Сгенерировать URL-приманку
```
Click "Lure" → Copy unguessable URL
```
Отправить жертвам
```
Distribute lure URL in emails, messages, etc.
```

Отслеживать в реальном времени

/sessions → View captured credentials, cookies, OTP codes
/admin/otp_panel.html → Intercept & inject 2FA codes

🔧 Ключевые возможности

Библиотека шаблонов

Сохранение конфигураций клонов
Повторное использование для нескольких пользователей
Режимы клонирования: both (учётные данные + cookie), login (только учётные данные), cookies (только сессия)
Движки браузера: Playwright (по умолчанию), Selenium (опционально)

Полная cookie-банка (домен, путь, secure, httponly, samesite, срок действия)
Перехват cookie через JavaScript
Обнаружение токенов аутентификации
Анализ атрибутов безопасности
Экспорт в JSON/CSV

Панель OTP в реальном времени

Двусторонняя связь на основе WebSocket
Отображение деталей сессии жертвы
Ожидание кодов OTP (вручную или автоматически)
Инъекция OTP обратно в браузер жертвы
Мониторинг сетевой активности

MITM и обратный прокси

Автоматическая настройка туннелей ngrok или cloudflared
Обратное проксирование всего трафика жертвы
Автоматический захват cookie и учётных данных
Без дополнительной настройки

Уведомления через Webhook

Slack, Discord, пользовательские API
Срабатывание при отправке учётных данных, получении OTP, создании сессии
Полезные данные в формате JSON, form-encoded или XML

Обнаружение многоэтапного входа и 2FA

Автоматическая эвристика для сложных потоков
Обнаружение конечных точек OTP
Ручные точки останова для взаимодействия с пользователем
Индикаторы 2FA в аналитике

📊 Поддерживаемые сайты

Работает с любой страницей входа, использующей:

✅ HTML-формы
✅ Отправку форм через JavaScript
✅ Аутентификацию на основе XHR/fetch
✅ Вход в SPA (React, Vue, Angular)
✅ Процессы 2FA/OTP
✅ Многоэтапную аутентификацию (Office365, Gmail, GitHub и т.д.)

🌐 API и CLI

Web API

# Список шаблонов
curl http://localhost:5000/templates

# Генерация URL-приманки
curl -X POST http://localhost:5000/lure/generate \
  -d "template_id=1"

# Просмотр сессии
curl http://localhost:5000/session/1

Команды CLI

# Установка
python setup.py                    # Интерактивная установка

# Туннелирование
python core/tunnel_manager.py setup
python core/tunnel_manager.py start --type ngrok

# База данных
python core/db_migration.py

📂 Структура проекта

SocialFish/
├── SocialFish.py               # Основное приложение Flask
├── setup.py                    # Интерактивный мастер установки
├── FEATURES_v3.md             # Документация по функциям
├── IMPLEMENTATION_SUMMARY.md   # Технические детали
├── core/
│   ├── recorder_playwright.py  # Автоматизация браузера
│   ├── cookie_inspector.py     # Анализ cookie
│   ├── tunnel_manager.py       # Поддержка туннелирования
│   ├── db_migration.py         # Схема базы данных
│   └── ... (другие модули)
└── templates/
    └── admin/
        ├── templates.html      # Интерфейс библиотеки шаблонов
        ├── otp_panel.html     # Интерфейс перехвата OTP
        ├── sessions.html       # Интерфейс управления сессиями
        └── ... (другие шаблоны)

🔐 Безопасность и этика

⚠️ ТОЛЬКО ДЛЯ ОБРАЗОВАТЕЛЬНЫХ ЦЕЛЕЙ

✅ Согласие обязательно — Тестируйте только системы, которыми владеете или на которые имеете явное письменное разрешение
✅ Журналирование — Все операции регистрируются с указанием пользователя
✅ Защита данных — Внедрение политик хранения данных
✅ Соответствие GDPR — Соблюдение местных законов о конфиденциальности
✅ Раскрытие — Ответственное информирование об уязвимостях

Подробнее см. в CODE_OF_CONDUCT.md и LICENSE.

📱 Мобильный контроллер

Ищете мобильный контроллер? Посмотрите SocialFishMobile

⚖️ Отказ от ответственности

ИСПОЛЬЗОВАТЬ ТОЛЬКО В ОБРАЗОВАТЕЛЬНЫХ ЦЕЛЯХ

Использование SocialFish является ПОЛНОЙ ОТВЕТСТВЕННОСТЬЮ КОНЕЧНОГО ПОЛЬЗОВАТЕЛЯ. Разработчики НЕ несут ответственности и НЕ отвечают за любое неправомерное использование или ущерб, причиненный этой программой.

«ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ. НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ ВЛАДЕЛЕЦ АВТОРСКОГО ПРАВ ИЛИ УЧАСТНИКИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ЗА ЛЮБОЙ ПРЯМОЙ, КОСВЕННЫЙ, СЛУЧАЙНЫЙ, ОСОБЫЙ, ПОБОЧНЫЙ ИЛИ КОНСЕКВЕНТНЫЙ УЩЕРБ (ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ, ЗАМЕНОЙ ТОВАРОВ ИЛИ УСЛУГ; ПОТЕРЕЙ ДАННЫХ ИЛИ ПРИБЫЛИ; ИЛИ ПРЕРЫВАНИЕМ БИЗНЕСА), КАК НА ОСНОВАНИИ ДОГОВОРА, СТРОГОЙ ОТВЕТСТВЕННОСТИ ИЛИ ПРАВОНАРУШЕНИЯ (ВКЛЮЧАЯ ХАЛАТНОСТЬ ИЛИ ИНОЕ), ВОЗНИКШИМ ВСЛЕДСТВИЕ ИСПОЛЬЗОВАНИЯ ЭТОГО ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ, ДАЖЕ ЕСЛИ БЫЛО СООБЩЕНО О ВОЗМОЖНОСТИ ТАКОГО УЩЕРБА."

Взято из LICENSE.

🐳 Docker

Запуск с Docker:

docker compose up

Статус: Готов к использованию для авторизованного тестирования безопасности и упражнений «красных команд»

УЧАСТИЕ В РАЗРАБОТКЕ

Мы призываем вас внести свой вклад в SocialFish! Пожалуйста, ознакомьтесь с руководством Contributing to SocialFish для получения рекомендаций. Присоединяйтесь к нам!

Особые участники

@carinamary2448 - https://github.com/carinamary2448

Популярное

SocialFish