You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by ro...@apache.org on 2016/09/30 11:37:07 UTC
[4/4] qpid-jms git commit: QPIDJMS-210 Add documentation for the
WebSocket transport (cherry picked from commit
f19b01cb45ac1c01a5c34ffa7e7ec0a137700b5a)
QPIDJMS-210 Add documentation for the WebSocket transport
(cherry picked from commit f19b01cb45ac1c01a5c34ffa7e7ec0a137700b5a)
Project: http://git-wip-us.apache.org/repos/asf/qpid-jms/repo
Commit: http://git-wip-us.apache.org/repos/asf/qpid-jms/commit/469bf470
Tree: http://git-wip-us.apache.org/repos/asf/qpid-jms/tree/469bf470
Diff: http://git-wip-us.apache.org/repos/asf/qpid-jms/diff/469bf470
Branch: refs/heads/0.11.x
Commit: 469bf4708209c17092340759be08891b98cfc7f5
Parents: c730c53
Author: Timothy Bish <ta...@gmail.com>
Authored: Tue Sep 27 12:58:13 2016 -0400
Committer: Robert Gemmell <ro...@apache.org>
Committed: Fri Sep 30 12:26:23 2016 +0100
----------------------------------------------------------------------
qpid-jms-docs/Configuration.md | 15 ++++++++++++++-
1 file changed, 14 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/qpid-jms/blob/469bf470/qpid-jms-docs/Configuration.md
----------------------------------------------------------------------
diff --git a/qpid-jms-docs/Configuration.md b/qpid-jms-docs/Configuration.md
index d9c05bf..40f9fb7 100644
--- a/qpid-jms-docs/Configuration.md
+++ b/qpid-jms-docs/Configuration.md
@@ -67,7 +67,11 @@ The basic format of the clients Connection URI is as follows:
amqp[s]://hostname:port[?option=value[&option2=value...]]
-Where the *amqps* scheme is specified to use SSL/TLS, the hostname segment from the URI can be used by the JVM for the
+or for WebSocket connections
+
+ amqpws[s]://hostname:port[/path][?option=value[&option2=value...]]
+
+Where the *amqps* and *amqpwss* scheme is specified to use SSL/TLS, the hostname segment from the URI can be used by the JVM for the
TLS SNI (Server Name Indication) extension in order to communicate the desired server hostname during a TLS handshake.
The SNI extension will be automatically included if a Fully Qualified name (e.g myhost.mydomain) is specified, but not
when an unqualified name (e.g myhost) or bare IP address are used.
@@ -173,6 +177,15 @@ The complete set of SSL Transport options is listed below:
+ **transport.verifyHost** Whether to verify that the hostname being connected to matches with the provided server certificate. Defaults to true.
+ **transport.keyAlias** The alias to use when selecting a keypair from the keystore if required to send a client certificate to the server. No default.
+### Websocket Transport Configuration options
+
+The WebSocket (WS) Transport extends the TCP and SSL Transports to provide both unsecured and secured Websocket connectivity and is enabled using the *amqpws* amd *amqpwss* URI schemes. The unsecured WS Transport extends the basic TCP transport which means all the normal TCP Transport configuration options also apply to the WS Transport, similarly the WSS Transport extends the SSL Transport which means both the TCP and SSL Transport options are available for configuration.
+
+A simple SSL/TLS based client URI is shown below:
+
+ amqpws[s]://myhost.mydomain:5671/[optional-path]
+
+
### AMQP Configuration options
These options apply to the behaviour of certain AMQP functionality.
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org