What problem does it solve?
This Skill helps security testers understand the WebSocket handshake and identify common WebSocket-specific weaknesses that lead to account takeover, data leakage, or injection paths in real-time applications.
Core Features & Use Cases
- WebSocket protocol validation: Review
Upgrade/Connection, Sec-WebSocket-Key, and 101 Switching Protocols behavior to confirm the endpoint is behaving correctly.
- CSWSH threat modeling and testing: Detect missing
Origin validation and assess whether browser cookies or session binding enable cross-site WebSocket hijacking.
- Practical assessment workflow: Use a decision tree to triage endpoints, align auth models with REST via
api-sec when applicable, and test message semantics and transport choices (ws:// vs wss://).
- Advanced vulnerability angles: Cover message injection risks, binary message manipulation (Protobuf/MessagePack), Socket.IO namespace/event issues, and potential proxy/WAF interactions including smuggling concepts.
Quick Start
Use websocket-security to review the WebSocket handshake, check for missing Origin validation, and validate whether an attacker-controlled page could connect and send messages using a victim’s active session to the target endpoint.