Creating Client Usernames

Client usernames help manage the authentication and permissions of connecting client application on an event broker. Client usernames are specific to a Message VPN. They are used by client applications to authenticate with the event broker. A client username can be used to make multiple client connections to allow applications to horizontally scale without additional configuration on the event broker.

Each client username is associated with a client profile and an ACL profile. These profiles control properties and permissions of the connected client application.

A client is only authorized to connect to a Message VPN that is associated with a client username that client has been assigned.

Client access to the resources and messaging capabilities on an event broker can be provisioned through client usernames. When clients are authenticated, they are provided with the client profile and ACL profile associated with their client username.

The client username must be unique within its Message VPN. A client username :

  • can contain up to 189 printable ASCII characters (that is, characters in the range 0x20 – 0x7e) are permitted - though the question mark (?) and asterisk (*) are not permitted.
  • are case-sensitive

For instructions to create client usernames in PubSub+ Cloud, see Creating and Managing Client Usernames.

To create a client username for an appliance or software event broker, use the following steps after logging into PubSub+ Broker Manager with at least Message VPN scope and read-write access level:

  1. Open Broker Manager. For instructions, see PubSub+ Broker Manager.
  2. Select a Message VPN.
  3. On the left navigation bar, select Access Control.
  4. On the Access Control page, select the Client Usernames tab.
  5. In the top-right corner, click +Client Username.
  6. In the Create Username dialog, enter a name for your client username and then click Create.
  7. On the Edit Client Username Settings page.
    1. Toggle on Enable.
    2. Click Change Password and enter a new password in the New Password and Confirm Password fields.
    3. In the Client Profile list, select the profile to use with the client username.
  8. Click Apply.