view mod_websocket.wiki @ 399:c35cf2a46b78

mod_s2s_auth_fingerprint: Describe cert pinning mode
author Kim Alvefur <zash@zash.se>
date Fri, 16 Aug 2013 00:23:17 +0200
parents 188ff73d261e
children 421d0865f89d
line wrap: on
line source

#summary Simple XMPP-over-websocket support
#labels Stage-Alpha

= Introduction =

[http://en.wikipedia.org/wiki/WebSocket WebSockets] is a new protocol for providing web pages with simple two-way communication with a web server.

In our case it is interesting to tunnel XMPP over !WebSockets, as an alternative to e.g. BOSH, !WebSockets having less overhead.

Note that the XMPP over !WebSocket specification has not been finalized, and is still evolving. There are few XMPP libraries capable of !WebSockets, among them:
  * [https://github.com/sonnyp/lightstring Lightstring]
  * Strophe.js branches:
    * [https://github.com/Gordin/strophejs Gordin's branch]
    * [https://github.com/superfeedr/strophejs/tree/protocol-ed Superfeedr's branch]

= Usage =

Simply add mod_websocket to your modules_enabled list, as you would any other module. The repository includes a demo websocket.html file to show connecting to the socket. It doesn't perform any XMPP.

A cross_domain_websocket option is supported.
Set it to true to enable cross-domain requests from all websites,
or specify a list like
{{{
cross_domain_websocket = { "http://jabber.org", "http://prosody.im" };
}}}

= Compatibility =
||0.9||Works||
||< 0.9||Not supported||