Wazuh multi-node cluster

Adding the Wazuh repository

This section describes how to add the Wazuh repository. It will be used for the Wazuh manager, the Wazuh API, and Filebeat installation. These steps must be followed in all the servers that will be part of the Wazuh multi-node cluster:

Installing the Wazuh manager

Install the Wazuh manager package. This step must be applied in all servers that will act as Wazuh cluster nodes:

# yum install wazuh-manager-4.0.4-1

# apt-get install wazuh-manager=4.0.4-1

# zypper install wazuh-manager-4.0.4-1

Now, the Wazuh manager has been installed in all the Wazuh cluster nodes. The Wazuh manager is configured as a single-node cluster by default. The following sections will describe how to configure the Wazuh manager as a Wazuh master node or as a Wazuh worker node.

One server has to be chosen as a master, the rest will be workers. So, the section Wazuh server master node must be applied once, in the server chosen for this role. For all the other servers, the section Wazuh server worker node must be applied.

Wazuh server master node

1. Configure the cluster node by editing the following settings in the /var/ossec/etc/ossec.conf file:

   <cluster>
     <name>wazuh</name>
     <node_name>master-node</node_name>
     <node_type>master</node_type>
     <key>c98b62a9b6169ac5f67dae55ae4a9088</key>
     <port>1516</port>
     <bind_addr>0.0.0.0</bind_addr>
     <nodes>
       <node>wazuh-master-address</node>
     </nodes>
     <hidden>no</hidden>
     <disabled>no</disabled>
   </cluster>
   

   The parameters:

   name	Name of the cluster.
   node_name	Name of the current node.
   node_type	Specifies the role of the node. Has to be set to master.
   key	Key that will be used to encrypt communication between cluster nodes. The key must be 32 characters long and same for all of the nodes in the cluster. The following command can be used to generate a random key: openssl rand -hex 16.
   port	Destination port for cluster communication.
   bind_addr	Network IP to which the node will be bound to listen for incoming requests (0.0.0.0 for any IP).
   nodes	The address of the master node. It must be specified in all nodes (including the master itself). The address can be either an IP or a DNS.
   hidden	Shows or hides the cluster information in the generated alerts.
   disabled	Indicates whether the node will be enabled or disabled in the cluster. This option must be set to no.

2. Once the /var/ossec/etc/ossec.conf configuration file is edited, enable and start the Wazuh manager service:

   SystemdSysV Init

   # systemctl daemon-reload
   # systemctl enable wazuh-manager
   # systemctl start wazuh-manager
   

3. Run the following command to check if the Wazuh manager is active:

   SystemdSysV Init

   # systemctl status wazuh-manager
   

Wazuh server worker nodes

1. Configure the cluster node by editing the following settings in the /var/ossec/etc/ossec.conf file:

   <cluster>
       <name>wazuh</name>
       <node_name>worker-node</node_name>
       <node_type>worker</node_type>
       <key>c98b62a9b6169ac5f67dae55ae4a9088</key>
       <port>1516</port>
       <bind_addr>0.0.0.0</bind_addr>
       <nodes>
           <node>wazuh-master-address</node>
       </nodes>
       <hidden>no</hidden>
       <disabled>no</disabled>
   </cluster>
   

   As shown in the example above, the following parameters have to be edited:

   name	Name of the cluster.
   node_name	Each node of the cluster must have a unique name.
   node_type	Has to be set as worker.
   key	The key created previously for the master node. It has to be the same for all the nodes.
   nodes	Has to contain the address of the master (it can be either an IP or a DNS).
   disabled	Has to be set to no.

2. Once the /var/ossec/etc/ossec.conf configuration file is edited, enable and start the Wazuh manager service:

   SystemdSysV Init

   # systemctl daemon-reload
   # systemctl enable wazuh-manager
   # systemctl start wazuh-manager
   

3. Run the following command to check if the Wazuh manager is active:

   SystemdSysV Init

   # systemctl status wazuh-manager
   

4. To verify that the Wazuh cluster is enabled and all the nodes are connected, execute the following command:

   # /var/ossec/bin/cluster_control -l
   

   An example output of the command looks as follows:

     NAME         TYPE    VERSION  ADDRESS
     master-node  master  4.0.0    10.0.0.3
     worker-node1 worker  4.0.0    10.0.0.4
     worker-node2 worker  4.0.0    10.0.0.5
   

   Note that 10.0.0.3, 10.0.0.4, 10.0.0.5 are example IPs.

Filebeat installation and configuration

1. Install the Filebeat package:

   YumAPTZYpp

   # yum install filebeat-7.9.1
   

2. Download the pre-configured Filebeat configuration file used to forward the Wazuh alerts to Elasticsearch:

   # curl -so /etc/filebeat/filebeat.yml https://raw.githubusercontent.com/wazuh/wazuh-documentation/4.0/resources/open-distro/filebeat/7.x/filebeat_elastic_cluster.yml
   

3. Download the alerts template for Elasticsearch:

   # curl -so /etc/filebeat/wazuh-template.json https://raw.githubusercontent.com/wazuh/wazuh/4.0/extensions/elasticsearch/7.x/wazuh-template.json
   # chmod go+r /etc/filebeat/wazuh-template.json
   

4. Download the Wazuh module for Filebeat:

   # curl -s https://packages.wazuh.com/4.x/filebeat/wazuh-filebeat-0.1.tar.gz | tar -xvz -C /usr/share/filebeat/module
   

5. Edit the file /etc/filebeat/filebeat.yml:

   Elasticsearch single-node clusterElasticsearch multi-node cluster

   output.elasticsearch:
     hosts: ["<elasticsearch_ip>:9200"]
   

   Replace elasticsearch_ip with the IP address or the hostname of the Elasticsearch server.

6. Configure Filebeat certificates:

   During the Elasticsearch installation, the certs.tar file was created.This guide assumes that a copy of this file has been placed in the root home folder (~/).

   The X must be replaced with the number used in the certificate name defined for this Wazuh server:

   # mkdir /etc/filebeat/certs
   # mv ~/certs.tar /etc/filebeat/certs/
   # cd /etc/filebeat/certs/
   # tar -xf certs.tar filebeat-X.pem filebeat-X.key root-ca.pem
   # mv /etc/filebeat/certs/filebeat-X.pem /etc/filebeat/certs/filebeat.pem
   # mv /etc/filebeat/certs/filebeat-X.key /etc/filebeat/certs/filebeat.key
   

7. Enable and start the Filebeat service:

   SystemdSysV Init

   # systemctl daemon-reload
   # systemctl enable filebeat
   # systemctl start filebeat
   

To ensure that Filebeat has been successfully installed, run the following command:

# filebeat test output

An example response should look as follows:

 elasticsearch: https://127.0.0.1:9200...
   parse url... OK
   connection...
     parse host... OK
     dns lookup... OK
     addresses: 127.0.0.1
     dial up... OK
   TLS...
     security: server's certificate chain verification is enabled
     handshake... OK
     TLS version: TLSv1.3
     dial up... OK
   talk to server... OK
   version: 7.9.1

To uninstall Wazuh and Filebeat, visit the uninstalling section.