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.
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:
# 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:
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.ymlPasso 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:
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.pemSe a injeção se completa com sucesso, a saída da consola deve finalizar com o mensagem: Done with success
2. Configuração e Conectividade do Dashboard (API Link)
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.
Passo 1: Parada Controlada do Dashboard
Sección titulada «Paso 1: Detención Controlada del Dashboard»Para evitar colisões ao editar arquivos do sistema em tempo real, desligue momentaneamente a interface gráfica:
sudo docker compose stop wazuh.dashboardPasso 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):
cat << 'EOF' > ./config/wazuh_dashboard/wazuh.ymlhosts: - default: url: https://wazuh.manager port: 55000 username: wazuh-wui password: mP5nT8qB2vK9wR3xY6cS4dB9. run_as: falseEOFPasso 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:
sudo docker compose start wazuh.dashboardsudo docker compose restart wazuh.manager
