Steps to Install the CYRISMA Linux Agent (Debian Distributions)

Download the Agent Package

• Log in to your CYRISMA instance.
• Navigate to Admin > Scan Agents in the CYRISMA App UI.
• Download the CyBroker_Linux_Installer.deb file for Debian distributions.
• By default, the downloaded package will be saved in the Downloads folder under the current user's home directory.

Move the Package to /tmp
The installation must be performed from the /tmp directory. To move the package, use the following console command:

sudo mv ~/Downloads/CyBroker_Linux_Installer.deb /tmp

Obtain the Key and URL

• Before proceeding with the installation, make sure you have the installation key and URL from Admin > Scan Agents in your CYRISMA instance.
• These details are required during the installation process and are the same for all versions of the CYRISMA Agent.

Install the CYRISMA Agent via Terminal

Open a terminal and navigate to the /tmp directory:

cd /tmp

To install the CYRISMA Agent, run the following command, replacing XXXX-XXXX with your actual installation key and the https://ccxxxxxx.cyrisma.com with your CYRISMA instance URL:

export cy_key=XXXX-XXXX cy_url=https://ccxxxxxx.cyrisma.com; sudo apt install -y ./CyBroker_Linux_Installer.deb

• The cy_key is the unique key for your agent installation, and the cy_url is the URL of your CYRISMA instance.

Dependencies

• The CYRISMA Agent .deb package has a few dependencies that will be automatically installed by the installer. You don’t need to manually install these dependencies.

Important Notes

• Do Not Install via UI: The installation must be executed from the terminal. Do not attempt to install the .deb package by double-clicking it in the Linux UI if one is running on the agent host machine.
• Agent Configuration: Once the installation is complete, log in to the CYRISMA web interface and follow the usual process to register the newly installed agent under Admin > Scan Agents.

Conclusion

By following these steps, you can successfully install the CYRISMA Agent (CyBroker) on a Debian-based Linux system. This method ensures that the agent is properly configured and ready to perform vulnerability scans on your Linux machines. The agent will also auto-update itself as new versions are released.