Support AMQP 1.0 Connections over WebSockets

[Luka-He]

Is your feature request related to a problem? Please describe.

Currently, the RabbitMQ AMQP 1.0 .NET Client only supports TCP-based connections. This limits usage in environments where raw TCP connections are restricted, but WebSockets are allowed (e.g., browsers using
frameworks like Blazor WebAssembly, corporate networks, certain cloud/PaaS platforms).

Describe the solution you'd like

Add support for AMQP 1.0 connections over WebSockets (ws:// / wss://) in the RabbitMQ AMQP 1.0 .NET Client.

The underlying library, AMQP.Net Lite, already supports WebSocket transports according to their GitHub README. Exposing or enabling this capability in the RabbitMQ client would allow users to leverage WebSockets without forking or re-implementing transport logic.

Describe alternatives you've considered

• Using AMQP.Net Lite directly instead of the RabbitMQ client (losing RabbitMQ-specific integrations).
• Using a different protocol entirely like MQTT over WebSocket.
• Forking the RabbitMQ AMQP 1.0 .NET Client to enable WebSocket transport directly.

None of these options are ideal for long-term maintenance or ecosystem consistency.

Additional context

Questions for maintainers:

• Is WebSocket transport intentionally unsupported?
• If not: Would a contribution adding this feature be welcome?
• And are there known architectural or security concerns with exposing this transport?

[ansd]

@Luka-He thanks for opening this issue.

Is WebSocket transport intentionally unsupported?

No, we plan to support it eventually. It's already supported in the RabbitMQ AMQP 1.0 Java client.

And are there known architectural or security concerns with exposing this transport?

No.

How are you planning to use AMQP 1.0 over WebSocket to RabbitMQ? VMware Tanzu RabbitMQ (the commercial RabbitMQ version) contains a plugin supporting AMQP 1.0 over WebSocket. Are you a VMware Tanzu RabbitMQ user?
See also https://www.rabbitmq.com/blog/2025/04/16/amqp-websocket

[Luka-He]

@ansd thank you for responding so quickly.

Are you a VMware Tanzu RabbitMQ user?

No, I currently do not have access to Tanzu RabbitMQ, but this enhancement would also make it possible to access the non-commercial version using a WebSocket TCP Relay like the one made by CloudAMQP.

This setup is what I am currently using to test a fork of this client where I have already implemented some support for communication over WebSockets (see https://github.com/Luka-He/rabbitmq-amqp-dotnet-client/tree/AMQP-over-WebSockets).
Connecting to RabbitMQ, sending and receiving messages seems to just work as expected.

I plan on creating a pull request when I have finished testing (and have finished adding some new ones to test the new connection method) and created some documentation on connecting using a WebSocket URI.

[ansd]

Thanks for clarifying, so you are using a relay as described in https://www.rabbitmq.com/blog/2025/04/16/amqp-websocket#websocket-relay

Thank you, a contribution for this feature would be welcome.

[Luka-He]

I created a pull request (#141) with my suggested changes. However, I need help testing the official WebSocket plugin for VMware Tanzu RabbitMQ (because I don't have access to that version) and writing unit tests for this case.

@ansd Is this something you could help me with, or provide instructions for?

The PR is still quite bare-bones, if there’s anything else I can add or do to help, please let me know.