Creating a Client Username

Client usernames are required to help manage 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 is facilitated through the client username accounts that are provisioned. When clients are authenticated, they are provided with the predefined configurations  (client profiles) that are associated with those client usernames.

The username must be unique among all created client usernames 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. In PubSub+ Broker Manager, on the Message VPN page, select Access Control from the navigation bar.
  2. On the Access Control page, select the Client Usernames tab.
  3. In the top-right corner, click the +Client Username button.
  4. In the Create Username dialog, enter a name for your client username and then click Create.
  5. 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.
  6. Click Apply.

You've now created a client username that can be used by client applications to access messaging services on the event broker.