Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Chariot MQTT Server Web UI provides multiple configuration pages on the left navigation panel.

Anchor
Accounts Configuration
Accounts Configuration

...

The Accounts page allows for the creating, updating and deleting of Users, and Roles and Sources.

Anchor
AccountsUsers
AccountsUsers
Users

The Users page allows for the creating, updating, and deleting of Chariot Users.  A Chariot User may log into the Chariot Web UI and perform different actions based the the Roles assigned to that User.  The main Chariot Users page shows a table of existing Chariot Users.  Users can be added by clicking the "Add User" button, or they can be edited by clicking on the individual the individual User in the table.Image Removed


Image Added

Add User

Clicking the "Add User" button will display a form for creating a new Chariot User.Image Removed

Image Added

The form contains the following fields:

...

The "Add" button in the bottom right of the form can be clicked to create the User.

Edit User

Clicking on an individual Chariot User in the edit icon on a Chariot User in the table will display a form for editing the Chariot User.Image Removed

The update form contains additional fields that can be used to provide more information about the Chariot User. Additionally, a dropdown list to the right of the Chariot User's username can be clicked to provide options for deleting the user, or changing the Chariot User's password. 

Image Removed

modal form for editing the Chariot User.

Image Added

Image Added


Leaving the password empty will retain the existing users password.The "Update" button in the bottom right can be clicked to update the Chariot User once all changes have been made. 


Anchor
AccountsRoles
AccountsRoles
Roles

The Roles page allows for the creating, updating, and deleting of Chariot Roles.  A Chariot Role is a collection of permissions that authorized viewing, editing, and/or controlling the Chariot MQTT Server. The main Chariot Roles page shows a table of existing Chariot Roles.  Roles can be added by clicking the "Add Role" button, or they can be edited by clicking on the individual Role in the table.Image Removed


Image Added

Add Role

Clicking the "Add Role" button will display a form for creating a new Chariot Role.Image Removed

Image Added

The form contains the following fields:

...

The "Add" button in the bottom right of the form can be clicked to create the Role.

Edit Role

Clicking on an individual on the edit icon on a Chariot Role in the table will display a modal form for editing the Chariot Role.Image Removed

Image Added

Image Added

The "Update" button in the bottom right can be clicked to update the Chariot Role once all changes have been made.

Anchor

...

UserSources

...

UserSources
User Sources

The Chariot Security Service can be configured to add an LDAP Realm to use when authenticating and authorizing access via the Chariot UI. 

Tip

This feature is available in Chariot v2.4.2 and newer

Review the LDAP and Microsoft Active Directory for Chariot UI/REST Users for configuration details

Image RemovedImage Added

Anchor
MQTT

...

Accounts
MQTT

...

Accounts

MQTT

...

Accounts

The MQTT Credentials Accounts page contains two tabs: MQTT Credentials and LDAP

...

MQTT Credentials also contain the access control lists (ACLs) that control which MQTT topics a client can publish and/or subscribe on. Credentials can be added by clicking the "Add Credential" button, or they can be edited by clicking on the individual Credential in the table.

Tip

From Chariot release 2.5.0, to avoid manual configuration, the required ACLs can be generated from the

STATUS

Main Navigation > Sparkplug > Tools menu and will automatically be added to the MQTT

Credentials 

Credentials

 Image Added

Image AddedImage Removed

Add Credential

Clicking the "Add Credential" button will display a form for creating a new MQTT Credential.Image Removed

Image Added

The form contains the following fields:

...

Note

By default, two default MQTT Credentials are created:

Username admin Password changeme

Username anonymous Password changeme 


The "AddSave" button in the bottom right of the form can be clicked to create the Credential.

...

Examples of MQTT Credentials

Image RemovedImage Added

Edit Credential

Clicking on an individual the edit icon on a MQTT Credential in the table will display a modal form for editing the Credential.Image Removed

Image Added

Image Added

The "UpdateSave" button in the bottom right can be clicked to update the Credential once all changes have been made.

...