Criptografía, Hashes y Configuración de API en Wazuh
Sincronización avanzada de credenciales, hash script de contraseñas OpenSearch e inyección criptográfica de usuarios 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)»Ejecuta la herramienta de inicialización de seguridad securityadmin.sh alimentándola con las firmas digitales de tus certificados internos para forzar al indexador a reconstruir la base de datos de usuarios:
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)»Una vez que la base de datos de identidades está operativa, debemos instruir al Dashboard para que pueda conectarse con el Manager de Wazuh mediante credenciales autorizadas en la API.
Paso 1: Detención Controlada del Dashboard
Sección titulada «Paso 1: Detención Controlada del Dashboard»Para evitar colisiones al editar ficheros del sistema en vivo, apaga momentáneamente la interfaz 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»Sobrescribimos el archivo del Dashboard garantizando la correcta anidación sintáctica del archivo YAML (evitando duplicar etiquetas 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»Inicializa de nuevo la interfaz de usuario y fuerza el reinicio del gestor analítico para consolidar los canales de red:
sudo docker compose start wazuh.dashboardsudo docker compose restart wazuh.manager
