Ir al contenido

Kryptografie, Hashes und API-Konfiguration in Wazuh

Erweiterte Synchronisierung von Anmeldedaten, OpenSearch-Passwort-Hash-Script und kryptografische Benutzerinjektion in den Wazuh-Cluster.

0Lesungen

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:

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"

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:

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

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

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

Wenn die Injektion erfolgreich abgeschlossen wird, muss die Konsolenausgabe mit der Meldung enden: Done with success.


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:

Ventana de terminal
sudo docker compose stop wazuh.dashboard

Schritt 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):

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

Initialisiere die Benutzeroberfläche erneut und erzwinge einen Neustart des Analyse-Managers, um die Netzwerkkanäle zu konsolidieren:

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