Criptografia, Hashes i Configuració de API en Wazuh
Sincronització avançada de credencials, hash script de contrasenyes OpenSearch i injecció criptogràfica d'usuaris en el clúster de Wazuh.
El mayor reto arquitectónico en la implementación de Wazuh mediante contenedores Docker reside en que la base de datos de indexación (OpenSearch / Wazuh Indexer) no lee ni procesa contraseñas en texto plano. Por seguridad, exige traducir las contraseñas del archivo de orquestación en hashes encriptados mediante el algoritmo de seguridad bcrypt e inyectarlas a bajo nivel utilizando la herramienta de administración interna.
Persistencia de Hashes
Este flujo de sincronización y generación de hashes debe ejecutarse obligatoriamente en cada nuevo aprovisionamiento del clúster, o tras ejecutar una purga completa de volumenes del sistema con la instrucción: sudo docker compose down -v.
1. Sincronización de Hashes de Seguridad (Bcrypt)
Sección titulada «1. Sincronización de Hashes de Seguridad (Bcrypt)»Asegúrate de que los contenedores del clúster se encuentran levantados y activos en el motor de Docker (sudo docker compose up -d) y ejecuta la siguiente secuencia de comandos desde el directorio /opt/wazuh-stack/single-node:
Paso 1: Generación y Extracción de Hashes Criptográficos
Sección titulada «Paso 1: Generación y Extracción de Hashes Criptográficos»Invocamos el script de hasheado nativo (hash.sh) alojado en el contenedor de almacenamiento forzando el uso de la variable de entorno Java interna del host del contenedor:
# 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"Paso 2: Reconstrucción Segura del Archivo de Usuarios
Sección titulada «Paso 2: Reconstrucción Segura del Archivo de Usuarios»Para evitar problemas de inodos causados por montajes de volumen atípicos en Docker, reescribiremos y aplicaremos permisos al archivo de configuración de usuarios directamente desde la terminal del 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.ymlPaso 3: Aplicación Forzada de la PKI en la Base de Datos (Inyección)
Sección titulada «Paso 3: Aplicación Forzada de la PKI en la Base de Datos (Inyección)»Executa la herramienta de inicialització de seguretat securityadmin.sh alimentant-la amb les firmes digitals de les teves certificats interns per forçar l'indexador a reconstruir la base de dades d'usuaris:
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.pemSi la inyección se completa con éxito, la salida de la consola debe finalizar con el mensaje: Done with success.
2. Configuración y Conectividad del Dashboard (API Link)
Sección titulada «2. Configuración y Conectividad del Dashboard (API Link)»Un cop que la base de dades d'identitats està operativa, devem instruir al Dashboard perquè pugui connectar-se amb el Gestor de Wazuh mitjançant credencials autoritzades en la API.
Paso 1: Detención Controlada del Dashboard
Sección titulada «Paso 1: Detención Controlada del Dashboard»Per evitar col·lisions en editar fitxers del sistema en viu, apaga momentàniament la interfície gràfica:
sudo docker compose stop wazuh.dashboardPaso 2: Inyectar Configuración y Credenciales Limpias
Sección titulada «Paso 2: Inyectar Configuración y Credenciales Limpias»Sobreescrivim l'arxiu del Dashboard garantint la correcta anidació sintàctica de l'arxiu YAML (evitant duplicar etiquetes base):
cat << 'EOF' > ./config/wazuh_dashboard/wazuh.ymlhosts: - default: url: https://wazuh.manager port: 55000 username: wazuh-wui password: mP5nT8qB2vK9wR3xY6cS4dB9. run_as: falseEOFPaso 3: Rearranque de Servicios
Sección titulada «Paso 3: Rearranque de Servicios»Inicialitza de nou la interfície d'usuari i força el reinici del gestor analític per consolidar els canals de xarxa:
sudo docker compose start wazuh.dashboardsudo docker compose restart wazuh.manager
