|
118
|
1 #summary Simple XMPP-over-websocket support |
|
|
2 #labels Stage-Alpha |
|
|
3 |
|
|
4 = Introduction = |
|
|
5 |
|
312
|
6 [http://http://en.wikipedia.org/wiki/WebSocket WebSockets] is a new protocol for providing web pages with simple two-way communication with a web server. |
|
|
7 |
|
313
|
8 In our case it is interesting to tunnel XMPP over !WebSockets, as an alternative to e.g. BOSH, !WebSockets having less overhead. |
|
118
|
9 |
|
313
|
10 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: |
|
312
|
11 * [https://github.com/sonnyp/lightstring Lightstring] |
|
|
12 * Strophe.js branches: |
|
|
13 * [https://github.com/Gordin/strophejs Gordin's branch] |
|
|
14 * [https://github.com/superfeedr/strophejs/tree/protocol-ed Superfeedr's branch] |
|
118
|
15 |
|
|
16 = Usage = |
|
|
17 |
|
312
|
18 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. |
|
|
19 |
|
|
20 A cross_domain_websocket option is supported. |
|
|
21 Set it to true to enable cross-domain requests from all websites, |
|
|
22 or specify a list like |
|
|
23 {{{ |
|
|
24 cross_domain_websocket = { "http://jabber.org", "http://prosody.im" }; |
|
|
25 }}} |
|
118
|
26 |
|
|
27 = Compatibility = |
|
312
|
28 ||0.9||Works|| |
|
|
29 ||< 0.9||Not supported|| |
