STIX 위협 인텔리전스 로그 수집
이 문서에서는 Bindplane 에이전트를 사용하여 STIX 위협 인텔리전스 로그를 Google Security Operations로 수집하는 방법을 설명합니다.
STIX (Structured Threat Information Expression)는 조직 간에 침해 지표 (IOC)와 위협 인텔리전스 데이터를 공유하기 위한 표준화된 언어 및 형식입니다. STIX 데이터는 일반적으로 TAXII 서버 또는 위협 인텔리전스 플랫폼에서 JSON 또는 XML 파일로 수신됩니다. Bindplane 에이전트는 로컬 파일 시스템에서 직접 STIX 데이터 파일을 수집합니다.
시작하기 전에
다음 기본 요건이 충족되었는지 확인합니다.
- Google SecOps 인스턴스
- Windows Server 2016 이상 또는
systemd가 설치된 Linux 호스트 - 프록시 뒤에서 실행하는 경우 Bindplane 에이전트 요구사항에 따라 방화벽 포트가 열려 있는지 확인합니다.
- STIX 형식 파일 (JSON 또는 XML)을 로컬 디렉터리에 저장하는 TAXII 클라이언트 또는 위협 인텔리전스 플랫폼
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설치가 완료될 때까지 기다립니다.
다음을 실행하여 설치를 확인합니다.
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서비스가 활성 (실행 중)으로 표시되어야 합니다.
추가 설치 리소스
추가 설치 옵션 및 문제 해결은 Bindplane 에이전트 설치 가이드를 참고하세요.
로그를 수집하여 Google SecOps로 전송하도록 Bindplane 에이전트 구성
구성 파일 찾기
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
구성 파일 설정
config.yaml의 전체 콘텐츠를 다음 구성으로 바꿉니다.receivers: filelog: include: - /var/log/stix/*.json start_at: beginning exporters: chronicle/stix: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: STIX raw_log_field: body ingestion_labels: env: production service: pipelines: logs/stix_to_chronicle: receivers: - filelog exporters: - chronicle/stix
구성 매개변수
다음 자리표시자를 바꿉니다.
수신기 구성:
filelog: 디스크에서 로그 파일을 수집하는 수신기 유형include: 모니터링할 파일 경로 목록입니다. STIX 파일이 저장된 디렉터리로 설정합니다.- Linux:
/var/log/stix/*.json - Windows:
C:\Logs\stix\*.json
- Linux:
start_at: 기존 로그를 읽으려면beginning로 설정하고 새 항목만 읽으려면end로 설정합니다.
내보내기 도구 구성:
stix: 내보내기 도구의 설명 이름creds_file_path: 수집 인증 파일의 전체 경로입니다.- Linux:
/etc/bindplane-agent/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
<customer_id>: 이전 단계의 고객 IDendpoint: 지역 엔드포인트 URL:- 미국:
malachiteingestion-pa.googleapis.com - 유럽:
europe-malachiteingestion-pa.googleapis.com - 아시아:
asia-southeast1-malachiteingestion-pa.googleapis.com - 전체 목록은 리전 엔드포인트를 참고하세요.
- 미국:
STIX: Chronicle에 표시되는 로그 유형ingestion_labels: YAML 형식의 선택적 라벨 (예:env: production)
파이프라인 구성:
stix_to_chronicle: 파이프라인의 설명 이름
구성 파일 저장
- 수정 후 파일을 저장합니다.
- Linux:
Ctrl+O,Enter,Ctrl+X순으로 누릅니다. - Windows: 파일 > 저장을 클릭합니다.
- Linux:
변경사항을 적용하려면 Bindplane 에이전트를 다시 시작하세요.
Linux에서 Bindplane 에이전트를 다시 시작하려면 다음 명령어를 실행합니다.
sudo systemctl restart observiq-otel-collector서비스가 실행 중인지 확인합니다.
sudo systemctl status observiq-otel-collector로그에서 오류를 확인합니다.
sudo journalctl -u observiq-otel-collector -f
Windows에서 Bindplane 에이전트를 다시 시작하려면 다음 옵션 중 하나를 선택하세요.
관리자 권한으로 명령 프롬프트 또는 PowerShell:
net stop observiq-otel-collector && net start observiq-otel-collector서비스 콘솔:
Win+R키를 누르고services.msc를 입력한 다음 Enter 키를 누릅니다.- observIQ OpenTelemetry Collector를 찾습니다.
- 마우스 오른쪽 버튼을 클릭하고 다시 시작을 선택합니다.
서비스가 실행 중인지 확인합니다.
sc query observiq-otel-collector로그에서 오류를 확인합니다.
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
STIX 데이터 파일 수집 구성
STIX는 제품이 아닌 데이터 형식입니다. STIX 위협 인텔리전스 데이터는 일반적으로 TAXII 클라이언트, 위협 인텔리전스 플랫폼 또는 수동 다운로드에서 JSON 또는 XML 파일로 수신됩니다. 이러한 파일이 Bindplane 에이전트가 모니터링하는 디렉터리에 배치되어야 합니다.
Linux
STIX 데이터 파일을 저장할 디렉터리를 만듭니다.
sudo mkdir -p /var/log/stixTAXII 클라이언트 또는 위협 인텔리전스 플랫폼이 STIX 파일을
/var/log/stix/에 저장하도록 구성합니다.Bindplane 에이전트 서비스 계정에 디렉터리에 대한 읽기 액세스 권한이 있는지 확인합니다.
sudo chmod 755 /var/log/stix
Windows
STIX 데이터 파일을 저장할 디렉터리를 만듭니다.
mkdir C:\Logs\stixTAXII 클라이언트 또는 위협 인텔리전스 플랫폼이 STIX 파일을 `C:\Logs\stix`에 저장하도록 구성합니다.
다음과 일치하도록
config.yaml에서 Bindplane 에이전트include경로를 업데이트합니다.include: - C:\Logs\stix\*.json
UDM 매핑 테이블
| 로그 필드 | UDM 매핑 | 로직 |
|---|---|---|
| entity.administrative_domain | 'TEST'로 설정 | |
| assetid_value | entity.asset.asset_id | 비어 있지 않은 경우 assetid_value의 값 |
| condition_label, related_indicators_relationship_label, related_indicators_scope, indicator_types_label, valid_start_time_label, controlled_structure_label, marking_structure_label | entity.asset.attribute.labels | 다양한 라벨에서 병합됨 |
| name | entity.file.full_path | 값이 직접 복사됨 |
| val, hash.simple_hash_value, MD5_val, hash_value | entity.file.md5 | md5 정규식과 일치하는 경우 val의 값, 그렇지 않고 유형이 MD5인 경우 hash.simple_hash_value, 그렇지 않고 MD5_val인 경우, 그렇지 않고 hash_value인 경우 |
| 값 | entity.file.names | 값이 직접 복사됨 |
| val, hash.simple_hash_value, sha1_val, hash_value | entity.file.sha1 | sha1 정규식과 일치하는 경우 val의 값, 그렇지 않고 유형이 SHA1인 경우 hash.simple_hash_value, 그렇지 않고 sha1_val, 그렇지 않고 hash_value |
| val, hash.simple_hash_value, sha256val, sha_value, sha_value | entity.file.sha256 | sha256 정규식과 일치하는 경우 val의 값, 유형이 SHA256인 경우 hash.simple_hash_value, 그렇지 않은 경우 sha256val, 그렇지 않은 경우 sha_value |
| observable.object.properties.value, dom, value, host, name, external_references.0.source_name | entity.hostname | 타입이 FQDN인 경우 observable.object.properties.value, 그렇지 않은 경우 grok의 dom, 그렇지 않은 경우 타입이 domain-name인 경우 value, 그렇지 않은 경우 host, 그렇지 않은 경우 main_observable_type이 domain/hostname인 경우 name, 그렇지 않은 경우 external_references.0.source_name |
| ip_val, ipval, ip, source_ip, value, src_ip | entity.ip | grok이 일치하는 경우 ip_val의 값, 그렇지 않고 카테고리가 ipv4-addr인 경우 ipval, 그렇지 않고 패턴 grok의 ip, 그렇지 않고 source_ip, 그렇지 않고 유형이 ipv4인 경우 값, 그렇지 않고 grok의 src_ip |
| source_port, src_port | entity.port | source_port 또는 src_port의 값 |
| indicator_label, extension_value1, extension_value2, extension_value3, extension_value4, revoked_value, spec_version_value, object_marking_ref_value, label_value | entity.resource.attribute.labels | 다양한 라벨에서 병합됨 |
| observable.object.properties.value, url_val, value, observable_properties_value | entity.url | 관찰 가능한 항목의 값(유형이 URL인 경우), grok의 url_val(그렇지 않은 경우), 값(유형이 url인 경우), observable_properties_value(비어 있지 않은 경우) |
| email_val, mail, value | entity.user.email_addresses | grok이 일치하는 경우 email_val의 값, 그렇지 않은 경우 grok의 메일, 유형이 email-addr인 경우 값 |
| 타임스탬프 | metadata.collected_timestamp | 날짜 일치 ISO8601/RFC 3339를 사용하여 변환됨 |
| title, description | metadata.description | 제목 또는 설명의 값 |
| entity_type | metadata.entity_type | 값이 직접 복사됨 |
| timestamp, valid_until | metadata.interval.end_time | 날짜 일치 ISO8601/RFC 3339를 사용하여 타임스탬프 또는 valid_until에서 변환됨 |
| timestamp, valid_from, created | metadata.interval.start_time | 날짜 일치 ISO8601/RFC 3339를 사용하여 타임스탬프, valid_from, created 또는 timestamp에서 변환됨 |
| id | metadata.product_entity_id | 값이 직접 복사됨 |
| 버전 | metadata.product_version | 값이 직접 복사됨 |
| threat_detail | metadata.threat | threat_detail에서 병합됨 |
| threat_detail_category | threat.category | 값이 직접 복사됨 |
| confidence_value, confidence, x_stix_confidence, x_ctix_confidence_score | threat.confidence_details | confidence_value의 값, 그렇지 않으면 no_value인 경우 신뢰도, 그렇지 않으면 x_stix_confidence, 그렇지 않으면 x_ctix_confidence_score |
| 값, 신뢰도, x_ctix_confidence_score | threat.confidence_score | 이름이 신뢰도 점수인 경우 값에서 가져온 값, 그렇지 않은 경우 신뢰도, 그렇지 않은 경우 x_ctix_confidence_score를 부동 소수점으로 변환 |
| property_label, sha512_value, observable_id, observable_object_id, keyword_label | threat.detection_fields | 다양한 라벨에서 병합됨 |
| 설명 | threat.description | 값이 직접 복사됨 |
| value, extensions.extension-definition--ea279b3e-5c71-4632-ac08-831c66a786ba.score | threat.risk_score | 이름이 Risk인 경우 값에서 가져온 값, 그렇지 않으면 확장 프로그램 점수(부동 소수점으로 변환됨) |
| metadata.product_name | 'STIX'로 설정 | |
| metadata.vendor_name | 'STIX'로 설정 | |
dom |
event.idm.entity.entity.hostname |
변경 로그에서 매핑됨 |
name |
event.idm.entity.entity.url |
변경 로그에서 매핑됨 |
valid_from |
event.idm.entity.entity.resource.attribute.labels |
변경 로그에서 매핑됨 |
valid_until |
event.idm.entity.entity.resource.attribute.labels |
변경 로그에서 매핑됨 |
pattern_version |
event.idm.entity.entity.resource.attribute.labels |
변경 로그에서 매핑됨 |
observable.object.properties.value.condition |
event.idm.entity.entity.asset.attribute.labels |
변경 로그에서 매핑됨 |
handling.controlled_structure |
event.idm.entity.entity.asset.attribute.labels |
변경 로그에서 매핑됨 |
handling.marking_structures.color |
event.idm.entity.entity.asset.attribute.labels |
변경 로그에서 매핑됨 |
related_indicators.related_indicators |
event.idm.entity.entity.asset.attribute.labels |
변경 로그에서 매핑됨 |
related_indicators.scope |
event.idm.entity.entity.asset.attribute.labels |
변경 로그에서 매핑됨 |
indicator_types |
event.idm.entity.entity.asset.attribute.labels |
변경 로그에서 매핑됨 |
valid_time_positions |
event.idm.entity.entity.asset.attribute.labels |
변경 로그에서 매핑됨 |
observable.object.properties.custom_properties |
event.idm.entity.metadata.threat.detection_fields |
변경 로그에서 매핑됨 |
observable.object.properties.value |
event.ioc.domain_and_ports.domain |
변경 로그에서 매핑됨 |
mitre-extension-definition.extension_type |
entity.resource.attribute.labels.value |
변경 로그에서 매핑됨 |
sco-extension-definition.extension_type |
entity.resource.attribute.labels.value |
변경 로그에서 매핑됨 |
x_ctix_confidence_score |
threat_detail.confidence_score |
변경 로그에서 매핑됨 |
modified |
timestamp |
변경 로그에서 매핑됨 |
valid_from |
entity_event.metadata.interval.start_time |
변경 로그에서 매핑됨 |
confidence |
threat_detail.confidence_score |
변경 로그에서 매핑됨 |
name |
entity.entity.file.full_path |
변경 로그에서 매핑됨 |
description |
threat_detail.description |
변경 로그에서 매핑됨 |
external_references.0.source_name |
entity_event.entity.hostname |
변경 로그에서 매핑됨 |
entity_type |
IP_ADDRESS |
변경 로그에서 매핑됨 |
entity_type |
USER |
변경 로그에서 매핑됨 |
entity_type |
FILE |
변경 로그에서 매핑됨 |
entity_type |
DOMAIN_NAME |
변경 로그에서 매핑됨 |
변경 로그
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.