Cryptografie, hashes en API-configuratie in Wazuh
Geavanceerde synchronisatie van inloggegevens, OpenSearch-wachtwoordhash-script en cryptografische injectie van gebruikers in de Wazuh-cluster.
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:
# 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:
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.ymlStap 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:
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.pemAls de injectie succesvol wordt voltooid, moet de console-output eindigen met de melding: Done with success.
2. Configuratie en Connectiviteit van het Dashboard (API Link)
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:
sudo docker compose stop wazuh.dashboardStap 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):
cat << 'EOF' > ./config/wazuh_dashboard/wazuh.ymlhosts: - default: url: https://wazuh.manager port: 55000 username: wazuh-wui password: mP5nT8qB2vK9wR3xY6cS4dB9. run_as: falseEOFStap 3: Herstarten van Services
Sección titulada «Paso 3: Rearranque de Servicios»Initialiseer de gebruikersinterface opnieuw en forceer een herstart van de analytische manager om de netwerkkanalen te consolideren:
sudo docker compose start wazuh.dashboardsudo docker compose restart wazuh.manager
