将 CyberArk PAM 与 Google SecOps 集成

本文档介绍了如何将 CyberArk Privileged Access Manager 与 Google Security Operations 集成。

准备工作

如需配置 CyberArk PAM 以便与集成搭配使用,您需要为集成创建一个用户,并向该用户提供访问所需 CyberArk PAM 保管箱的权限。

创建用户

完成以下步骤,为集成创建用户:

  1. 以管理员身份登录 PrivateArk 客户端。
  2. 依次前往工具 > 管理工具 > 用户和群组。
  3. 在用户和群组对话框中,选择用户位置,点击新建,然后选择用户。
  4. 在新用户对话框的不同标签页中,根据需要填写信息。常规和身份验证标签页为必填项。

如需详细了解如何创建用户,请参阅向保险柜添加用户。

向创建的用户授予权限

如需向新创建的用户添加对保险柜的访问权限,请完成以下步骤:

  1. 以管理员身份登录 PrivateArk 客户端。
  2. 选择您要提供访问权限的保险柜,然后登录该保险柜(双击该保险柜)。
  3. 在顶部菜单中,点击所有者。
  4. 如需添加新用户,请点击添加。
  5. 在对话框中,选择相应用户。
  6. 在授权对象部分,至少选择以下权限:
    • Monitor Safe
    • Retrieve files from Safe
    • Store files in Safe
    • Admisiter Safe
  7. 要保存更改,请点击确定。
  8. 如需退出对话框窗口,请点击关闭。

可选:配置客户端证书

您可以使用现有客户端证书,也可以创建新的客户端证书,以便在 CyberArk PAM 实例与 Google SecOps SOAR 之间进行安全通信。如需详细了解如何配置客户端证书,请参阅中央凭证提供程序 Web 服务配置。

集成 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 中配置集成,请参阅配置集成。

如有需要,您可以在后续阶段进行更改。配置集成实例后,您可以在 playbook 中使用该实例。如需详细了解如何配置和支持多个实例,请参阅支持多个实例。

操作

如需详细了解操作,请参阅 在工作桌上响应待处理的操作和在案例中运行手动操作。

获取账号密码值

使用获取账号密码值操作从 CyberArk 获取账号密码值。

通过此操作,您可以同时检索密码和 SSH 密钥。

此操作不会在 Google SecOps 实体上运行。

操作输入

获取账号密码值操作需要以下参数:

参数 说明
Account 必需

要检索其密码值的账号 ID。

注意:账号 ID 可通过列出账号操作检索。

Reason 必需

访问账号密码值的原因。

系统会自动从 Google SecOps SOAR 中检索默认值。

Ticketing System Name 可选

票务系统的名称。

Ticket ID 可选

工单系统的工单 ID。

Version 可选

要检索的账号密码值版本。

操作输出

获取账号密码值操作会提供以下输出:

操作输出类型 可用性
案例墙附件 不可用
案例墙链接 不可用
案例墙表格 不可用
丰富化表 不可用
JSON 结果 可用
输出消息 可用
脚本结果 可用
JSON 结果

以下示例介绍了使用获取账号密码值操作时收到的 JSON 结果输出:

{
 "content": "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

操作失败。

请检查与服务器的连接、输入参数或凭据。

脚本结果

下表介绍了使用获取账号密码值操作时脚本结果输出的值:

脚本结果名称 值
is_success True 或 False

列出账号

使用列出账号操作,根据提供的条件列出 CyberArk PAM 中可用的账号。

此操作不会在 Google SecOps SOAR 实体上运行。

操作输入

列出账号操作需要以下参数:

参数 说明
Search Query 必需

要使用的搜索查询。

Search operator 必需

用于根据提供的搜索查询运行搜索的搜索运算符。

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

默认值为 contains。

Max Records To Return 必需

要返回的记录数量。如果您未提供值,该操作会返回 50 条记录(API 默认值)。

Records Offset 必需

操作返回值的偏移量。

Filter Query 必需

要使用的过滤条件查询。您可以根据 safeName 或 modificationTime 参数设置过滤条件。

Saved Filter 必需

要使用的已保存过滤条件查询。

此参数的优先级高于 Filter Query 参数。

操作输出

列出账号操作会提供以下输出:

操作输出类型 可用性
案例墙附件 不可用
案例墙链接 不可用
案例墙表格 可用
丰富化表 不可用
JSON 结果 可用
输出消息 可用
脚本结果 可用
案例墙表格

在案例墙上,列出账号操作会提供下表:

表名称:Available PAM Accounts

表列:

  • ID
  • 保险柜名称
  • 用户名
  • Secret 类型
JSON 结果

以下示例说明了使用列出账号操作时收到的 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
}
输出消息

列出账号操作会提供以下输出消息:

输出消息 消息说明

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

操作失败。

请检查与服务器的连接、输入参数或凭据。

脚本结果

下表介绍了使用列出账号操作时脚本结果输出的值:

脚本结果名称 值
is_success True 或 False

Ping

使用 *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 的逗号分隔列表。

注意:您可以直接从列出账号操作的输出参数中检索目标账号 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 - 同步集成凭证作业,通过动态更新集成实例、连接器和计划作业的配置,自动从 CyberArk PAM 提取账号凭证和 Secret,并将其同步到 Google SecOps SOAR。

作业参数

CyberArk PAM - 同步集成凭据作业需要以下参数:

参数 说明
API Root

必填。

CyberArk PAM 的 API 根网址。

如果未提供任何值,则作业会引用集成配置中提供的值。

Username

必填。

用于连接到 CyberArk PAM 的用户名。

如果未提供任何值,则作业会引用集成配置中提供的值。

Password

必填。

用于连接到 CyberArk PAM 的密码。

如果未提供任何值,则作业会引用集成配置中提供的值。

Verify SSL

必填。

如果选中,集成会在连接到 CyberArk PAM 服务器时验证 SSL 证书。

默认处于启用状态。

CA Certificate

可选。

用于验证与 API 根的 SSL 连接的 Base64 编码 CA 证书。

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 专业人士的解答。