整合 CyberArk PAM 與 Google SecOps
本文件說明如何將 CyberArk Privileged Access Manager 與 Google Security Operations 整合。
事前準備
如要設定 CyberArk PAM 與整合功能搭配運作,您必須為整合功能建立使用者,並授予該使用者存取所需 CyberArk PAM vault 的權限。
新增使用者
請按照下列步驟,為整合建立使用者:
- 以管理員身分登入 PrivateArk Client。
- 依序前往「Tools」 > 「Administrative Tools」 > 「Users and Groups」。
- 在「Users and Groups」(使用者和群組) 對話方塊中,選取使用者位置,按一下「New」(新增),然後選取「User」(使用者)。
- 在「New User」(新使用者) 對話方塊的不同分頁中,視需要填寫資訊。「一般」和「驗證」分頁為必填。
如要進一步瞭解如何建立使用者,請參閱「將使用者新增至 Vault」。
將權限授予建立的使用者
請按照下列步驟,為新建立的使用者新增 Vault 存取權:
- 以管理員身分登入 PrivateArk Client。
- 選取要提供存取權的保管箱,然後登入 (按兩下)。
- 按一下頂端選單中的「擁有者」。
- 如要新增使用者,請按一下「新增」。
- 在對話方塊中選取使用者。
- 在「Authorized to」(授權對象) 部分,至少選取下列權限:
Monitor SafeRetrieve files from SafeStore files in SafeAdmisiter Safe
- 如要儲存變更,請點選 [OK] (確定)。
- 如要關閉對話方塊視窗,請按一下「關閉」。
選用:設定用戶端憑證
您可以使用現有的用戶端憑證,或建立新的用戶端憑證,在 CyberArk PAM 執行個體和 Google SecOps SOAR 之間進行安全通訊。如要進一步瞭解如何設定用戶端憑證,請參閱「Central Credential Provider 網路服務設定」。
整合 CyberArk PAM 和 Google SecOps
整合時需要下列參數:
| 參數 | 說明 |
|---|---|
API Root |
必要 API 根網址。 請按照下列格式提供值: |
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
|
動作成功。 |
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 |
必要 根據提供的搜尋查詢執行搜尋時,要使用的搜尋運算子。 可能的值如下:
預設值為 |
Max Records To Return |
必要 要傳回的記錄數量。如未提供值,動作會傳回 50 筆記錄 (API 預設值)。 |
Records Offset |
必要 動作傳回值的偏移量。 |
Filter Query |
必要 要使用的篩選器查詢。您可以根據 |
Saved Filter |
必要 要使用的已儲存篩選器查詢。 這個參數的優先順序高於 |
動作輸出內容
「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」動作會提供下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作成功。 |
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 環境的名稱,用於查詢及更新整合執行個體、連接器和工作。如果是共用環境,請提供 預設值為 |
Credential Mapping |
這是必填欄位。 JSON 或 YAML 對應字串,用於將 SOAR 整合執行個體、連接器和工作對應至 CyberArk PAM 帳戶路徑。 值必須採用 預設值為 |
還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。