How to use the older WebSocket draft 00 hybi 00 hixie 76 protocol - Atmosphere/atmosphere GitHub Wiki

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.

--

⚠️ **GitHub.com Fallback** ⚠️