Documentation > Programming Guide > Subscriber Black and Whitelisting

Subscriber Black- and Whitelisting

Subscriber Black-/Whitelisting is a feature from the WAMP Advanced Profile. The specification can be found here.

There is a complete white- and black- listing example with Python and JavaScript clients available.

As per default, whenever there is a publication to a topic, a PubSub event is dispatched to all (authorized) subscribers to that topic other than the publisher itself. Subscriber Black- and White- listing restricts the set of subscribers who receive events for a particular publication.

There are three ways to do blacklisting: exclude (using a list of session IDs to exclude), exclude_authid (using a list of authentication IDs to exclude) and exclude_authrole (using a list of authentication roles to exclude); and three corresponding ways to do whitelisting: eligible, eligible_authid, and eligible_authrole.

Use Cases

For a frontend with state synchronized across devices, a device on which an update is made may communicate this via an RPC to the backend. The local change may be effected as soon as the user input is made, with a possible rollback should the RPC fail. The other devices receive the update based on a successfully processed user input from the backend. In this case the backend will want to exclude the source device for the user input from the update.

Subscriber Blacklisting

If you have a list of sessions to exclude from a publication, you should pass a list of session-id's to exclude; if any of those sessions are subscribers, they will not receive this publish.

You can also exclude sessions with exclude_authid or exclude_authrole. These options take a string or list of strings representing sessions to remove from the receivers. Thus any subscribers with the corresponding authid (or authrole) will not receive this publish.


Subscriber Whitelisting

Whitelisting is the inverse of blacklisting: you specify the set of subscribers who may receive the publish instead of saying who may not.

If you have a list of sessions who could receive a publication, you should pass a list of session-id's to the eligible option; only these sessions will possibly be able to receive the publish. This is a filtering operation, so they won't all necessarily receive the publish -- they still need to subscribe, for example.

You can also filter by eligible_authid or eligible_authrole. These options both take either a single string or a list of strings representing an assigned authid or authrole and work similarly. Of all the subscribers, only those without the correct authid (or authrole) will get the publish.


Getting Session IDs

Subscriber Session IDs, which are used in Subscriber Black- and Whitelisting, can be communicated to application components via application-level messages. Components should be able to retrieve their WAMP Session ID - e.g. in Autobahn|JS, it's stored in

Additionally, has Subscription Meta-Events and Procedures which allow the retrieval of this information from the router.

Further, has Publisher Identification and Caller Identification.