Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add changes to integrations guide #6575

Merged
merged 1 commit into from
Oct 2, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions source/integrations-guide/elastic-stack/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -68,8 +68,8 @@ Create a ``/etc/logstash/templates/`` directory and download the template as ``w

.. code-block:: console

# mkdir /etc/logstash/templates
# curl -o /etc/logstash/templates/wazuh.json https://packages.wazuh.com/integrations/elastic/4.x-8.x/dashboards/wz-es-4.x-8.x-template.json
$ sudo mkdir /etc/logstash/templates
$ sudo curl -o /etc/logstash/templates/wazuh.json https://packages.wazuh.com/integrations/elastic/4.x-8.x/dashboards/wz-es-4.x-8.x-template.json

In Elasticsearch, the indexes support up to ``1000`` fields by default. However, Wazuh logs might contain even more than this number of fields. To solve this issue, the provided ``wazuh.json`` template has the fields set to ``10000`` by default as shown below:

Expand Down Expand Up @@ -112,7 +112,7 @@ We use the `Logstash keystore <https://www.elastic.co/guide/en/logstash/current/
:emphasize-lines: 2,3

$ set +o history
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash
$ export LOGSTASH_KEYSTORE_PASS=<MY_KEYSTORE_PASSWORD>
$ set -o history
$ sudo chown root /etc/sysconfig/logstash
Expand Down Expand Up @@ -295,8 +295,8 @@ Create a ``/etc/logstash/templates/`` directory and download the template as ``w

.. code-block:: console

# mkdir /etc/logstash/templates
# curl -o /etc/logstash/templates/wazuh.json https://packages.wazuh.com/integrations/elastic/4.x-8.x/dashboards/wz-es-4.x-8.x-template.json
$ sudo mkdir /etc/logstash/templates
$ sudo curl -o /etc/logstash/templates/wazuh.json https://packages.wazuh.com/integrations/elastic/4.x-8.x/dashboards/wz-es-4.x-8.x-template.json

In Elasticsearch, the indexes support up to ``1000`` fields by default. However, Wazuh logs might contain even more than this number of fields. To solve this issue, the provided ``wazuh.json`` template has the fields set to ``10000`` by default as shown below:

Expand Down Expand Up @@ -336,7 +336,7 @@ We use the `Logstash keystore <https://www.elastic.co/guide/en/logstash/current/
:emphasize-lines: 2,3

$ set +o history
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash
$ export LOGSTASH_KEYSTORE_PASS=<MY_KEYSTORE_PASSWORD>
$ set -o history
$ sudo chown root /etc/sysconfig/logstash
Expand Down
4 changes: 2 additions & 2 deletions source/integrations-guide/opensearch/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ We use the `Logstash keystore <https://www.elastic.co/guide/en/logstash/current
:emphasize-lines: 2,3

$ set +o history
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash
$ export LOGSTASH_KEYSTORE_PASS=<MY_KEYSTORE_PASSWORD>
$ set -o history
$ sudo chown root /etc/sysconfig/logstash
Expand Down Expand Up @@ -329,7 +329,7 @@ We use the `Logstash keystore <https://www.elastic.co/guide/en/logstash/current/
:emphasize-lines: 2,3

$ set +o history
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash
$ export LOGSTASH_KEYSTORE_PASS=<MY_KEYSTORE_PASSWORD>
$ set -o history
$ sudo chown root /etc/sysconfig/logstash
Expand Down
15 changes: 9 additions & 6 deletions source/integrations-guide/splunk/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ To securely store these values, you can use the `Logstash keystore <https://www.
:emphasize-lines: 2,3

$ set +o history
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"' | sudo tee /etc/sysconfig/logstash LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"' | sudo tee /etc/sysconfig/logstash
$ export LOGSTASH_KEYSTORE_PASS=<MY_KEYSTORE_PASSWORD>
$ set -o history
$ sudo chown root /etc/sysconfig/logstash
Expand Down Expand Up @@ -157,7 +157,7 @@ Perform the following steps to configure the Logstash pipeline.
http_method => "post" # HTTP method used to forward logs
url => "<SPLUNK_URL>:8088/services/collector/raw" # endpoint to forward logs to
headers => ["Authorization", "Splunk ${SPLUNK_AUTH}"]
cacert => </PATH/TO/LOCAL/SPLUNK/CERTIFICATE>/ca.pem
cacert => "</PATH/TO/LOCAL/SPLUNK/CERTIFICATE>/ca.pem"
}
}

Expand Down Expand Up @@ -261,7 +261,7 @@ To securely store these values, you can use the `Logstash keystore <https://www.
:emphasize-lines: 2,3

$ set +o history
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"
$ echo 'LOGSTASH_KEYSTORE_PASS="<MY_KEYSTORE_PASSWORD>"'| sudo tee /etc/sysconfig/logstash
$ export LOGSTASH_KEYSTORE_PASS=<MY_KEYSTORE_PASSWORD>
$ set -o history
$ sudo chown root /etc/sysconfig/logstash
Expand Down Expand Up @@ -312,7 +312,7 @@ To configure the Logstash pipeline do the following.
http_method => "post" # HTTP method used to <SPLUNK_URL>forward logs
url => "<SPLUNK_URL>:8088/services/collector/raw" # endpoint to forward logs to
headers => ["Authorization", "Splunk ${SPLUNK_AUTH}"]
cacert => </PATH/TO/LOCAL/SPLUNK/CERTIFICATE>/ca.pem
cacert => "</PATH/TO/LOCAL/SPLUNK/CERTIFICATE>/ca.pem"
}
}

Expand Down Expand Up @@ -516,7 +516,6 @@ Splunk dashboards

Wazuh provides several dashboards for Splunk.

- `Wz-sp-4.x-9.x-search-bar-in-progress <https://packages.wazuh.com/integrations/splunk/4.x-9.x/dashboards/wz-sp-4.x-9.x-search-bar-in-progress>`__
- `Wz-sp-4.x-9.x-wazuh-amazon-aws <https://packages.wazuh.com/integrations/splunk/4.x-9.x/dashboards/wz-sp-4.x-9.x-wazuh-amazon-aws>`__
- `Wz-sp-4.x-9.x-wazuh-docker-listener <https://packages.wazuh.com/integrations/splunk/4.x-9.x/dashboards/wz-sp-4.x-9.x-wazuh-docker-listener>`__
- `Wz-sp-4.x-9.x-wazuh-incident-response <https://packages.wazuh.com/integrations/splunk/4.x-9.x/dashboards/wz-sp-4.x-9.x-wazuh-incident-response>`__
Expand All @@ -525,7 +524,6 @@ Wazuh provides several dashboards for Splunk.
- `wz-sp-4.x-9.x-wazuh-security-events <https://packages.wazuh.com/integrations/splunk/4.x-9.x/dashboards/wz-sp-4.x-9.x-wazuh-security-events>`__
- `wz-sp-4.x-9.x-wazuh-vulnerabilities <https://packages.wazuh.com/integrations/splunk/4.x-9.x/dashboards/wz-sp-4.x-9.x-wazuh-vulnerabilities>`__


After you complete the Splunk integration, you can use these dashboards to display your Wazuh alerts in Splunk.

.. thumbnail:: /images/integrations/security-events-dashboard-for-splunk.png
Expand All @@ -539,6 +537,11 @@ To import the Wazuh dashboards for Splunk, repeat the following steps for each d
#. Navigate to **Search & Reporting** in Splunk Web.
#. Click **Dashboards** and click **Create New Dashboard**.
#. Enter a dashboard title and select **Dashboard Studio**.

.. note::

The dashboard title you enter here will be overwritten with the original title set in the dashboard template.

#. Select **Grid** and click on **Create**.
#. Click on the **</> Source** icon.
#. Paste your dashboard file content, replacing everything in the source.
Expand Down