Ir al contenido

Cryptografie, hashes en API-configuratie in Wazuh

Geavanceerde synchronisatie van inloggegevens, OpenSearch-wachtwoordhash-script en cryptografische injectie van gebruikers in de Wazuh-cluster.

0lecturas

De grootste architecturale uitdaging bij de implementatie van Wazuh via Docker-containers is dat de indexatiedatabase (OpenSearch / Wazuh Indexer) geen wachtwoorden in platte tekst leest of verwerkt. Om veiligheidsredenen is het vereist om de wachtwoorden uit het orchestratiebestand te vertalen naar versleutelde hashes met behulp van het beveiligingsalgoritme bcrypt en deze op een laag niveau te injecteren met behulp van de interne beheertools.

Persistentie van Hashes

Deze workflow voor synchronisatie en hash-generatie moet verplicht worden uitgevoerd bij elke nieuwe provisioning van de cluster, of na het uitvoeren van een volledige purge van de systeemvolumes met het commando: sudo docker compose down -v.


1. Synchronisatie van Beveiligingshashes (Bcrypt)

Sección titulada «1. Sincronización de Hashes de Seguridad (Bcrypt)»

Zorg ervoor dat de clustercontainers zijn gestart en actief zijn in de Docker-engine (sudo docker compose up -d) en voer de volgende reeks commando's uit vanuit de directory /opt/wazuh-stack/single-node:

Stap 1: Generatie en Extractie van Cryptografische Hashes

Sección titulada «Paso 1: Generación y Extracción de Hashes Criptográficos»

We roepen het native hashing-script (hash.sh) aan dat in de opslagcontainer wordt gehost, waarbij het gebruik van de interne Java-omgevingsvariabele van de host van de container wordt afgedwongen:

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"

Stap 2: Veilige Reconstructie van het Gebruikersbestand

Sección titulada «Paso 2: Reconstrucción Segura del Archivo de Usuarios»

Om inode-problemen te voorkomen die worden veroorzaakt door atypische volumemounts in Docker, zullen we het gebruikersconfiguratiebestand herschrijven en machtigingen toepassen, rechtstreeks vanuit de hostterminal:

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

Stap 3: Geforceerde Toepassing van de PKI in de Database (Injectie)

Sección titulada «Paso 3: Aplicación Forzada de la PKI en la Base de Datos (Inyección)»

Voer de beveiligingsinitialisatietool securityadmin.sh uit door deze te voeden met de digitale handtekeningen van je interne certificaten om de indexer te dwingen de gebruikersdatabase te reconstrueren:

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

Als de injectie succesvol wordt voltooid, moet de console-output eindigen met de melding: Done with success.


Sección titulada «2. Configuración y Conectividad del Dashboard (API Link)»

Zodra de identiteitsdatabase operationeel is, moeten we het Dashboard instrueren zodat het verbinding kan maken met de Wazuh Manager met behulp van geautoriseerde inloggegevens in de API.

Stap 1: Gecontroleerd Stoppen van het Dashboard

Sección titulada «Paso 1: Detención Controlada del Dashboard»

Om conflicten te voorkomen bij het bewerken van live systeembestanden, schakelt u de grafische interface tijdelijk uit:

Ventana de terminal
sudo docker compose stop wazuh.dashboard

Stap 2: Schone Configuratie en Inloggegevens Injecteren

Sección titulada «Paso 2: Inyectar Configuración y Credenciales Limpias»

We overschrijven het Dashboard-bestand en garanderen de juiste syntactische nesting van het YAML-bestand (waarbij we dubbele basistags vermijden):

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

Initialiseer de gebruikersinterface opnieuw en forceer een herstart van de analytische manager om de netwerkkanalen te consolideren:

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