# hunt-websocket

Скилл hunt-websocket ищет уязвимости в WebSocket: CSWSH, слабую проверку Origin, отсутствие аутентификации сообщений, подмену фреймов и обход авторизации в socket.io.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 16193 у репозитория
- Автор: Sachin Sharma
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/elementalsouls/Claude-BugHunter/tree/HEAD/skills/hunt-websocket/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/hunt-websocket

## Что делает

Скилл проверяет WebSocket-эндпоинты на несколько классов уязвимостей. Главная цель — Cross-Site WebSocket Hijacking (CSWSH): хендшейк аутентифицируется через cookie без CSRF-токена, сервер не проверяет `Origin`, и атакующая страница открывает сокет от имени жертвы, перехватывая её данные в реальном времени. Скилл ищет эндпоинты через grep по JS (`new WebSocket`, `io()`, `socket.io`), пробует хендшейк с чужим `Origin`, строит PoC для проверки утечки данных жертвы.

Внутри — команды для проверки socket.io, SignalR, Phoenix Channels, сканирование нестандартных портов (`nmap`), анализ истории WebSocket в Burp. Для socket.io скилл запрашивает версию через polling-хендшейк и сверяет известные advisory. Без `wscat`, `nmap` и `curl` часть проверок не пройдёт.

Скилл использует публичные кейсы: исследование PortSwigger по CSWSH, оригинальную публикацию Christian Schneider 2013 года, CVE-2020-7662 (ReDoS в `websocket-extensions`) и CVE-2024-37890 (DoS в `ws`). Проверяет подмену сообщений в торговых и игровых приложениях, обход авторизации в namespace/room socket.io, smuggling на уровне `Upgrade`-хендшейка.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add elementalsouls/Claude-BugHunter
```
В чате агента (не в терминале):
```text
/plugin install claude-bughunter@elementalsouls
```
Команда ставит плагин claude-bughunter целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill hunt-websocket -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/hunt-websocket/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/hunt-websocket/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill hunt-websocket -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/hunt-websocket/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill hunt-websocket -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/hunt-websocket/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install elementalsouls/Claude-BugHunter skills/hunt-websocket
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/hunt-websocket/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill hunt-websocket -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/elementalsouls/Claude-BugHunter --path skills/hunt-websocket
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/hunt-websocket/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/elementalsouls/Claude-BugHunter/tree/HEAD/skills/hunt-websocket/SKILL.md

## Когда брать
- найти WebSocket-эндпоинты через grep по JS и краулинг URL
- проверить CSWSH: cookie-хендшейк без CSRF-токена и контроля Origin
- обнаружить отсутствие аутентификации отдельных фреймов
- выявить обход авторизации в socket.io namespace и room
- построить PoC для перехвата данных жертвы через сторонний Origin

## Примеры запросов агенту
- Найди все WebSocket-эндпоинты в `recon/target.com/` через grep по `new WebSocket` и `socket.io`
- Проверь `wss://target.com/ws` на CSWSH: хендшейк с `Origin: https://evil.com` и моей сессией
- Построй PoC для CSWSH: HTML-страница, которая открывает сокет от имени жертвы и логирует её сообщения

## Похожие
- [websocket-security](https://affpapa.org/nevibecode/skills/websocket-security.md) — скилл · 4100 установок
- [testing-websocket-api-security](https://affpapa.org/nevibecode/skills/testing-websocket-api-security.md) — скилл · 379 установок
- [websocket](https://affpapa.org/nevibecode/skills/websocket.md) — скилл · 272 установки
- [websocket-engineer](https://affpapa.org/nevibecode/skills/websocket-engineer.md) — скилл · 7300 установок
- [websocket-implementation](https://affpapa.org/nevibecode/skills/websocket-implementation.md) — скилл · 669 установок
- [websocket-realtime-builder](https://affpapa.org/nevibecode/skills/websocket-realtime-builder.md) — скилл · 549 установок

Из того же набора: [elementalsouls/claude-bughunter](https://affpapa.org/nevibecode/by/elementalsouls/claude-bughunter.md) — 92 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
