Data source parameters

hostNameOrIpAddress

Required

string

Host name or IP address of the MQTT server

Allowed value: Any valid WS or TCP/IP endpoint address
Default value: null

port

Optional

integer

Port number of the MQTT server. Required only if Protocol is TCP.

Allowed value: Valid port range or null

Default value (if Protocol is TCP): 8883
Default value (if Protocol is WS): null

protocol

Optional

enum

The protocol used to communicate to the MQTT broker

Allowed value: WS or TCP
Default value: TCP

TLS

Optional

enum

Determines if TLS should be used and what version

Allowed value: None, TLS, TLS11, TLS12, TLS13
Default value: TLS12

userName

Optional

string

User name or client Id for accessing the MQTT server

Allowed value: any string
Default value: null

password

Optional

string

Password or token for accessing the MQTT server

Note: We recommend using REST to configure the data source when the password must be specified because the adapter will encrypt the password when using REST. If you do not use REST, the plain text password is stored on-disk. You cannot specify a Password without specifying a UserName.

Allowed value: Any string
Default value: null

clientId

Optional

string

Unique identification of the adapter component connecting to the MQTT broker.

Note: If the ClientId is null, the adapter generates a GUID.

MQTTVersion

Optional

enum

Version of the MQTT protocol to be used.

Allowed value: 3.1.0, or 3.1.1, or 5.0.0
Default value: 3.1.1

validateServerCertificate

Optional

boolean

Determines if the server certificate gets validated. If the server certificate validation is disabled, a warning is printed.

Note: Setting this parameter to false changes https to http if used in a request.

Default value: true

clientCertificateThumbprint

Optional

string

The thumbprint of the certificate when the MQTT broker requires a client certificate.

Default value: null

clientCertificatePassword

Optional

string

(Protected) - The password to access the certificate when the MQTT broker requires a client certificate.

Default value: null

streamIdPrefix

Optional

string

Specifies what prefix is used for stream Ids. The naming convention is {StreamIdPrefix}{StreamId}. An empty string means no prefix is added to the stream Ids and names. A null value defaults to ComponentId followed by a period.

Example: Mqtt1.{Topic}.{ValueField}

Note: Every time you change the StreamIdPrefix of a configured adapter, for example when you delete and add a data source, you need to restart the adapter for the changes to take place. New streams are created on adapter restart and pre-existing streams are no longer updated.

Allowed value: Any string
Default value: null

defaultStreamIdPattern

Optional

string

Specifies the default stream Id pattern to use. Possible parameters: {Topic}, {ValueField}, {DataType}.

Allowed value: Any string
Default value: {Topic}.{ValueField}

timeZone

Optional

string

Specifies the time zone associated with data received from the configured MQTT broker and its topics.

Allowed value: A valid time zone from the tz database list (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).

Note: The time zones listed in the TZ identifier column of the tz database list are used for configuration in our adapters. Examples include America/New_York, Europe/Paris, Asia/Singapore and Etc/UTC.

Default value: null

Note: Provide this information if you are using source timestamps and the timestamp does not contain time zone information.