From adb40a57952c6670fc671bff2e2e82b3bcedc782 Mon Sep 17 00:00:00 2001 From: Gui-Gos <97973228+Gui-Gos@users.noreply.github.com> Date: Sun, 4 Jan 2026 13:38:46 +0100 Subject: [PATCH] docs: Update password change procedure to match official Wazuh documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replaced the simplified password change instructions with the official Wazuh Docker deployment procedure from: https://documentation.wazuh.com/current/deployment-options/docker/changing-default-password.html Changes: - Added reference link to official Wazuh documentation - Updated MĂ©thode 2 with official hash generation procedure using hash.sh - Added complete securityadmin.sh command with correct paths - Specified password requirements (8-64 chars with symbols for API) - Added warning about complexity of post-install password changes - Emphasized pre-installation password configuration as best practice This ensures users follow the correct and secure procedure for changing passwords in Wazuh Docker deployments. đŸ€– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 --- apps/wazuh-runtipi/metadata/description.md | 72 +++++++++++++++------- 1 file changed, 49 insertions(+), 23 deletions(-) diff --git a/apps/wazuh-runtipi/metadata/description.md b/apps/wazuh-runtipi/metadata/description.md index dbc7157..7c69c0d 100644 --- a/apps/wazuh-runtipi/metadata/description.md +++ b/apps/wazuh-runtipi/metadata/description.md @@ -186,6 +186,8 @@ Si vous utilisez les valeurs par dĂ©faut: ### Étape 4: Changer les Mots de Passe (RecommandĂ© pour Production) +⚠ **Source officielle:** [Wazuh Documentation - Changing Default Passwords](https://documentation.wazuh.com/current/deployment-options/docker/changing-default-password.html) + #### MĂ©thode 1: Avant l'Installation (RecommandĂ©) La maniĂšre la plus sĂ»re est de dĂ©finir des mots de passe forts **avant** l'installation via l'interface Runtipi: @@ -195,39 +197,63 @@ La maniĂšre la plus sĂ»re est de dĂ©finir des mots de passe forts **avant** l'in - `INDEXER_PASSWORD` - Mot de passe admin de l'indexer (au lieu de "admin") - `DASHBOARD_PASSWORD` - Mot de passe dashboard→indexer (au lieu de "kibanaserver") - `API_PASSWORD` - Mot de passe API REST (au lieu de "MyS3cr37P450r.*-") -3. Utiliser des mots de passe forts (minimum 12 caractĂšres, majuscules, minuscules, chiffres, symboles) +3. Utiliser des mots de passe forts: + - **Indexer/Dashboard:** Minimum 8 caractĂšres + - **API:** 8-64 caractĂšres avec majuscules, minuscules, chiffres ET symboles 4. ProcĂ©der Ă  l'installation -#### MĂ©thode 2: AprĂšs l'Installation +#### MĂ©thode 2: AprĂšs l'Installation (MĂ©thode Officielle Wazuh) -Si vous avez dĂ©jĂ  installĂ© Wazuh avec les mots de passe par dĂ©faut, vous devez les changer: +Si vous avez dĂ©jĂ  installĂ© Wazuh avec les mots de passe par dĂ©faut, suivez la procĂ©dure officielle : -**A. Changer le mot de passe admin du dashboard:** +**A. Changer le mot de passe des utilisateurs Indexer (admin/kibanaserver):** -1. Se connecter au dashboard: `https://VOTRE_IP:5601` -2. Login: `admin` / `admin` -3. Cliquer sur le menu **☰** (hamburger) en haut Ă  gauche -4. Aller dans **Security → Internal users** -5. Cliquer sur l'utilisateur **admin** -6. Cliquer sur **Edit** -7. Entrer un **nouveau mot de passe fort** -8. Cliquer sur **Save** +1. **Se dĂ©connecter du dashboard** pour Ă©viter les conflits de session -**B. Mettre Ă  jour les variables d'environnement dans Runtipi:** +2. **GĂ©nĂ©rer le hash du nouveau mot de passe:** + ```bash + docker run --rm -ti wazuh/wazuh-indexer:4.14.1 bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/hash.sh + ``` + Entrez votre nouveau mot de passe et copiez le hash gĂ©nĂ©rĂ©. -1. Dans l'interface Runtipi, aller dans l'application Wazuh -2. Cliquer sur "Settings" ou "Configuration" -3. Mettre Ă  jour `INDEXER_PASSWORD` avec le nouveau mot de passe -4. RedĂ©marrer l'application pour appliquer les changements +3. **Mettre Ă  jour internal_users.yml:** + ```bash + # Éditer le fichier de sĂ©curitĂ© + nano /opt/runtipi/app-data/*/wazuh-runtipi/data/indexer-security/internal_users.yml + ``` -**C. Changer les autres utilisateurs internes (optionnel mais recommandĂ©):** + Remplacez le hash de l'utilisateur cible (admin ou kibanaserver). -Dans le dashboard, sous **Security → Internal users**, vous pouvez Ă©galement modifier: -- `kibanaserver` - Utilisateur technique dashboard→indexer -- `wazuh-wui` - Utilisateur API REST -- `logstash` - Utilisateur Filebeat→Indexer (si utilisĂ©) +4. **Appliquer les changements:** + ```bash + # RedĂ©marrer l'application via Runtipi + # Puis se connecter au conteneur indexer + docker exec -it wazuh-runtipi-wazuh-indexer-1 bash -**Note:** AprĂšs modification des mots de passe, assurez-vous de mettre Ă  jour les variables d'environnement correspondantes dans Runtipi et redĂ©marrer les conteneurs pour synchroniser les configurations. + # Dans le conteneur, exĂ©cuter: + export INSTALLATION_DIR=/usr/share/wazuh-indexer + export JAVA_HOME=/usr/share/wazuh-indexer/jdk + bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/securityadmin.sh \ + -cd /usr/share/wazuh-indexer/opensearch-security/ \ + -cacert /usr/share/wazuh-indexer/config/certs/root-ca.pem \ + -cert /usr/share/wazuh-indexer/config/certs/admin.pem \ + -key /usr/share/wazuh-indexer/config/certs/admin-key.pem \ + -p 9200 -nhnv -icl + ``` + +5. **Mettre Ă  jour les variables d'environnement Runtipi** avec les nouveaux mots de passe et redĂ©marrer. + +**B. Changer le mot de passe de l'API Wazuh (wazuh-wui):** + +**Exigences:** 8-64 caractĂšres avec majuscules, minuscules, chiffres ET symboles + +1. **Mettre Ă  jour la variable d'environnement:** + - Dans Runtipi → Wazuh → Settings + - Modifier `API_PASSWORD` avec le nouveau mot de passe + +2. **RedĂ©marrer l'application** pour appliquer les changements + +**Note importante:** La mĂ©thode officielle nĂ©cessite de regĂ©nĂ©rer les hash et d'exĂ©cuter `securityadmin.sh`. Pour une installation Runtipi, il est **fortement recommandĂ©** de dĂ©finir des mots de passe forts **avant** l'installation (MĂ©thode 1) pour Ă©viter cette procĂ©dure complexe. ---