@@ -17,8 +17,8 @@ The short version
1717#. Deploy the Wazuh agents: ``kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/wazuh-agent.yml ``
1818
1919
20- Wazuh Manager
21- =============
20+ Wazuh Manager Host
21+ ==================
2222
2323Provision using infra-vms
2424-------------------------
@@ -57,7 +57,9 @@ Define VM sizing in ``etc/kayobe/inventory/group_vars/wazuh-manager/infra-vms``:
5757 infra_vm_data_capacity: "200G"
5858
5959
60- Optional: define LVM volumes ``etc/kayobe/inventory/group_vars/wazuh-manager/lvm ``:
60+ Optional: define LVM volumes in ``etc/kayobe/inventory/group_vars/wazuh-manager/lvm ``.
61+ ``/var/ossec `` often requires greater storage space, and ``/var/lib/wazuh-indexer ``
62+ may be beneficial too.
6163
6264.. code-block :: console
6365
@@ -73,7 +75,7 @@ Optional: define LVM volumes ``etc/kayobe/inventory/group_vars/wazuh-manager/lvm
7375 size: "100%VG"
7476 filesystem: "ext4"
7577 mount: true
76- mntp: “ /var/lib/elasticsearch”
78+ mntp: " /var/ossec"
7779 create: true
7880
7981
@@ -249,7 +251,7 @@ It will be used by wazuh secrets playbook to generate wazuh secrets vault file.
249251.. code-block :: console
250252
251253 kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/wazuh-secrets.yml
252- ansible-vault encrypt --vault-password-file ~/vault.pass $KAYOBE_CONFIG_PATH/inventory/group_vars/ wazuh/wazuh-manager/wazuh- secrets
254+ ansible-vault encrypt --vault-password-file ~/vault.pass $KAYOBE_CONFIG_PATH/wazuh- secrets.yml
253255
254256
255257 TLS (optional)
@@ -288,6 +290,21 @@ Example OpenSSL rune to convert to PKCS#8:
288290
289291TODO: document how to use a local certificate. Do we need to override all certificates?
290292
293+ Custom SCA Policies (optional)
294+ ------------------------------
295+
296+ Wazuh ships with a large selection of Security Configuration Assessment
297+ rulesets. However, you may find you want to add more. This can be achieved via
298+ `custom policies <https://documentation.wazuh.com/current/user-manual/capabilities/sec-config-assessment/how-to-configure.html >`_.
299+
300+ SKC supports this automatically, just add the policy file from this PR to
301+ ``{{ kayobe_env_config_path }}/wazuh/custom_sca_policies ``.
302+
303+ Currently, Wazuh does not ship with a CIS benchmark for Rocky 9. You can find
304+ the in-development policy here: https://github.com/wazuh/wazuh/pull/17810 To
305+ include this in your deployment, simply copy it to
306+ ``{{ kayobe_env_config_path }}/wazuh/custom_sca_policies/cis_rocky_linux_9.yml ``.
307+
291308Deploy
292309------
293310
@@ -303,7 +320,7 @@ Encrypt the keys (and remember to commit to git):
303320``ansible-vault encrypt --vault-password-file ~/vault.pass $KAYOBE_CONFIG_PATH/ansible/wazuh/certificates/certs/*.key ``
304321
305322Verification
306- ==============
323+ ------------
307324
308325The Wazuh portal should be accessible on port 443 of the Wazuh
309326manager’s IPs (using HTTPS, with the root CA cert in ``etc/kayobe/ansible/wazuh/certificates/wazuh-certificates/root-ca.pem ``).
@@ -315,11 +332,9 @@ Troubleshooting
315332
316333Logs are in ``/var/log/wazuh-indexer/wazuh.log ``. There are also logs in the journal.
317334
318- ============
319335Wazuh agents
320336============
321337
322-
323338Wazuh agent playbook is located in ``etc/kayobe/ansible/wazuh-agent.yml ``.
324339
325340Wazuh agent variables file is located in ``etc/kayobe/inventory/group_vars/wazuh-agent/wazuh-agent ``.
@@ -333,13 +348,13 @@ Deploy the Wazuh agents:
333348``kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/wazuh-agent.yml ``
334349
335350Verification
336- =============
351+ ------------
337352
338353The Wazuh agents should register with the Wazuh manager. This can be verified via the agents page in Wazuh Portal.
339354Check CIS benchmark output in agent section.
340355
341- Additional resources:
342- =====================
356+ Additional resources
357+ --------------------
343358
344359For times when you need to upgrade wazuh with elasticsearch to version with opensearch or you just need to deinstall all wazuh components:
345360Wazuh purge script: https://github.com/stackhpc/wazuh-server-purge
0 commit comments