ESET AV 로그 수집

파서 버전: 6.0

다음에서 지원:

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

ESET은 위협 감지, 방화벽 이벤트, HIPS 알림, 감사 작업에 대한 syslog 메시지를 생성하는 엔드포인트 보안 솔루션입니다. 파서는 JSON 형식의 syslog에서 키-값 쌍을 추출하여 통합 데이터 모델 (UDM)에 매핑합니다.

시작하기 전에

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

  • Google SecOps 인스턴스

  • Windows Server 2016 이상 또는 systemd가 설치된 Linux 호스트

  • Bindplane 에이전트와 ESET PROTECT 서버 간의 네트워크 연결

  • 프록시 뒤에서 실행하는 경우 Bindplane 에이전트 요구사항에 따라 방화벽 포트가 열려 있는지 확인합니다.

  • ESET PROTECT 콘솔 (온프레미스 또는 클라우드)에 대한 액세스 권한

Bindplane 에이전트의 Google SecOps 사용자 인증 정보 가져오기

Bindplane 에이전트를 Google SecOps에 인증하려면 다음 방법 중 하나를 선택하세요.

  • 새 배포: Chronicle API를 사용합니다 (옵션 1).
  • 기존 배포: 2027년 7월 20일에 수집 API가 지원 중단될 때까지 수집 인증 파일 (옵션 2)을 계속 사용합니다.
  1. Google Cloud 콘솔에 로그인하고 Google SecOps 인스턴스에 연결된 Google Cloud 프로젝트를 선택합니다.
  2. IAM 및 관리자 > 서비스 계정으로 이동합니다.
  3. 서비스 계정 만들기를 클릭합니다.
  4. 다음 구성 세부정보를 제공합니다.
    • 서비스 계정 이름: 계정 이름을 입력합니다 (예: bindplane-ingest).
    • 서비스 계정 설명: 설명을 입력합니다 (예: Bindplane agent log ingestion).
  5. 만들고 계속하기를 클릭합니다.
  6. 이 서비스 계정에 프로젝트에 대한 액세스 권한 부여 섹션에서 역할 선택을 클릭하고 Chronicle 편집자를 선택합니다.
  7. 계속을 클릭한 다음 완료를 클릭합니다.
  8. 만든 서비스 계정을 클릭한 다음 키 탭으로 이동합니다.
  9. 키 추가 > 새 키 만들기를 클릭합니다.
  10. JSON을 선택하고 만들기를 클릭합니다. 키 파일이 컴퓨터에 다운로드됩니다.
  11. 키 파일을 Bindplane 수집기 디렉터리 (Linux의 경우 /opt/observiq-otel-collector/ingestion-auth.json, Windows의 경우 C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json)에 ingestion-auth.json로 저장하거나 config.yaml의 creds_file_path을 저장된 경로와 일치하도록 업데이트합니다.
  12. IAM 및 관리자 > 설정으로 이동하여 프로젝트 번호를 복사합니다. 내보내기 도구 구성에 필요합니다.

옵션 2: 데이터 수집 인증 파일 다운로드 (기존)

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

Google SecOps 고객 ID 가져오기

  1. Google SecOps 콘솔에 로그인합니다.
  2. SIEM 설정 > 프로필로 이동합니다.

  3. 조직 세부정보 섹션에서 고객 ID를 복사하여 저장합니다.

Bindplane 에이전트 설치

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

Windows 설치

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

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

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

  3. 설치가 완료될 때까지 기다립니다.

  4. 다음을 실행하여 설치를 확인합니다.

    sc query observiq-otel-collector

    서비스가 실행 중으로 표시되어야 합니다.

Linux 설치

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

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

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

  3. 설치가 완료될 때까지 기다립니다.

  4. 다음을 실행하여 설치를 확인합니다.

    sudo systemctl status observiq-otel-collector

    서비스가 활성 (실행 중)으로 표시되어야 합니다.

추가 설치 리소스

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

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

구성 파일 찾기

  • Linux:

    sudo nano /opt/observiq-otel-collector/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/eset_av:
    protocol: https
    # Region of your instance, for example us, europe, asia-southeast1
    location: <LOCATION>
    # Project number of the Google Cloud project linked to the instance
    project: '<PROJECT_NUMBER>'
    compression: gzip
    creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
    customer_id: '<customer_id>'
    endpoint: chronicle.googleapis.com
    log_type: ESET_AV
    raw_log_field: body

service:
  pipelines:
    logs/eset_av_to_chronicle:
      receivers:
        - udplog
      exporters:
        - chronicle/eset_av

구성 매개변수

다음 자리표시자를 바꿉니다.

  • 수신자 구성:

    • listen_address: 리슨할 IP 주소 및 포트:
      • 0.0.0.0: 모든 인터페이스에서 수신 대기 (권장)
      • 포트 514은 표준 syslog 포트입니다 (Linux에서 루트 필요, 루트가 아닌 경우 1514 사용).

  • 내보내기 도구 구성:

    • creds_file_path: 서비스 계정 JSON 키 파일의 전체 경로 (옵션 1):
      • Linux: /opt/observiq-otel-collector/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: Google SecOps 콘솔에서 복사한 고객 ID
    • location: <LOCATION>을 Google SecOps 인스턴스의 리전 (예: us, europe, asia-southeast1)으로 바꿉니다. 내보내기 프로그램은 chronicle.googleapis.com에 이 값을 접두사로 추가합니다. 전체 목록은 리전 엔드포인트를 참조하세요.
    • project: <PROJECT_NUMBER>을 IAM 및 관리자 > 설정의 프로젝트 번호로 바꿉니다.
    • endpoint: chronicle.googleapis.com로 설정된 상태를 유지합니다.

기존 수집 API 내보내기 도구

  • 옵션 2의 데이터 수집 인증 파일을 사용하는 경우 exporters 블록을 다음으로 바꿉니다. creds_file_path을 수집 인증 파일의 경로로 설정하고 인스턴스가 미국 외부에 있는 경우 malachiteingestion-pa.googleapis.com을 리전 엔드포인트 (예: europe-malachiteingestion-pa.googleapis.com)로 바꿉니다.

    exporters:
  chronicle/eset_av:
    compression: gzip
    creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
    customer_id: '<customer_id>'
    endpoint: malachiteingestion-pa.googleapis.com
    log_type: ESET_AV
    raw_log_field: body

구성 파일 저장

  • 수정 후 파일을 저장합니다.
    • Linux: Ctrl+O, Enter, Ctrl+X를 차례로 누릅니다.
    • Windows: 파일 > 저장을 클릭합니다.

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

  • Linux에서 Bindplane 에이전트를 다시 시작하려면 다음 명령어를 실행합니다.

    sudo systemctl restart observiq-otel-collector

    1. 서비스가 실행 중인지 확인합니다.

      sudo systemctl status observiq-otel-collector

    2. 로그에서 오류를 확인합니다.

      sudo journalctl -u observiq-otel-collector -f

  • Windows에서 Bindplane 에이전트를 다시 시작하려면 다음 옵션 중 하나를 선택합니다.

    • 관리자 권한으로 명령 프롬프트 또는 PowerShell:

      net stop observiq-otel-collector && net start observiq-otel-collector

    • 서비스 콘솔:

      1. Win+R 키를 누르고 services.msc를 입력한 다음 Enter 키를 누릅니다.
      2. observIQ OpenTelemetry Collector를 찾습니다.
      3. 마우스 오른쪽 버튼으로 클릭하고 다시 시작을 선택합니다.

      4. 서비스가 실행 중인지 확인합니다.

        sc query observiq-otel-collector

      5. 로그에서 오류를 확인합니다.

        type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"

ESET PROTECT 온프레미스에서 syslog 구성

  1. ESET PROTECT 웹 콘솔에 로그인합니다.
  2. 더보기 > 설정 > 고급 설정 > 시스템로그 서버를 클릭합니다.
  3. Syslog 사용 설정 스위치를 전환하여 syslog를 사용 설정합니다.
  4. 다음 구성 세부정보를 제공합니다.
    • 호스트: Bindplane 에이전트 IP 주소를 입력합니다.
    • 포트: 514를 입력합니다.
    • 형식: Syslog를 선택합니다.
    • 전송: UDP를 선택합니다.
    • 트레이스 로그 상세 출력: 정보를 선택합니다.
    • 로그를 Syslog로 내보내기: 사용 설정으로 설정합니다.
    • 내보낸 로그 형식: JSON을 선택합니다.
  5. 저장을 클릭합니다.

ESET PROTECT Cloud에서 syslog 구성

  1. ESET PROTECT Cloud 콘솔에 로그인합니다.
  2. 더보기 > 설정 > 시스템로그 서버를 클릭합니다.
  3. Syslog 사용 설정 스위치를 전환하여 syslog를 사용 설정합니다.
  4. 다음 구성 세부정보를 제공합니다.
    • 페이로드 형식: JSON을 선택합니다.
    • 봉투 형식: Syslog를 선택합니다.
    • 최소 로그 수준: 정보를 선택합니다.
    • 로깅할 이벤트 유형: 모두를 선택합니다 (필요한 경우 특정 유형 선택).
    • 대상 IP: Bindplane 에이전트 IP 주소를 입력합니다.
    • 포트: 514를 입력합니다.
  5. 저장을 클릭합니다.

UDM 매핑 테이블

로그 필드 UDM 매핑 로직
계정 principal.administrative_domain grok 패턴 %{DATA:admin_domain}\\\\%{WORD:user_id}을 사용하여 account 필드에서 추출했습니다.
계정 principal.user.userid grok 패턴 %{DATA:admin_domain}\\\\%{WORD:user_id}을 사용하여 account 필드에서 추출됩니다.
action security_result.action action이 Block (대소문자를 구분하지 않음)이면 BLOCK로 설정합니다. action이 Start (대소문자 구분 안 함)이면 ALLOW로 설정합니다.
action_taken security_result.action_details action_taken 필드에서 직접 매핑됩니다.
computer_severity_score security_result.detection_fields 키가 computer_severity_score이고 값이 computer_severity_score 필드인 키-값 쌍이 생성됩니다. 이 쌍은 security_result.detection_fields 배열에 추가됩니다.
디테일 security_result.description detail 필드에서 직접 매핑됩니다.
도메인 principal.domain.name domain 필드에서 직접 매핑됩니다.
eialarmid security_result.detection_fields 키가 eialarmid이고 값이 eialarmid 필드인 키-값 쌍이 생성됩니다. 이 쌍은 security_result.detection_fields 배열에 추가됩니다.
eiconsolelink principal.url eiconsolelink 필드에서 직접 매핑됩니다.
이벤트 metadata.description event에서 event_desc로 이름이 변경되고 metadata.description에 매핑되었습니다.
event_type metadata.product_event_type event_type 필드에서 직접 매핑됩니다.
group_name principal.group.group_display_name group_name 필드에서 직접 매핑됩니다.
해시 principal.file.sha1 소문자로 변환됨 소문자 값이 SHA-1 정규식과 일치하는 경우 principal.file.sha1에 매핑됩니다.
해시 principal.resource.attribute.labels 키-값 쌍은 키 hash와 hash 필드의 값으로 생성됩니다. 이 쌍은 principal.resource.attribute.labels 배열에 추가됩니다.
호스트 이름 principal.asset.hostname hostname 필드에서 직접 매핑됩니다.
호스트 이름 principal.hostname hostname 필드에서 직접 매핑됩니다.
인바운드 network.direction true인 경우 INBOUND로 설정합니다. false인 경우 OUTBOUND로 설정합니다.
ipv4 target.asset.ip target_address가 비어 있으면 ipv4 필드에서 직접 매핑됩니다.
ipv4 target.ip target_address가 비어 있으면 ipv4 필드에서 직접 매핑됩니다.
json_data 다양한 필드를 추출하기 위해 JSON으로 파싱됩니다.
메시지 grok을 사용하여 타임스탬프, 호스트, json_data를 추출합니다.
need_restart additional.fields 키가 need_restart이고 값이 need_restart 필드 (문자열로 변환됨)인 키-값 쌍이 생성됩니다. 이 쌍은 additional.fields 배열에 추가됩니다.
os_name principal.platform Window 또는 window (대소문자 구분 안 함)가 포함된 경우 WINDOWS로 설정합니다. Linux 또는 linux (대소문자 구분 안 함)가 포함된 경우 LINUX로 설정합니다. Mac 또는 mac (대소문자 구분 안 함)가 포함된 경우 MAC로 설정합니다.
os_name principal.platform_version os_name 필드에서 직접 매핑됩니다.
process_name principal.process.file.full_path process_name 필드에서 직접 매핑됩니다. 비어 있으면 processname 값을 사용합니다.
processname principal.process.file.full_path process_name가 비어 있으면 process_name에 매핑됩니다.
프로토콜 network.ip_protocol 대문자로 변환됨 대문자 값이 알려진 프로토콜 (TCP, UDP, ICMP 등)과 일치하면 network.ip_protocol에 매핑됩니다.
결과 security_result.summary result 필드에서 직접 매핑됩니다.
rulename security_result.rule_name rulename 필드에서 직접 매핑됩니다.
scan_id security_result.detection_fields 키가 scan_id이고 값이 scan_id 필드인 키-값 쌍이 생성됩니다. 이 쌍은 security_result.detection_fields 배열에 추가됩니다.
scanner_id security_result.detection_fields 키가 scanner_id이고 값이 scanner_id 필드인 키-값 쌍이 생성됩니다. 이 쌍은 security_result.detection_fields 배열에 추가됩니다.
줄이는 것을 security_result.severity Warn 또는 warn (대소문자를 구분하지 않음)가 포함된 경우 HIGH로 설정합니다. Info 또는 info가 포함된 경우 (대소문자를 구분하지 않음) LOW로 설정합니다.
severity_score security_result.detection_fields 키가 severity_score이고 값이 severity_score 필드인 키-값 쌍이 생성됩니다. 이 쌍은 security_result.detection_fields 배열에 추가됩니다.
source_address principal.asset.ip source_address 필드에서 직접 매핑됩니다.
source_address principal.ip source_address 필드에서 직접 매핑됩니다.
source_port principal.port 문자열로 변환한 후 정수로 변환했습니다. principal.port에 매핑됩니다.
source_uuid metadata.product_log_id source_uuid 필드에서 직접 매핑됩니다.
대상 이름이 target1으로 변경되었습니다.
target_address target.asset.ip target_address 필드에서 직접 매핑됩니다.
target_address target.ip target_address 필드에서 직접 매핑됩니다.
target_port target.port 문자열로 변환된 후 정수로 변환됩니다. target.port에 매핑됩니다.
threat_handled security_result.detection_fields 키-값 쌍은 threat_handled 키와 threat_handled 필드의 값 (문자열로 변환됨)으로 생성됩니다. 이 쌍은 security_result.detection_fields 배열에 추가됩니다.
threat_name security_result.threat_name threat_name 필드에서 직접 매핑됩니다.
threat_type security_result.threat_id threat_type 필드에서 직접 매핑됩니다.
시간 metadata.event_timestamp metadata.event_timestamp를 채우는 데 사용됩니다.
사용자 이름 principal.user.userid user_id 및 user가 비어 있는 경우 username 필드에서 직접 매핑됩니다.
사용자 principal.user.userid user_id이 비어 있으면 user 필드에서 직접 매핑됩니다.
metadata.event_type source_address 및 target_address가 비어 있지 않으면 NETWORK_CONNECTION로 설정합니다. 그렇지 않고 has_user가 true이면 USER_UNCATEGORIZED로 설정합니다. has_principal가 true이면 STATUS_UPDATE로 설정합니다. 그렇지 않으면 GENERIC_EVENT로 설정합니다.
metadata.log_type ESET_AV로 설정합니다.
metadata.product_name ESET_AV로 설정합니다.
metadata.vendor_name ESET_AV로 설정합니다.
intermediary.hostname 이 필드의 값은 로그 메시지에서 추출된 host 필드에서 가져옵니다.
principal.user.userid account 필드가 비어 있지 않으면 파서는 grok 패턴을 사용하여 account 필드에서 사용자 ID를 추출합니다. 그렇지 않으면 user 필드가 비어 있지 않은지 확인하고 비어 있지 않으면 해당 값을 가져옵니다. account와 user가 모두 비어 있으면 username 필드가 비어 있지 않은지 확인하고 비어 있지 않으면 값을 가져옵니다.
timestamp event.idm.read_only_udm.metadata.collected_timestamp 변경 로그에서 매핑됨
event_id event.idm.read_only_udm.metadata.product_log_id 변경 로그에서 매핑됨
process_pid event.idm.read_only_udm.principal.process.pid 변경 로그에서 매핑됨
desc event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
occurred event.idm.read_only_udm.metadata.event_timestamp 변경 로그에서 매핑됨
threatHandled event.idm.read_only_udm.security_result.detection_fields 변경 로그에서 매핑됨
actionTaken event.idm.read_only_udm.security_result.action_details 변경 로그에서 매핑됨
threatName event.idm.read_only_udm.security_result.threat_name 변경 로그에서 매핑됨
threatType event.idm.read_only_udm.security_result.summary 변경 로그에서 매핑됨
target target.resource.attribute.labels 변경 로그에서 매핑됨
object_uri target.url 변경 로그에서 매핑됨
severity security_result.severity_details 변경 로그에서 매핑됨
threat_flags security_result.detection_fields 변경 로그에서 매핑됨
category security_result.category_details 변경 로그에서 매핑됨
object_type" and "engine_version principal.resource.attribute.labels 변경 로그에서 매핑됨
circumstances security_result.description 변경 로그에서 매핑됨
security_result_action BLOCK 변경 로그에서 매핑됨
security_result_action ALLOW 변경 로그에서 매핑됨
scan_id", "scanner_id", and "threat_handled security_result.detection_fields 변경 로그에서 매핑됨
group_name principal.group_display_name 변경 로그에서 매핑됨

변경 로그

이 파서의 변경 로그 보기

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