Kryptografie, Hashes und API-Konfiguration in Wazuh
Erweiterte Synchronisierung von Anmeldedaten, OpenSearch-Passwort-Hash-Script und kryptografische Benutzerinjektion in den Wazuh-Cluster.
Die größte architektonische Herausforderung bei der Implementierung von Wazuh mittels Docker-Containern besteht darin, dass die Indexierungsdatenbank (OpenSearch / Wazuh Indexer) keine Passwörter im Klartext liest oder verarbeitet. Aus Sicherheitsgründen müssen die Passwörter aus der Orchestrierungsdatei in verschlüsselte Hashes mittels des Sicherheitsalgorithmus bcrypt umgewandelt und mittels des internen Administrationstools auf niedriger Ebene injiziert werden.
Persistenz von Hashes
Dieser Synchronisierungs- und Hash-Generierungsprozess muss zwingend bei jeder neuen Bereitstellung des Clusters oder nach einer vollständigen Bereinigung der Systemvolumes mit dem Befehl sudo docker compose down -v ausgeführt werden.
1. Synchronisierung von Sicherheits-Hashes (Bcrypt)
Sección titulada «1. Sincronización de Hashes de Seguridad (Bcrypt)»Stellen Sie sicher, dass die Cluster-Container in der Docker-Engine (sudo docker compose up -d) gestartet und aktiv sind, und führen Sie die folgende Befehlssequenz aus dem Verzeichnis /opt/wazuh-stack/single-node aus:
Schritt 1: Generierung und Extraktion kryptografischer Hashes
Sección titulada «Paso 1: Generación y Extracción de Hashes Criptográficos»Wir rufen das native Hashing-Script (hash.sh) auf, das im Storage-Container unter Verwendung der internen Java-Umgebungsvariable des Container-Hosts erzwungen wird:
# 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"Schritt 2: Sichere Rekonstruktion der Benutzerdatei
Sección titulada «Paso 2: Reconstrucción Segura del Archivo de Usuarios»Um Inode-Probleme zu vermeiden, die durch atypische Volume-Mounts in Docker verursacht werden, schreiben wir die Benutzerkonfigurationsdatei neu und wenden Berechtigungen direkt über das Host-Terminal an:
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.ymlSchritt 3: Erzwungene Anwendung der PKI in der Datenbank (Injektion)
Sección titulada «Paso 3: Aplicación Forzada de la PKI en la Base de Datos (Inyección)»Führen Sie das Sicherheitsinitialisierungstool securityadmin.sh aus, indem Sie es mit den digitalen Signaturen Ihrer internen Zertifikate speisen, um den Indexer zur Rekonstruktion der Benutzerdatenbank zu zwingen:
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.pemWenn die Injektion erfolgreich abgeschlossen wird, muss die Konsolenausgabe mit der Meldung enden: Done with success.
2. Konfiguration und Konnektivität des Dashboards (API-Link)
Sección titulada «2. Configuración y Conectividad del Dashboard (API Link)»Sobald die Identitätsdatenbank betriebsbereit ist, müssen wir das Dashboard anweisen, sich über autorisierte Anmeldeinformationen in der API mit dem Wazuh-Manager zu verbinden.
Schritt 1: Kontrolliertes Stoppen des Dashboards
Sección titulada «Paso 1: Detención Controlada del Dashboard»Um Kollisionen beim Bearbeiten von Live-Systemdateien zu vermeiden, schalte die grafische Benutzeroberfläche vorübergehend aus:
sudo docker compose stop wazuh.dashboardSchritt 2: Saubere Konfiguration und Anmeldeinformationen injizieren
Sección titulada «Paso 2: Inyectar Configuración y Credenciales Limpias»Wir überschreiben die Dashboard-Datei und stellen die korrekte syntaktische Verschachtelung der YAML-Datei sicher (um doppelte Basis-Tags zu vermeiden):
cat << 'EOF' > ./config/wazuh_dashboard/wazuh.ymlhosts: - default: url: https://wazuh.manager port: 55000 username: wazuh-wui password: mP5nT8qB2vK9wR3xY6cS4dB9. run_as: falseEOFSchritt 3: Neustart der Dienste
Sección titulada «Paso 3: Rearranque de Servicios»Initialisiere die Benutzeroberfläche erneut und erzwinge einen Neustart des Analyse-Managers, um die Netzwerkkanäle zu konsolidieren:
sudo docker compose start wazuh.dashboardsudo docker compose restart wazuh.manager
