Wazuh 트러블슈팅 및 모니터링
docker compose 설정 오류 해결, 안전하지 않은 암호 예외 5007, inode 손상 및 블루 팀 감사 명령어.
0조회
이 기술 가이드는 Docker 하의 보안 플랫폼 Wazuh 4.9의 아키텍처, 배포 및 통합 단계에서 감지된 주요 이슈를 수집하며, Blue Team 분석가를 위한 진단 흐름 및 운영 감사 지침을 포함합니다.
1. 주요 오류 로그 및 아키텍처 해결 방법
Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»사건 1: 변수 ($) 인터폴레이션을 통한 인증 실패
Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»- 오류 증상: 컨테이너가 초기 복잡한 암호를 거부하고 초기화 로그에서 암호화 예외를 발생시켰습니다.
- 시스템 진단: Docker Compose 엔진은 YAML 구성 파일의 특수 문자
$를 호스트 시스템의 로컬 변수 호출 또는 대체 지시로 인식합니다. 관리자 키에 특수 문자가 포함되어 단축된 암호가 주입되었습니다. - 적용된 해결책: 충돌하는 특수 문자 없이 고 엔트로피의 복합 알파벳-숫자 암호로 키 사전을 완전히 대체했습니다.
사건 2: 컨테이너 매니저에서 무한 재시작 루프 (오류 5007)
Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»- 오류 증상: 컨테이너 쿼리가 관리자
wazuh.manager를 지속적인 재시작 루프에 빠뜨렸습니다. 로그 감사 결과 다음과 같은 예외가 발생했습니다:wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided. - 시스템 진단: Wazuh 펌웨어는 4.9 버전부터 REST API에 엄격한 비밀번호 강화 정책을 적용합니다. 반드시 대문자, 소문자, 숫자, 그리고 최소 하나의 특수 기호가 함께 포함되어야 합니다.
- 적용된 해결책: API 키(
mP5nT8qB2vK9wR3xY6cS4dB9.)를 수정하여 끝에 점.을 추가하여 내장된 정규 표현식 검증기의 요구 사항을 충족시켰습니다.
사건 3: 파일 internal_users.yml의 인오드 손상
Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»- 오류 증상: OpenSearch 엔진은 자격 증명 테이블에 존재하지 않는 식별자로 인해 동기화 명령을 거부했습니다. 컨테이너 내부에서 파일이 완전히 비어 있는 것으로 나타났습니다.
- 시스템 진단: 호스트 파일을 Docker 볼륨으로 마운트하고 실시간으로 수정할 때 파일 시스템 레벨의 인오드 충돌이 발생했습니다. OpenSearch는 메타데이터를 지우고 다시 쓰면서 물리적 참조를 잃었습니다.
- 적용된 해결 방안: 강력한 비동기 프로세스 설계:
- 컨테이너에서 별도로 bcrypt 해시를 생성합니다.
- 호스트에서 직접 원본 파일을 물리적으로 수정합니다.
- 스크립트
securityadmin.sh의 SSL 서명을 사용하여 강제로 읽기 수행합니다.
사건 4: 영구 로딩 중단 "Wazuh 대시보드 서버가 아직 준비되지 않았습니다"
Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»- 오류 증상: 시스템 볼륨 정리 후 웹 프론트엔드가 영구히 접근 불가 상태가 됩니다.
- 시스템 진단:
down -v명령어는 호스트에 마운트된 로컬 데이터베이스를 파괴합니다. 클러스터를 시작할 때 OpenSearch는 공장 기본 해시로 초기화되어 대시보드가 사용하는 복잡한 키와의 통신을 방해합니다. - 적용된 해결책: 클러스터 볼륨 정리 후 반드시 [[모듈 2의 단계 1 (암호 해시 동기화)]]을 완전히 재실행해야 합니다.
사건 5: 중복 키로 인한 대시보드 크래시 루프 (Duplicated Mapping Key)
Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»- 오류 증상: 웹 컨테이너
wazuh.dashboard가 중단되었으며, 오류 트레이스에 다음과 같이 표시되었습니다:FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:. - 시스템 진단: 웹 인터페이스는 처음 시작 시
wazuh.yml파일을 찾지 못하면 매니저 구조를 자동으로 삽입하려 합니다. 관리자가 동시에 파일을 수동으로 편집하면 두 개의 헤더 키hosts:가 삽입되어 YAML 언어의 구문을 무효화합니다. - 적용된 해결책: 수동 개입: 컨테이너를 중지하고
hosts:단일 키가 있는 깨끗한 설정 파일을 재구성한 후 서비스를 다시 시작하십시오.
2. 모니터링 운영 매뉴얼 (분석가 명령어)
Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»침입 시뮬레이션 또는 일상적인 관리 작업 중 SIEM의 건강 및 성능을 확인하기 위한 추천 명령어:
# Comprobar estado de encendido de todos los serviciossudo docker compose ps
# Monitorizar el consumo de recursos de CPU y RAM de cada contenedorsudo docker statsB. 데이터베이스(인덱서) 건강 진단
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»분산 데이터베이스가 인덱싱 문제 또는 떨어진 shard가 없는지 확인하세요 ("status" : "green" 키를 반환해야 합니다):
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"C. 분석(매니저) 서브프로세스 운영 상태
Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)» Wazuh의 내부 상태를 확인하고 모든 분석 대기열과 로그 엔진이 활성 상태를 보고하는지 확인하십시오 (running):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. 포렌식 추적 및 사건 대응 (실시간 로그)
Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»통신 오류를 감사하거나 실시간 네트워크 보안 사고를 추적하기 위한 핵심 명령어:
# Monitorizar trazas de conexión del Portal Websudo docker compose logs -f wazuh.dashboard
# Monitorizar trazas de enlace y alertas del Indexer con el Managersudo docker compose logs -f wazuh.manager
# Inspeccionar logs internos de alertas caídas o bloqueos de agentessudo docker compose exec wazuh.manager tail -f /var/ossec/logs/ossec.log
# Visualización analítica de Alertas en Caliente (Ideal para Incident Response)sudo docker compose exec wazuh.manager tail -f /var/ossec/logs/alerts/alerts.json
