Skip to content

How to use the older WebSocket draft 00 hybi 00 hixie 76 protocol

Sebastian Lövdahl edited this page Aug 21, 2014 · 4 revisions

Before proceeding, please ensure that you understand the security implications of enabling the hybi-00 protocol. Recommended reading: http://www.ietf.org/mail-archive/web/hybi/current/msg04744.html

An older WebSocket Protocol implementation called draft-00, hybi-00 or hixie-76 is used by (at least) the following browsers and versions:

  • Opera 11.00 to 12.02
  • Firefox 4 and 5
  • Safari 5.0.1 and 5.1 (including iOS 4.2 and 5)
  • Chrome 6 to 13

There are security issues with it and it's in some cases disabled by default in the browser. In that case Atmosphere will automatically fall back to other transports.

If you need to support draft-00/hybi-00/hixie-76 you need to use Atmosphere 2.0.5 or newer with Jetty 7 or 8 (Jetty 9 does NOT support older WebSocket protocol drafts) and add the following init-param in web.xml:

 <init-param>
  <param-name>org.atmosphere.websocket.jetty.minVersion</param-name>
  <param-value>-1</param-value>
 </init-param>

If you need the Atmosphere protocol enabled, or if you need CORS support you must also set the following init-param in web.xml (no issues have been found, but it might cause compatibility issues):

 <init-param>
  <param-name>org.atmosphere.cpr.disallowModifyQueryString</param-name>
  <param-value>true</param-value>
 </init-param>

See #1403 for more information about the problem.

Step by Step Tutorials

Concepts & Architecture

15 Minutes Tutorial

Advanced Topics

API

Known WebServer Issues

References

External Documentations

githalytics.com alpha

Clone this wiki locally