Document how to support proxying via web sockets

[robbavey]

This plugin supports using a proxy, but setting it up is currently tricky - it requires the proxy to have web socket support and the settings are not intuitive to do so. Until we have proper support for proxying, we should document the steps (and prerequisites) to support proxying. Much of the detail is in #29, but should be added more formally.

Posted the actual thing to be documented to ensure it raises visibility:

Add an environment variable that contains the proxy
export https_proxy="https://my_proxy:8080"

Add the following to the connection String
;TransportType=AmqpWebSockets

(A user followed up to the issue and stated that adding these to jvm.options may be necessary

-Dhttp.proxyHost=my_proxy
-Dhttp.proxyPort=8080
-Dhttps.proxyHost=my_proxy
-Dhttps.proxyPort=8443
-Dhttp.nonProxyHosts="localhost|127.0.0.1"

)

[geekpete]

We should also include a note around the proxy needing to support websockets to work with this method.

[niempy]

Hi, we encountered the same issue and it cost us lot of time to find this solution. When do you think it will be documented? Thanks.

[chauchse]

Dear,

I try to use the not founded in this issue, but it does not work if proxy requires authentication.

I tried to add

-Dhttps.proxyUser=my_proxy_user
-Dhttps.proxyPassword=my_proxy_password

But it does not work, do you have some advices ?
NB : I can see request on proxy logs (but without creds)

Thx

[davidkarlsen]

Maybe swithcing libraries is worthwhile? https://techcommunity.microsoft.com/t5/messaging-on-azure-blog/azure-event-hubs-websockets-and-proxy-support/ba-p/371136