tis-cyberwatch-agent-conf icon

Cyberwatch Agent Configuration

Silent install package for Cyberwatch Agent Configuration

1-23
Security
Security

tis-cyberwatch-agent-conf

Creating the API Key

First, you need to create an API key from the CyberWatch web interface.

  1. In the top-right corner of the interface, click your profile icon, then select My Profile.
  2. Go to the API Keys tab, then click the Add button.
  3. Enter a clear name to identify the key:
    • Access level → select Agent Installation
    • Expiration → leave this field empty
  4. Once the key has been generated, securely save the following values: ID, Secret

⚠️ Warning: These details will no longer be displayed after creation. Store them in a password manager or a secure file.

Configuring the setup.py file

Open the setup.py file and fill in the following fields with the information obtained earlier:

registration_key_id = "YOUR_ID"
secret_registration_key = "YOUR_SECRET"

Then, modify the base_url field to point to your CyberWatch server URL:

base_url = "https://your-server.cyberwatch.local/api/v2/"

❗ Do not remove the /api/v2/ suffix at the end of the URL.

If you are using a self-signed HTTPS certificate, set allow_selfsigned to True.

You can now install the configuration package on all your machines. The agents will automatically register and gradually appear in your CyberWatch console.

If the registration was successful, the registration_key_id and secret_registration_key fields will be empty, while access_key_id and secret_access_key will now contain their respective values.

  • package: tis-cyberwatch-agent-conf
  • name: Cyberwatch Agent Configuration
  • version: 1-23
  • categories: Security
  • maintainer: WAPT Team,Tranquil IT
  • editor: Cyberwatch
  • locale: all
  • target_os: all
  • architecture: all
  • signature_date:
  • size: 10.98 Ko
  • homepage : https://cyberwatch.fr
  • depends:

package           : tis-cyberwatch-agent-conf
version           : 1-23
architecture      : all
section           : base
priority          : optional
name              : Cyberwatch Agent Configuration
categories        : Security
maintainer        : WAPT Team,Tranquil IT
description       : Cyberwatch Vulnerability Manager is a vulnerability management platform with Assets mapping, Vulnerability scanning, Prioritization. Vulnerability Manage
depends           : tis-cyberwatch-agent
conflicts         : 
maturity          : PROD
locale            : all
target_os         : all
min_wapt_version  : 2.0
sources           : 
installed_size    : 
impacted_process  : 
description_fr    : Cyberwatch Vulnerability Manager est une plateforme de gestion des vulnérabilités avec cartographie des actifs, analyse des vulnérabilités et priorisation. Gestion des vulnérabilités
description_pl    : 
description_de    : 
description_es    : 
description_pt    : 
description_it    : 
description_nl    : 
description_ru    : 
audit_schedule    : 1d
editor            : Cyberwatch
keywords          : 
licence           : 
homepage          : https://cyberwatch.fr
package_uuid      : 87db3728-f076-49ae-9e4d-d3e19436410b
valid_from        : 
valid_until       : 
forced_install_on : 
changelog         : https://docs.cyberwatch.fr/help/fr/general_administration_software/changelog/agent/
min_os_version    : 
max_os_version    : 
icon_sha256sum    : 84c8d943064b7613cd3ed456ddd81ab07c487931ae81fbbe029c670255d379d2
signer            : Tranquil IT
signer_fingerprint: 8c5127a75392be9cc9afd0dbae1222a673072c308c14d88ab246e23832e8c6bb
signature_date    : 2025-10-18T09:04:29.000000
signed_attributes : package,version,architecture,section,priority,name,categories,maintainer,description,depends,conflicts,maturity,locale,target_os,min_wapt_version,sources,installed_size,impacted_process,description_fr,description_pl,description_de,description_es,description_pt,description_it,description_nl,description_ru,audit_schedule,editor,keywords,licence,homepage,package_uuid,valid_from,valid_until,forced_install_on,changelog,min_os_version,max_os_version,icon_sha256sum,signer,signer_fingerprint,signature_date,signed_attributes
signature         : F4Da6eU1RrDeBoCawbeVqgu28vt/bD6ccRf9pFCnJjBIPTvJufzjLl+a4EXSAuE3ec0i4Fjz7bkE9nj5Bzj4j/aXBQQ9qTe54j2uXJPeGSn6c9Gq1vJU1oHsGc7IF7DcKs8y56gql8QNpHG8wJSSPdsn+B7DH0JrED7bMV7rh7gtNaqpIOkDKt810i5wpC/wC4ikEdGYeA0/e+VD1MIdehEWNCr/BleOnRhiVpEOlpBIluc9HVf4FA18V69Gz5EuwI/ycWrZmWhflJb5hGQbJb3rE3nxakfvDBFw9wraqxvwk5ULdhAQXD3boOkzCxtCnl9CZzR2BABKn6q/e61cDQ==

from setuphelpers import *
import platform

if platform.system() == 'Windows':
    inipath = makepath(programfiles(), 'CYBERWATCH SAS','CyberwatchAgent','agent.conf')
else:
    inipath = '/etc/cyberwatch-agent/agent.conf'

registration_key_id = 'AAA+AAOAAAAAAAAAAAAAAA/+AAAAAAAAAAA='
secret_registration_key = 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAdyA=='
base_url = 'https://demo.cyberwatch.fr/api/v2/'
allow_selfsigned = False

def install():
    if not params.get("install_with_luti", False):
        if base_url == 'https://demo.cyberwatch.fr/api/v2/':
            error('Please Configure this package')

    inifile_writestring(inipath,'api','base_url',base_url)
    inifile_writestring(inipath,'api','allow_selfsigned',str(allow_selfsigned))

    if  len(str(inifile_readstring(inipath,'api','access_key_id'))) < 32 and len(str(inifile_readstring(inipath,'api','secret_access_key'))) < 32:
 
        inifile_writestring(inipath,'api','registration_key_id'    ,registration_key_id)
        inifile_writestring(inipath,'api','secret_registration_key',secret_registration_key)

        inifile_writestring(inipath,'api','access_key_id'    ,'')
        inifile_writestring(inipath,'api','secret_access_key','')
        inifile_writestring(inipath,'api','groups','')
        inifile_writestring(inipath,'api','category','server')

        inifile_writestring(inipath,'proxy','enabled','False')
        inifile_writestring(inipath,'proxy','host','')

        inifile_writestring(inipath,'wsus_proxy','enabled','False')
        inifile_writestring(inipath,'wsus_proxy','host','')
        
        if platform.system() == 'Windows':
            service_restart('CyberwatchService')
 

def uninstall():
    remove_file(inipath)


def audit():

    if platform.system() == 'Windows':
        return "OK"
    elif platform.system() == 'Darwin':
        run('/opt/wapt/bin/python3 /Library/Cyberwatch/cyberwatch-agent/cyberwatch-agent.py')
    else:
        if isfile('/usr/bin/cyberwatch-agent'):
            run('/opt/wapt/bin/python3 /usr/bin/cyberwatch-agent')
        elif isfile('/usr/local/bin/cyberwatch-agent'):
            run('/opt/wapt/bin/python3 /usr/local/bin/cyberwatch-agent')
        else:
            pass

    return "OK"    

0b1f2dac9d55e86d1a6abb70d7898f14b73a2692fd73fc106776a2c371ac713b : WAPT/README.md
7cc45cdd1b9862d83fc27da29a5028d368a380c36b6a0174ebf41540d9f9e734 : WAPT/README_fr.md
38d056ab130f7bf7c481c12636a4e9959de36561d3dfcbe54c6e3571bc0c1dc3 : WAPT/certificate.crt
35490a262bc127826eb4e1d9ef4ca9350ce8d07d6a1bd0f24330f037c2abe13f : WAPT/control
84c8d943064b7613cd3ed456ddd81ab07c487931ae81fbbe029c670255d379d2 : WAPT/icon.png
98d319128738569f54556b2614d90e1388c5b5f9a05d942c78200fddf3747d84 : luti.json
f1b563463f5e2100d1ef524cc162b15f1360540acae86ad62a8ac2456fe13f7e : setup.py