Client Registry for MQTT Clients

The Client Registry process allows you to securely add new MQTT clients to Connectware via self-registration without having to handle passwords manually. This method works with any standard MQTT client and requires minimal configuration because clients generate their own random passwords during registration.

New users created through this process have no permissions by default. Administrators must explicitly assign appropriate permissions after registration is complete.

The username must follow the Connectware username requirements. The password must be at least five characters long.

Registration Process

The MQTT client registration follows this workflow:

Registering MQTT clients in Connectware

1. The Connectware administrator opens the Client Registry view in the Admin UI.
2. An MQTT client attempts to connect using credentials for a non-existent user.

3. Connectware records the connection attempt while rejecting the request.

4. The administrator reviews the pending registration in the Client Registry view.

5. Upon approval, Connectware automatically creates a user with the provided credentials.

6. The administrator assigns appropriate permissions to the newly created user.

7. The client reconnects using the same credentials and successfully establishes a connection to Connectware.

Approving MQTT Client Registration Requests (Admin)

After an MQTT client has attempted to connect to Connectware with new credentials, an administrator must review and approve the registration request through the Admin UI.

The following assumes that your MQTT client has attempted to register with Connectware at least once. This generates a pending registration request.

1. In the navigation panel, click User.

2. In the sidebar, click Client Registry.

3. Click the Unlock button to temporarily unlock the self-registration. The registry will remain open for five minutes and will automatically lock again after this period. You can manually relock the registry by clicking the Lock button.

1. Locate the pending client request in the table.

1. Click the registration request in the list to open the Grant Access dialog.

2. In the Grant Access dialog, inspect the client request details, then click Allow to approve the registration.

1. In the navigation panel, click User and verify that the newly created user appears in the users list.

2. Assign roles or individual permissions to the user. For more information, see Adding Roles to Users.