암호화, 해시 및 Wazuh API 구성
고급 자격 증명 동기화, OpenSearch 비밀번호 해시 스크립트 및 Wazuh 클러스터 사용자 암호화 주입
Docker 컨테이너를 통해 Wazuh를 구현할 때 아키텍처상의 가장 큰 도전은 인덱싱 데이터베이스(OpenSearch / Wazuh Indexer)가 평문으로 된 비밀번호를 읽거나 처리하지 않는다는 점입니다. 보안을 위해 암호를 Java 호스트의 내부 환경 변수를 사용하여 암호화된 해시로 변환해야 하며, 내부 관리 도구를 사용하여 저수준으로 주입해야 합니다.
해시 유지
이 동기화 및 해시 생성 프로세스는 클러스터를 새로 프로비저닝할 때나 시스템의 모든 볼륨을 삭제한 후 명령어 sudo docker compose down -v를 실행한 후에 반드시 실행되어야 합니다.
1. 보안 해시 동기화 (Bcrypt)
Sección titulada «1. Sincronización de Hashes de Seguridad (Bcrypt)»클러스터 컨테이너가 Docker 엔진에서 실행 중이고 활성 상태인지 확인하세요 (sudo docker compose up -d) 및 다음 스크립트 시퀀스를 /opt/wazuh-stack/single-node 디렉토리에서 실행하세요:
단계 1: 암호화 해시 생성 및 추출
Sección titulada «Paso 1: Generación y Extracción de Hashes Criptográficos»저장소 컨테이너에 호스팅된 내장 해시 스크립트(hash.sh)를 호출하여 컨테이너 호스트의 Java 내부 환경 변수를 강제로 사용합니다:
# 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"단계 2: 사용자 파일의 안전한 재구성
Sección titulada «Paso 2: Reconstrucción Segura del Archivo de Usuarios»Docker의 비정상적인 볼륨 마운트로 인한 inode 문제를 방지하기 위해 호스트 터미널에서 사용자 구성 파일을 재작성하고 권한을 적용합니다:
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.yml단계 3: 데이터베이스에 PKI 강제 적용 (주입)
Sección titulada «Paso 3: Aplicación Forzada de la PKI en la Base de Datos (Inyección)»보안 초기화 도구 securityadmin.sh를 실행하여 내부 인증서의 디지털 서명을 입력하여 인덱서가 사용자 데이터베이스를 재구성하도록 강제합니다:
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주입이 성공적으로 완료되면 콘솔 출력은 다음 메시지로 종료되어야 합니다: Done with success
2. 대시보드 설정 및 연결성 (API 링크)
Sección titulada «2. Configuración y Conectividad del Dashboard (API Link)»신뢰 데이터베이스가 운영 상태가 되면, Wazuh 매니저와 API를 통해 인증된 자격 증명으로 연결할 수 있도록 대시보드에 지시해야 합니다.
단계 1: 대시보드 제어 중지
Sección titulada «Paso 1: Detención Controlada del Dashboard»실시간 시스템 파일 편집 시 충돌을 방지하기 위해 일시적으로 그래픽 인터페이스를 종료하세요:
sudo docker compose stop wazuh.dashboard단계 2: 깨끗한 설정 및 자격 증명 주입
Sección titulada «Paso 2: Inyectar Configuración y Credenciales Limpias»대시보드 파일을 덮어쓰고 YAML 파일의 올바른 중첩 구문을 보장합니다 (기본 라벨 중복을 피함):
cat << 'EOF' > ./config/wazuh_dashboard/wazuh.ymlhosts: - default: url: https://wazuh.manager port: 55000 username: wazuh-wui password: mP5nT8qB2vK9wR3xY6cS4dB9. run_as: falseEOF단계 3: 서비스 재시작
Sección titulada «Paso 3: Rearranque de Servicios»사용자 인터페이스를 다시 시작하고 분석기 관리자를 강제로 재시작하여 네트워크 채널을 통합합니다:
sudo docker compose start wazuh.dashboardsudo docker compose restart wazuh.manager
