Versions Compared

Key

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

The agent installation parameters have changed.

Previously installed agents will have no impact to this modification, only new agents installed after Monday, September 30, 2024.

Please note this and change your RMM scripts and any other automated command line installations to support the agent parameter changes.

The current installation method (without the -j $user_secret) will be supported until September 6th, 2024; any installations after this date that are not using the new -j $user_secret will error out for invalid token.

  • The user secret is automatically generated by ConnectSecure

  • The user secret is generated for ConnectSecure users only

  • The user secret is generated per ConnectSecure user and can be used across all company tenants and RMM installers; you do not need a unique $user_secret for each RMM installer

  • The user secret does not expire unless explicitly reset in Global Settings

The agent download screen will automatically create and assign the $user_secret as shown here:

image-20240829-144545.png

The updated script that includes $user_secret is highlighted in bold below:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; 

$source = (Invoke-RestMethod -Method "Get" -URI "https://configuration.myconnectsecure.com/api/v4/configuration/agentlink?ostype=windows");

$destination = 'cybercnsagent.exe';

Invoke-WebRequest -Uri $source -OutFile $destination;

./cybercnsagent.exe -c $company_id -e $tenant_id -j $user_secret -i;


Please send email to support@connectsecure.com if you have any questions or concerns on this.

...

Table of Contents

...

Overview

This document will cover installing the ConnectSecure Vulnerability Scan Agent for V4 using different methods.

...

Instructions

Info

Please review the https://cybercns.atlassian.net/wiki/x/nYA_fif you require policies for agent dependencies.

...

  1. Select the desired operating system: Windows, Mac, Linux, or ARM.

...

Windows

Web Installer (Download)

Tap this option to download the ‘cybercns_webinstaller,’ which comes as a Windows Application (*.exe) and should use the ‘Run as Administrator’ option when installing.

...

🏁 Installation using Web Installer is completed.

...

Command Line (Download)

Tap on the download option to use the command prompt installation method.

...

Run the following command:

cybercnsagent.exe -c <CompanyID> -e <TenantID> -i

Panel
bgColor#DEEBFF

^ Replace the <CompanyID> and <TenantID> from the values found in the agent installation window.

...

🏁 Installation using Command Prompt is completed.

...

PowerShell (Copy to Clipboard)

(preferred installation method)

...

🏁 Installation using PowerShell (Copy to Clipboard) is completed.

...

MSI via GPO

Refer to our KB here: How To: Install ConnectSecure Agent MSI via GPO

...

Mac

Terminal (Copy to Clipboard)

  1. Select the Mac option, then use the Copy to Clipboard button.

...

🏁 MAC Agent Install Completed

...

Installer PKG

  1. Select the Mac option, then tap the Download button.

...

🏁 MAC PKG Agent Install Completed

...

Linux

Terminal (Copy to Clipboard)

  1. Select the Linux option then use the Copy to Clipboard button.

...

🏁 Linux Agent Install Completed

...

ARM

Terminal (Copy to Clipboard)

IN PROGRESS

...

RMM or Script Install

NOTE: If you are planning to deploy ConnectSecure V4 Agent through your RMM or similar scripting engine(s), please use the following URL, which has no expiration:

...

  1. For Windows -> windows

  2. For Linux -> linux

  3. For MAC -> darwin

  4. For ARM / Raspberry Pi.  -> arm

...

Need Support?

Do you need help? You can access our support portal to create, view, and update tickets anytime.

https://cybercns.freshdesk.com

Click below to be directed to our secure support portal or email support@cybercns.com to open a ticket.

...