Ir al contenido

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.

0lectures

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)»

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:

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)»

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.

Per evitar col·lisions en editar fitxers del sistema en viu, apaga momentàniament la interfície 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»

Sobreescrivim l'arxiu del Dashboard garantint la correcta anidació sintàctica de l'arxiu YAML (evitant duplicar etiquetes 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

Inicialitza de nou la interfície d'usuari i força el reinici del gestor analític per consolidar els canals de xarxa:

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