将 CyberArk PAM 与 Google SecOps 集成
本文档介绍了如何将 CyberArk Privileged Access Manager 与 Google Security Operations 集成。
准备工作
如需配置 CyberArk PAM 以便与集成搭配使用,您需要为集成创建一个用户,并向该用户提供访问所需 CyberArk PAM 保管箱的权限。
创建用户
完成以下步骤,为集成创建用户:
- 以管理员身份登录 PrivateArk 客户端。
- 依次前往工具 > 管理工具 > 用户和群组。
- 在用户和群组对话框中,选择用户位置,点击新建,然后选择用户。
- 在新用户对话框的不同标签页中,根据需要填写信息。常规和身份验证标签页为必填项。
如需详细了解如何创建用户,请参阅向保险柜添加用户。
向创建的用户授予权限
如需向新创建的用户添加对保险柜的访问权限,请完成以下步骤:
- 以管理员身份登录 PrivateArk 客户端。
- 选择您要提供访问权限的保险柜,然后登录该保险柜(双击该保险柜)。
- 在顶部菜单中,点击所有者。
- 如需添加新用户,请点击添加。
- 在对话框中,选择相应用户。
- 在授权对象部分,至少选择以下权限:
Monitor SafeRetrieve files from SafeStore files in SafeAdmisiter Safe
- 要保存更改,请点击确定。
- 如需退出对话框窗口,请点击关闭。
可选:配置客户端证书
您可以使用现有客户端证书,也可以创建新的客户端证书,以便在 CyberArk PAM 实例与 Google SecOps SOAR 之间进行安全通信。如需详细了解如何配置客户端证书,请参阅中央凭证提供程序 Web 服务配置。
集成 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 中配置集成,请参阅配置集成。
如有需要,您可以在后续阶段进行更改。配置集成实例后,您可以在 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
|
操作成功。 |
Error executing action "Get Account Password Value". Reason:
ERROR_REASON |
操作失败。 请检查与服务器的连接、输入参数或凭据。 |
脚本结果
下表介绍了使用获取账号密码值操作时脚本结果输出的值:
| 脚本结果名称 | 值 |
|---|---|
is_success |
True 或 False |
列出账号
使用列出账号操作,根据提供的条件列出 CyberArk PAM 中可用的账号。
此操作不会在 Google SecOps SOAR 实体上运行。
操作输入
列出账号操作需要以下参数:
| 参数 | 说明 |
|---|---|
Search Query |
必需 要使用的搜索查询。 |
Search operator |
必需 用于根据提供的搜索查询运行搜索的搜索运算符。 可能的值如下:
默认值为 |
Max Records To Return |
必需 要返回的记录数量。如果您未提供值,该操作会返回 50 条记录(API 默认值)。 |
Records Offset |
必需 操作返回值的偏移量。 |
Filter Query |
必需 要使用的过滤条件查询。您可以根据 |
Saved Filter |
必需 要使用的已保存过滤条件查询。 此参数的优先级高于 |
操作输出
列出账号操作会提供以下输出:
| 操作输出类型 | 可用性 |
|---|---|
| 案例墙附件 | 不可用 |
| 案例墙链接 | 不可用 |
| 案例墙表格 | 可用 |
| 丰富化表 | 不可用 |
| 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
}
输出消息
列出账号操作会提供以下输出消息:
| 输出消息 | 消息说明 |
|---|---|
|
操作成功。 |
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 环境的名称。对于共享环境,请提供 默认值为 |
Credential Mapping |
必填。 JSON 或 YAML 映射字符串,用于将 SOAR 集成实例、连接器和作业映射到其 CyberArk PAM 账号路径。 值必须使用 默认值为 |
需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。