Crittografia, hash e configurazione API in Wazuh
Sincronizzazione avanzata delle credenziali, script hash per le password di OpenSearch e iniezione crittografica degli utenti nel cluster di Wazuh.
La sfida architettonica maggiore nell'implementazione di Wazuh tramite container Docker risiede nel fatto che il database di indicizzazione (OpenSearch / Wazuh Indexer) non legge né elabora password in testo in chiaro. Per motivi di sicurezza, richiede di tradurre le password dal file di orchestrazione in hash crittografati tramite l'algoritmo di sicurezza bcrypt e di iniettarli a basso livello utilizzando lo strumento di amministrazione interna.
Persistenza degli Hash
Questo flusso di sincronizzazione e generazione di hash deve essere eseguito obbligatoriamente ad ogni nuovo provisioning del cluster, o dopo aver eseguito una purga completa dei volumi di sistema con l'istruzione: sudo docker compose down -v.
1. Sincronizzazione degli Hash di Sicurezza (Bcrypt)
Sección titulada «1. Sincronización de Hashes de Seguridad (Bcrypt)»Assicurati che i container del cluster siano avviati e attivi nel motore Docker (sudo docker compose up -d) ed esegui la seguente sequenza di comandi dalla directory /opt/wazuh-stack/single-node:
Passaggio 1: Generazione ed Estrazione degli Hash Crittografici
Sección titulada «Paso 1: Generación y Extracción de Hashes Criptográficos»Invochiamo lo script di hashing nativo (hash.sh) ospitato nel container di storage forzando l'uso della variabile d'ambiente Java interna dell'host del container:
# 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"Passaggio 2: Ricostruzione Sicura del File Utenti
Sección titulada «Paso 2: Reconstrucción Segura del Archivo de Usuarios»Per evitare problemi di inode causati da montaggi di volume atipici in Docker, riscriveremo e applicheremo i permessi al file di configurazione degli utenti direttamente dal terminale dell'host:
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.ymlPassaggio 3: Applicazione Forzata della PKI nel Database (Iniezione)
Sección titulada «Paso 3: Aplicación Forzada de la PKI en la Base de Datos (Inyección)»Esegui lo strumento di inizializzazione della sicurezza securityadmin.sh fornendo le firme digitali dei tuoi certificati interni per forzare l'indexer a ricostruire il database degli utenti:
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.pemSe l'iniezione viene completata con successo, l'output della console deve terminare con il messaggio: Done with success.
2. Configurazione e Connettività della Dashboard (API Link)
Sección titulada «2. Configuración y Conectividad del Dashboard (API Link)»Una volta che il database delle identità è operativo, dobbiamo istruire la Dashboard affinché possa connettersi al Manager di Wazuh tramite credenziali autorizzate nell'API.
Passaggio 1: Arresto Controllato della Dashboard
Sección titulada «Paso 1: Detención Controlada del Dashboard»Per evitare collisioni durante la modifica dei file di sistema dal vivo, spegni momentaneamente l'interfaccia grafica:
sudo docker compose stop wazuh.dashboardPassaggio 2: Iniettare Configurazione e Credenziali Pulite
Sección titulada «Paso 2: Inyectar Configuración y Credenciales Limpias»Sovrascriviamo il file della Dashboard garantendo la corretta nidificazione sintattica del file YAML (evitando di duplicare le etichette di base):
cat << 'EOF' > ./config/wazuh_dashboard/wazuh.ymlhosts: - default: url: https://wazuh.manager port: 55000 username: wazuh-wui password: mP5nT8qB2vK9wR3xY6cS4dB9. run_as: falseEOFPassaggio 3: Riavvio dei Servizi
Sección titulada «Paso 3: Rearranque de Servicios»Inizializza di nuovo l'interfaccia utente e forza il riavvio del gestore analitico per consolidare i canali di rete:
sudo docker compose start wazuh.dashboardsudo docker compose restart wazuh.manager
