Versions Compared

Key

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

...

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 User in the table.

Image RemovedImage Added

Add User

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

Image Removed

Image AddedThe form contains the following fields:

...

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

Image Removed

Image AddedThe 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

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

...

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 RemovedImage Added

Add Role

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

Image RemovedImage Added

The form contains the following fields:

...

Clicking on an individual Chariot Role in the table will display a form for editing the Chariot Role.

Image RemovedImage Added

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

...

MQTT Credentials are the credentials that clients will use to authenticate when establishing an MQTT connection to the Chariot MQTT Server.  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.


Image RemovedImage Added

Add Credential

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

Image RemovedImage AddedThe form contains the following fields:

...

Clicking on an individual MQTT Credential in the table will display a form for editing the Credential.

Image RemovedImage AddedThe "Update" button in the bottom right can be clicked to update the Credential once all changes have been made.

...

The MQTT Server page contains a form used to configure the MQTT Server.

Image RemovedImage Added

The form contains the following fields:

  • Enable Non-secure
    • Whether to enable non-secure client connections over plain TCP.
  • Non-secure Port
    • The port that the MQTT Server will listen on for non-secure connections.
  • Enable Secure
    • Whether to enable Secure client connections over SSL/TLS.
  • Secure Port
    • The port that the MQTT Server will listen on for secure connections.
  • Enable WebSocket
    • Whether to enable non-secure client connections over WebSockets.
  • WebSocket Port
    • The port that the MQTT Server will listen on for non-secure WebSocket connections.
  • Enable Secure WebSocket
    • Whether to enable secure client connections over WebSockets.
  • Secure WebSocket Port
    • The port that the MQTT Server will listen on for secure WebSocket connections.
  • Allow Anonymous
    • Whether to allow anonymous connections (no username and password).
  • Bind Address
    • The address that the MQTT Server will listen on for MQTT connections.

...

A Chariot License is represented by a text file which contains a license key.  The file can either be dragged/dropped into the "Upload License" form, or the license text can be pasted directly into the form.

Image RemovedImage AddedThe Activate toggle (in the Upload License form) can be used to auto-activate the license immediately after it is uploaded. This is a convenience to prevent the need to click Activate License after uploading a license.

...

Online Activation allows the Chariot MQTT Server to remotely connect to the Chariot Licensing server for activation and deactivation of Chariot Licenses. When the "Online Activation" is selected, the License page appears with the following options:

Image RemovedImage Added

  • Activate License
    • Activates an uploaded Chariot License by remotely accessing the Chariot Licensing Server.
  • Deactivate License
    • Deactivates an uploaded & active Chariot License by remotely accessing the Chariot Licensing Server.

...

Offline Activation requires the user to generate an activation request and provide it to Cirrus Link Solutions in order to obtain an Activation Code.  The Activation Code can then be uploaded into the Chariot MQTT Server to activate the previously uploaded Chariot License.  When the "Offline Activation" option is selected, the License page appears with the following options:

Image RemovedImage Added

  • Generate Activation Code
    • Generates an Activation Request Code.
  • Deactivate and Generate Code
    • Deactivates an active Chariot License and generates a Deactivation Request Code.
  • Upload Activation Code
    • Uploads an Activation Code that was obtained using the Generate Activation Code.

...

The System page uses the following form to configure the system settings:

Image RemovedImage Added

The form contains the following fields:

  • Server Name
    • An optional name for this Chariot installation.
  • Enable HTTP
    • Whether to enable non-secure HTTP connections to the Chariot Web UI.
  • HTTP Port
    • The port that the Chariot MQTT Server will use for HTTP.
  • Enable HTTPS
    • Whether to enable Secure HTTPS connections to the Chariot Web UI.
  • HTTPS Port
    • The port that the Chariot MQTT Server will use for HTTPS.

...

The certificates tab provides the means to upload the necessary certificates and keys for setting up SSL/TLS.

Image RemovedImage Added

The Certificates tab contains the following fields:

...

If successful, the certificate information will now be displayed on the Certificates tab:

Image RemovedImage AddedThe "Delete SSL" button can be used to remove the certificate and key from the Chariot MQTT Server and revert to a "SSL Not Setup" state.

Backup/Restore

This tab allows for the backup and restore of Chariot configuration data.

Image Added

  • Export Backup
    • This button downloads a backup.zip file that contains the current configuration data of the Chariot instance.
  • Restore From Backup
    • This button restore configuration data from backup.zip file.