Jamf Pro Integration - Installation and User Guide - TeamViewer Support
<main>
<article class="userContent">
<p><br></p><h2 data-id="general">General</h2><div class="blockquote"><div class="blockquote-content"><p class="blockquote-line"><em>Please keep in mind that Integrations are not included in basic license packages. They have to be purchased separately as AddOns. For more information, please visit our website: </em><a href="http://www.teamviewer.com/integrations" rel="nofollow noreferrer ugc"><em>http://www.teamviewer.com/integrations</em></a></p></div></div><p>Jamf is an Enterprise Management platform focusing on Apple devices (iOS and macOS). You can find more information at <a href="https://www.jamf.com/" rel="nofollow noreferrer ugc">https://www.jamf.com/</a> . TeamViewer has partnered with Jamf to bring an intuitive combined service that enabled initiating attended remote control sessions directly from the Jamf console.</p><p>The integration is available in the Jamf Pro subscription tier only.</p><p><br></p><h3></h3><h2 data-id="pre-requisites">Pre-requisites</h2><p>In order to be able to use the TeamViewer integration in Jamf, you will need to have a TeamViewer account with an eligible license activated (see top of the article for details). </p><p>You will also need to create a Script token (preferably from the TeamViewer administrator account). To do this follow the steps below.</p><p>1) Login to <a href="https://login.teamviewer.com/LogOn" rel="nofollow noreferrer ugc">https://login.teamviewer.com/LogOn</a></p><p>2) Go to your avatar on the top right corner and select “<strong>Edit Profile</strong>”, as shown below.</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/OAX0PFW1O3DM/edit-profile.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/OAX0PFW1O3DM/edit-profile.png" alt="Edit profile.png" height="388" width="1904" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><p>3) Go to <strong>“Apps”</strong> and select <strong>“Create Script Token”</strong>, as shown below.</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/L7I9R9R47VQ6/create-script-token.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/L7I9R9R47VQ6/create-script-token.png" alt="Create script token.png" height="824" width="1910" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><p>4) From the next screen select the permission scope <strong>Session Management</strong> and enter as parameter <strong>Create sessions, View and edit all sessions</strong> click <strong>Create</strong>.</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/H9YWD9T3UC53/image.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/H9YWD9T3UC53/image.png" alt="image.png" height="809" width="501" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><p>5) <strong>Click </strong>on the created <strong>script</strong>. <strong>Copy the token</strong> from the menu as below</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/ZMW73LHMOEP0/image.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/ZMW73LHMOEP0/image.png" alt="image.png" height="221" width="818" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><h3 data-id="-1"></h3><h2 data-id="activating-the-integration">Activating the integration</h2><p>The TeamViewer integration is readily available on the Jamf platform. No need to download and install any plugin. </p><ul><li>Once you have logged in to Jamf PRO, go to <strong>Management Settings</strong> -> <strong>Global Management</strong> -> <strong>Remote Administration</strong>, and click <strong>“New”</strong> (‘+’ sign on the top right corner). </li><li>You will then be prompted to select the provider. Select TeamViewer as shown in the image below.</li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/5J9UIX1Z6D3R/screenshot2.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/5J9UIX1Z6D3R/screenshot2.png" alt="screenshot2.png" height="1466" width="3000" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><ul><li>Click “Next”</li><li>Add a Configuration name and the Script Token from your TeamViewer account created in the previous chapter. </li><li>The Maximum session time field defines the validity period of the Remote control invitation. This is the period after which the invitation will expire. This doesn’t affect the remote control connection, once it’s setup. The default value is 15 mins but can be set to any value from 1 min to 720 mins (1 day).</li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/YC0SQ2PNT0FQ/screenshot3.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/YC0SQ2PNT0FQ/screenshot3.png" alt="screenshot3.png" height="1462" width="3000" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><ul><li>Click <strong>“Next”</strong> </li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/U51QTFLSAU3V/screenshot4.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/U51QTFLSAU3V/screenshot4.png" alt="screenshot4.png" height="1467" width="3000" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><ul><li>The Script Token will be validated at this point to confirm that it’s a valid token with the required permissions. </li><li>Click <strong>“Complete”</strong>.</li></ul><p>The integration has now been activated.</p><p><br></p><h3 data-id="-2"></h3><h2 data-id="how-to-initiate-a-teamviewer-remote-control-request">How to initiate a TeamViewer remote control request</h2><p>Once you have activated the integration with a licensed TeamViewer account you can initiate remote control requests. </p><p>To remote control a Mac, follow the steps below:</p><p>Step 1: Creating the session</p><ul><li>From the device inventory, select the device you want to control. </li><li>Then go to tab “<strong>Management”</strong> and select <strong>“Remote Management”</strong></li><li>On the right panel enter a description for the issue (optional) and click <strong>“Start Session”</strong></li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/JYI3ULYP36KT/screenshot5.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/JYI3ULYP36KT/screenshot5.png" alt="screenshot5.png" height="1467" width="3000" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><p>Step 2: Getting the notification</p><ul><li>The session will then be automatically created and a notification sent to the <strong>Self Service application</strong> of the target device as a <strong>bookmark</strong>. </li><li>In the screenshots below, you can see the screen that the admin will see after the session has been generated.</li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/UZF0OU4CQHK2/screenshot7.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/UZF0OU4CQHK2/screenshot7.png" alt="screenshot7.png" height="1464" width="3000" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><ul><li>In the screenshot below you can see how the notification is displayed as a bookmark on the target Mac device. </li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/KSWSUTNWN05S/screenshot8.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/KSWSUTNWN05S/screenshot8.png" alt="screenshot8.png" height="900" width="1440" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><p>Step 3 : Starting the session</p><ul><li>The administrator will then need to click on the Administrator link below</li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/Q613ZM1R2SWA/screenshot6b.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/Q613ZM1R2SWA/screenshot6b.png" alt="screenshot6b.png" height="1464" width="3000" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><ul><li>,which will open the locally installed TeamViewer application and join the session. The administrator will be in a ‘virtual lobby’ until the end user accepts the connection.</li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/3POMRKDIS23S/screenshot9.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/3POMRKDIS23S/screenshot9.png" alt="screenshot9.png" height="1625" width="3000" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><ul><li>On the other side, once the end user clicks the connection request in the bookmark, a browser window will open prompting him/her to select whether they want to use a locally installed TeamViewer version or use a one-time downloaded version (no installation needed). By checking the box “Remember the selection”, you won’t have to choose each time.</li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/QOZ9TO6RMCMX/screenshot10.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/QOZ9TO6RMCMX/screenshot10.png" alt="screenshot10.png" height="780" width="1440" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p><br></p><ul><li>The user is then prompted to accept the connection</li></ul><div class="embedExternal embedImage display-large float-none">
<div class="embedExternal-content">
<a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/NDRJQ8JAM00O/image.png" rel="nofollow noreferrer noopener ugc" target="_blank">
<img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/NDRJQ8JAM00O/image.png" alt="image.png" height="466" width="708" loading="lazy" data-display-size="large" data-float="none"></img></a>
</div>
</div>
<p>, and the connection is setup!</p><p><br></p><h3 data-id="-3"></h3><h2 data-id="faq">FAQ</h2><p>❓ Can someone use the same TeamViewer account /license in multiple Remote Management configurations?</p><p>👉 <strong>Yes</strong>, there is no limitation. You can use Script token from the same account or the same Script Token to multiple Jamf Configurations.</p><p>❓ When a session has been created for a device, will that be visible from other administrators that have access to the Jamf PRO portal?</p><p>👉 Yes, once a session has been created, for as long as the session is still valid, it will be visible to all Jamf PRO users who have access to that device.</p><p>❓ In which Jamf subscription is the integration available?</p><p>👉 The TeamViewer integration is only available in the Jamf PRO subscription tier.</p>
</article>
</main>