Ir al contenido

Wazuh 트러블슈팅 및 모니터링

docker compose 설정 오류 해결, 안전하지 않은 암호 예외 5007, inode 손상 및 블루 팀 감사 명령어.

0조회

이 기술 가이드는 Docker 하의 보안 플랫폼 Wazuh 4.9의 아키텍처, 배포 및 통합 단계에서 감지된 주요 이슈를 수집하며, Blue Team 분석가를 위한 진단 흐름 및 운영 감사 지침을 포함합니다.


  • 오류 증상: 컨테이너가 초기 복잡한 암호를 거부하고 초기화 로그에서 암호화 예외를 발생시켰습니다.
  • 시스템 진단: 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.)를 수정하여 끝에 점 .을 추가하여 내장된 정규 표현식 검증기의 요구 사항을 충족시켰습니다.
  • 오류 증상: OpenSearch 엔진은 자격 증명 테이블에 존재하지 않는 식별자로 인해 동기화 명령을 거부했습니다. 컨테이너 내부에서 파일이 완전히 비어 있는 것으로 나타났습니다.
  • 시스템 진단: 호스트 파일을 Docker 볼륨으로 마운트하고 실시간으로 수정할 때 파일 시스템 레벨의 인오드 충돌이 발생했습니다. OpenSearch는 메타데이터를 지우고 다시 쓰면서 물리적 참조를 잃었습니다.
  • 적용된 해결 방안: 강력한 비동기 프로세스 설계:
    1. 컨테이너에서 별도로 bcrypt 해시를 생성합니다.
    2. 호스트에서 직접 원본 파일을 물리적으로 수정합니다.
    3. 스크립트 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: 단일 키가 있는 깨끗한 설정 파일을 재구성한 후 서비스를 다시 시작하십시오.

침입 시뮬레이션 또는 일상적인 관리 작업 중 SIEM의 건강 및 성능을 확인하기 위한 추천 명령어:

Ventana de terminal
# Comprobar estado de encendido de todos los servicios
sudo docker compose ps
# Monitorizar el consumo de recursos de CPU y RAM de cada contenedor
sudo docker stats

분산 데이터베이스가 인덱싱 문제 또는 떨어진 shard가 없는지 확인하세요 ("status" : "green" 키를 반환해야 합니다):

Ventana de terminal
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"

Wazuh의 내부 상태를 확인하고 모든 분석 대기열과 로그 엔진이 활성 상태를 보고하는지 확인하십시오 (running):

Ventana de terminal
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control status

D. 포렌식 추적 및 사건 대응 (실시간 로그)

Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»

통신 오류를 감사하거나 실시간 네트워크 보안 사고를 추적하기 위한 핵심 명령어:

Ventana de terminal
# Monitorizar trazas de conexión del Portal Web
sudo docker compose logs -f wazuh.dashboard
# Monitorizar trazas de enlace y alertas del Indexer con el Manager
sudo docker compose logs -f wazuh.manager
# Inspeccionar logs internos de alertas caídas o bloqueos de agentes
sudo 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