Cryptographie, Hashes et Configuration de l'API dans Wazuh
Synchronisation avancée des identifiants, script de hachage des mots de passe OpenSearch et injection cryptographique d'utilisateurs dans le cluster Wazuh.
Le plus grand défi architectural lors de l'implémentation de Wazuh via des conteneurs Docker réside dans le fait que la base de données d'indexation (OpenSearch / Wazuh Indexer) ne lit ni ne traite pas les mots de passe en texte clair. Pour des raisons de sécurité, il est impératif de convertir les mots de passe du fichier d'orchestration en hachages chiffrés via l'algorithme de sécurité bcrypt et de les injecter à bas niveau en utilisant l'outil d'administration interne.
Persistance des hachages
Ce flux de synchronisation et de génération de hachages doit être exécuté obligatoirement lors de chaque nouvel approvisionnement du cluster, ou après avoir effectué une purge complète des volumes du système avec l'instruction : sudo docker compose down -v.
1. Synchronisation des hachages de sécurité (Bcrypt)
Sección titulada «1. Sincronización de Hashes de Seguridad (Bcrypt)»Assurez-vous que les conteneurs du cluster sont lancés et actifs sur le moteur Docker (sudo docker compose up -d) et exécutez la séquence de commandes suivante depuis le répertoire /opt/wazuh-stack/single-node :
Étape 1 : Génération et extraction de hachages cryptographiques
Sección titulada «Paso 1: Generación y Extracción de Hashes Criptográficos»Nous invoquons le script de hachage natif (hash.sh) hébergé dans le conteneur de stockage en forçant l'utilisation de la variable d'environnement Java interne de l'hôte du conteneur :
# 1. Generar y exportar el hash encriptado del usuario 'admin'HASH_ADMIN=$(sudo docker compose exec --env JAVA_HOME=/usr/share/wazuh-indexer/jdk wazuh.indexer bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/hash.sh -p zR9mK2vX5pW8qN3tY6cR4vB1 | grep '\$2')
# 2. Generar y exportar el hash encriptado del usuario de servicios 'kibanaserver'HASH_KIBANA=$(sudo docker compose exec --env JAVA_HOME=/usr/share/wazuh-indexer/jdk wazuh.indexer bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/hash.sh -p yQ3wV8xR9pK2mN6tT5sR4vC1 | grep '\$2')
# 3. VERIFICACIÓN (Paso crítico: valida que las variables contienen texto cifrado)echo "HASH ADMIN ES: $HASH_ADMIN"echo "HASH KIBANA ES: $HASH_KIBANA"Étape 2 : Reconstruction sécurisée du fichier d'utilisateurs
Sección titulada «Paso 2: Reconstrucción Segura del Archivo de Usuarios»Pour éviter les problèmes d'inodes causés par des montages de volumes atypiques dans Docker, nous allons réécrire et appliquer les autorisations au fichier de configuration des utilisateurs directement depuis le terminal de l'hôte :
cat << EOF > ./config/wazuh_indexer/internal_users.yml_meta: type: "internalusers" config_version: 2
admin: hash: "$HASH_ADMIN" reserved: true backend_roles: ["admin"] description: "Admin user"
kibanaserver: hash: "$HASH_KIBANA" reserved: true description: "Kibana user"EOF
# Aplicar permisos correctos de lecturasudo chmod 644 ./config/wazuh_indexer/internal_users.ymlÉtape 3 : Application forcée de la PKI dans la base de données (Injection)
Sección titulada «Paso 3: Aplicación Forzada de la PKI en la Base de Datos (Inyección)»Exécutez l'outil d'initialisation de sécurité securityadmin.sh en l'alimentant avec les signatures numériques de vos certificats internes pour forcer l'indexeur à reconstruire la base de données des utilisateurs :
sudo docker compose exec --env JAVA_HOME=/usr/share/wazuh-indexer/jdk wazuh.indexer bash /usr/share/wazuh-indexer/plugins/opensearch-security/tools/securityadmin.sh -cd /usr/share/wazuh-indexer/opensearch-security/ -icl -nhnv -cacert /usr/share/wazuh-indexer/certs/root-ca.pem -cert /usr/share/wazuh-indexer/certs/admin.pem -key /usr/share/wazuh-indexer/certs/admin-key.pemSi l'injection réussit, la sortie de la console doit se terminer par le message : Done with success.
2. Configuration et connectivité du tableau de bord (Lien API)
Sección titulada «2. Configuración y Conectividad del Dashboard (API Link)»Une fois que la base de données d'identités est opérationnelle, nous devons indiquer au tableau de bord de se connecter au Manager Wazuh à l'aide d'identifiants autorisés dans l'API.
Étape 1 : Arrêt contrôlé du tableau de bord
Sección titulada «Paso 1: Detención Controlada del Dashboard»Pour éviter les collisions lors de l'édition de fichiers système en direct, éteignez momentanément l'interface graphique :
sudo docker compose stop wazuh.dashboardÉtape 2 : Injecter une configuration et des identifiants propres
Sección titulada «Paso 2: Inyectar Configuración y Credenciales Limpias»Nous écrasons le fichier du tableau de bord en garantissant l'imbrication syntaxique correcte du fichier YAML (en évitant de dupliquer les balises de base) :
cat << 'EOF' > ./config/wazuh_dashboard/wazuh.ymlhosts: - default: url: https://wazuh.manager port: 55000 username: wazuh-wui password: mP5nT8qB2vK9wR3xY6cS4dB9. run_as: falseEOFÉtape 3 : Redémarrage des services
Sección titulada «Paso 3: Rearranque de Servicios»Initialisez à nouveau l'interface utilisateur et forcez le redémarrage du gestionnaire analytique pour consolider les canaux réseau :
sudo docker compose start wazuh.dashboardsudo docker compose restart wazuh.manager
