Ir al contenido

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.

0vues

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 :

Ventana de terminal
# 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 :

Ventana de terminal
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 lectura
sudo 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 :

Ventana de terminal
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.pem

Si l'injection réussit, la sortie de la console doit se terminer par le message : Done with success.


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 :

Ventana de terminal
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) :

Ventana de terminal
cat << 'EOF' > ./config/wazuh_dashboard/wazuh.yml
hosts:
- default:
url: https://wazuh.manager
port: 55000
username: wazuh-wui
password: mP5nT8qB2vK9wR3xY6cS4dB9.
run_as: false
EOF

É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 :

Ventana de terminal
sudo docker compose start wazuh.dashboard
sudo docker compose restart wazuh.manager