websocket Plugin Archive

Below is a list of versions that are available for the websocket plugin. To find other plugins, please review this listing of most recent releases of all plugins.

Plugins extend and enhance the functionality of Openfire. To install plugins, copy the .jar file into the plugins directory of your Openfire installation.

Openfire WebSocket Plugin Readme

Overview

This plugin extends Openfire to support WebSocket. The implementation follows the XMPP WebSocket subprotocol(RFC 7395) specification, which is a standard extension of the WebSocket protocol specification (RFC 6455).

Note that the BOSH (http-bind) capabilities of Openfire must be enabled and correctly configured as a prerequisite before installing this plugin. The WebSocket servlet is installed within the same context as the BOSH component, and will reuse the same HTTP/S port(s) when establishing the WebSocket connection.

Installation

Please note that the functionality provided by this plugin is added to Openfire direclty in version 4.2.0. This plugin is no longer needed in Openfire 4.2.0 or later!

Copy websocket.jar into the plugins directory of your Openfire installation. Theplugin will then be automatically deployed. To upgrade to a new version, copy the newwebsocket.jar file over the existing file.

Upon installation, the WebSocket URI path will be /ws/ on the same server/port as the BOSHconnector. To establish a secure WebSocket, modify the following URL as appropriate:

    wss://your.openfire.host:7443/ws/

Configuration

The WebSocket plugin implements the Stream Management (XEP-0198) "ack" capabilities introduced with Openfire 4.0. This provides assurance for XMPP packet delivery by allowing the peersto agree on the number of stanzas exchanged. Two system properties are available to configure this feature:

stream.management.active
Boolean property to enable/disable stream management (default: true)
stream.management.unsolicitedAckFrequency
Integer property indicating frequency of unsolicited ack's from the server to the client (default: 0)

XEP-0198 allows either party (client or server) to send unsolicited ack/answerstanzas on a periodic basis. This implementation approximates BOSH ack behaviorby sending unsolicited stanzas from the server to the client after aconfigurable number of stanzas have been received from the client.

Setting the system property to "1" would indicate that each client packet should be ack'd by the server when stream management is enabled for a particular stream. To disable unsolicited server acks, use the default value for system property"stream.management.unsolicitedAckFrequency" ("0"). This setting does not affectserver responses to explicit ack requests from the client.

Releases Info File Version Released Openfire Version
Plugin Openfire WebSocket
Provides WebSocket support for Openfire.
ReadMe Changelog Download 1.2.1 Mon Aug 07 00:00:00 UTC 2017 4.1.5 - 4.2.0
Plugin Openfire WebSocket
Provides WebSocket support for Openfire.
ReadMe Changelog Download 1.1.4 Thu Mar 03 00:00:00 UTC 2016 4.1.0 Alpha +
Plugin Openfire WebSocket
Provides WebSocket support for Openfire.
ReadMe Changelog Download 1.1.3 Wed Jan 06 00:00:00 UTC 2016 4.0.0 Alpha +
Plugin Openfire WebSocket
Provides WebSocket support for Openfire.
ReadMe Changelog Download 1.0.0 Tue Jul 28 00:00:00 UTC 2015 3.10.0 +

The plugins below, so-called SNAPSHOTS, are build automatically by the continuous integration system. They represent the latest development, but are untested.

Snapshots Info File Version Built at Openfire Version
No snapshots.