이 문서에서는 Bindplane을 사용하여 CyberArk Privilege Cloud 로그를 Google Security Operations에 수집하는 방법을 설명합니다. 파서 코드는 로그를 원시 SYSLOG + KV 형식에서 Google SecOps 통합 데이터 모델(UDM) 형식으로 변환합니다. 먼저 grok 패턴과 키-값 파싱을 사용하여 CEF 형식 메시지에서 필드를 추출한 다음 이러한 필드와 기타 필드를 해당 UDM 필드에 매핑하여 공급업체, 제품, 심각도에 대한 표준화된 값으로 데이터를 보강합니다.
Syslog를 수집하여 Google SecOps로 전송하도록 Bindplane 에이전트 구성
구성 파일에 액세스합니다.
config.yaml 파일을 찾습니다. 일반적으로 Linux에서는 /etc/bindplane-agent/ 디렉터리에 있고 Windows에서는 설치 디렉터리에 있습니다.
텍스트 편집기 (예: nano, vi, 메모장)를 사용하여 파일을 엽니다.
다음과 같이 config.yaml 파일을 수정합니다.
receivers:tcplog:# Replace the port and IP address as requiredlisten_address:"0.0.0.0:6514"exporters:chronicle/chronicle_w_labels:compression:gzip# Adjust the path to the credentials file you downloaded in Step 1creds_file_path:'/path/to/ingestion-authentication-file.json'# Replace with your actual customer ID from Step 2customer_id:<customer_id>
endpoint:malachiteingestion-pa.googleapis.com# Add optional ingestion labels for better organizationlog_type:'CYBERARK_PRIVILEGE_CLOUD'raw_log_field:bodyingestion_labels:service:pipelines:logs/source0__chronicle_w_labels-0:receivers:-tcplogexporters:-chronicle/chronicle_w_labels
Privilege Cloud에 인증 페이지에서 다음 세부정보를 입력한 후 다음을 클릭합니다.
하위 도메인 또는 고객 ID: 하위 도메인은 권한 Cloud Portal FQDN(https://<subdomain>.Privilegecloud.cyberark.com)에 표시된 시스템 주소의 시스템 식별자입니다. 전체 URL이 아닌 <subdomain> 식별자만 입력합니다. 또는 CyberArk에서 제공한 고객 ID를 사용하세요.
사용자 이름 및 비밀번호: CyberArk 지원팀에서 제공한 사용자 인증 정보를 입력합니다.
온프레미스 구성요소 구성 페이지에서 보안 터널을 통해 연결할 구성요소를 추가하고 구성요소 구성을 클릭합니다.
다음 구성 세부정보를 제공합니다.
구성요소 유형: SIEM을 선택합니다.
호스트 주소: Bindplane 에이전트 호스트 주소를 입력합니다 (SIEM 구성요소에 호스트 이름이 포함되어야 함).
대상 포트: Bindplane 에이전트 포트 번호를 입력합니다.
원격 포트: CyberArk가 보안 터널과 인터페이스하는 데 사용하는 포트입니다. 원격 포트는 CyberArk 지원팀에서 제공하며 일반적으로 포트는 1468입니다.
고급을 클릭하여 이 열을 표시합니다.
보안 터널을 통한 액세스: 보안 터널이 다른 머신에서 실행되더라도 서버가 액세스할 보안 터널을 구성할 수 있습니다.
구성요소 구성 > 닫기를 클릭합니다.
UDM 매핑 테이블
로그 필드
UDM 매핑
논리
act
security_result.action_details
원시 로그의 act 필드에서 직접 매핑됩니다.
앱
network.application_protocol
원시 로그의 app 필드에서 매핑되고 parse_app_protocol.include의 논리를 사용하여 변환됩니다.
cn1
additional.fields.value.string_value
원시 로그의 cn1 필드에서 직접 매핑됩니다.
cn1Label
additional.fields.key
원시 로그의 cn1Label 필드에서 직접 매핑됩니다.
cn2
additional.fields.value.string_value
원시 로그의 cn2 필드에서 직접 매핑됩니다.
cn2Label
additional.fields.key
원시 로그의 cn2Label 필드에서 직접 매핑됩니다.
cs1
additional.fields.value.string_value
원시 로그의 cs1 필드에서 직접 매핑됩니다.
cs1Label
additional.fields.key
원시 로그의 cs1Label 필드에서 직접 매핑됩니다.
cs2
additional.fields.value.string_value
원시 로그의 cs2 필드에서 직접 매핑됩니다.
cs2Label
additional.fields.key
원시 로그의 cs2Label 필드에서 직접 매핑됩니다.
cs3
additional.fields.value.string_value
원시 로그의 cs3 필드에서 직접 매핑됩니다.
cs3Label
additional.fields.key
원시 로그의 cs3Label 필드에서 직접 매핑됩니다.
cs4
additional.fields.value.string_value
원시 로그의 cs4 필드에서 직접 매핑됩니다.
cs4Label
additional.fields.key
원시 로그의 cs4Label 필드에서 직접 매핑됩니다.
cs5
additional.fields.value.string_value
원시 로그의 cs5 필드에서 직접 매핑됩니다.
cs5Label
additional.fields.key
원시 로그의 cs5Label 필드에서 직접 매핑됩니다.
device_event_class_id
metadata.product_event_type
원시 로그의 device_event_class_id 필드에서 직접 매핑됩니다.
device_version
metadata.product_version
원시 로그의 device_version 필드에서 직접 매핑됩니다.
dhost
target.hostname
원시 로그의 dhost 필드에서 직접 매핑됩니다.
duser
target.user.user_display_name
원시 로그의 duser 필드에서 직접 매핑됩니다.
dvc
about.ip
원시 로그의 dvc 필드에서 직접 매핑됩니다.
event_name
metadata.product_event_type
원시 로그의 event_name 필드에서 직접 매핑됩니다.
externalId
metadata.product_log_id
원시 로그의 externalId 필드에서 직접 매핑됩니다.
fname
additional.fields.value.string_value
원시 로그의 fname 필드에서 직접 매핑됩니다.
msg
metadata.description
원시 로그의 msg 필드에서 직접 매핑됩니다.
reason
security_result.summary
원시 로그의 reason 필드에서 직접 매핑됩니다.
줄이는 것을
security_result.severity
원시 로그의 severity 필드에서 매핑되고 값에 따라 '낮음', '중간', '높음' 또는 '중요'로 변환됩니다.
shost
principal.ip
원시 로그의 shost 필드에서 직접 매핑됩니다.
suser
principal.user.user_display_name
원시 로그의 suser 필드에서 직접 매핑됩니다.
시간
metadata.event_timestamp.seconds
파싱되고 타임스탬프로 변환된 후 원시 로그의 time 필드에서 직접 매핑됩니다.
metadata.event_type
suser이 있고 duser이 없으면 'USER_UNCATEGORIZED'로 설정됩니다. 그 외의 경우 'GENERIC_EVENT'로 설정합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Collect CyberArk Privilege Cloud logs\n=====================================\n\nSupported in: \nGoogle secops [SIEM](/chronicle/docs/secops/google-secops-siem-toc)\n| **Note:** This feature is covered by [Pre-GA Offerings Terms](https://chronicle.security/legal/service-terms/) of the Google Security Operations Service Specific Terms. Pre-GA features might have limited support, and changes to pre-GA features might not be compatible with other pre-GA versions. For more information, see the [Google SecOps Technical Support Service guidelines](https://chronicle.security/legal/technical-support-services-guidelines/) and the [Google SecOps Service Specific Terms](https://chronicle.security/legal/service-terms/).\n\nThis document explains how to ingest CyberArk Privilege Cloud logs to\nGoogle Security Operations using Bindplane. The parser code transforms the logs from\ntheir raw SYSLOG + KV format into the Google SecOps Unified Data Model\n(UDM) format. It first extracts fields from CEF formatted messages using grok\npatterns and key-value parsing, then maps those fields and others to their\ncorresponding UDM fields, enriching the data with standardized values for vendor,\nproduct, and severity.\n\nBefore you begin\n----------------\n\nMake sure you have the following prerequisites:\n\n- Google SecOps instance\n- Windows 2016 or later, or a Linux host with `systemd`\n- If running behind a proxy, firewall [ports](/chronicle/docs/ingestion/use-bindplane-agent#verify_the_firewall_configuration) are open\n- Privileged access to CyberArk Privilege Cloud\n\nGet Google SecOps ingestion authentication file\n-----------------------------------------------\n\n1. Sign in to the Google SecOps console.\n2. Go to **SIEM Settings \\\u003e Collection Agents**.\n3. Download the **Ingestion Authentication File**. Save the file securely on the system where Bindplane will be installed.\n\nGet Google SecOps customer ID\n-----------------------------\n\n1. Sign in to the Google SecOps console.\n2. Go to **SIEM Settings \\\u003e Profile**.\n3. Copy and save the **Customer ID** from the **Organization Details** section.\n\nInstall the Bindplane agent\n---------------------------\n\nInstall the Bindplane agent on your Windows or Linux operating system according\nto the following instructions.\n\n### Windows installation\n\n1. Open the **Command Prompt** or **PowerShell** as an administrator.\n2. Run the following command:\n\n msiexec /i \"https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi\" /quiet\n\n### Linux installation\n\n1. Open a terminal with root or sudo privileges.\n2. Run the following command:\n\n sudo sh -c \"$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)\" install_unix.sh\n\n### Additional installation resources\n\nFor additional installation options, consult the [installation guide](/chronicle/docs/ingestion/use-bindplane-agent#install_the_bindplane_agent).\n\nConfigure the Bindplane agent to ingest Syslog and send to Google SecOps\n------------------------------------------------------------------------\n\n1. Access the configuration file:\n - Locate the `config.yaml` file. Typically, it's in the `/etc/bindplane-agent/` directory on Linux or in the installation directory on Windows.\n - Open the file using a text editor (for example, `nano`, `vi`, or Notepad).\n2. Edit the `config.yaml` file as follows:\n\n receivers:\n tcplog:\n # Replace the port and IP address as required\n listen_address: \"0.0.0.0:6514\"\n\n exporters:\n chronicle/chronicle_w_labels:\n compression: gzip\n # Adjust the path to the credentials file you downloaded in Step 1\n creds_file_path: '/path/to/ingestion-authentication-file.json'\n # Replace with your actual customer ID from Step 2\n customer_id: \u003ccustomer_id\u003e\n endpoint: malachiteingestion-pa.googleapis.com\n # Add optional ingestion labels for better organization\n log_type: 'CYBERARK_PRIVILEGE_CLOUD'\n raw_log_field: body\n ingestion_labels:\n\n service:\n pipelines:\n logs/source0__chronicle_w_labels-0:\n receivers:\n - tcplog\n exporters:\n - chronicle/chronicle_w_labels\n\n - Replace the port and IP address as required in your infrastructure.\n - Replace `\u003ccustomer_id\u003e` with the actual customer ID.\n - Update `/path/to/ingestion-authentication-file.json` to the path where the authentication file was saved in the [Get Google SecOps ingestion authentication file](/chronicle/docs/ingestion/default-parsers/cyberark-privilege-cloud#get-auth-file) section.\n\nRestart the Bindplane agent to apply the changes\n------------------------------------------------\n\n1. To restart the Bindplane agent in **Linux**, run the following command:\n\n sudo systemctl restart bindplane-agent\n\n2. To restart the Bindplane agent in **Windows** , you can either use the\n **Services** console or enter the following command:\n\n net stop BindPlaneAgent && net start BindPlaneAgent\n\nInstall Secure Tunnel\n---------------------\n\n1. Make sure that your **Machine ID** is unique, even when the machines are deployed in multiple domains.\n2. Download the **Privilege Cloud software package** from [Deploy the Privilege Cloud Connector (Standard)](https://docs.cyberark.com/privilege-cloud-standard/latest/en/content/privilege%20cloud/privcloud-install.htm#Prepare), copy the **Secure Tunnel** ZIP file, and **unzip** it.\n3. Run the installation from the unzipped folder.\n4. On the **Select Installation Folder** page, enter the location of the installation folder, and click **Next**.\n5. On the **Ready to Install** page, click **Install**.\n6. When the installation is complete, click **Finish**; the configuration tool is launched.\n\nConfigure Secure Tunnel\n-----------------------\n\n1. On the **Authenticate to Privilege Cloud** page, enter the following details and then click **Next** :\n - **Subdomain or Customer ID** : The subdomain is your system identifier in the system address, as displayed in the Privilege Cloud Portal FQDN: `https://\u003csubdomain\u003e.Privilegecloud.cyberark.com`. Enter only the `\u003csubdomain\u003e` identifier, not the whole URL. Alternatively, use the Customer ID provided to you by CyberArk.\n - **User name \\& Password**: Enter the credentials provided by CyberArk Support.\n2. On the **Configure on-premise components** page, add the components that you want to connect through the Secure Tunnel, and click **Configure Components**.\n3. Provide the following configuration details:\n - **Component Type** : Select **SIEM**.\n - **Host Address**: Enter the Bindplane agent host address (SIEM component must include a hostname).\n - **Destination Port**: Enter the Bindplane agent port number.\n - **Remote Port** : The port used by the CyberArk to interface with your Secure Tunnel (The Remote Port is provided to you by CyberArk support, typically the port is `1468`).\n - Click **Advanced** to display this column.\n - **Access through Secure Tunnels**: You can configure which Secure Tunnels your servers will access through, even if these Secure Tunnels are running on a different machine.\n4. Click **Configure Components \\\u003e Close**.\n\nUDM mapping table\n-----------------\n\n**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/google-security-operations-2)"]]
