Ir al contenido

Criptografia, Hashes e Configuração de API em Wazuh

Sincronização avançada de credenciais, hash script de senhas OpenSearch e injeção criptográfica de usuários no clúster de Wazuh.

0lecturas

O maior desafio arquitetônico na implementação de Wazuh mediante contenedores Docker reside em que a base de dados de indexação (OpenSearch / Wazuh Indexer) não lê nem processa senhas em texto plano. Por segurança, exige traduzir as senhas do arquivo de orquestração em hashes encriptados mediante o algoritmo de segurança bcrypt e injetá-las a baixo nível utilizando a ferramenta de administração interna.

Persistência de Hashes

Esse fluxo de sincronização e geração de hashes deve ser executado obrigatoriamente em cada novo aprovisionamento do clúster, ou após executar uma purga completa de volumes do sistema com a instrução: sudo docker compose down -v.


1. Sincronização de Hashes de Segurança (Bcrypt)

Sección titulada «1. Sincronización de Hashes de Seguridad (Bcrypt)»

Certifique-se de que os contenedores do clúster estejam levantados e ativos no motor de Docker (sudo docker compose up -d) e execute a seguinte sequência de comandos desde o diretório /opt/wazuh-stack/single-node:

Passo 1: Geração e Extração de Hashes Criptográficos

Sección titulada «Paso 1: Generación y Extracción de Hashes Criptográficos»

Invocamos o script de hasheado nativo (hash.sh) alojado no contenedor de armazenamento forçando o uso da variável de ambiente Java interna do host do 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"

Passo 2: Reconstrução Segura do Arquivo de Usuários

Sección titulada «Paso 2: Reconstrucción Segura del Archivo de Usuarios»

Para evitar problemas de inodes causados por montagens de volume atípicas no Docker, reescreveremos e aplicaremos permissões ao arquivo de configuração de usuários diretamente do terminal do 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

Passo 3: Aplicação Forçada da PKI no Banco de Dados (Injeção)

Sección titulada «Paso 3: Aplicación Forzada de la PKI en la Base de Datos (Inyección)»

Execute a ferramenta de inicialização de segurança (securityadmin.sh) alimentando-a com as firmas digitais de seus certificados internos para forçar o indexador a reconstruir a base de dados de usuários:

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

Se a injeção se completa com sucesso, a saída da consola deve finalizar com o mensagem: Done with success


Sección titulada «2. Configuración y Conectividad del Dashboard (API Link)»

Uma vez que o banco de dados de identidades esteja operacional, devemos instruir o Dashboard para que possa se conectar ao Manager do Wazuh por meio de credenciais autorizadas na API.

Para evitar colisões ao editar arquivos do sistema em tempo real, desligue momentaneamente a interface gráfica:

Ventana de terminal
sudo docker compose stop wazuh.dashboard

Passo 2: Injetar Configuração e Credenciais Limpas

Sección titulada «Paso 2: Inyectar Configuración y Credenciales Limpias»

Sobrescrevemos o arquivo do Dashboard garantindo o aninhamento sintático correto do arquivo YAML (evitando duplicar tags 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

Passo 3: Reinicialização de Serviços

Sección titulada «Paso 3: Rearranque de Servicios»

Inicialize novamente a interface de usuário e force a reinicialização do gerenciador analítico para consolidar os canais de rede:

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