Check Point Harmony 로그 수집

파서 버전: 3.0

다음에서 지원:

이 문서에서는 Bindplane을 사용하여 Check Point Harmony Email and Collaboration (HEC) 로그를 Google Security Operations로 수집하는 방법을 설명합니다. 이 파서 코드는 Check Point Harmony syslog 메시지에서 키-값 쌍을 추출하여 통합 데이터 모델 (UDM)에 매핑합니다. 먼저 메시지 형식을 정규화한 다음 필드를 principal, target, network, security_result과 같은 UDM 카테고리에 반복적으로 파싱하고 매핑하여 보안 분석을 위한 데이터를 보강합니다.

시작하기 전에

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

  • Google SecOps 인스턴스
  • Windows 2016 이상 또는 systemd가 설치된 Linux 호스트
  • 프록시 뒤에서 실행하는 경우 방화벽 포트가 열려 있음
  • Check Point Harmony HEC (Infinity Portal)에 대한 권한 있는 액세스

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

  1. Google SecOps 콘솔에 로그인합니다.
  2. SIEM 설정 > 수집 에이전트로 이동합니다.
  3. 데이터 수집 인증 파일을 다운로드합니다. 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

Linux 설치

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

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

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

추가 설치 리소스

추가 설치 옵션은 설치 가이드를 참고하세요.

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

  1. 구성 파일에 액세스합니다.
    • config.yaml 파일을 찾습니다. 일반적으로 Linux에서는 /etc/bindplane-agent/ 디렉터리에 있고 Windows에서는 설치 디렉터리에 있습니다.
    • 텍스트 편집기 (예: nano, vi 또는 메모장)를 사용하여 파일을 엽니다.

  2. 다음과 같이 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: 'CHECKPOINT_HARMONY'
        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-agent

  • Windows에서 Bindplane 에이전트를 다시 시작하려면 서비스 콘솔을 사용하거나 다음 명령어를 입력하면 됩니다.

    net stop BindPlaneAgent && net start BindPlaneAgent

Check Point Harmony HEC용 Syslog 구성

  1. Infinity Portal > Harmony Email & Collaboration 웹 UI에 로그인합니다.
  2. 설정 > 모니터링 > SIEM으로 이동합니다.
  3. SIEM 서버 추가를 클릭합니다.
  4. 다음 구성 세부정보를 제공합니다.
    • 호스트: Bindplane 에이전트 IP 주소를 입력합니다.
    • 포트: Bindplane 에이전트 포트 번호를 입력합니다.
    • 프로토콜: UDP를 선택합니다.
    • (선택사항) 토큰: 로그에 선택적 태그를 입력합니다.
  5. 저장을 클릭합니다.

UDM 매핑 테이블

로그 필드 UDM 매핑 논리
action security_result.action_details 직접 매핑됩니다.
security_result.action action 필드의 값에 따라 ALLOW, BLOCK, ALLOW_WITH_MODIFICATION 또는 QUARANTINE에 매핑됩니다.
additional_info additional.fields.value.string_value 키 = additional_info로 직접 매핑됩니다.
analyzed_on security_result.detection_fields.value 키 = analyzed_on로 직접 매핑됩니다.
client_name additional.fields.value.string_value 키 = client_name로 직접 매핑됩니다.
client_version intermediary.platform_version 직접 매핑됩니다.
confidence_level security_result.detection_fields.value 키 = confidence_level로 직접 매핑됩니다.
security_result.confidence confidence_level 필드의 값에 따라 UNKNOWN_CONFIDENCE, LOW_CONFIDENCE, MEDIUM_CONFIDENCE 또는 HIGH_CONFIDENCE에 매핑됩니다.
설명 security_result.description 직접 매핑됩니다.
dst target.ip 직접 매핑됩니다.
dst_dns_name security_result.detection_fields.value 키 = dst_dns_name로 직접 매핑됩니다.
dst_machine_name security_result.detection_fields.value 키 = dst_machine_name로 직접 매핑됩니다.
target.asset.hostname 직접 매핑됩니다.
target.hostname 직접 매핑됩니다.
dst_user_dn security_result.detection_fields.value 키 = dst_user_dn로 직접 매핑됩니다.
dst_user_name target.user.userid 직접 매핑됩니다.
ep_rule_id security_result.rule_id rule_uid가 비어 있으면 직접 매핑됩니다.
오류 security_result.summary 직접 매핑됩니다.
event_type metadata.product_event_type 직접 매핑됩니다.
file_md5 target.process.file.md5 값이 유효한 MD5 해시이고 모두 0이 아닌 경우 직접 매핑됩니다.
target.file.md5 값이 유효한 MD5 해시이고 모두 0이 아닌 경우 직접 매핑됩니다.
file_name target.process.file.full_path 직접 매핑됩니다.
file_sha1 target.process.file.sha1 값이 유효한 SHA-1 해시이고 모두 0이 아닌 경우 직접 매핑됩니다.
target.file.sha1 값이 유효한 SHA-1 해시이고 모두 0이 아닌 경우 직접 매핑됩니다.
file_sha256 target.process.file.sha256 값이 유효한 SHA256 해시이고 모두 0이 아닌 경우 직접 매핑됩니다.
target.file.sha256 값이 유효한 SHA256 해시이고 모두 0이 아닌 경우 직접 매핑됩니다.
file_size target.file.size 직접 매핑됩니다.
file_type target.file.file_type file_type 필드의 값에 따라 FILE_TYPE_ZIP, FILE_TYPE_DOS_EXE, FILE_TYPE_PDF 또는 FILE_TYPE_XLSX에 매핑됩니다.
flags additional.fields.value.string_value 키 = flags로 직접 매핑됩니다.
fw_subproduct additional.fields.value.string_value 제품이 비어 있으면 key = fw_subproduct로 직접 매핑됩니다.
metadata.product_name 제품이 비어 있으면 직접 매핑됩니다.
host_type security_result.detection_fields.value 키 = host_type로 직접 매핑됩니다.
ifdir network.direction 대문자로 변환한 후 직접 매핑됩니다.
ifname security_result.detection_fields.value 키 = ifname로 직접 매핑됩니다.
installed_products security_result.detection_fields.value 키 = installed_products로 직접 매핑됩니다.
is_scanned security_result.detection_fields.value 키 = is_scanned로 직접 매핑됩니다.
layer_name security_result.detection_fields.value 키 = layer_name로 직접 매핑됩니다.
security_result.rule_set_display_name 직접 매핑됩니다.
layer_uuid security_result.detection_fields.value 키 = layer_uuid로 직접 매핑됩니다.
security_result.rule_set 직접 매핑됩니다.
loguid metadata.product_log_id 직접 매핑됩니다.
machine_guid principal.asset.attribute.labels.value 키 = machine_guid로 직접 매핑됩니다.
malware_action security_result.detection_fields.value 키 = malware_action로 직접 매핑됩니다.
malware_family security_result.detection_fields.value 키 = malware_family로 직접 매핑됩니다.
media_authorized security_result.detection_fields.value 키 = media_authorized로 직접 매핑됩니다.
media_class_id security_result.detection_fields.value 키 = media_class_id로 직접 매핑됩니다.
media_description security_result.detection_fields.value 키 = media_description로 직접 매핑됩니다.
media_encrypted security_result.detection_fields.value 키 = media_encrypted로 직접 매핑됩니다.
media_manufacturer security_result.detection_fields.value 키 = media_manufacturer로 직접 매핑됩니다.
media_type security_result.detection_fields.value 키 = media_type로 직접 매핑됩니다.
메서드 security_result.detection_fields.value 키 = methods로 직접 매핑됩니다.
originsicname security_result.detection_fields.value 키 = originsicname로 직접 매핑됩니다.
origin intermediary.ip 직접 매핑됩니다.
os_version principal.asset.platform_software.platform_patch_level 직접 매핑됩니다.
outzone security_result.detection_fields.value 키 = outzone로 직접 매핑됩니다.
parent_rule security_result.detection_fields.value 키 = parent_rule로 직접 매핑됩니다.
peer_gateway intermediary.ip 직접 매핑됩니다.
policy_guid security_result.detection_fields.value 키 = policy_guid로 직접 매핑됩니다.
policy_name security_result.detection_fields.value 키 = policy_name로 직접 매핑됩니다.
policy_number security_result.detection_fields.value 키 = policy_number로 직접 매핑됩니다.
policy_type security_result.detection_fields.value 키 = policy_type로 직접 매핑됩니다.
제품 additional.fields.value.string_value 키 = product로 직접 매핑됩니다.
metadata.product_name 직접 매핑됩니다.
product_family additional.fields.value.string_value 키 = product_family로 직접 매핑됩니다.
program_name additional.fields.value.string_value 키 = program_name로 직접 매핑됩니다.
protection_name security_result.detection_fields.value 키 = protection_name로 직접 매핑됩니다.
protection_type security_result.detection_fields.value 키 = protection_type로 직접 매핑됩니다.
reading_data_access security_result.detection_fields.value 키 = reading_data_access로 직접 매핑됩니다.
rule_action security_result.detection_fields.value 키 = rule_action로 직접 매핑됩니다.
rule_name security_result.rule_name 직접 매핑됩니다.
rule_uid security_result.rule_id ep_rule_id가 비어 있으면 직접 매핑됩니다.
s_port principal.port 직접 매핑됩니다.
scheme security_result.detection_fields.value 키 = scheme로 직접 매핑됩니다.
sequencenum additional.fields.value.string_value 키 = sequencenum로 직접 매핑됩니다.
서비스 target.port 직접 매핑됩니다.
service_id security_result.detection_fields.value 키 = service_id로 직접 매핑됩니다.
session_uid network.session_id 직접 매핑됩니다.
src principal.ip 직접 매핑됩니다.
src_dns_name security_result.detection_fields.value 키 = src_dns_name로 직접 매핑됩니다.
src_machine_name security_result.detection_fields.value 키 = src_machine_name로 직접 매핑됩니다.
principal.asset.hostname 직접 매핑됩니다.
principal.hostname 직접 매핑됩니다.
src_user_dn security_result.detection_fields.value 키 = src_user_dn로 직접 매핑됩니다.
src_user_name principal.user.userid 직접 매핑됩니다.
principal.user.email_addresses 이메일 주소는 src_user_name 필드가 있고 userid (email) 형식인 경우 이 필드에서 추출됩니다.
te_verdict_determined_by security_result.detection_fields.value 키 = te_verdict_determined_by로 직접 매핑됩니다.
타임스탬프 metadata.event_timestamp 직접 매핑됩니다.
trusted_domain security_result.detection_fields.value 키 = trusted_domain로 직접 매핑됩니다.
사용자 principal.user.userid src_user_name이 비어 있으면 직접 매핑됩니다.
principal.user.email_addresses 이메일 주소는 사용자 필드에서 추출되며, 존재하는 경우 userid (email) 형식입니다.
user_name principal.user.email_addresses 값이 유효한 이메일 주소인 경우 직접 매핑됩니다.
user_sid principal.user.windows_sid 직접 매핑됩니다.
결과 security_result.detection_fields.value 키 = verdict로 직접 매핑됩니다.
version additional.fields.value.string_value 키 = version로 직접 매핑됩니다.
vpn_feature_name security_result.detection_fields.value 키 = vpn_feature_name로 직접 매핑됩니다.
web_client_type security_result.detection_fields.value 키 = web_client_type로 직접 매핑됩니다.
metadata.log_type 이 필드는 CHECKPOINT_HARMONY로 하드코딩됩니다.
metadata.vendor_name 이 필드는 CHECKPOINT_HARMONY로 하드코딩됩니다.
principal.asset.platform_software.platform os_name 필드의 값에 따라 WINDOWS, MAC 또는 LINUX에 매핑됩니다.
network.ip_protocol proto 필드 및 service, service_id와 같은 기타 필드의 값을 기반으로 TCP, UDP, ICMP, IP6IN4 또는 GRE에 매핑됩니다.
security_result.severity 심각도 필드의 값에 따라 낮음, 중간, 높음 또는 매우 높음으로 매핑됩니다.
metadata.event_type 이 필드는 주 구성원과 타겟이 모두 있는 경우 NETWORK_CONNECTION, 주 구성원만 있는 경우 STATUS_UNCATEGORIZED, 그 외의 경우 GENERIC_EVENT로 설정됩니다.
label event.idm.read_only_udm.network.email.to 변경 로그에서 매핑됨
entityLink event.idm.read_only_udm.metadata.url_back_to_product 변경 로그에서 매핑됨
actionType event.idm.read_only_udm.security_result.action_details 변경 로그에서 매핑됨
eventId event.idm.read_only_udm.metadata.product_log_id 변경 로그에서 매핑됨
eventCreated event.idm.read_only_udm.metadata.event_timestamp 변경 로그에서 매핑됨
type event.idm.read_only_udm.metadata.product_event_type 변경 로그에서 매핑됨
act.createTime event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
act.relatedEntityId event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
customerId event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
saas event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
state event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
entityId event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
connectivity_state event.idm.read_only_udm.additional.fields 변경 로그에서 매핑됨
actions.actionType event.idm.read_only_udm.security_result.action 변경 로그에서 매핑됨
senderAddress event.idm.read_only_udm.network.email.from 변경 로그에서 매핑됨

변경 로그

이 파서의 변경 로그 보기

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