/ansible-wazuh-agent

This role is used for installing and configuring the Wazuh client on Ubuntu and RedHat based operating systems.

Primary LanguageJinjaApache License 2.0Apache-2.0

ansible-wazuh-agent

License

This role is used for installing and configuring the Wazuh client on Ubuntu and RedHat based operating systems.

Restrictions for this library are in:

  • CentOS 7 or Rocky Linux 8
  • Ubuntu distribution, recommended versions above 18.04
  • Ansible version 2.8

This role was developed following the instructions available on the Wazuh

https://documentation.wazuh.com/current/installation-guide/wazuh-agent/index.html

And using the role as a base

https://github.com/lotusnoir/ansible-apps_wazuh_agent

Role Variables (default values)

wazuh_version: "4.x"
wazuh_manager_ip: ""
wazuh_manager_port: "1514"
wazuh_registration_port: "1515"
wazuh_manager_protocol: "tcp"
wazuh_agent_group: "server-linux"
wazuh_registration_password: ""
wazuh_autoupdate: true

Role Variables (explanation)

  • wazuh_version: Sets the Wazuh Agent repository version (Ex: 4.x)
  • wazuh_release_package: Sets the package Wazuh Agent release version (Ex: 4.2.5-1)
  • wazuh_autoupdate: Defines if agent package repository will be active. If true, keep the repository. If false, it will remove the repository thus preventing package autoupdate
  • wazuh_registration_password: Password for registration in Wazuh Server Manager
  • wazuh_manager_ip: IP Wazuh Server Manager

Example Playbook

- name: Install and Configure Wazuh Agent
  hosts: all
  roles:
    - role: "ansible-wazuh-agent"
  vars:
    - wazuh_manager_ip: "127.0.0.1"
    - wazuh_registration_password: "XXXXXXXXXXXXX"

To run tests on molecule

Packages needed to install

  • molecule
  • molecule-docker
  • molecule-goss

Run the commands to install

pip install molecule
pip install molecule-docker
pip install molecule-goss

To run the test run the command below in 3 scenario

  • molecule_test_default
  • molecule_test_disable_autoupdate
  • molecule_test_disable_autoupdate
molecule test