Ir al contenido

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.

0letture

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:

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"

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:

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

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

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

Se l'iniezione viene completata con successo, l'output della console deve terminare con il messaggio: Done with success.


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:

Ventana de terminal
sudo docker compose stop wazuh.dashboard

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

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

Inizializza di nuovo l'interfaccia utente e forza il riavvio del gestore analitico per consolidare i canali di rete:

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