Skip to main content

Deploy ConnectSecure Agent [Windows]

Overview

Downloads and deploys the ConnectSecure Vulnerability Scan Agent utilizing organization-level custom fields for automated authentication.

Sample Run

Image1

Dependencies

Custom Field

Field LabelRequiredAccepted ValuesScopeDescription
cPVAL Connect Secure Company IDTrueSecureOrganization, Location, DeviceThe unique identifier mapped to the specific company within the ConnectSecure portal.
cPVAL Connect Secure Tenant IDTrueSecureOrganization, Location, DeviceThe top-level tenant identifier for the ConnectSecure environment.
cPVAL Connect Secure User SecretTrueSecureOrganization, Location, DeviceThe authentication secret/token required to register the agent to the portal.

For instructions on obtaining the required IDs for running the script, refer to the Instructions section of this article.

Parameters

NameExampleAccepted ValuesRequiredDefaultTypeDescription
ForceFalseFalseCheckboxThis forces a re-download and re-installation of the agent even if the CyberCnsAgent service is already detected on the endpoint.

Automation Setup/Import

Automation Configuration

Output

  • Activity Details

Changelog

2026-03-16

  • Introduced the Force parameter to allow explicit installation when required.
  • Updated the script to retrieve the user secret from a custom field instead of using a hardcoded value.
  • Removed the forced uninstallation behavior, as rerunning the installer now properly updates existing installations.
  • Updated the detection logic to rely on a service-based check.
  • Renamed the script for improved clarity and consistency.

2025-12-10

  • Initial version of the document