WebSocket

WebSocket is a web technology providing for bi-directional, full-duplex communications channels over a single TCP connection. The WebSocket API is being standardized by the W3C, and the WebSocket protocol has been standardized by the IETF as RFC 6455.^[1]

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 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-direction) ongoing conversation can take place between a browser and the server. A similar effect has been done in non-standardized ways using stop-gap technologies such as Comet.

In addition, the communications are done over the regular TCP port number 80, which is of benefit for those environments which block non-standard Internet connections using a firewall. WebSocket protocol is currently supported in several browsers including Safari, Firefox and Google Chrome. WebSocket also requires web applications on the server to be able to support it.

Technical overview

Like TCP, WebSocket provides for bi-directional, full-duplex communication. Websocket differs from TCP in that it provides for a stream of messages instead of a stream of bytes. Before the implementation of WebSocket, bi-directional communication was only possible using comet channels; however, a comet is not trivial to implement reliably, and due to the TCP handshake and HTTP header overhead, it may be inefficient for small messages. The WebSocket protocol aims to solve these problems without compromising security assumptions of the web.

Browser support

For web browser support, a secure version of the WebSocket protocol is implemented in Firefox 6 (named MozWebSocket),^[2] Google Chrome 14^[3] and Internet Explorer 10 developer preview.^[4] 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.^[5] Also, the BlackBerry Browser in OS7 supports WebSocket.^[6]

Although there are no known exploits, it was disabled in Firefox 4 and 5,^[7] and has been disabled in Opera 11 until the new version of the protocol is implemented.^[8]

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

Server response:(Server Architecture)

HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: HSmrc0sMlYUkAGmm5OPpG2HaGWk=
Sec-WebSocket-Protocol: chat

The handshake resembles HTTP, but actually isn't. It allows the server to interpret part of the handshake request as HTTP, then switch to WebSocket.

Note that each line ends with the characters \r\n, with a blank line at the end.

The client sends a Sec-WebSocket-Key which is 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 Sec-WebSocket-Accept.

Details of Sec-WebSocket-Key to Sec-WebSocket-Accept :

• x3JJHMbDL1EzLkh9GBhXDw==258EAFA5-E914-47DA-95CA-C5AB0DC85B11 string hashed by SHA-1 gives 1d29ab734b0c9585240069a6e4e3e91b61da1969 hexadecimal value.
• Encoding the SHA-1 hash by Base64 yields HSmrc0sMlYUkAGmm5OPpG2HaGWk=, which is the Sec-WebSocket-Accept value.

Once established, WebSocket data frames can be sent back and forth between the client and the server in full-duplex mode. Text frames can be sent full-duplex, in either direction at the same time. The data is minimally framed. Please see the current spec for framing details.

Proxy traversal

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 harmless 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.^[9]

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.^[10] This data was not forwarded by all intermediates, which could lead to protocol failure. More recent drafts (e.g., hybi-09^[11]) put the key data in a Sec-WebSocket-Key header, solving this problem.

URI scheme

The WebSocket protocol specification defines two new URI schemes, ws: and wss:,^[12] for unencrypted and encrypted connections respectively. Apart from the scheme name, the rest of the URI components are defined to use URI generic syntax.^[13]

Browser support

Chrome 16, Firefox 11 and Internet Explorer 10 are currently the only browsers supporting the latest specification (RFC 6455) of the WebSocket protocol. A detailed protocol test suite report^[14] lists the conformance of those browsers to specific protocol aspects.

Firefox 4^[15] and Opera 11^[16] originally supported the outdated draft-ietf-hybi-thewebsocketprotocol-00 WebSocket, but have since disabled the protocol by default due to security issues. Chrome also plans to disable the WebSocket if actual exploit code appears before the protocol is revised.^[17]

¹ Gecko-based browsers versions 6–10 implement the WebSocket object as "MozWebSocket",^[23] requiring extra code to integrate with existing WebSocket-enabled code.

Experimental extensions

There is also a command-line switch for Google Chrome (--enable-websocket-over-spdy) that enables an early experimental implementation of WebSocket over SPDY.^[24]

See also

• Comparison of WebSocket implementations
• Socket
• XMLHttpRequest
• Push technology
• Comet
• Server-sent events
• BOSH

References

External links

This article's use of external links may not follow Wikipedia's policies or guidelines. Please improve this article by removing excessive or inappropriate external links, and converting useful links where appropriate into footnote references. (December 2011)

• HLL Websocket Server Article linked to live demo and providing downloadable dhtml for running final draft protocols (submitted as standard).
• IETF Hypertext-Bidirectional (HyBi) working group
  • The WebSocket protocol - Internet-Draft published by the IETF HyBi Working Group
  • The WebSocket protocol - Original protocol proposal by Ian Hickson
• The WebSocket API - W3C draft specification of the API
• WebSocket.org - a commercially sponsored website dedicated to WebSocket
• WebSocketsTest.com - a website to test WebSockets support and operation in your browser.
• HTML5 Server-Push Technologies, Part 2 - explains WebSocket
• Websockets in HTML5 - Easy to understand read on WebSocket
• HTML5 WebSockets: An example with jetty and chrome - A complete example on WebSocket with jetty.
• Web Socket API in BlackBerry Browser with OS7