MQTT Distributor provides a configuration section to the Ignition Gateway and this can been seen in the left side bar of the Ignition Gateway web UI.

The configuration options for each of the tabs - General and Users - are detailed below.

General

These are the global MQTT Server configuration parameters.  The configuration sections available are Status, Non-TLS Settings, TLS Settings and Advanced.

General - Status

• Enable MQTT Distributor
  • This denotes whether or not to enable or disable the MQTT Server functionality of MQTT Distributor

General - Non-TLS Settings

• Enable TCP

  • This denotes whether or not to enable plain TCP connections. This is enabled by default.

• Port
  • This is the standard TCP MQTT Server listening port.  By default it is port 1883 and is the MQTT reserved port with IANA
• Enable Websocket
  • This denotes whether or not to enable plain Websocket connections. This is enabled by default.
    
• Websocket Port
  • This is the standard Websocket listening port for the MQTT Server.  By default this is 8090

General - TLS Settings

• Enable TLS

  • Checkbox to enable TLS.

  • Requires that TLS Certificate has been uploaded in Ignition.

  • TLS 1.2 and TLS 1.3 are supported
• Secure Port
  • This is the TLS enabled MQTT Server listening port if TLS is enabled.  By default it is port 8883 and is a reserved port with IANA
• Enable Secure Websocket
  • Checkbox to enable Secure Websocket connections for MQTT Server
• Secure Websocket Port
  • TLS enabled Websocket port for the MQTT Server.  By default this is port 9443

General - Advanced

• Allow Anonymous MQTT Connections
  • Checkbox to enable anonymous MQTT connections. Not selected by default.
• Custom Properties
  • Do not use unless instructed to by Cirrus Link personnel.

Users

There are two configuration sections Authentication and Access Control available.

Users - Authentication

• Username
  • The username that must be provided in the MQTT Connect packet to MQTT Server. Any client attempting an anonymous connection will be rejected. 
  • By default a user with Username admin is created
• Password
  • The password that must be provided in the MQTT Connect packet to MQTT Server. Any client attempting an anonymous connection will be rejected. 
  • By default the admin user has a Password changeme created

Users - Access Control

• ACLs
  • The comma separated list of Access Control Lists (ACLs) that clients connecting with this username and password are allowed to publish and subscribe on.
  • By default the admin user has an ACL of RW #