將 Proofpoint Threat Protection 與 Google SecOps 整合

本文說明如何將 Proofpoint Threat Protection 與 Google Security Operations 整合。

用途

在 Google SecOps 平台中,Proofpoint Threat Protection 整合功能支援下列用途:

  • 自動緩解網路釣魚:驗證網路釣魚警示後,自動將惡意寄件者的電子郵件地址和網域加入 Proofpoint 封鎖清單,防止類似威脅進一步傳送至整個組織。

  • 加速事件應變:在調查期間,快速更新 IP 位址和主機名稱的封鎖清單項目,確保在電子郵件閘道立即消除新發現的入侵指標 (IOC)。

  • 主動威脅防護:主動查詢及擷取現有的許可和封鎖清單項目,確保安全性政策保持最新狀態,並與目前的威脅情報一致,減少組織的攻擊面。

  • 簡化政策管理:使用 Playbook 根據核准的業務要求,大量新增或移除許可清單中的信任寄件者,簡化電子郵件安全政策的管理作業。

事前準備

在 Google SecOps 平台中設定整合功能前,請確認您具備下列項目:

  • Proofpoint Threat Protection API 憑證:請確認您有有效的用戶端 ID 和用戶端密鑰。這些值是在 Proofpoint 管理控制台中產生

  • 叢集 ID:找出與 Proofpoint 執行個體相關聯的特定叢集 ID。您需要這個 ID,才能指定正確的許可和封鎖清單。

  • 網路連線:確認 Google SecOps 環境可與 Proofpoint Threat Protection API 根端點通訊。如果您使用 Proxy,請確認憑證和位址可用。

整合參數

Proofpoint Threat Protection 整合需要下列參數:

參數 說明
API Root

這是必填欄位。

Proofpoint Threat Protection 執行個體的基準網址。

Client ID

這是必填欄位。

與 Proofpoint Threat Protection API 憑證相關聯的用戶端 ID。

Client Secret

這是必填欄位。

與 Proofpoint Threat Protection API 憑證相關聯的用戶端密鑰。

Cluster ID

這是必填欄位。

與 Proofpoint Threat Protection API 執行個體相關聯的叢集 ID。

Verify SSL

選填。

如果選取,整合功能會在連線至 Proofpoint Threat Protection 伺服器時驗證 SSL 憑證。

(預設為啟用)。

如要瞭解如何在 Google SecOps 中設定整合功能,請參閱「設定整合功能」。

如有需要,您可以在後續階段進行變更。設定整合執行個體後,即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體,請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作,請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。

將項目新增至許可清單

使用「Add Entry to Allow List」動作,將項目新增至 Proofpoint Threat Protection 許可清單。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Add Entry to Allow List」動作需要下列參數:

參數 說明
Cluster ID

選填。

許可清單的叢集 ID。

如未提供值,動作會使用整合設定中的叢集 ID。

Allowlist Item

這是必填欄位。

JSON 物件,代表要新增的許可清單項目。

預設值為:

{
    "action": "add",
    "attribute": "",
    "operator": "",
    "value": "",
    "comment": ""
}

動作輸出內容

「Add Entry to Allow List」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼執行結果 可用
輸出訊息

「Add Entry to Allow List」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully added a new entry to the allow list.

動作成功。
Error ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Add Entry to Allow List」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

將項目新增至封鎖清單

使用「Add Entry to Block List」動作,將項目新增至 Proofpoint Threat Protection 封鎖清單。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Add Entry to Block List」動作需要下列參數:

參數 說明
Cluster ID

選填。

封鎖清單的叢集 ID。

如未提供值,動作會使用整合設定中的叢集 ID。

Blocklist Item

這是必填欄位。

代表要新增封鎖清單項目的 JSON 物件。

預設值為:

{
    "action": "add",
    "attribute": "",
    "operator": "",
    "value": "",
    "comment": ""
}

動作輸出內容

「Add Entry to Block List」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼執行結果 可用
輸出訊息

「Add Entry to Block List」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully added new entry to the block list.

動作成功。
Error ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Add Entry to Block List」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

將 IOC 新增至許可清單

使用「Add IOC to Allow List」動作,將特定 IOC 新增至 Proofpoint Threat Protection 許可清單。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Add IOC to Allow List」動作需要下列參數:

參數 說明
Cluster ID

選填。

許可清單的叢集 ID。

如未提供值,動作會使用整合設定中的叢集 ID。

Recipient Email Address

選填。

以半形逗號分隔的收件者電子郵件地址清單,用於新增至許可清單。

Sender Email Address

選填。

以半形逗號分隔的寄件者電子郵件地址清單,用於新增至許可清單。

Sender IP Address

選填。

以半形逗號分隔的寄件者 IP 位址清單,用於新增至許可清單。

Sender Hostname

選填。

以半形逗號分隔的寄件者主機名稱清單,用於新增至許可清單。

Sender HELO Domain Name

選填。

以半形逗號分隔的 HELO 網域名稱清單,用於新增至許可清單。

Message Header From (Address Only)

選填。

以半形逗號分隔的「郵件標頭寄件者」項目清單,用於新增至許可清單。

Comment

選填。

與許可清單項目相關聯的說明或理由。

動作輸出內容

「Add IOC to Allow List」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼執行結果 可用
輸出訊息

「Add IOC to Allow List」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully added new entries to the allow list.

動作成功。
Error ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Add IOC to Allow List」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

將 IOC 新增至封鎖清單

使用「Add IOC to Block List」動作,將特定 IOC 新增至 Proofpoint Threat Protection 封鎖清單。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Add IOC to Block List」動作需要下列參數:

參數 說明
Cluster ID

選填。

封鎖清單的叢集 ID。

如未提供值,動作會使用整合設定中的叢集 ID。

Recipient Email Address

選填。

以半形逗號分隔的收件者電子郵件地址清單,用於新增至封鎖清單。

Sender Email Address

選填。

以半形逗號分隔的寄件者電子郵件地址清單,用於新增至封鎖清單。

Sender IP Address

選填。

以半形逗號分隔的寄件者 IP 位址清單,用於新增至封鎖清單。

Sender Hostname

選填。

以半形逗號分隔的寄件者主機名稱清單,用於新增至封鎖清單。

Sender HELO Domain Name

選填。

以半形逗號分隔的 HELO 網域名稱清單,用於新增至封鎖清單。

Message Header From (Address Only)

選填。

以半形逗號分隔的「郵件標頭寄件者」項目清單,用於新增至封鎖清單。

Comment

選填。

與封鎖清單項目相關聯的說明或理由。

動作輸出內容

「Add IOC to Block List」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼執行結果 可用
輸出訊息

「Add IOC to Block List」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully added new entries to the block list.

動作成功。
Error ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Add IOC to Block List」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

取得許可清單項目

使用「Get Allow List Entries」動作,從 Proofpoint Threat Protection 許可清單擷取現有項目。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Get Allow List Entries」動作需要下列參數:

參數 說明
Cluster ID

這是必填欄位。

許可清單的叢集 ID。

如未提供值,動作會使用整合設定中的叢集 ID。

IOC Type To Return

選填。

要傳回的 IOC 類型。

如果選取 All,動作會傳回所有項目。

可能的值如下:

  • All
  • Recipient Email Address
  • Sender Email Address
  • Sender IP Address
  • Sender Hostname
  • Sender HELO Domain Name
  • Message Header From (Address Only)

預設值為 All。

Max IOCs To Return

選填。

要傳回的 IOC 數量。

最大值為 1000。

預設值為 100。

動作輸出內容

「Get Allow List Entries」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用「Get Allow List Entries」動作時,收到的 JSON 結果輸出內容:

[
       {
           "attribute": "$from",
           "operator": "equal",
           "value": "test@example.com",
           "comment": ""
       }
]
輸出訊息

「Get Allow List Entries」動作可傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully listed entries in the allow list based on the provided criteria.

動作成功。
Error ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Get Allow List Entries」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

取得封鎖清單項目

使用「Get Block List Entries」動作,從 Proofpoint Threat Protection 封鎖清單中擷取現有項目。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Get Block List Entries」動作需要下列參數:

參數 說明
Cluster ID

這是必填欄位。

封鎖清單的叢集 ID。

如未提供值,動作會使用整合設定中的叢集 ID。

IOC Type To Return

選填。

要傳回的 IOC 類型。

如果選取 All,動作會傳回所有項目。

可能的值如下:

  • All
  • Recipient Email Address
  • Sender Email Address
  • Sender IP Address
  • Sender Hostname
  • Sender HELO Domain Name
  • Message Header From (Address Only)

預設值為 All。

Max IOCs To Return

選填。

要傳回的 IOC 數量。

最大值為 1000。

預設值為 100。

動作輸出內容

「Get Block List Entries」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用「Get Block List Entries」動作時,收到的 JSON 結果輸出內容:

[
       {
           "attribute": "$from",
           "operator": "equal",
           "value": "test@example.com",
           "comment": ""
       }
]
輸出訊息

「Get Block List Entries」動作可傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully listed entries in the block list based on the provided criteria.

動作成功。
Error ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Get Block List Entries」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

乒乓

使用 Ping 動作,測試與 Proofpoint Threat Protection 的連線能力。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

無

動作輸出內容

Ping 動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼執行結果 可用
輸出訊息

Ping 動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully connected to the Proofpoint Threat Protection server with the provided connection parameters!

動作成功。
Failed to connect to the Proofpoint Threat Protection server! Error is ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用 Ping 動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

從許可清單中移除項目

使用「Remove Entry from Allow List」動作,從 Proofpoint Threat Protection 許可清單中移除項目。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Remove Entry from Allow List」動作需要下列參數:

參數 說明
Cluster ID

這是必填欄位。

許可清單的叢集 ID。

如未提供值,動作會使用整合設定中的叢集 ID。

IOC Type To Search

選填。

要搜尋的 IOC 類型。

如果選取 All,這項動作會移除所有與該值相符的項目。

可能的值如下:

  • All
  • Recipient Email Address
  • Sender Email Address
  • Sender IP Address
  • Sender Hostname
  • Sender HELO Domain Name
  • Message Header From (Address Only)

預設值為 All。

Value

選填。

要從許可清單中移除的值。

Case Insensitive Search

這是必填欄位。

如果選取,動作會執行不區分大小寫的搜尋,找出並移除所有相符項目。

動作輸出內容

「Remove Entry from Allow List」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼執行結果 可用
輸出訊息

Remove Entry from Allow List 動作可傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully deleted entry in the allow list based on the provided criteria.

動作成功。
Error ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Remove Entry from Allow List」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

從封鎖清單中移除項目

使用「Remove Entry from Block List」動作,從 Proofpoint Threat Protection 封鎖清單中移除項目。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Remove Entry from Block List」動作需要下列參數:

參數 說明
Cluster ID

這是必填欄位。

封鎖清單的叢集 ID。

如未提供值,動作會使用整合設定中的叢集 ID。

IOC Type To Search

選填。

要搜尋的 IOC 類型。

如果選取 All,這項動作會移除所有與該值相符的項目。

可能的值如下:

  • All
  • Recipient Email Address
  • Sender Email Address
  • Sender IP Address
  • Sender Hostname
  • Sender HELO Domain Name
  • Message Header From (Address Only)

預設值為 All。

Value

選填。

要從封鎖清單中移除的值。

Case Insensitive Search

這是必填欄位。

如果選取,動作會執行不區分大小寫的搜尋,找出並移除所有相符項目。

動作輸出內容

「Remove Entry from Block List」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼執行結果 可用
輸出訊息

「Remove Entry from Block List」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Successfully deleted entry in the block list based on the provided criteria.

動作成功。
Error ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Remove Entry from Block List」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success true或false

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