整合 CyberArk PAM 與 Google SecOps

本文件說明如何將 CyberArk Privileged Access Manager 與 Google Security Operations 整合。

事前準備

如要設定 CyberArk PAM 與整合功能搭配運作,您必須為整合功能建立使用者,並授予該使用者存取所需 CyberArk PAM vault 的權限。

新增使用者

請按照下列步驟,為整合建立使用者:

  1. 以管理員身分登入 PrivateArk Client。
  2. 依序前往「Tools」 > 「Administrative Tools」 > 「Users and Groups」。
  3. 在「Users and Groups」(使用者和群組) 對話方塊中,選取使用者位置,按一下「New」(新增),然後選取「User」(使用者)。
  4. 在「New User」(新使用者) 對話方塊的不同分頁中,視需要填寫資訊。「一般」和「驗證」分頁為必填。

如要進一步瞭解如何建立使用者,請參閱「將使用者新增至 Vault」。

將權限授予建立的使用者

請按照下列步驟,為新建立的使用者新增 Vault 存取權:

  1. 以管理員身分登入 PrivateArk Client。
  2. 選取要提供存取權的保管箱,然後登入 (按兩下)。
  3. 按一下頂端選單中的「擁有者」。
  4. 如要新增使用者,請按一下「新增」。
  5. 在對話方塊中選取使用者。
  6. 在「Authorized to」(授權對象) 部分,至少選取下列權限:
    • Monitor Safe
    • Retrieve files from Safe
    • Store files in Safe
    • Admisiter Safe
  7. 如要儲存變更,請點選 [OK] (確定)。
  8. 如要關閉對話方塊視窗,請按一下「關閉」。

選用:設定用戶端憑證

您可以使用現有的用戶端憑證,或建立新的用戶端憑證,在 CyberArk PAM 執行個體和 Google SecOps SOAR 之間進行安全通訊。如要進一步瞭解如何設定用戶端憑證,請參閱「Central Credential Provider 網路服務設定」。

整合 CyberArk PAM 和 Google SecOps

整合時需要下列參數:

參數 說明
API Root 必要

API 根網址。

請按照下列格式提供值:https://IP_ADDRESS :PORT。

Username 必要

連線時使用的使用者名稱。

Password 必要

連線密碼。

Verify SSL 選用

如果選取這個選項,整合功能會驗證連至 CyberArk 伺服器的 SSL 憑證是否有效。

預設為選取。

CA Certificate 必要

用於驗證與 API 根目錄安全連線的 CA 憑證。

這項參數接受 Base64 編碼字串形式的 CA 憑證。

Client Certificate 選用

如果已設定 CyberArk PAM,請指定要用於建立 API 根目錄連線的 CyberArk 用戶端憑證。以 PFX 檔案 (PKCS #12 格式) 的形式提供憑證。

Client Certificate Passphrase 選用

用戶端憑證所需的通關密語。

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

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

動作

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

取得帳戶密碼值

使用「Get Account Password Value」(取得帳戶密碼值) 動作,從 CyberArk 取得帳戶密碼值。

這項操作可讓您擷取密碼和安全殼層金鑰。

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

動作輸入內容

「Get Account Password Value」動作需要下列參數:

參數 說明
Account 必要

要擷取密碼值的帳戶 ID。

注意:您可以透過「List Accounts」動作擷取帳戶 ID。

Reason 必要

存取帳戶密碼值的原因。

系統會自動從 Google SecOps SOAR 擷取預設值。

Ticketing System Name 選用

票務系統的名稱。

Ticket ID 選用

支援單處理系統的支援單 ID。

Version 選用

要擷取的帳戶密碼值版本。

動作輸出內容

「Get Account Password Value」動作會提供下列輸出內容:

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

以下範例說明使用「Get Account Password Value」動作時,收到的 JSON 結果輸出內容:

{
 "content": "PASSWORD_VALUE"
}
輸出訊息

「Get Account Password Value」動作會提供下列輸出訊息:

輸出訊息 訊息說明
Successfully fetched password value for account ID ACCOUNT_ID

Password value for account with ID ACCOUNT_ID and supplied version VERSION was not found in the CyberArk PAM.

動作成功。
Error executing action "Get Account Password Value". Reason: ERROR_REASON

動作失敗。

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

指令碼執行結果

下表說明使用「Get Account Password Value」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success True或False

可列出帳戶

使用「List Accounts」(列出帳戶) 動作,根據提供的條件列出 CyberArk PAM 中可用的帳戶。

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

動作輸入內容

List Accounts 動作需要下列參數:

參數 說明
Search Query 必要

要使用的搜尋查詢。

Search operator 必要

根據提供的搜尋查詢執行搜尋時,要使用的搜尋運算子。

可能的值如下:
  • contains
  • startswith
。

預設值為 contains。

Max Records To Return 必要

要傳回的記錄數量。如未提供值,動作會傳回 50 筆記錄 (API 預設值)。

Records Offset 必要

動作傳回值的偏移量。

Filter Query 必要

要使用的篩選器查詢。您可以根據 safeName 或 modificationTime 參數設定篩選條件。

Saved Filter 必要

要使用的已儲存篩選器查詢。

這個參數的優先順序高於 Filter Query 參數。

動作輸出內容

「List Accounts」動作會提供下列輸出內容:

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

在案件牆上,「List Accounts」動作會提供下表:

資料表名稱:Available PAM Accounts

表格欄:

  • ID
  • Safe Name
  • 使用者名稱
  • Secret 類型
JSON 結果

以下範例說明使用「List Accounts」動作時,收到的 JSON 結果輸出內容:

{
   "value": [
       {
           "categoryModificationTime": 1672051160,
           "platformId": "WinDomain",
           "safeName": "UserTestSafe",
           "id": "33_3",
           "name": "user@example.com",
           "address": "user@example.com",
           "userName": "user",
           "secretType": "password",
           "platformAccountProperties": {},
           "secretManagement": {
               "automaticManagementEnabled": true,
               "lastModifiedTime": 1672051160
           },
           "createdTime": 1672051160
       }
   ],
   "count": 1
}
輸出訊息

「List Accounts」動作會提供下列輸出訊息:

輸出訊息 訊息說明

Successfully found accounts for the criteria provided in CyberArk PAM.

No accounts were found for the criteria provided in CyberArk PAM.

Both the Filter Query and Saved Filter parameters are provided, Saved Filter takes priority.

動作成功。
Error executing action "List Accounts". Reason: ERROR_REASON

動作失敗。

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

指令碼執行結果

下表說明使用「List Accounts」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success True或False

乒乓

使用 *Ping 動作測試與 CyberArk 的連線能力。

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

整合輸入內容

無

動作輸出內容

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

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

Ping 動作會提供下列輸出訊息:

輸出訊息 訊息說明
Successfully connected to the CyberArk PAM installation with the provided connection parameters! 動作成功。
Failed to connect to the CyberArk PAM installation! Error is ERROR_REASON

動作失敗。

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

指令碼執行結果

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

指令碼結果名稱 值
is_success True或False

變更帳戶密碼

使用「變更帳戶密碼」動作,在 CyberArk PAM 中排定立即變更密碼的工作。

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

動作輸入內容

Change Account Password 動作需要下列參數:

參數 說明
Account ID 必要

列出要排入佇列、立即變更密碼的帳戶 ID,並以半形逗號分隔。

注意:您可以直接從「List Accounts」動作的輸出參數,擷取目標帳戶 ID 字串。

動作輸出內容

「變更帳戶密碼」動作會提供下列輸出內容:

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

以下範例說明使用「變更帳戶密碼」動作時,收到的 JSON 結果輸出內容:

{
  "successful_accounts": [
    "28_12"
  ],
  "failed_accounts": [
    {
      "account_id": "36_4",
      "error": "The account is not managed by the CPM"
    }
  ]
}
輸出訊息

「變更帳戶密碼」動作會提供下列輸出訊息:

輸出訊息 訊息說明
Successfully queued immediate password change task for the following accounts: ACCOUNT_IDS 動作成功。
Error executing action "Change Account Password". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、目標帳戶 ID 值,或管理員千次曝光出價設定。

指令碼執行結果

下表說明使用「變更帳戶密碼」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success True或False

工作

如要進一步瞭解工作,請參閱「 設定新工作」和「 進階排程」。

CyberArk PAM - 同步整合憑證工作

使用 CyberArk PAM - Sync Integration Credentials Job,自動從 CyberArk PAM 擷取帳戶憑證和密鑰,並動態更新整合執行個體、連接器和排定工作的設定,將這些資訊同步到 Google SecOps SOAR。

工作參數

CyberArk PAM - Sync Integration Credentials Job 需要下列參數:

參數 說明
API Root

這是必填欄位。

CyberArk PAM 的 API 根網址。

如未提供任何值,工作會參照整合設定中提供的值。

Username

這是必填欄位。

用於連線至 CyberArk PAM 的使用者名稱。

如未提供任何值,工作會參照整合設定中提供的值。

Password

這是必填欄位。

用於連線至 CyberArk PAM 的密碼。

如未提供任何值,工作會參照整合設定中提供的值。

Verify SSL

這是必填欄位。

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

(預設為啟用)。

CA Certificate

選填。

Base64 編碼的 CA 憑證,用於驗證與 API 根目錄的 SSL 連線。

Client Certificate

選填。

用於雙向 TLS 驗證的 Base64 編碼用戶端憑證。

Client Certificate Passphrase

選填。

用戶端憑證所需的通關密語 (如果已加密)。

Environment Name

這是必填欄位。

Google SecOps SOAR 環境的名稱,用於查詢及更新整合執行個體、連接器和工作。如果是共用環境,請提供 *。

預設值為 Default Environment。

Credential Mapping

這是必填欄位。

JSON 或 YAML 對應字串,用於將 SOAR 整合執行個體、連接器和工作對應至 CyberArk PAM 帳戶路徑。

值必須採用 accounts/<account_id> 或 accounts/<account_id>/versions/<version_id> 格式。

預設值為 {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "accounts/Account_ID"}}}。

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