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.