Assigning Edge devices to your TeamViewer account at scale (mass deployment) - TeamViewer Support
<main> <article class="userContent"> <p><br></p><p>The journey of the IoT user starts from assigning his edge device to the cloud and the assignment process should be as simple as possible.</p><p>The assignment of a single device is mostly done for testing purposes or when evaluating the solution. The time spent on the assignment will not have a significant impact. But when dealing with a big project mostly you have a bunch of devices that should be assigned to the account. This procedure will shorten the time spent on the assignment process up to even without touching the device.</p><p>The <strong>TeamViewer IoT Cloud</strong> offers assignments via token functionality which can be used both for single device assignment and for assigning hundreds or thousands of devices securely.</p><p><br></p><h3></h3><h2 data-id="how-it-works">How it works</h2><p>For each <strong>TeamViewer Account</strong>, a unique assignment token is being generated. The <strong>assignment token</strong> can be used only for the device assignment to the account.</p><p>During the assignment process, the device connects to <strong>TeamViewer IoT Cloud</strong> and presents its assignment token. The assignment service receives the token and connects the device to the account to which the token belongs.</p><p>Starting from that moment the edge device continues to work with the assigned account.</p><p><br></p><h3 data-id="-1"></h3><h2 data-id="what-you-will-need">What you will need</h2><p>Make sure that you have prepared the following points:</p><p><strong>📌Note: </strong>When assigning a TeamViewer IoT Starter Kit this procedure will only work with Starter Kit Version 2 (or newer). For more information see the Owners Manual.</p><ul><li>The edge device is set up with a TeamViewer IoT Agent.</li><li>Your login credentials for the edge device (user name, and password).</li><li>Your TeamViewer credentials.</li><li>A tool to access the edge device remotely via ssh (e.g. <a href="https://www.putty.org/" rel="nofollow noreferrer ugc">Putty</a>).</li></ul><p><br></p><h3 data-id="-2"></h3><h2 data-id="assign-the-edge-devices-to-your-teamviewer-account">Assign the Edge devices to your TeamViewer account</h2><p><strong>📌Note: </strong>Assigning the Edge Device will override existing assignments.</p><p>1. To log in to the <strong>IoT Management Console</strong>, open <a href="https://teamviewer-iot.com" rel="nofollow noreferrer ugc">https://teamviewer-iot.com</a> and use your TeamViewer account credentials.</p><p>2. From the <strong>top menu</strong> click <strong>Assignment token</strong>.</p><div class="embedExternal embedImage display-medium float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/1UZX6DLXKPQ6/assignment-token-menu.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/1UZX6DLXKPQ6/assignment-token-menu.png" alt="assignment_token-menu.png" height="228" width="390" loading="lazy" data-display-size="medium" data-float="none"></img></a> </div> </div> <p>3. In the popup click <strong>Reveal</strong> to see the token.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/FE5KB78JKGIE/assignment-token-reveal.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/FE5KB78JKGIE/assignment-token-reveal.png" alt="assignment_token-reveal.png" height="109" width="593" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><strong>📌Note: </strong>Remember the token (TOKEN).</p><ol><li>Log in to the <strong>Edge Device</strong> and use your credentials by using a <strong>ssh-tool</strong>.</li><li>Assign the <strong>Edge Device</strong> to your <strong>TeamViewer Account</strong>. In the terminal type in the following command and press return. Replace <code class="code codeInline" spellcheck="false" tabindex="0">TOKEN </code>with the token from the previous step.</li></ol><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo teamviewer-iot-agent assign -t TOKEN --accept-license </pre><p><strong>📌Note: </strong>For mass deployment of Edge Devices, this command needs to be configured to run once when the device boots.</p><p><br></p><h3 data-id="-3"></h3> </article> </main>
