Constructs an MQTT5 Client configuration object for creating mqtt5 clients.
Overrides the default system trust store.
Buffer containing all trust CAs, in PEM format
Overrides the default system trust store.
Optional
caDirpath: stringOnly used on Unix-style systems where all trust anchors are stored in a directory (e.g. /etc/ssl/certs).
Optional
caFilepath: stringSingle file containing all trust CAs, in PEM format
Overrides the time interval to wait after sending a CONNECT request for a CONNACK to arrive. If one does not arrive, the connection will be shut down.
Optional
connackTimeoutMs: numbertime interval to wait after sending a CONNECT request for a CONNACK to arrive
Overrides all configurable options with respect to the CONNECT packet sent by the client, including the will. These connect properties will be used for every connection attempt made by the client. Custom authentication configuration will override the username and password values in this configuration.
all configurable options with respect to the CONNECT packet sent by the client
Overrides the maximum amount of time to wait to reconnect after a disconnect. Exponential backoff is performed with controllable jitter after each connection failure.
Optional
maxReconnectDelayMs: numbermaximum amount of time to wait to reconnect after a disconnect.
Overrides the amount of time that must elapse with an established connection before the reconnect delay is reset to the minimum. This helps alleviate bandwidth-waste in fast reconnect cycles due to permission failures on operations.
Optional
minConnectedTimeToResetReconnectDelayMs: numberthe amount of time that must elapse with an established connection before the reconnect delay is reset to the minimum
Overrides the minimum amount of time to wait to reconnect after a disconnect. Exponential backoff is performed with controllable jitter after each connection failure.
Optional
minReconnectDelayMs: numberminimum amount of time to wait to reconnect after a disconnect.
Overrides the IoT endpoint port to connect to.
The IoT endpoint port to connect to. Usually 8883 for MQTT, or 443 for websockets
Overrides how the reconnect delay is modified in order to smooth out the distribution of reconnection attempt timepoints for a large set of reconnecting clients.
controls how the reconnect delay is modified in order to smooth out the distribution of econnection attempt timepoints for a large set of reconnecting clients.
Overrides how the MQTT5 client should behave with respect to MQTT sessions.
how the MQTT5 client should behave with respect to MQTT sessions.
Overrides how the MQTT5 client should behave with respect to topic aliasing
how the MQTT5 client should behave with respect to topic aliasing
Static
newCreate a new MQTT5 client builder that will create MQTT5 clients that connect to AWS IoT Core via TLS, authenticating via a custom authenticator.
AWS IoT endpoint to connect to
AWS IoT custom auth configuration
Static
newCreate a new MQTT5 client builder that will create MQTT5 clients that connect to AWS IoT Core via mutual TLS using in-memory X509 certificate and key.
AWS IoT endpoint to connect to
Certificate, in PEM format
Private key, in PEM format
Static
newCreate a new MQTT5 client builder that will create MQTT5 clients that connect to AWS IoT Core via mutual TLS using X509 certificate and key at the supplied file paths.
AWS IoT endpoint to connect to
Path to certificate, in PEM format
Path to private key, in PEM format
Static
newCreate a new MQTT5 client builder that will create MQTT5 clients that connect to AWS IoT Core via mutual TLS using a PKCS11 library for certificate and private key operations.
NOTE: This configuration only works on Unix devices.
AWS IoT endpoint to connect to
PKCS#11 options.
Static
newCreate a new MQTT5 client builder that will create MQTT5 clients that connect to AWS IoT Core via mutual TLS using a PKCS12 file.
Note: This configuration only works on MacOS devices.
AWS IoT endpoint to connect to
The PKCS#12 options to use in the builder.
Static
newCreate a new MQTT5 client builder that will create MQTT5 clients that connect to AWS IoT Core via mutual TLS using a certificate entry in a Windows certificate store.
NOTE: This configuration only works on Windows devices.
AWS IoT endpoint to connect to
Path to certificate in a Windows certificate store.
The path must use backslashes and end with the certificate's thumbprint.
Example: CurrentUser\MY\A11F8A9B5DF5B98BA3508FBCA575D09570E0D2C6
Static
newCreate a new MQTT5 client builder that will create MQTT5 clients that connect to AWS IoT Core via websockets, authenticating via a custom authenticator.
AWS IoT endpoint to connect to
AWS IoT custom auth configuration
Static
newCreate a new MQTT5 client builder that will create MQTT5 clients that connect to AWS IoT Core via websockets, using AWS Sigv4 signing to establish authenticate.
AWS IoT endpoint to connect to
Optional
options: WebsocketSigv4Configadditional sigv4-oriented options to use
Overrides the time interval to wait for an ack after sending a QoS 1+ PUBLISH, SUBSCRIBE, or UNSUBSCRIBE before failing the operation. Defaults to no timeout.
Optional
ackTimeoutSeconds: numberthe time interval to wait for an ack after sending a QoS 1+ PUBLISH, SUBSCRIBE, or UNSUBSCRIBE before failing the operation
Overrides additional controls for client behavior with respect to operation validation and flow control; these checks go beyond the base MQTT5 spec to respect limits of specific MQTT brokers.
additional controls for client behavior with respect to operation validation and flow control
Overrides (tunneling) HTTP proxy usage when establishing MQTT connections.
HTTP proxy options to use when establishing MQTT connections
Overrides how disconnects affect the queued and in-progress operations tracked by the client. Also controls how new operations are handled while the client is not connected. In particular, if the client is not connected, then any operation that would be failed on disconnect (according to these rules) will also be rejected.
how disconnects affect the queued and in-progress operations tracked by the client
Overrides the time interval to wait after sending a PINGREQ for a PINGRESP to arrive. If one does not arrive, the client will close the current connection.
Optional
pingTimeoutMs: numbertime interval to wait after sending a PINGREQ for a PINGRESP to arrive
Overrides the socket properties of the underlying MQTT connections made by the client. Leave undefined to use defaults (no TCP keep alive, 10 second socket timeout).
socket properties of the underlying MQTT connections made by the client
Generated using TypeDoc
Builder pattern class to create an Mqtt5ClientConfig which can then be used to create an Mqtt5Client, configured for use with AWS IoT.
MQTT5 Client User Guide