Device Cloud Connectivity

Applications on the device communicate with Device Cloud using the TR-50 protocol over Message Queue Telemetry Transport (MQTT) secured with TLS 1.2.

MQTT is automatically configured for QOS (quality of service) 1; therefore, messages from client applications on the device are queued for retransmission if the connection between the application and Device Cloud is lost.

Transport Protocol Support

Connectivity between applications on the device and Device Cloud is supported over the following:

  • MQTT on port 1883

  • Message Queue Telemetry Transport Secure (MQTTS) on port 8883

  • WebSocket Secure (WSS) on port 443 (supported only by the Python agent on Linux and Mac OS X)

You specify the port to use when you configure the applications on the device. Ensure that you open the required outbound port on your firewall.

Proxy Server Support

Client applications on the device can connect to Device Cloud through a proxy server using SOCKS4, SOCKS5, and HTTP protocols. You configure the proxy settings when you configure the applications on the device.

Authentication

Client applications on the device initiate the connection with Device Cloud and send an application token and a unique identifier, which is referred to as a thing key.

Applications that use the REST APIs authenticate with a token obtained through the Auth REST API.