docs: Add missing wazuh.yml edit step for API password change
Some checks failed
Test / test (push) Has been cancelled
Some checks failed
Test / test (push) Has been cancelled
According to official Wazuh documentation, changing the API password requires updating BOTH: 1. The wazuh.yml file in the dashboard container 2. The API_PASSWORD environment variable Previous documentation only mentioned step 2, which is incomplete. Added: - Step to edit /usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml - Warning that this file is not in a persistent volume - Link to official documentation - vi editor instructions for YAML modification Fixes incomplete API password change procedure. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -307,7 +307,7 @@ Si vous utilisez les valeurs par défaut:
|
|||||||
docker exec -it wazuh-runtipi_*-wazuh-dashboard-1 bash -c \
|
docker exec -it wazuh-runtipi_*-wazuh-dashboard-1 bash -c \
|
||||||
"curl -ks https://wazuh.indexer:9200 -u kibanaserver:VOTRE_NOUVEAU_MOT_DE_PASSE"
|
"curl -ks https://wazuh.indexer:9200 -u kibanaserver:VOTRE_NOUVEAU_MOT_DE_PASSE"
|
||||||
```
|
```
|
||||||
✅ Succès si vous voyez: `"cluster_name" : "wazuh-cluster"`
|
✅ Succès si vous voyez: `"name" : "wazuh.indexer"`
|
||||||
|
|
||||||
**⚠️ Test de sécurité (vérifier que les anciens mots de passe ne fonctionnent PLUS):**
|
**⚠️ Test de sécurité (vérifier que les anciens mots de passe ne fonctionnent PLUS):**
|
||||||
```bash
|
```bash
|
||||||
@@ -318,24 +318,64 @@ Si vous utilisez les valeurs par défaut:
|
|||||||
|
|
||||||
**B. Changer le mot de passe de l'API Wazuh (wazuh-wui):**
|
**B. Changer le mot de passe de l'API Wazuh (wazuh-wui):**
|
||||||
|
|
||||||
|
**⚠️ Source officielle:** [Wazuh Documentation - Changing API Password](https://documentation.wazuh.com/current/deployment-options/docker/changing-default-password.html)
|
||||||
|
|
||||||
**⚠️ Exigences du mot de passe:** 8-64 caractères avec majuscules, minuscules, chiffres ET symboles
|
**⚠️ Exigences du mot de passe:** 8-64 caractères avec majuscules, minuscules, chiffres ET symboles
|
||||||
|
|
||||||
1. **Choisir un nouveau mot de passe fort:**
|
1. **Choisir un nouveau mot de passe fort:**
|
||||||
- Exemple: `MyN3wP@ssw0rd!2024`
|
- Exemple: `MyN3wP@ssw0rd!2024`
|
||||||
- Doit respecter les critères ci-dessus
|
- Doit respecter les critères ci-dessus
|
||||||
|
|
||||||
2. **Mettre à jour la variable d'environnement dans Runtipi:**
|
2. **Mettre à jour le fichier wazuh.yml dans le conteneur dashboard:**
|
||||||
|
```bash
|
||||||
|
# Se connecter au conteneur dashboard
|
||||||
|
docker exec -it wazuh-runtipi_*-wazuh-dashboard-1 bash
|
||||||
|
```
|
||||||
|
|
||||||
|
**Une fois dans le conteneur:**
|
||||||
|
```bash
|
||||||
|
# Éditer le fichier de configuration
|
||||||
|
vi /usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml
|
||||||
|
```
|
||||||
|
|
||||||
|
**Trouvez la section qui ressemble à:**
|
||||||
|
```yaml
|
||||||
|
hosts:
|
||||||
|
- default:
|
||||||
|
url: https://wazuh.manager
|
||||||
|
port: 55000
|
||||||
|
username: wazuh-wui
|
||||||
|
password: "MyS3cr37P450r.*-"
|
||||||
|
run_as: false
|
||||||
|
```
|
||||||
|
|
||||||
|
**Modifiez uniquement le champ `password`:**
|
||||||
|
```yaml
|
||||||
|
hosts:
|
||||||
|
- default:
|
||||||
|
url: https://wazuh.manager
|
||||||
|
port: 55000
|
||||||
|
username: wazuh-wui
|
||||||
|
password: "VOTRE_NOUVEAU_MOT_DE_PASSE"
|
||||||
|
run_as: false
|
||||||
|
```
|
||||||
|
|
||||||
|
Sauvegardez: Appuyez sur `Esc`, puis tapez `:wq` et `Entrée`
|
||||||
|
|
||||||
|
Quittez le conteneur: `exit`
|
||||||
|
|
||||||
|
3. **Mettre à jour la variable d'environnement dans Runtipi:**
|
||||||
- Allez dans Runtipi → Apps → Wazuh → Paramètres
|
- Allez dans Runtipi → Apps → Wazuh → Paramètres
|
||||||
- Trouvez `API_PASSWORD`
|
- Trouvez `API_PASSWORD`
|
||||||
- Remplacez `MyS3cr37P450r.*-` par votre nouveau mot de passe
|
- Remplacez `MyS3cr37P450r.*-` par votre nouveau mot de passe
|
||||||
- Cliquez sur "Mettre à jour"
|
- Cliquez sur "Mettre à jour"
|
||||||
|
|
||||||
3. **Redémarrer l'application:**
|
4. **Redémarrer l'application:**
|
||||||
- Cliquez sur "Arreter"
|
- Cliquez sur "Arreter"
|
||||||
- Attendez quelques secondes
|
- Attendez quelques secondes
|
||||||
- Cliquez sur "Démarrer"
|
- Cliquez sur "Démarrer"
|
||||||
|
|
||||||
4. **Vérifier que le changement est effectif:**
|
5. **Vérifier que le changement est effectif:**
|
||||||
```bash
|
```bash
|
||||||
# Tester l'API avec le nouveau mot de passe
|
# Tester l'API avec le nouveau mot de passe
|
||||||
curl -k -u wazuh-wui:VOTRE_NOUVEAU_MOT_DE_PASSE https://VOTRE_IP:55000/security/user/authenticate
|
curl -k -u wazuh-wui:VOTRE_NOUVEAU_MOT_DE_PASSE https://VOTRE_IP:55000/security/user/authenticate
|
||||||
@@ -350,7 +390,9 @@ Si vous utilisez les valeurs par défaut:
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Si vous obtenez un token, le changement est réussi!
|
✅ Si vous obtenez un token, le changement est réussi!
|
||||||
|
|
||||||
|
**⚠️ NOTE IMPORTANTE:** Le fichier `wazuh.yml` est stocké dans `/usr/share/wazuh-dashboard/data/` qui n'est PAS un volume persistant. Cela signifie que si vous **supprimez complètement l'application** (pas juste un redémarrage), vous devrez refaire cette modification. Pour un simple redémarrage ou mise à jour, le fichier est préservé.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user