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

Update documentation for distributed environment #7370

Conversation

Enaraque
Copy link
Member

@Enaraque Enaraque commented Jun 5, 2024

Description

Related wazuh-packages PR
2968

The goal of this PR is to upload the documentation from the password management section.
In this update, new information has been added to the part related to the distributed environment:

  • It adds a new Filebeat user which mitigates the need to change the filebeat keystore manually.
  • It is now possible to change the kibanaserver and wazuh-wui passwords with the script, so there is no need to change them manually.

Documentation changes

Changes in password management

Captura de pantalla 2024-06-05 a las 10 22 58

@Enaraque Enaraque requested review from javimed and c-bordon June 5, 2024 08:49
@Enaraque Enaraque self-assigned this Jun 5, 2024
@Enaraque
Copy link
Member Author

PR Update

Now it is not necessary to add a new user to the API users section. Wazuh manager uses the indexer admin user to change the Filebeat password.

Also, when changing passwords in the dashboard, it will not be necessary to manually reset it, it will be done in the script itself.

Documentation changes

Changes in passwords management Captura de pantalla 2024-06-10 a las 12 19 55 Captura de pantalla 2024-06-10 a las 12 33 18

Copy link
Member

@c-bordon c-bordon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some minor changes, GJ

@Enaraque
Copy link
Member Author

Changes commited

@c-bordon c-bordon self-requested a review June 10, 2024 10:59
c-bordon
c-bordon previously approved these changes Jun 10, 2024
@davidjiglesias davidjiglesias added level/task Task issue type/enhancement Enhancement issue labels Jun 14, 2024
@@ -99,6 +99,7 @@ If you use the tool in an all-in-one deployment, it automatically updates the pa

If you want to change the password for a Wazuh manager API user, run the script on a Wazuh server node and use option ``-A, --api``. Alternatively, you can change the Wazuh manager API passwords following the instructions in the :doc:`Securing the Wazuh API </user-manual/api/securing-api>` documentation.

.. note:: If you want to change the password for Filebeat in the Wazuh server, you don't need to use option ``-A, --api``.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Enaraque More useful would be to say what to do rather than what not to do. And I don't see the need to use a note here. Just a paragraph like the previous ones would be ok.

@@ -179,7 +198,7 @@ The options ``-au`` and ``-ap`` are necessary to change the passwords for the AP
Changing the passwords in a distributed environment
---------------------------------------------------

Follow the instructions below to change the passwords for all the Wazuh indexer users as well as the Wazuh manager API users.
Follow the instructions below to change the passwords for all Wazuh indexer users, Wazuh manager API users, and the Wazuh dashboard user.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The "Wazuh dashboard user" isn't evident from reading the introduction. Does it mean wazuh-wui? admin? kibanaserver? Other?


#. Update the ``/usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml`` configuration file with the new `wazuh-wui` password generated in the second step.
#. Again, on your `Wazuh dashboard node`, run the following command to update the *wazuh-wui* password in the Wazuh dashboard keystore. Replace ``<WAZUH-WUI_PASSWORD>`` with the random password generated in the second step. Use the ``-A`` or ``--api`` option to change the password for the ``wazuh-wui`` user in the Wazuh dashboard node.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The second step generates more than one password. Do we mean Wazuh API user wazuh-wui password?

@javimed javimed merged commit e04000d into master Jun 14, 2024
3 checks passed
@javimed javimed deleted the bug/1854-improve-the-passwords-tool-behavior-in-distributed-environments branch June 14, 2024 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
level/task Task issue type/enhancement Enhancement issue
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

4 participants