ClamAV 로그 수집

다음에서 지원:

Google secops SIEM

이 문서에서는 Bindplane 에이전트를 사용하여 ClamAV 로그를 Google Security Operations로 수집하는 방법을 설명합니다.

ClamAV는 트로이 목마, 바이러스, 멀웨어, 기타 악성 위협을 감지하도록 설계된 오픈소스 바이러스 백신 엔진입니다. 명령줄 검사를 제공하고, 자동 서명 데이터베이스 업데이트를 지원하며, 보관 파일, 실행 파일, 문서를 비롯한 여러 파일 형식을 지원합니다. ClamAV는 Linux, Unix, Windows 시스템에서 로컬 데몬 (clamd) 또는 명령줄 스캐너 (clamscan)로 작동합니다.

시작하기 전에

다음 기본 요건이 충족되었는지 확인합니다.

Google SecOps 인스턴스
Windows Server 2016 이상 또는 systemd가 설치된 Linux 호스트
Bindplane 에이전트 호스트와 ClamAV 서버 간의 네트워크 연결
프록시 뒤에서 실행하는 경우 Bindplane 에이전트 요구사항에 따라 방화벽 포트가 열려 있는지 확인합니다.
Linux 엔드포인트에 ClamAV가 설치되어 실행 중
ClamAV 서버 및 Bindplane 에이전트 호스트에 대한 루트 또는 sudo 액세스

Google SecOps 수집 인증 파일 가져오기

Google SecOps 콘솔에 로그인합니다.
SIEM 설정 > 수집 에이전트로 이동합니다.
수집 인증 파일을 다운로드합니다. Bindplane이 설치될 시스템에 파일을 안전하게 저장합니다.

참고: 이 JSON 파일에는 Bindplane 에이전트를 Google SecOps에 인증하기 위한 사용자 인증 정보가 포함되어 있습니다.

Google SecOps 고객 ID 가져오기

Google SecOps 콘솔에 로그인합니다.
SIEM 설정 > 프로필로 이동합니다.
조직 세부정보 섹션에서 고객 ID를 복사하여 저장합니다.

참고: Bindplane 에이전트 내보내기를 구성하려면 고객 ID가 필요합니다.

Bindplane 에이전트 설치

다음 안내에 따라 Windows 또는 Linux 운영체제에 Bindplane 에이전트를 설치합니다.

Windows 설치

명령 프롬프트 또는 PowerShell을 관리자로 엽니다.

다음 명령어를 실행합니다.

msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet

설치가 완료될 때까지 기다립니다.
다음을 실행하여 설치를 확인합니다.
```
sc query observiq-otel-collector
```
서비스 상태는 실행 중이어야 합니다.

Linux 설치

루트 또는 sudo 권한으로 터미널을 엽니다.

다음 명령어를 실행합니다.

sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh

설치가 완료될 때까지 기다립니다.
다음을 실행하여 설치를 확인합니다.
```
sudo systemctl status observiq-otel-collector
```
서비스 상태는 active (running)이어야 합니다.

추가 설치 리소스

추가 설치 옵션 및 문제 해결은 Bindplane 에이전트 설치 가이드를 참고하세요.

syslog를 수집하고 로그를 Google SecOps로 전송하도록 Bindplane 에이전트 구성

구성 파일 찾기

Linux:

sudo nano /etc/bindplane-agent/config.yaml

Windows:

notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

구성 파일 설정

config.yaml의 전체 내용을 다음 구성으로 바꿉니다.

receivers:
    udplog:
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/clamav:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: CLAM_AV
        raw_log_field: body
        ingestion_labels:
            env: production

service:
    pipelines:
        logs/clamav_to_chronicle:
            receivers:
                - udplog
            exporters:
                - chronicle/clamav

다음 자리표시자를 바꿉니다.
- 수신기 구성:
  - listen_address: UDP 포트 514에서 모든 인터페이스를 수신하려면 0.0.0.0:514로 설정합니다. Linux에서 포트 514에 루트 권한이 필요한 경우 0.0.0.0:1514를 사용하고 포트 1514로 전달하도록 rsyslog를 구성합니다.
- 내보내기 도구 구성:
  - creds_file_path: 수집 인증 파일의 전체 경로입니다.
    - Linux: /etc/bindplane-agent/ingestion-auth.json
    - Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  - customer_id: YOUR_CUSTOMER_ID을 이전에 가져온 고객 ID로 바꿉니다.
  - endpoint: 리전 엔드포인트 URL:
    - 미국: malachiteingestion-pa.googleapis.com
    - 유럽: europe-malachiteingestion-pa.googleapis.com
    - 아시아: asia-southeast1-malachiteingestion-pa.googleapis.com
    - 전체 목록은 리전 엔드포인트를 참고하세요.
  - log_type: CLAM_AV (Google SecOps 파서의 일치검색)로 설정
  - ingestion_labels: YAML 형식의 선택적 라벨 (예: env: production)

구성 파일 저장

수정 후 파일을 저장합니다.

Linux: Ctrl+O, Enter, Ctrl+X 순서로 누릅니다.
Windows: 파일 > 저장을 클릭합니다.

변경사항을 적용하려면 Bindplane 에이전트를 다시 시작하세요.

Linux에서 Bindplane 에이전트를 다시 시작하려면 다음 단계를 따르세요.
1. 다음 명령어를 실행합니다.
```
sudo systemctl restart observiq-otel-collector
```
2. 서비스가 실행 중인지 확인합니다.
```
sudo systemctl status observiq-otel-collector
```
3. 로그에서 오류를 확인합니다.
```
sudo journalctl -u observiq-otel-collector -f
```
Windows에서 Bindplane 에이전트를 다시 시작하려면 다음 단계를 따르세요.
1. 다음 옵션 중 하나를 선택합니다.
  - 관리자 권한으로 명령 프롬프트 또는 PowerShell:
```
net stop observiq-otel-collector && net start observiq-otel-collector
```
  - 서비스 콘솔:
    1. Win+R 키를 누르고 services.msc을 입력한 다음 Enter 키를 누릅니다.
    2. observIQ OpenTelemetry Collector를 찾습니다.
    3. 마우스 오른쪽 버튼을 클릭하고 다시 시작을 선택합니다.
2. 서비스가 실행 중인지 확인합니다.
```
sc query observiq-otel-collector
```
3. 로그에서 오류를 확인합니다.
```
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
```

ClamAV syslog 전달 구성

ClamAV에서 syslog 로깅 사용 설정

루트 또는 sudo 권한으로 ClamAV를 실행하는 Linux 시스템에 로그인합니다.
ClamAV 데몬 구성 파일을 엽니다.
```
sudo nano /etc/clamav/clamd.conf
```
참고: 구성 파일 위치는 배포에 따라 다를 수 있습니다. 일반적인 위치로는 /etc/clamav/clamd.conf, /etc/clamd.conf, /usr/local/etc/clamd.conf가 있습니다.
#LogSyslog yes 또는 #LogSyslog true이라고 쓰여 있는 코드 줄을 찾습니다.
syslog 로깅을 사용 설정하려면 # 주석 문자를 삭제합니다.
```
LogSyslog yes
```
선택사항: syslog 기능을 구성합니다. #LogFacility LOG_LOCAL6 줄을 찾아 주석 처리를 삭제합니다.
```
LogFacility LOG_LOCAL6
```
참고: 기본 시설은 LOG_LOCAL6입니다. 필요한 경우 LOG_LOCAL0~LOG_LOCAL7과 같은 다른 기능으로 변경할 수 있습니다.
선택사항: 더 자세한 로그를 위해 추가 로깅 옵션을 사용 설정합니다.
```
LogTime yes
LogVerbose yes
ExtendedDetectionInfo yes
```
- LogTime: 로그 메시지에 타임스탬프 추가
- LogVerbose: 추가 세부정보와 함께 상세 로깅을 사용 설정합니다.
- ExtendedDetectionInfo: 바이러스 감지와 함께 파일 크기 및 해시를 포함합니다.
파일을 저장하고 종료합니다.

Ctrl+O, Enter, Ctrl+X 순서로 누릅니다.
ClamAV 데몬을 다시 시작하여 변경사항을 적용합니다.
```
sudo systemctl restart clamav-daemon
```
참고: 서비스 이름은 배포에 따라 다를 수 있습니다. 위 명령어가 실패하면 clamav-daemon, clamd 또는 clamd@scan를 사용해 보세요.
ClamAV 데몬이 실행 중인지 확인합니다.
```
sudo systemctl status clamav-daemon
```

ClamAV 로그를 전달하도록 rsyslog 구성

ClamAV 전달을 위한 새 rsyslog 구성 파일을 만듭니다.
```
sudo nano /etc/rsyslog.d/30-clamav-forward.conf
```
참고: 파일 이름은 기본 rsyslog 구성 후 기본 규칙 전에 로드되도록 30-로 시작합니다.

ClamAV 로그를 Bindplane 에이전트로 전달하는 다음 구성을 추가합니다.

# Forward ClamAV logs (LOG_LOCAL6 facility) to Bindplane agent
if $syslogfacility-text == 'local6' then {
    action(
        type="omfwd"
        protocol="udp"
        target="BINDPLANE_AGENT_IP"
        port="514"
        queue.type="linkedList"
        queue.size="10000"
        action.resumeRetryCount="100"
    )
    stop
}

BINDPLANE_AGENT_IP를 Bindplane 에이전트 호스트의 IP 주소로 바꿉니다.
- Bindplane이 ClamAV와 동일한 호스트에 설치된 경우 127.0.0.1를 사용합니다.
- Bindplane이 다른 호스트에 있는 경우 해당 호스트의 IP 주소를 사용합니다 (예: 192.168.1.100).
다른 포트 (예: 1514)에서 리슨하도록 Bindplane을 구성한 경우 port 매개변수를 적절하게 업데이트합니다.
파일을 저장하고 종료합니다.

Ctrl+O, Enter, Ctrl+X 순서로 누릅니다.
rsyslog 구성 구문을 검증합니다.
```
sudo rsyslogd -N1
```
참고: 이 명령어는 구문 오류를 확인합니다. 오류가 없으면 rsyslogd: version X, config validation run (level 1), master config /etc/rsyslog.conf가 표시됩니다.
rsyslog를 다시 시작하여 변경사항을 적용합니다.
```
sudo systemctl restart rsyslog
```
rsyslog가 실행 중인지 확인합니다.
```
sudo systemctl status rsyslog
```

구성 테스트

EICAR 테스트 파일을 사용하여 테스트 바이러스 감지를 생성합니다.

cd /tmp
echo 'X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*' > eicar.com

ClamAV로 테스트 파일을 스캔합니다.
```
sudo clamdscan /tmp/eicar.com
```

감지가 syslog에 표시되는지 확인합니다.

sudo tail -f /var/log/syslog | grep clamd

다음과 비슷한 로그 항목이 표시됩니다.

Jan 15 10:30:45 hostname clamd[1234]: /tmp/eicar.com: Win.Test.EICAR_HDB-1(44d88612fea8a8f36de82e1278abb02f:68) FOUND

Bindplane 에이전트 로그를 확인하여 로그가 전달되고 있는지 확인합니다.
```
sudo journalctl -u observiq-otel-collector -f
```
로그가 Google SecOps에 표시되는지 확인합니다.
1. Google SecOps 콘솔에 로그인합니다.
2. 검색 > UDM 검색으로 이동합니다.
3. ClamAV 로그에 대한 검색어를 실행합니다.
```
metadata.log_type = "CLAM_AV"
```
테스트 파일을 정리합니다.
```
sudo rm /tmp/eicar.com
```

대체 구성: 모든 syslog 메시지를 Bindplane으로 전달

ClamAV뿐만 아니라 모든 syslog 메시지를 Bindplane으로 전달하려면 다음의 더 간단한 구성을 사용하세요.

rsyslog 구성을 수정합니다.

sudo nano /etc/rsyslog.d/30-forward-all.conf

다음 구성을 추가합니다.

# Forward all logs to Bindplane agent
*.* action(
    type="omfwd"
    protocol="udp"
    target="BINDPLANE_AGENT_IP"
    port="514"
    queue.type="linkedList"
    queue.size="10000"
    action.resumeRetryCount="100"
)

BINDPLANE_AGENT_IP을 적절한 IP 주소로 바꿉니다.
이전 단계에 설명된 대로 rsyslog를 저장하고, 검증하고, 다시 시작합니다.

참고: 이 구성은 ClamAV 로그뿐만 아니라 모든 syslog 메시지를 Bindplane으로 전달합니다. 다른 로그 소스에 대해 추가 Bindplane 파이프라인과 Google SecOps 파서를 구성해야 할 수 있습니다.

UDM 매핑 테이블

로그 필드	UDM 매핑	논리
parsed_msg.resource.labels.instance_id	observer.resource.id	값이 직접 복사됨
parsed_msg.labels.compute.googleapis.com/resource_name	observer.resource.name	값이 직접 복사됨
parsed_msg.resource.type, parsed_msg.labels.container.googleapis.com/stream	observer.resource.type	parsed_msg.resource.type과 parsed_msg.labels.container.googleapis.com/stream을 '/' 구분자로 연결
parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name, parsed_msg.resource.labels.container_name	observer.hostname	parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name, parsed_msg.resource.labels.container_name을 '/' 구분자로 연결한 값
parsed_msg.resource.labels.container_name	observer.application	값이 직접 복사됨
parsed_msg.labels.container.googleapis.com/namespace_name	observer.namespace	값이 직접 복사됨
parsed_msg.resource.labels.zone	observer.location.country_or_region	값이 직접 복사됨
parsed_msg.resource.labels.pod_id	observer.labels	parsed_msg.resource.labels.pod_id의 값과 함께 'pod_id' 키로 병합됨
parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name, parsed_msg.resource.labels.container_name	principal.hostname	parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name, parsed_msg.resource.labels.container_name을 '/' 구분자로 연결한 값
file, _file_path	target.file.full_path	grok 패턴에서 추출된 경우 파일의 값, 대체 grok 패턴에서 추출된 경우 _file_path의 값
위협	security_result.threat_name	값이 직접 복사됨
total_files, _outcome, threat	security_result.summary	추출된 파일 수가 있는 경우 '%{total_files}개의 감염된 파일을 찾았습니다.'로 설정하고, 그렇지 않으면 '파일을 검사했습니다. (%{_outcome})'(_outcome이 추출된 경우) 또는 '위협 %{threat} 서명이 발견되었습니다.'(위협이 비어 있지 않은 경우)
카테고리	security_result.category	직접 복사된 값 (위협이 비어 있지 않으면 'SOFTWARE_MALICIOUS'로 설정됨)
action	security_result.action	직접 복사된 값 (위협이 비어 있지 않으면 'BLOCK'으로 설정되고, 그렇지 않고 _outcome이 추출된 경우 'ALLOW'로 설정됨)
parsed_msg.insertId	metadata.product_log_id	값이 직접 복사됨
parsed_msg.logName	metadata.description	값이 직접 복사됨
	metadata.event_type	위협이 발견되거나 파일이 검사된 경우 'SCAN_FILE'로 설정하고, 감염된 파일 수가 추출된 경우 'STATUS_UPDATE'로 설정합니다.
	metadata.product_name	'CLAMAV'로 설정
	metadata.vendor_name	'Cisco Systems'로 설정

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.