websocket-security

用途：面向 WebSocket 协议的安全测试技能，用于审查实时通道、聊天、通知及 WS 后端 API 的安全问题，仅限授权测试，令牌与消息内容按敏感数据处理。

主要能力：

1. 协议基础：识别握手请求头 Upgrade: websocket、Connection: Upgrade、Sec-WebSocket-Key、Sec-WebSocket-Version: 13、Sec-WebSocket-Protocol，以及服务端 101 Switching Protocols 与 Sec-WebSocket-Accept 响应。
2. 跨站 WebSocket 劫持（CSWSH）：当服务端未校验 Origin 且受害者存在活动会话时，恶意页面可以受害者身份建立连接。测试需确认 Origin 校验、Cookie 是否发送（SameSite 规则）及子协议/自定义头要求。
3. 工具：wsrepl（pip install wsrepl；wsrepl -u wss://target.example.com/ws -P auth_plugin.py）、ws-harness（python ws-harness.py -u "ws://127.0.0.1:8765/path" -m ./message.txt）将 WS 桥接为 HTTP 供其他工具使用；Burp 生态的 SocketSleuth、WebSocket Turbo Intruder。
4. 常见漏洞：缺少 Origin 校验、令牌置于 URL、无消息限速、使用 ws:// 明文、消息体注入（SQLi/命令注入/XSS）。
5. 进阶主题：WebSocket 隧道走私（升级后透传原始 HTTP、H2-over-WebSocket）、Socket.IO 命名空间/事件名注入、确认回调滥用、轮询回退 CSRF、消息注入与存储型 XSS、二进制消息篡改（Protobuf、MessagePack、类型混淆）。

使用方式：从 JS 包、Swagger 或 101 响应定位端点；审查握手与 Origin/Host/Cookie 策略；用另一用户 Cookie 重连比对订阅主题与数据泄露；构造本地页面验证 CSWSH；对 JSON/文本载荷做注入模糊测试；标记生产环境中的 ws://。

限制：资料未提供具体授权流程、平台支持范围或效果保证；所有测试须在授权范围内进行，令牌与消息内容应视为敏感信息。