Vectra Detect 로그 수집
이 문서에서는 Bindplane을 사용하여 Vectra Detect 로그를 Google Security Operations로 수집하는 방법을 설명합니다. 파서는 SYSLOG, JSON, CEF 형식의 로그를 통합 데이터 모델 (UDM)로 변환합니다. 먼저 불필요한 문자 및 필드를 삭제하여 데이터를 정규화한 다음 grok 패턴을 사용하여 다양한 로그 형식에서 정보를 추출하고 마지막으로 추출된 필드를 해당 UDM 속성에 매핑합니다.
시작하기 전에
다음 기본 요건이 충족되었는지 확인합니다.
- Google SecOps 인스턴스
systemd이 설치된 Windows 2016 이상 또는 Linux 호스트- 프록시 뒤에서 실행하는 경우 BindPlane 에이전트 요구사항에 따라 방화벽 포트가 열려 있는지 확인합니다.
- Vectra UI에 대한 액세스 권한 관리
Google SecOps 수집 인증 파일 가져오기
- Google SecOps 콘솔에 로그인합니다.
- SIEM 설정 > 수집 에이전트로 이동합니다.
- 수집 인증 파일을 다운로드합니다. Bindplane이 설치될 시스템에 파일을 안전하게 저장합니다.
Google SecOps 고객 ID 가져오기
- Google SecOps 콘솔에 로그인합니다.
- SIEM 설정 > 프로필로 이동합니다.
- 조직 세부정보 섹션에서 고객 ID를 복사하여 저장합니다.
Bindplane 에이전트 설치
다음 안내에 따라 Windows 또는 Linux 운영체제에 Bindplane 에이전트를 설치합니다.
Windows 설치
- 명령 프롬프트 또는 PowerShell을 관리자로 엽니다.
다음 명령어를 실행합니다.
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Linux 설치
- 루트 또는 sudo 권한으로 터미널을 엽니다.
다음 명령어를 실행합니다.
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
추가 설치 리소스
- 추가 설치 옵션은 이 설치 가이드를 참고하세요.
Syslog를 수집하여 Google SecOps로 전송하도록 Bindplane 에이전트 구성
구성 파일에 액세스합니다.
config.yaml파일을 찾습니다. 일반적으로 Linux에서는/etc/bindplane-agent/디렉터리에 있고 Windows에서는 설치 디렉터리에 있습니다.- 텍스트 편집기 (예:
nano,vi, 메모장)를 사용하여 파일을 엽니다.
다음과 같이
config.yaml파일을 수정합니다.receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <CUSTOMER_ID> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization log_type: 'VECTRA_DETECT' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels- 인프라에 필요한 대로 포트와 IP 주소를 바꿉니다.
<CUSTOMER_ID>를 실제 고객 ID로 바꿉니다.- Google SecOps 수집 인증 파일 가져오기 섹션에서 인증 파일이 저장된 경로로
/path/to/ingestion-authentication-file.json를 업데이트합니다.
Bindplane 에이전트를 다시 시작하여 변경사항 적용
Linux에서 Bindplane 에이전트를 다시 시작하려면 다음 명령어를 실행합니다.
sudo systemctl restart bindplane-agentWindows에서 Bindplane 에이전트를 다시 시작하려면 서비스 콘솔을 사용하거나 다음 명령어를 입력하면 됩니다.
net stop BindPlaneAgent && net start BindPlaneAgent
Syslog를 전송하도록 Vectra Detect 구성
- Vectra Detect UI에 로그인합니다.
- 설정 > 알림으로 이동합니다.
- Syslog 섹션으로 이동합니다.
- 수정을 클릭하여 Syslog 구성을 추가하거나 수정합니다.
- 대상: Bindplane 에이전트 IP 주소를 입력합니다.
- 포트: Bindplane 에이전트 포트 번호를 입력합니다.
- 프로토콜: 실제 Bindplane 에이전트 구성에 따라 UDP 또는 TCP를 선택합니다.
- 형식: JSON을 선택합니다.
- 로그 유형: Google SecOps로 전송할 로그를 선택합니다.
- Include Enhanced Details(향상된 세부정보 포함) 체크박스를 선택합니다.
- 오른쪽에는 추가 구성을 위한 세 개의 스위치 버튼이 표시됩니다.
- 선별된 감지 포함: 사용 중지하면 선별된 감지가 생성되거나 업데이트될 때 syslog 메시지가 전송되지 않습니다.
- 정보 카테고리에 감지 포함: 사용 중지하면 정보 카테고리의 감지가 생성되거나 업데이트될 때 syslog 메시지가 전송되지 않습니다.
- 호스트/계정 점수 감소 포함: 이 옵션을 사용 중지하면 위협 점수와 확실성 점수가 모두 감소하거나 동일하게 유지될 때 syslog 메시지가 전송되지 않습니다.
- 저장을 클릭합니다.
- 테스트를 클릭하여 구성을 테스트합니다.
UDM 매핑 테이블
| 로그 필드 | UDM 매핑 | 논리 |
|---|---|---|
| action | read_only_udm.security_result.action | 감사 이벤트에서 [result] 가 'true' 또는 'failure'인 경우 'action' 필드에서 가져온 값입니다. |
| 카테고리 | read_only_udm.security_result.category_details | 'category' 필드에서 가져온 값입니다. |
| 확실성 | read_only_udm.security_result.confidence | [확실성] 이 0~35인 경우 'LOW_CONFIDENCE'로 설정합니다. [확실성] 이 35~70인 경우 'MEDIUM_CONFIDENCE'로 설정합니다. [확실성] 이 70~100인 경우 'HIGH_CONFIDENCE'로 설정합니다. |
| dd_bytes_rcvd | read_only_udm.network.received_bytes | 'dd_bytes_rcvd' 필드에서 가져온 값입니다. |
| dd_bytes_sent | read_only_udm.network.sent_bytes | 'dd_bytes_sent' 필드에서 가져온 값입니다. |
| dd_dst_dns | read_only_udm.target.hostname | 'dd_dst_dns' 필드에서 가져온 값입니다. |
| dd_dst_dns | read_only_udm.target.asset.hostname | 'dd_dst_dns' 필드에서 가져온 값입니다. |
| dd_dst_ip | read_only_udm.target.asset.ip | 'dd_dst_ip' 필드에서 가져온 값입니다. |
| dd_dst_ip | read_only_udm.target.ip | 'dd_dst_ip' 필드에서 가져온 값입니다. |
| dd_dst_port | read_only_udm.target.port | 'dd_dst_port' 필드에서 가져온 값입니다. |
| detection_id | read_only_udm.metadata.product_log_id | 'detection_id' 필드에서 가져온 값입니다. |
| detection_profile.name | read_only_udm.security_result.detection_fields | 키는 'detection_profile name'이고 값은 'detection_profile.name' 필드에서 가져옵니다. |
| detection_profile.scoringDetections | read_only_udm.security_result.detection_fields | 키는 'detectionprofile scoringDetections{index}'이고 값은 'detection_profile.scoringDetections' 배열의 각 요소에서 가져옵니다. |
| detection_profile.vname | read_only_udm.security_result.detection_fields | 키는 'detection_profile vname'이고 값은 'detection_profile.vname' 필드에서 가져옵니다. |
| dest_ip | read_only_udm.target.asset.ip | 캠페인 이벤트의 'dest_ip' 필드에서 가져온 값입니다. |
| dest_ip | read_only_udm.target.ip | 캠페인 이벤트의 'dest_ip' 필드에서 가져온 값입니다. |
| dest_name | read_only_udm.target.asset.hostname | 캠페인 이벤트의 'dest_name' 필드에서 가져온 값입니다. |
| dest_name | read_only_udm.target.hostname | 캠페인 이벤트의 'dest_name' 필드에서 가져온 값입니다. |
| d_type | read_only_udm.additional.fields | 키는 'd_type'이고 값은 'd_type' 필드에서 가져옵니다. |
| d_type_vname | read_only_udm.additional.fields | 키는 'd_type_vname'이고 값은 'd_type_vname' 필드에서 가져옵니다. |
| dvchost | read_only_udm.observer.hostname | 'dvchost' 필드에서 가져온 값입니다. |
| dvchost | read_only_udm.principal.asset.hostname | [host_name] 이 호스트 이벤트에서 비어 있는 경우 'dvchost' 필드에서 가져온 값입니다. |
| dvchost | read_only_udm.principal.hostname | [host_name] 이 호스트 이벤트에서 비어 있는 경우 'dvchost' 필드에서 가져온 값입니다. |
| headend_addr | read_only_udm.observer.ip | 'headend_addr' 필드에서 가져온 값입니다. |
| headend_addr | read_only_udm.principal.asset.ip | [host_ip] 가 감지 이벤트에서 비어 있는 경우 'headend_addr' 필드에서 가져온 값입니다. |
| headend_addr | read_only_udm.principal.ip | [host_ip] 가 감지 이벤트에서 비어 있는 경우 'headend_addr' 필드에서 가져온 값입니다. |
| href | read_only_udm.target.url | 'href' 필드에서 가져온 값입니다. |
| host_id | read_only_udm.target.asset_id | 값은 호스트 이벤트에서 'VectraAI.DETECT:{host_id}'입니다. |
| host_ip | read_only_udm.principal.asset.ip | HOST 및 감지 이벤트의 'host_ip' 필드에서 가져온 값입니다. |
| host_ip | read_only_udm.principal.ip | HOST 및 감지 이벤트의 'host_ip' 필드에서 가져온 값입니다. |
| host_name | read_only_udm.principal.asset.hostname | 'host_name' 필드에서 가져온 값입니다. |
| host_name | read_only_udm.principal.hostname | 'host_name' 필드에서 가져온 값입니다. |
| msg_data | read_only_udm.security_result.summary | 감사 및 상태 이벤트의 'msg_data' 필드에서 가져온 값입니다. |
| 사분면 | read_only_udm.security_result.priority_details | 'quadrant' 필드에서 가져온 값입니다. |
| 결과 | read_only_udm.security_result.action | [결과] 가 'true'인 경우 'ALLOW'로 설정합니다. [result] 가 'failure'인 경우 감사 이벤트에서 'BLOCK'으로 설정합니다. |
| 결과 | read_only_udm.security_result.detection_fields | 키는 'result'이고 값은 감사 및 상태 이벤트의 'result' 필드에서 가져옵니다. |
| 역할 | read_only_udm.target.user.attribute.roles.name | 감사 이벤트의 'role' 필드에서 가져온 값입니다. |
| 줄이는 것을 | read_only_udm.security_result.severity | [위협] 이 0~20인 경우 '정보'로 설정합니다. [위협] 이 20~40이면 'LOW'로 설정합니다. [위협] 이 40~60인 경우 'MEDIUM'으로 설정합니다. [위협] 이 60~80인 경우 '높음'으로 설정합니다. [위협] 이 80~100인 경우 '심각'으로 설정합니다. |
| 줄이는 것을 | read_only_udm.security_result.severity_details | 'severity' 필드에서 가져온 값입니다. |
| source_ip | read_only_udm.principal.asset.ip | 감사 및 상태 이벤트의 'source_ip' 필드에서 가져온 값입니다. |
| source_ip | read_only_udm.principal.ip | 감사 및 상태 이벤트의 'source_ip' 필드에서 가져온 값입니다. |
| src | read_only_udm.principal.asset.ip | CEF 이벤트의 'src' 필드에서 가져온 값입니다. |
| src | read_only_udm.principal.ip | CEF 이벤트의 'src' 필드에서 가져온 값입니다. |
| src_ip | read_only_udm.principal.asset.ip | 캠페인 이벤트의 'src_ip' 필드에서 가져온 값입니다. |
| src_ip | read_only_udm.principal.ip | 캠페인 이벤트의 'src_ip' 필드에서 가져온 값입니다. |
| src_name | read_only_udm.principal.asset.hostname | [host_name] 및 [dvchost] 가 비어 있는 경우 'src_name' 필드에서 가져온 값입니다. |
| src_name | read_only_udm.principal.hostname | [host_name] 및 [dvchost] 가 비어 있는 경우 'src_name' 필드에서 가져온 값입니다. |
| 위협 | read_only_udm.security_result.severity | [위협] 이 0~20인 경우 '정보'로 설정합니다. [위협] 이 20~40이면 'LOW'로 설정합니다. [위협] 이 40~60인 경우 'MEDIUM'으로 설정합니다. [위협] 이 60~80인 경우 '높음'으로 설정합니다. [위협] 이 80~100인 경우 '심각'으로 설정합니다. |
| 분류됨 | read_only_udm.additional.fields | 키는 'triaged'이고 값은 'triaged' 필드에서 가져옵니다. |
| 유형 | read_only_udm.metadata.product_event_type | 건강 이벤트의 'type' 필드에서 가져온 값입니다. |
| 사용자 | read_only_udm.target.user.userid | 감사 이벤트의 'user' 필드에서 가져온 값입니다. |
| vectra_timestamp | read_only_udm.metadata.event_timestamp | 'vectra_timestamp' 필드에서 가져온 값입니다. |
| version | read_only_udm.metadata.product_version | 'version' 필드에서 가져온 값입니다. |
| read_only_udm.metadata.event_type | 감사 이벤트에서 [msg_data] 에 '로그인'이 포함되고 [user] 가 비어 있지 않은 경우 'USER_LOGIN'으로 설정됩니다. | |
| read_only_udm.metadata.event_type | 호스트 이벤트에서 'SCAN_HOST'로 설정합니다. | |
| read_only_udm.metadata.event_type | [host_ip] 가 비어 있지 않고 [principal_present] 가 true이며 [target_present] 가 감지 이벤트에서 true인 경우 'NETWORK_HTTP'로 설정됩니다. | |
| read_only_udm.metadata.event_type | [principal_present] 가 감지 활동에서 true인 경우 'STATUS_UPDATE'로 설정됩니다. | |
| read_only_udm.metadata.event_type | 감지 이벤트에서 [principal_present] 가 true이고 [target_present] 가 true인 경우 'NETWORK_CONNECTION'으로 설정됩니다. | |
| read_only_udm.metadata.event_type | [event_type] 이 'GENERIC_EVENT'이고 [principal_present] 가 true이며 [target_present] 가 true인 경우 'NETWORK_CONNECTION'으로 설정됩니다. | |
| read_only_udm.metadata.event_type | [event_type] 이 'GENERIC_EVENT'이고 [principal_present] 가 true인 경우 'STATUS_UPDATE'로 설정됩니다. | |
| read_only_udm.metadata.log_type | 'VECTRA_DETECT'로 설정합니다. | |
| read_only_udm.metadata.vendor_name | 'Vectra.AI'로 설정합니다. | |
| read_only_udm.metadata.product_name | 'DETECT'로 설정합니다. | |
| read_only_udm.network.application_protocol | [dd_dst_port] 가 80인 경우 'HTTP'로 설정합니다. | |
| read_only_udm.network.application_protocol | [dd_dst_port] 가 443인 경우 'HTTPS'로 설정됩니다. | |
| read_only_udm.network.application_protocol | 감지 이벤트에서 [principal_present] 가 true이고 [target_present] 가 true인 경우 'UNKNOWN_APPLICATION_PROTOCOL'로 설정됩니다. | |
| read_only_udm.network.http.method | 'METHOD_OTHER'로 설정합니다. | |
| read_only_udm.extensions.auth.type | [msg_data] 에 감사 이벤트의 '로그인'이 포함된 경우 'AUTHTYPE_UNSPECIFIED'로 설정됩니다. | |
| is_alert | [triaged] 가 true인 경우 'true'로 설정됩니다. |
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.