收集 Cisco Secure Web Appliance (舊稱 Web Security Appliance) 記錄檔

剖析器版本：7.0

支援的國家/地區：

本文說明如何使用 Bindplane，將 Cisco Secure Web Appliance (舊稱 Web Security Appliance) 記錄檔擷取至 Google Security Operations。

Cisco Secure Web Appliance 是地端部署的網頁 Proxy 和安全閘道，可保護機構免於網路威脅。這項服務可針對所有 HTTP、HTTPS 和 FTP 流量提供網址篩選、惡意軟體掃描、資料遺失防護，以及應用程式可視性和控制功能。這項設備會強制執行合理使用政策，並檢查加密流量，偵測及封鎖進階威脅。

事前準備

請確認您已完成下列事前準備事項：

  • Google SecOps 執行個體
  • Windows Server 2016 以上版本，或搭載 systemd 的 Linux 主機
  • Bindplane 代理程式與 Cisco Secure Web Appliance 之間的網路連線
  • 如果透過 Proxy 執行，請確保防火牆通訊埠已根據 Bindplane 代理程式需求開啟
  • Cisco Secure Web Appliance 網頁介面的權限存取

取得 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

  3. 等待安裝完成。

  4. 執行下列指令，確認安裝成功：

    sc query observiq-otel-collector

服務應顯示為「RUNNING」。

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 代理程式安裝指南。

設定 Bindplane 代理程式，擷取系統記錄檔並傳送至 Google SecOps

找出設定檔

  • Linux：

    sudo nano /status observiq-otel-collector/config.yaml

  • Windows：

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

編輯設定檔

  • 將 config.yaml 的所有內容替換為下列設定：

    receivers:
  tcplog:
    listen_address: "0.0.0.0:514"

exporters:
  chronicle/cisco_wsa:
    compression: gzip
    creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
    customer_id: '<customer_id>'
    endpoint: malachiteingestion-pa.googleapis.com
    log_type: CISCO_WSA
    raw_log_field: body

service:
  pipelines:
    logs/cisco_wsa_to_chronicle:
      receivers:
        - tcplog
      exporters:
        - chronicle/cisco_wsa

設定參數

替換下列預留位置：

  • 接收器設定：

    • listen_address：要接聽的 IP 位址和通訊埠：
      • 0.0.0.0，監聽所有介面 (建議)
      • 通訊埠 514 是標準的系統記錄通訊埠 (在 Linux 上需要根層級權限；非根層級權限請使用 1514)

  • 匯出工具設定：

    • creds_file_path：擷取驗證檔案的完整路徑：
      • Linux：/etc/bindplane-agent/ingestion-auth.json
      • Windows：C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id：從 Google SecOps 控制台複製的客戶 ID
    • endpoint：區域端點網址：
      • 美國：malachiteingestion-pa.googleapis.com
      • 歐洲：europe-malachiteingestion-pa.googleapis.com
      • 亞洲：asia-southeast1-malachiteingestion-pa.googleapis.com
      • 如需完整清單，請參閱「區域端點」

儲存設定檔

  • 編輯完成後，請儲存檔案：
    • Linux：依序按下 Ctrl+O、Enter 和 Ctrl+X
    • Windows：依序點選「檔案」>「儲存」

重新啟動 Bindplane 代理程式，以套用變更

如要在 Linux 中重新啟動 Bindplane 代理程式，請執行下列步驟：

  1. 執行下列指令：

    sudo systemctl restart observiq-otel-collector

  2. 確認服務正在執行：

    sudo systemctl status observiq-otel-collector

  3. 檢查記錄中是否有錯誤：

    sudo journalctl -u observiq-otel-collector -f

如要在 Windows 中重新啟動 Bindplane 代理程式，請按照下列步驟操作：

  1. 您可以選擇下列其中一個選項：

    • 以管理員身分開啟命令提示字元或 PowerShell：
    net stop observiq-otel-collector && net start observiq-otel-collector
    • 服務控制台：
      1. 按下 Win+R，輸入 services.msc，然後按下 Enter 鍵。
      2. 找出 observIQ OpenTelemetry Collector。
      3. 按一下滑鼠右鍵，然後選取「重新啟動」。

  2. 確認服務正在執行：

    sc query observiq-otel-collector

  3. 檢查記錄中是否有錯誤：

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

在 Cisco Secure Web Appliance 上設定系統記錄轉送

  1. 登入 Cisco Secure Web Appliance 網頁介面。
  2. 依序前往「系統管理」>「記錄訂閱」。
  3. 按一下「新增記錄訂閱項目」。
  4. 從「記錄類型」下拉式選單中選取記錄類型。如果是網頁 Proxy 流量，請選取「存取記錄」。
  5. 在「記錄名稱」欄位中，輸入記錄訂閱項目的描述性名稱 (例如 chronicle-access)。

  6. 選取存取記錄格式：

    • Squid - 標準 Squid 相容格式
    • Apache - Apache 相容格式
    • W3C Extended - W3C Extended 記錄檔格式，可設定欄位

  7. 指定記錄檔輪替前的檔案大小上限，以及輪替之間的時間間隔。

  8. 選取「記錄層級」。可用選項包括「重大」、「警告」、「資訊」、「偵錯」或「追蹤」。

  9. 在「擷取方法」部分，選取「Syslog Push」。

  10. 請提供下列設定詳細資料：

    • 主機名稱：輸入 Bindplane 代理程式主機的 IP 位址或主機名稱 (例如 192.168.1.100)。
    • 「Port」(通訊埠)：輸入在 Bindplane 代理程式上設定的通訊埠編號 (例如 514)。
    • 「通訊協定」：選取「TCP」。
    • 郵件大小上限：輸入要傳送至遠端系統記錄檔伺服器的記錄檔訊息大小上限 (以位元組為單位)。
    • 設施：選取所需的系統記錄設施 (例如 Local0)。

  11. 按一下「提交」。

  12. 按一下「Commit Changes」，套用設定。

UDM 對應表

記錄欄位 UDM 對應 邏輯
_field additional.fields 已合併
case_name_label additional.fields 已合併
cmf_label additional.fields 已合併
dcf_label additional.fields 已合併
err_label additional.fields 已合併
interaction_mode_label additional.fields 已合併
proxy_session_id_label additional.fields 已合併
request_size_label additional.fields 已合併
total_bytes_label additional.fields 已合併
transaction_disposition_label additional.fields 已合併
auth_mechanism extensions.auth.auth_details 直接對應
wsa_hostname intermediary.asset.hostname 直接對應
wsa_hostname intermediary.hostname 直接對應
description metadata.description 直接對應
time metadata.event_timestamp 已剖析為 MMM dd HH:mm:ss
when metadata.event_timestamp 已剖析為 UNIX
has_principal metadata.event_type 對應：true → NETWORK_HTTP、true → NETWORK_CONNECTION、true → STATUS_UPDATE
has_user metadata.event_type 已對應：true → USER_UNCATEGORIZED
action metadata.product_event_type 直接對應
app_proto network.application_protocol 直接對應
method network.http.method 直接對應
referer_url network.http.referral_url 直接對應
returnCode network.http.response_code 直接對應
user_agent network.http.user_agent 直接對應
response_size network.received_bytes 直接對應
bytes_sent network.sent_bytes 直接對應
size network.sent_bytes 直接對應
session_id network.session_id 直接對應
srcip principal.asset.ip 已合併
srcip principal.ip 已合併
process_id principal.process.pid 直接對應
_field principal.resource.attribute.labels 已合併
key principal.resource.attribute.labels 已對應：server_response → _field
username principal.user.userid 直接對應
_security_result security_result 已合併
domain target.administrative_domain 直接對應
tgthost target.asset.hostname 直接對應
tgtip target.asset.ip 已合併
mime_type target.file.mime_type 直接對應
tgthost target.hostname 直接對應
tgtip target.ip 已合併
tar_city target.location.city 直接對應
tar_region target.location.country_or_region 直接對應
tar_state target.location.state 直接對應
tgtport target.port 直接對應
kerberos_enctype_label target.resource.attribute.labels 已合併
kerberos_keytab_label target.resource.attribute.labels 已合併
kerberos_kvno_label target.resource.attribute.labels 已合併
server_cert_organization_label target.resource.attribute.labels 已合併
target_kerberos_realm_label target.resource.attribute.labels 已合併
url target.url 直接對應
不適用 metadata.event_type 常數：NETWORK_HTTP
不適用 metadata.product_name 常數：WSA
不適用 metadata.vendor_name 常數：CISCO
information event.idm.read_only_udm.additional.fields 從變更記錄對應
appname event.idm.read_only_udm.additional.fields 從變更記錄對應
facility event.idm.read_only_udm.additional.fields 從變更記錄對應
logtime event.idm.read_only_udm.additional.fields 從變更記錄對應
policy event.idm.read_only_udm.additional.fields 從變更記錄對應
hostname event.idm.read_only_udm.principal.hostname 從變更記錄對應
hostname event.idm.read_only_udm.principal.asset.hostname 從變更記錄對應
ser_url event.idm.read_only_udm.security_result.description 從變更記錄對應
ser_msg event.idm.read_only_udm.security_result.rule_name 從變更記錄對應
ser_data event.idm.read_only_udm.security_result.detection_fields 從變更記錄對應
priority event.idm.read_only_udm.security_result.severity_details 從變更記錄對應
srcport event.idm.read_only_udm.principal.port 從變更記錄對應
category event.idm.read_only_udm.security_result.category_details 從變更記錄對應
sha_value event.idm.read_only_udm.target.file.sha256 從變更記錄對應
cmf event.idm.read_only_udm.additional.fields 從變更記錄對應
dcf event.idm.read_only_udm.additional.fields 從變更記錄對應
err event.idm.read_only_udm.additional.fields 從變更記錄對應
case_name event.idm.read_only_udm.additional.fields 從變更記錄對應
total_bytes event.idm.read_only_udm.additional.fields 從變更記錄對應
request_size event.idm.read_only_udm.additional.fields 從變更記錄對應
transaction_disposition event.idm.read_only_udm.additional.fields 從變更記錄對應
application event.idm.read_only_udm.additional.fields 從變更記錄對應
bytes_sent event.idm.read_only_udm.network.sent_bytes 從變更記錄對應
response_size event.idm.read_only_udm.network.received_bytes 從變更記錄對應
description event.idm.read_only_udm.metadata.description 從變更記錄對應
referer_url event.idm.read_only_udm.network.http.referral_url 從變更記錄對應
wsa_hostname event.idm.read_only_udm.intermediary.hostname、event.idm.read_only_udm.intermediary.asset.hostname 從變更記錄對應

變更記錄

查看這個剖析器的變更記錄

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求答案。