Wazuh agent

The Wazuh agent is multi-platform and runs on the endpoints that you want to monitor. It communicates with the Wazuh manager, sending data in near real-time through an encrypted and authenticated channel.

The Wazuh agent was developed considering the need to monitor a wide variety of different endpoints without impacting their performance. It is supported on the most popular operating systems, and it requires 35 MB of RAM on average.

The Wazuh agent provides key features to enhance your system’s security.

Log collector

Command execution

File integrity monitoring (FIM)

Security configuration assessment (SCA)

System inventory

Malware detection

Active response

Container security

Cloud security

To install a Wazuh agent, select your operating system and follow the instructions.

If you are deploying Wazuh in a large environment, with a high number of servers or endpoints, keep in mind that this deployment might be easier using automation tools such as SCCM or Ansible.

Note

Compatibility between the Wazuh agent and the Wazuh manager is guaranteed when the Wazuh manager version is later than or equal to that of the Wazuh agent.

You can also deploy a new agent following the instructions in the Wazuh dashboard. Go to Agents management > Summary, and click on Deploy new agent.

Deploy new agent button

Then follow the steps on the Wazuh dashboard to deploy a new agent.

Deploy a new agent instructions
Deploy a new agent instructions

Requirements

During enrollment, the Wazuh agent authenticates to the Wazuh manager using a shared password. The Wazuh manager accepts the enrollment request only if the agent provides the configured password. For more information see Enroll Wazuh agents with password authentication.

To enroll a Wazuh agent using password authentication, complete the following steps on the Wazuh manager:

  1. Verify that the <auth> section of the Wazuh manager configuration file /var/wazuh-manager/etc/wazuh-manager.conf, contains the configuration highlighted below.

    <auth>
      <use_password>yes</use_password>
    </auth>
    
  2. Run the following command to view the enrollment password generated by the Wazuh manager. Wazuh agents use this password during the enrollment process to authenticate with the Wazuh manager:

    # cat /var/wazuh-manager/etc/authd.pass
    

    The command output looks similar to this:

    f96d957cb68e94512eae3f5063b649b7
    

Once the above prerequisites are met, you can enroll the Wazuh agent by following the steps for the OS running on the endpoints where the Wazuh agent is installed.