...
| Table of Contents |
|---|
...
Overview
This document will cover installing the ConnectSecure Vulnerability Scan Agent for V4 using different methods.
...
Prerequisites
Access to your ConnectSecure V4 Portal
The company needs to be created in the ConnectSecure portal
For Windows installation: Administrator-level access to PowerShell
Port 4222 outbound communication open
For Darwin/macOS installation: Sudo SU level access to Terminal
Instructions
| Info |
|---|
Please review the https://cybercns.atlassian.net/wiki/x/nYA_fif you require policies for agent dependencies. |
You must be at the Company company level to see the installer options; it they will not display at the Global levelglobally.
Tap on Overview > Agents
...
Tap on the ‘Download Agent' button.
| Info |
|---|
It does not matter if you are under the Probe Agents or LightWeight Agents section; both agent installers are the same. ALL newly installed agents will report as a LightWeight and then can be converted to a Probe Agent by mapping Discovery Settings and Credentials. |
...
> Download Agent icon.
...
| Info |
|---|
The agent ALWAYS installs as a Lightweight by default. You must use the Discovery Settings to convert the Lightweight to a Probe. |
Select the desired operating system: Windows, Mac, Linux, or ARM.
...
...
Windows
Web Installer
...
(Download)
Tap this option to download the ‘cybercns_webinstaller’webinstaller,’ which comes as a Windows Application (*.exe) and should use the ‘Run as Administrator’ option when installing.
...
The system will prompt you to save the application (.exe) to your desired location; choose and click save.
Browse to the location of the download. It’s called ‘cybercns_webinstaller_ID’.
Run the application as administrator to install the agent.
...
The command prompt will appear temporarily and display the installation progress.
...
Download = Tap this option to download the ‘cybercnsagent.exe’ file directly; use the Command Prompt as Administrator to install; requires additional switches for Company ID and Tenant ID. Navigate to the location where you downloaded the .exe
Copy to Clipboard (preferred installation method) - Tap this option, and the prebuilt PowerShell script is copied to your clipboard for easy pasting. Open PowerShell As Administrator, and run the command to install the agent.
...
...
Once the CyberCNSAgent service is successfully started, the prompt will close out automatically.
🏁 Installation using Web Installer is completed.
...
Command Line (Download)
Tap on the download option to use the command prompt installation method.
...
You will be prompted to save the application called ‘cybercnsagent’ (.exe) to a location of your choice.
Tap save to continue.
To install, open the Command Prompt as Administrator.
...
Use the change directory command and navigate to the location where you saved the ‘cybercnsagent.exe’ application from the download step earlier.
Run the following command:
cybercnsagent.exe -c <CompanyID> -e <TenantID> -j <User_Secret> -i
| Panel | ||
|---|---|---|
| ||
^ Replace the <CompanyID>, <TenantID>, and <User_Secret> from the values found in the agent installation window. |
...
Agent installation should start and be completed with a successful message, and the CyberCNSAgent service should be started.
...
🏁 Installation using Command Prompt is completed.
...
PowerShell (Copy to Clipboard)
(preferred installation method)
Tap the Copy to Clipboard button to copy the prebuilt PowerShell script to your clipboard.
...
Open PowerShell as Administrator and run the script.
...
The script will begin the agent download process first, which shows in the PowerShell window.
...
Once the download completes, the script will need a return/enter to start and complete the installation.
Tap Enter.
...
Once the CyberCNSAgent service is started, you can close PowerShell out.
...
🏁 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)
Select the Mac option, then use the Copy to Clipboard button.
...
Launch the MAC Terminal
Execute: sudo su (enter the password)
Execute: paste the command copied to the clipboard
...
🏁 MAC Agent Install Completed
...
Installer PKG
Select the Mac option, then tap the Download button.
...
Launch the Terminal
Run the following commands
| Code Block |
|---|
sudo su
sudo installer -pkg ./cybercnsagent_darwin.pkg -target /; sudo /opt/install.sh -c XXXX -e XXXX -j XXXX -i |
| Info |
|---|
In the above command on line #2, you need to replace the values for ‘XXXX’ -c XXXX = your Company ID -e XXXX = your Tenant ID -j XXXX = your User Secret  |
🏁 MAC PKG Agent Install Completed
...
Linux
Terminal (Copy to Clipboard)
Select the Linux option, then use the Copy to Clipboard button.
...
Launch the Terminal
Execute: su root (enter the root password)
Execute: paste the command copied to the clipboard
...
🏁 Linux Agent Install Completed
...
ARM
| Info |
|---|
Use ARM for installation with Raspberry Pi V4 or better. This is the only OS that supports both x32 and x64-bit architectures. |
Terminal (Copy to Clipboard)
...
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:
https://configuration.myconnectsecure.com/api/v4/configuration/agentlink?ostype=windows
>>supported ostype keys
| Info |
|---|
For Windows -> windows
For Linux -> linux
For MAC -> darwin
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.
...