Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

After Sept 30th, 2024 all scripted agent installs will require the -j $user_secret

NOTE: Installs will error out with “invalid token” in the logs if not supplied.

...

ConnectSecure Agent Deployment for Windows using ConnectWise Automate RMMTable of Contents

Table of Contents

Overview

ConnectSecure agents can be rapidly deployed using your ConnectWise Automate RMM by using a combination of EDFs and Scripting. You will need to complete the below steps:

  1. Import the XML script.

  2. Modify LINE 15 in script (TenateID, UserSecret)

  3. Ensure EDF’s are created, and info added per company (CompanyID)

  4. Place cyberagent.exe in LTshare or deployment path

...

Configuration Process

Required Items

  1. ConnectWise Automate (hosted or on-premise versions are supported)

  2. Permission to import a script

  3. Download our XML script from the .zip file below.

  4. Login to your ConnectWise Automate Control Center desktop application

  5. Select System > General > Import > XML Expansion and choose the file download from below.

    NOTE: It is common to have import errors on first import attempt, please attempt the import twice. This is a known issue in Automate.

  6. Modify line 15.

  7. If agent deployment is desired for a client; the companyID must be saved on the client level.

ConnectSecure Automate XML Script Import

  1. Import the XML Automate script into your Automate server.

    View file
    nameConnectSecure-Automate-V4-Installer-Script-091024-UserSecret.xml

  2. Browse to the Labtech Expansion (.xml) file you downloaded from Step 3 above and choose Open.

...

  1. Please replace TenateID-Changeme and UserSecret-Changeme (Line 15), these values can be found in the portal.

    image-20240903-185652.png

    When viewing a customer, and under AGENTS please find the TenateID (3), and UserSecret (4)

...

Modify Line15 for Environment

The script will not function if imported and not modified. You must replace two items in the script

  1. Change LINE 15 (install command)

    image-20240913-145805.png

    Please replace TenateID-Changeme and UserSecret-Changeme, these values can be found in the ConnectSecure portal.

    When viewing a customer (1), and under agents (2) please find the CompanyID(3), and UserSecret (4)

    image-20240903-190720.png

Cybercnsagent.exe Available for Deployment

  1. Before you can use any of the methods described below, you must upload the ‘cybercnsagent.exe' to your LTShare located on your Automate server at the following path: ‘LTShare\Transfer\ConnnectSecure\cybercnsagent.exe’

Info

If you are using hosted Automate (domain.hostedrmm.com) then you will need to setup WebDAV access to upload to your LTShare. ConnectWise Documentation:

https://docs.connectwise.com/ConnectWise_Automate_Documentation/020/010/080

Ensure CompanyID Present

  1. You must setup each Automate client with their CyberCNS CompanyID from your CyberCNS portal. This comes when you use the ‘Probe/Agent’ download button at the Company level.

...

  1. In Automate, double-click on any client and find the Info > ConnectSecure tab to enter the company for ConnectSecure deployment. This is required for EACH company you wish to use the script to deploy agents.

    image-20240903-185025.png

Using the ConnectSecure Automate Deployment Script

Three Deployment Methods

  1. Manual: Computer Level Install

  2. Manual: Client Level Install (all computers at the Client level)

  3. Automated: Search/Group based auto installs by scheduled script

Method 1 and 2 - Manual: Computer Level Install or Manual: Client Level Install

Info

Both manual methods (1 and 2) use the same steps outlined below

...

Select OK the agent should start installation.

Method 3 - Automated: Using Search, EDF, Groups, and Scheduled Script

Configuring Search in Automate

  1. From Automate Control Center desktop application, browse to Automate > Searches > View Searches

...

Search is completed and you can close out any of the ‘Search’ windows.

Configuring EDF in Automate

  1. From Automate choose Browse > Clients

  2. Double tap on the Client you wish to enable ConnectSecure agent deployment (1)

  3. Choose the Info tab (2)

  4. Choose the ConnectSecure tab (3) and use the checkbox options to enable auto deployment (4).

  5. Ensure you select ‘Save Additional Information’ and ‘Save’.

...

Copy these value and ensure they are entered into your EDF field as displayed below and choose Save (3) once you are finished.

...

Configuring Group in Automate

  1. Navigate to Browse > Groups tab > right-click on Groups and select ‘Create Group’

...

Once you save you can proceed to setup the script scheduler using your preferences.

Configuring Scheduled Scripts in Automate

  1. From within the ‘Group’ created above, choose Computers (1) > Scheduled Scripts (2) > choose the ‘ConnectSecure\Connectsecure V4 Agent Installer - PSA Tickets Enabled’ script (3) > set the Daily schedule option (4) > and the target start time (5). Select ‘Add' when complete to complete adding the script to the group.

...