ScreenConnect
What it Does:
Allows you to remote into an Asset using your ScreenConnect account
What it doesn't Do:
Give +3 to Vision
Table of Contents:
Overview
Configuring ScreenConnect with Policies
Accessing ScreenConnect
Troubleshooting
MAC
To get started, head to Admin > App Center > ScreenConnect App Card and add your ScreenConnect URL, preceded by "https://", like so:
ScreenConnect:
How to get the ScreenConnect URL and Instance ID:
(The Instance ID shown in the ConnectWise portal is NOT the ID needed for this integration. This will be shown in step 7)
- Login into your ScreenConnect account at https://cloud.screenconnect.com/#/account
- If you don't already have an instance created, you'll want to create one first
- With the instance created, copy the Instance URL highlighted here:
- Paste the Instance URL in the 'ScreenConnect URL' field in Syncro
- To get the Instance ID, you’ll need to access one of your endpoints that already has your ScreenConnect Client installed
- From the endpoint, head to the Windows Service manager, and locate the ScreenConnect Client service
- The Instance ID you’ll want to copy is in parenthesis in the service name. Here’s a screenshot highlighting this:
- Paste the Instance ID in the 'ScreenConnect Instance ID’ field in Syncro
- Next, click the Instance URL in ConnectWise Control to launch the Host
- Once you've launched the instance host, you'll be able to build the MSI installer to upload into Syncro
How to get a MSI Installer:
Go to build, and set it for MSI in the ACCESS button on the left hand side of the UI
Once you download the installer, make sure to rename it to exactly "screenconnect.msi" before uploading it to Syncro. Otherwise, with the Instance ID and URL entered and the MSI uploaded, you're all set! Hit Save!
That's it for authentication!
Configuring ScreenConnect with Policies
Now you will want to add the ScreenConnect integration to a Policy. Head to the Policies tab and select the Policy that will have ScreenConnect on it.
With ScreenConnect configured, there will be a new option to "BRING YOUR OWN SCREENCONNECT" to activate. Check the box and hit Save.
Once you activate this option, the system will begin to scan the Assets that have the Policy attached.
-If ScreenConnect is installed on the Asset with a ScreenConnect Instance ID that is different than the one you entered in the Settings step, then the system will install a new instance of ScreenConnect with the instance ID that was used in Syncro and upload the ScreenConnect unique GUID for the Asset.
-If ScreenConnect is not installed, we will install it using the ScreenConnect ID that was used during the Setup stage and upload the ScreenConnect unique GUID for the Asset.
*NOTE*: The sync can vary in time and of course depends if the Asset is online at the time. You will know if the Asset has synced if there is a ScreenConnect GUID in the Asset info.
*NOTE*: There is a ScreenConnect ID column you can turn on in the Device Settings button on the Device page.
Once everything is synced up, you can get to ScreenConnect by clicking the Device Quick Access or in the Device Details Screen using the Remote drop down.
- If you are getting an error stating "One or more errors occurred." from ScreenConenct when you attempt to remote into the device from Syncro, please check that your main "Access" session group in ScreenConnect is named "All Machines" and try again.
- If you use Syncro to remote into a machine, but you access a different computer in your ScreenConnect account, please make sure that you did not use the "End" button in ScreenConnect discussed here: https://docs.connectwise.com/ConnectWise_Control_Documentation/Get_started/Host_page/End_a_session
This will prevent Syncro from accessing the machine further, because ScreenConnect has permanently ended the session, and leaves the service installed on the machine, preventing Syncro from connecting or reinstalling ScreenConnect.
To resolve this issue, you will need to completely uninstall ScreenConnect from the machine, and clear the ScreenConnect GUID value from the asset's custom field so that Syncro can reinstall and repopulate the ScreenConnect GUID. - If ScreenConnect installs on your assets, but the 'ScreenConnect GUID' asset field is blank and there is no option to connect via ScreenConnect, it is likely that the Instance ID that was entered in the ScreenConnect app card is incorrect.
You can quickly find the Instance ID by going to an asset that ScreenConnect was deployed to and looking for ScreenConnect in the 'Installed Apps' tab. The ID will be displayed between the parentheses after 'ScreenConnect Client':
Once you have that ID, head over to 'Admin > App Center > ScreenConnet' and update the Instance ID. As your assets sync with our servers, you should see the ScreenConnect GUID appear on the asset and an option to start a ScreenConnect remote session.
You would need to zip the .pkg file up then upload it to be made available for the RMM to download it. The pkg file will pass to the local device but won't silently install. It will need to be manually run on the local device. You can find the zipped ScreenConnect .pkg file here:
/Applications/SyncroAgent.app/Contents/MacOS/
ScreenConnect managed installation is not officially supported on our Mac at this current time. If this is not working for you, please install ScreenConnect outside of Syncro until further notice.
To show the SceenConnect button on your Mac asset in Syncro, please grab the ScreenConnect GUID from the Mac endpoint, and manually enter it in the field that shows after integration. That should populate the 'remote access > ScreenConnect' option on the mac asset's detail page.
You will need to create a group in ScreenConnect and make sure it is the default.
Grab the Mac GUID here: /opt/connectwisecontrol-xxxxxxxxxxxxxxxx.app/Contents/Resources/ClientLaunchParameters.txt.lproj/locversion.plist. It is at the end of the file and includes the text in front of the & (ampersand).
You can get more information for obtaining the GUID from your Mac here:
https://docs.connectwise.com/ConnectWise_Control_Documentation/Developers/Integration_guide