Ir al contenido

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.

0lecturas

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:

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"

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:

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

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

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

Si la inyección se completa con éxito, la salida de la consola debe finalizar con el mensaje: Done with success.


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.

Para evitar colisiones al editar ficheros del sistema en vivo, apaga momentáneamente la interfaz gráfica:

Ventana de terminal
sudo docker compose stop wazuh.dashboard

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

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

Inicializa de nuevo la interfaz de usuario y fuerza el reinicio del gestor analítico para consolidar los canales de red:

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