将 CyberArk Credential Provider 与 Google SecOps 集成

本文档介绍了如何将 CyberArk Credential Provider 与 Google Security Operations (Google SecOps) 集成。

准备工作

如需配置此集成，您必须在 Linux 主机上安装 CyberArk Credential Provider。

在为 Google SecOps 配置 CyberArk Credential Provider 集成之前，请先完成以下前提条件：

  • 在 Linux 主机上安装 CyberArk Credential Provider。

  • 如果您使用的是 Docker 容器来运行 Google SecOps 远程代理，请执行以下操作：

    • 配置 Docker 容器。

    • 生成 SSH 密钥，以便与主机安全通信。

集成参数

CyberArk Credential Provider 集成需要以下参数：

                                                                       
参数说明
Path to clipasswordsdk

必填。

CLI Application Password SDK 的完整路径。

默认值为 /opt/CARKaim/sdk/clipasswordsdk。

Username for Credential Provider for Linux

必填。

远程代理在 Docker 容器中部署时用于进行身份验证的用户名。

默认值为 secopssuser。

Docker Gateway IP Address

必填。

Docker 网关的 IP 地址。

默认值为 172.17.0.1。

Host Public Key

必填。

宿主机公钥，用于确保与正确服务器的安全连接，并防止未经授权的访问。
SSH Private Key Path

可选。

SSH 私钥的完整路径。

这是推荐的身份验证方法，如果选择此方法，则此参数是必需的。

Password for Credential Provider for Linux

可选。

远程代理在 Docker 容器中部署时进行身份验证所需的密码。

如需了解如何在 Google SecOps 中配置集成，请参阅配置集成。

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

操作

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

Ping

使用 Ping 操作测试与 Credential Provider 的连接。

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

操作输入

无。

操作输出

Ping 操作提供以下输出：

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

Ping 操作可能会返回以下输出消息：

                                                                   
输出消息消息说明

Successfully connected to the CyberArk Credential Provider with the provided connection parameters!

操作成功。
Failed to connect to the CyberArk Credential Provider! Error is ERROR_REASON

操作失败。

请检查与服务器的连接、输入参数或凭证。
脚本结果

下表列出了使用 Ping 操作时脚本结果输出的值：

                                               
脚本结果名称值
is_successTrue 或 False

获取应用密码值

使用获取应用密码值操作从 CyberArk Credential Provider 检索应用密码值。

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

操作输入

获取应用密码值操作需要以下参数：

                                                                     
参数说明
Application

必填。

要从中检索密码值的应用 ID。

Safe Name

必填。

要从中检索密码的保险柜的名称。

Folder Name

必填。

要从中检索密码的文件夹的名称。

Object Name

必填。

要从中检索密码的对象的名称。

Output

必填。

以逗号分隔列表形式的输出字段，用于指定要检索的数据。

默认值为 Password。

操作输出

获取应用密码值操作提供以下输出：

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

以下示例展示了使用获取应用密码值操作时收到的 JSON 结果输出：

{
    "result": "YYYY"
}
输出消息

获取应用密码值操作可能会返回以下输出消息：

                                                                   
输出消息消息说明
Successfully fetched password value for the application ID APPLICATION_ID.

The password value for the application ID APPLICATION_ID was not found in the CyberArk Credential Provider.

操作成功。

Error executing action "Get Application Password Value": ERROR_REASON.

操作失败。

请检查与服务器的连接、输入参数或凭证。
脚本结果

下表列出了使用获取应用密码值操作时脚本结果输出的值：

                                               
脚本结果名称值
is_successTrue 或 False

运行 CLI 应用密码 SDK 命令

使用运行 CLI 应用密码 SDK 命令操作，通过 CLI Application Password SDK 参数直接在 CyberArk Credential Provider 上运行命令。

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

操作输入

运行 CLI 应用密码 SDK 命令操作需要以下参数：

                       
参数说明
clipasswdsdk Command

必填。

CLI 应用密码 SDK 要运行的命令。

示例：APPID=Application-Password-SDK user=admin safe=safe folder=folder object=object

操作输出

运行 CLI 应用密码 SDK 命令操作提供以下输出：

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

以下示例展示了使用运行 CLI 应用密码 SDK 命令操作时收到的 JSON 结果输出：

{
   "output_value": "COMMAND_OUTPUT"
}
输出消息

运行 CLI 应用密码 SDK 命令操作可能会返回以下输出消息：

                                                             
输出消息消息说明

Successfully executed the following CLI Application Password SDK command: COMMAND.

操作成功。
Error executing the following command: COMMAND.      

Error executing action "Run CLI Application Password SDK Command". Reason: ERROR_REASON.

操作失败。

请检查命令语法、与服务器的连接或凭据。
脚本结果

下表列出了使用运行 CLI 应用密码 SDK 命令操作时脚本结果输出的值：

脚本结果名称 值
is_success True 或 False

作业

同步集成凭证作业

使用同步集成凭据作业同步 CyberArk Credential Provider Secret Manager 条目，并自动更新集成、连接器和作业配置。

作业输入

同步集成凭证作业需要以下参数：

参数 说明
Environment Name

必填。

要在其中搜索凭据的环境的名称。对于共享环境，请提供 *。

默认值为 Default Environment。
Credential Mapping

必填。

一个 JSON 对象，用于指定要同步的凭据的组件显示名称、参数名称和 CyberArk Secret Manager 条目查找字符串。在运行作业之前，必须先在平台上配置目标集成实例、连接器或作业。

Secret Manager 条目采用以下格式：

AppDescs.AppID=<app_id>;Safe=<safe_name>;Object=<object_name>[;Folder=<folder_name>]

通用结构：

{
  "integration_instances": {
    "<integration_instance_display_name>": {
      "<parameter_name>": "AppDescs.AppID=<app_id>;Safe=<safe_name>;Object=<object_name>[;Folder=<folder_name>]"
    }
  },
  "connectors": {
    "<connector_display_name>": {
      "<parameter_name>": "AppDescs.AppID=<app_id>;Safe=<safe_name>;Object=<object_name>[;Folder=<folder_name>]"
    }
  },
  "jobs": {
    "<job_display_name>": {
      "<parameter_name>": "AppDescs.AppID=<app_id>;Safe=<safe_name>;Object=<object_name>[;Folder=<folder_name>]"
    }
  }
}

配置示例：

{
  "integration_instances": {
    "MicrosoftGraphMail_1": {
      "Tenant": "AppDescs.AppID=<app_id>;Safe=<safe_name>;Object=<object_name>;Folder=<folder_name>"
    }
  },
  "connectors": {
    "Microsoft Graph Mail Connector": {
      "Tenant": "AppDescs.AppID=<app_id>;Safe=<safe_name>;Object=<object_name>;Folder=<folder_name>"
    }
  },
  "jobs": {
    "Sync Mail Job": {
      "Tenant": "AppDescs.AppID=<app_id>;Safe=<safe_name>;Object=<object_name>;Folder=<folder_name>"
    }
  }
}

注意：集成实例显示名称特定于所选环境，并且每个环境的显示名称必须是唯一的。连接器和作业独立于环境。
Path to clipasswordsdk

必填。

CLI Application Password SDK 的完整路径。

默认值为 /opt/CARKaim/sdk/clipasswordsdk。
Username for Credential Provider for Linux

必填。

远程代理在 Docker 容器中部署时用于进行身份验证的用户名。

默认值为 secopsuser。
Docker Gateway IP Address

必填。

Docker 网关的 IP 地址。

默认值为 172.17.0.1。
Host Public Key

必填。

宿主机公钥，用于确保与正确服务器的安全连接，并防止未经授权的访问。
SSH Private Key Path

可选。

SSH 私钥的完整路径。这是推荐的身份验证方法，如果选择此方法，则此参数是必需的。
Password for Credential Provider for Linux

可选。

远程代理在 Docker 容器中部署时进行身份验证所需的密码。

需要更多帮助？获得社区成员和 Google SecOps 专业人士的解答。