Set up secure clients, sensors and metrics - TeamViewer Support
<main>
<article class="userContent">
<p><br></p><h2 data-id="what-you-will-need">What you will need</h2><p>Make sure that you have prepared the following points:</p><ul><li>Your TeamViewer credentials.</li><li>The edge device is set up with a TeamViewer IoT Agent and <a href="https://community.teamviewer.com/English/kb/articles/109820-enable-the-edge-management" rel="nofollow noreferrer ugc">TeamViewer Edge Management is enabled</a>.</li><li>The edge device is connected to the internet.</li></ul><p>This application provides a GUI wizard for you to create secure clients and define sensors and metrics, as defined by the TeamViewer IoT <a href="https://community.teamviewer.com/English/kb/articles/109884-teamviewer-iot-agent-mqtt-api" rel="nofollow noreferrer ugc">MQTT API</a>. You will need to then push your sensor data as specified in the <a href="https://docs.teamviewer-iot.com/mqtt-api/?&_ga=2.122809736.2061074140.1679400704-933174053.1679400704#1-introduction" rel="nofollow noreferrer ugc">MQTT API Push Metric Values</a> section to visualize it in real-time.</p><p>Using the wizard, you can create new Clients or authorize existing ones.</p><p><br></p><h3></h3><h2 data-id="create-new-clients">Create new clients</h2><p>You can create new clients either automatically or by using an existing Certificate Signing Request (CSR). To create clients using a CSR, you must upload the CSR & the associated private key.</p><p>Once a secure client has been created, you can download its credentials for use on edge devices (to easily integrate sensors on edge devices to your TeamViewer IoT Agent).</p><p>For more information see <a href="https://community.teamviewer.com/English/kb/articles/109807-set-up-remote-client-to-integrate-your-iot-network" rel="nofollow noreferrer ugc">Remote Clients</a>.</p><p>Once a secure client has been created, you can use the wizard to define the sensors and metrics you want to connect. The wizard will provide you with the details and a template to push the sensor’s data as described in <a href="https://download.teamviewer-iot.com/docs/agentapi/index.html?&_ga=2.118710922.2061074140.1679400704-933174053.1679400704#api-Metric-Sensor_Send_sensor_data" rel="nofollow noreferrer ugc">MQTT API Push Metric Values</a>.</p><p><br></p><h3 data-id="-1"></h3><h2 data-id="authorize-existing-clients">Authorize existing clients</h2><p>Any existing client will automatically appear on your <strong>clients page</strong> of the <a href="https://community.teamviewer.com/English/kb/articles/109817-iot-management-console" rel="nofollow noreferrer ugc">IoT Management Console</a>. However, you must upload its Certificate credentials using the <strong>clients<em> </em>page</strong>, to view it in real-time.</p><p><br></p><h3 data-id="-2"></h3><h2 data-id="view-data-in-real-time">View data in real-time</h2><p>Using the <strong>Metrics<em> </em>page</strong> of the <a href="https://community.teamviewer.com/English/kb/articles/109817-iot-management-console" rel="nofollow noreferrer ugc">IoT Management Console</a>, you can view a list of all your sensor metrics and quickly view each in real-time by clicking on the metric name.</p><p>📌<strong>Note:</strong> All client/sensor/metric metadata shown in the application is the same as displayed in the TeamViewer IoT Cloud Dashboard.</p><p><br></p><h3 data-id="-3"></h3><h2 data-id="manage-certificates">Manage certificates</h2><p>All client certificates, created by the application or uploaded by the user, are stored under:</p><p><code class="code codeInline" spellcheck="false" tabindex="0">/var/lib/docker/volumes/teamviewer-iot-edge-device-management-cert/_data</code></p><pre class="code codeBlock" spellcheck="false" tabindex="0">Public Key: cert-clientId.pem
Private Key: key-clientId.pem
</pre><p>The certificate file names contain the <code class="code codeInline" spellcheck="false" tabindex="0">client Id</code>, in case the certificates are needed on edge devices.</p><p><strong>⚠CAUTION:</strong> Do not rename, delete, or modify files under the cert/ directory. Doing so will cause data corruption.</p><p>For more information see <a href="https://community.teamviewer.com/English/kb/articles/109807-set-up-remote-client-to-integrate-your-iot-network" rel="nofollow noreferrer ugc">Remote Clients</a>.</p><p><br></p><h3 data-id="-4"></h3>
</article>
</main>