WebSocket is a protocol providing full-duplex communications channels over a single TCP connection. The WebSocket protocol was standardized by the IETF as RFC 6455 in 2011, and the WebSocket API in Web IDL is being standardized by the W3C.
WebSocket is designed to be implemented in web browsers and web servers, but it can be used by any client or server application. The WebSocket Protocol is an independent TCP-based protocol. Its only relationship to HTTP is that its handshake is interpreted by HTTP servers as an Upgrade request. The WebSocket protocol makes possible more interaction between a browser and a web site, facilitating live content and the creation of real-time games. This is made possible by providing a standardized way for the server to send content to the browser without being solicited by the client, and allowing for messages to be passed back and forth while keeping the connection open. In this way a two-way (bi-directional) ongoing conversation can take place between a browser and the server. A similar effect has been achieved in non-standardized ways using stop-gap technologies such as Comet.
In addition, the communications are done over TCP port number 80, which is of benefit for those environments which block non-web Internet connections using a firewall. WebSocket protocol is currently supported in several browsers including Google Chrome, Internet Explorer, Firefox, Safari and Opera. WebSocket also requires web applications on the server to support it.
Like TCP, WebSocket provides for full-duplex communication. Websocket differs from TCP in that it enables a stream of messages instead of a stream of bytes. Before WebSocket, port 80 full-duplex communication was attainable using Comet channels; however, Comet implementation is nontrivial, and due to the TCP handshake and HTTP header overhead, it is inefficient for small messages. WebSocket protocol aims to solve these problems without compromising security assumptions of the web.
An older, less secure version of the protocol was implemented in Opera 11 and Safari 5, as well as the mobile version of Safari in iOS 4.2. Also, the BlackBerry Browser in OS7 implements WebSocket. Although there are no known exploits, it was disabled in Firefox 4 and 5, and Opera 11.
WebSocket protocol handshake
To establish a WebSocket connection, the client sends a WebSocket handshake request, and the server sends a WebSocket handshake response, as shown in the following example:
GET /mychat HTTP/1.1 Host: server.example.com Upgrade: websocket Connection: Upgrade Sec-WebSocket-Key: x3JJHMbDL1EzLkh9GBhXDw== Sec-WebSocket-Protocol: chat Sec-WebSocket-Version: 13 Origin: http://example.com
HTTP/1.1 101 Switching Protocols Upgrade: websocket Connection: Upgrade Sec-WebSocket-Accept: HSmrc0sMlYUkAGmm5OPpG2HaGWk= Sec-WebSocket-Protocol: chat
The handshake resembles HTTP so that servers can handle HTTP connections as well as WebSocket connections on the same port. However the specific fields involved, and what follows after the handshake, do not conform to the HTTP protocol.
Note that each line ends with an EOL (end of line) sequence,
\r\n. There must be a blank line at the end.
The client sends a
Sec-WebSocket-Key which is a random value that has been base64 encoded. To form a response, the magic string
258EAFA5-E914-47DA-95CA-C5AB0DC85B11 is appended to this (undecoded) key. The resulting string is then hashed with SHA-1, then base64 encoded. Finally, the resulting reply occurs in the header
Details of Sec-WebSocket-Key to Sec-WebSocket-Accept :
x3JJHMbDL1EzLkh9GBhXDw==258EAFA5-E914-47DA-95CA-C5AB0DC85B11string hashed by SHA-1 gives 0x
- Encoding the SHA-1 hash by Base64 (using the binary of the SHA-1) yields
HSmrc0sMlYUkAGmm5OPpG2HaGWk=, which is the Sec-WebSocket-Accept value.
Once the connection is established, the client and server can send WebSocket data or text frames back and forth in full-duplex mode. The data is minimally framed, with a small header followed by payload. WebSocket transmissions are described as "messages", where a single message can optionally be split across several data frames. This can allow for sending of messages where initial data is available but the complete length of the message is unknown (it sends one data frame after another until the end is reached and marked with the FIN bit). With extensions to the protocol, this can also be used for multiplexing several streams simultaneously (for instance to avoid monopolizing use of a socket for a single large payload).
WebSocket protocol client implementations try to detect if the user agent is configured to use a proxy when connecting to destination host and port and, if it is, uses HTTP CONNECT method to set up a persistent tunnel.
While the WebSocket protocol itself is unaware of proxy servers and firewalls, it features an HTTP-compatible handshake so that HTTP servers can share their default HTTP and HTTPS ports (80 and 443) with a WebSocket gateway or server. The WebSocket protocol defines a ws:// and wss:// prefix to indicate a WebSocket and a WebSocket Secure connection, respectively. Both schemes use an HTTP upgrade mechanism to upgrade to the WebSocket protocol. Some proxy servers are transparent and work fine with WebSocket; others will prevent WebSocket from working correctly, causing the connection to fail. In some cases, additional proxy server configuration may be required, and certain proxy servers may need to be upgraded to support WebSocket.
If unencrypted WebSocket traffic flows through an explicit or a transparent proxy server on its way to the WebSocket server, then, whether or not the proxy server behaves as it should, the connection is almost certainly bound to fail today (as WebSocket become more mainstream, proxy servers may become WebSocket aware). Therefore, unencrypted WebSocket connections should be used only in the simplest topologies.
If an encrypted WebSocket connection is used, then the use of Transport Layer Security (TLS) in the WebSocket Secure connection ensures that an HTTP CONNECT command is issued when the browser is configured to use an explicit proxy server. This sets up a tunnel, which provides low-level end-to-end TCP communication through the HTTP proxy, between the WebSocket Secure client and the WebSocket server. In the case of transparent proxy servers, the browser is unaware of the proxy server, so no HTTP CONNECT is sent. However, since the wire traffic is encrypted, intermediate transparent proxy servers may simply allow the encrypted traffic through, so there is a much better chance that the WebSocket connection will succeed if WebSocket Secure is used. Using encryption is not free of resource cost, but often provides the highest success rate.
A mid-2010 draft (version hixie-76) broke compatibility with reverse-proxies and gateways by including 8 bytes of key data after the headers, but not advertising that data in a Content-Length: 8 header. This data was not forwarded by all intermediates, which could lead to protocol failure. More recent drafts (e.g., hybi-09) put the key data in a Sec-WebSocket-Key header, solving this problem.
The WebSocket protocol specification defines two new URI schemes, ws: and wss:, for unencrypted and encrypted connections respectively. Apart from the scheme name, the rest of the URI components are defined to use URI generic syntax.
All the latest browsers except Android browser support the latest specification (RFC 6455) of the WebSocket protocol. A detailed protocol test suite report lists the conformance of those browsers to specific protocol aspects.
|Protocol||Draft date||Internet Explorer||Firefox (PC)||Firefox (Android)||Chrome (PC, Mobile)||Safari (Mac, iOS)||Opera (PC, Mobile)||Android Browser|
|hixie-75||February 4, 2010||4||5.0.0|
|May 6, 2010
May 23, 2010
|4.0 (disabled)||6||5.0.1||11.00 (disabled)|
|7 hybi-07||April 22, 2011||61|
|8 hybi-10||July 11, 2011||71||7||14|
|13 RFC 6455||December, 2011||10||11||11||16||6||12.10|
1 Gecko-based browsers versions 6–10 implement the WebSocket object as "MozWebSocket", requiring extra code to integrate with existing WebSocket-enabled code.
Using the Google Chrome Developer Tools, developers can inspect the WebSocket handshake as well as the WebSocket frames.
- Comparison of WebSocket implementations
- Internet socket
- Push technology
- Server-sent events
- RFC 6455#section-1.7
- Dirkjan Ochtman (May 27, 2011). "WebSocket enabled in Firefox 6". Mozilla.org. Retrieved 2011-06-30.
- "Chromium Web Platform Status". Retrieved 2011-08-03.
- "WebSockets (Windows)". Microsoft. 2012-09-28. Retrieved 2012-11-07.
- Katie Marsal (November 23, 2010). "Apple adds accelerometer, WebSockets support to Safari in iOS 4.2". AppleInsider.com. Retrieved 2011-05-09.
- "Web Sockets API". RIM. Retrieved 8 July 2011.
- Chris Heilmann (December 8, 2010). "WebSocket disabled in Firefox 4". Hacks.Mozilla.org. Retrieved 2011-05-09.
- Aleksander Aas (December 10, 2010). "Regarding WebSocket". My Opera Blog. Retrieved 2011-05-09.
- "How Web Sockets Interact With Proxy Servers". Infoq.com. Retrieved 2011-12-10.
- "WebSocket -76 is incompatible with HTTP reverse proxies". Ietf.org. 2010-07-06. Retrieved 2011-12-10.
- "The WebSocket protocol, draft hybi-09". June 13, 2011. Retrieved June 15, 2011.
- "IANA Uniform Resource Identifer (URI) Schemes". Iana.org. 2011-11-14. Retrieved 2011-12-10.
- "draft-hixie-thewebsocketprotocol-76 - The WebSocket protocol". Tools.ietf.org. Retrieved 2011-12-10.
- "WebSockets Protocol Test Report". Tavendo.de. 2011-10-27. Retrieved 2011-12-10.
- "WebSockets (support in Firefox)". Developer.mozilla.org. 2011-09-30. Retrieved 2011-12-10.
- "Bug 640003 - WebSockets - upgrade to ietf-06". Bugzilla.mozilla.org. Retrieved 2011-12-10.
- WebSockets - upgrade to ietf-07>
- "Chromium bug 64470". Code.google.com. 2010-11-25. Retrieved 2011-12-10.
- "WebSockets in Windows Consumer Preview". IE Engineering Team. 2012-03-19. Retrieved 2012-07-23.
- "WebKit Changeset 97247: WebSocket: Update WebSocket protocol to hybi-17". Trac.webkit.org. Retrieved 2011-12-10.
- "A hot Opera 12.50 summer-time snapshot". Opera Developer News. Retrieved 2012-08-03.
- "WebSockets - MDN". Developer.mozilla.org. 2011-09-30. Retrieved 2011-12-10.
- "List of Chromium Command Line Switches". Peter.sh. Retrieved 2011-12-10.
- Wang, Vanessa; Salim, Frank; Moskovits, Peter (February 2013). "APPENDIX A: WebSocket Frame Inspection with Google Chrome Developer Tools". The Definitive Guide to HTML5 WebSocket. Apress. ISBN 978-1-4302-4740-1. Retrieved 07 April 2013.
- IETF Hypertext-Bidirectional (HyBi) working group
- The WebSocket API - W3C Working Draft specification of the API
- The WebSocket API - W3C Candidate Recommendation specification of the API
- Websocket.org - A WebSocket Community