Learn how to set up Remote Clients to integrate your IoT Network - TeamViewer Support
<main> <article class="userContent"> <p><em>This article applies to TeamViewer IoT users who want to monitor their IoT networks.</em></p><p><em>The solution presented in this article requires TeamViewer IoT Agent v 1.1.102 (or higher). To identify the version of your agent, run: </em><strong><em>sudo teamviewer-iot-agent info </em></strong><em>(an error, or no result, indicates an older version of the agent is installed).</em></p><p><em>It is recommended to review the </em><a href="https://community.teamviewer.com/English/home/leaving?target=https%3A%2F%2Fdocs.teamviewer-iot.com%2Fmqtt-api%2F%231-introduction" rel="nofollow noreferrer ugc"><em>TeamViewer MQTT API documentation</em></a><em> prior to proceeding with this article.</em></p><h4 data-id="overview">Overview</h4><p>The TeamViewer IoT Agent acts as a centralized hub bringing the TeamViewer IoT solution to your IoT network. In order to securely integrate your IoT devices and sensors, you must create trusted Clients (Reference <a href="https://community.teamviewer.com/English/home/leaving?target=https%3A%2F%2Fdocs.teamviewer-iot.com%2Fmqtt-api%2F%231-introduction" rel="nofollow noreferrer ugc"><em>TeamViewer MQTT API documentation</em></a><em> for details) </em>which can communicate with the TeamViewer IoT Agent.</p><p>Remote Clients allows you to extend your clients to trusted remote devices rather than being limited to the localhost (the device hosting the agent). The following quick-guide will illustrate how to enable Remote Clients and how to use the TeamViewer MQTT API to remotely create Clients and send your sensor data for monitoring & visualization.</p><h4 data-id="getting-started-with-remote-clients">Getting Started with Remote Clients</h4><p><strong>Caution</strong>: Enabling Remote Clients will allow any device on your local area network to initiate Client certificate generation. It is strongly encouraged to Disable Remote Client Provisioning & Remote Client Data connections when not in use.</p><p> </p><p>By default, TeamViewer IoT Agent only allows localhost connections; to enable remote connection:</p><ol><li>Enable remote connections to allow non-localhost devices to create Clients.</li></ol><ul><li><em>teamviewer-iot-agent enable remote-client-provision</em></li><li>From your remote device, create a Client by generating a trusted certificate</li><li>Reference: <a href="https://community.teamviewer.com/English/home/leaving?target=https%3A%2F%2Fdocs.teamviewer-iot.com%2Fmqtt-api%2F%231-introduction" rel="nofollow noreferrer ugc"><em>TeamViewer MQTT API documentation</em></a></li><li>Note: Replace <strong><em>localhost </em></strong>with the <strong><em>hostname</em></strong> of the device running the TeamViewer IoT Agent in the <em>publish/subscribe </em>examples</li><li>Note: You will need to copy the Trusted CA Cert <em>TeamViewerAuthority.crt, </em>referenced in the publish/subscribe examples, to the remote device</li><li>Once your Client(s) has been created, disable the remote Client provisioning access to prevent unauthorized access from other hosts on the network. Disabling remote Client provisioning only allows certificate based secure access from remote hosts.</li><li><em>teamviewer-iot-agent disable remote-client-provision </em></li><li>Enable remote data for Clients to securely connect to the TeamViewer IoT Agent to send data</li><li><em>teamviewer-iot-agent enable remote-data</em></li><li>From your remote device, securely register metrics and push data to the TeamViewer IoT Agent</li><li>Reference: <a href="https://community.teamviewer.com/English/home/leaving?target=https%3A%2F%2Fdocs.teamviewer-iot.com%2Fmqtt-api%2F%231-introduction" rel="nofollow noreferrer ugc"><em>TeamViewer MQTT API documentation</em></a></li><li>Note: Replace <strong><em>localhost </em></strong>with the <strong><em>hostname</em></strong> of the device running the TeamViewer IoT Agent in the <em>publish/subscribe </em>examples</li><li>To provision additional remote clients enable the remote Client provisioning</li><li><em>teamviewer-iot-agent enable remote-client-provision</em></li><li>Note: For security purposes, disable the remote Client provisioning when no longer needed</li><li>For security purposes, when remote connections are no longer needed for Clients to send data, disable remote data</li><li><em>teamviewer-iot-agent disable remote-data</em></li><li>For security purposes, when remote connections are no longer needed for client provisioning or sending data, disable ALL remote connections</li><li><em>teamviewer-iot-agent disable remote-clients</em></li></ul> </article> </main>
