将 Google 翻译与 Google SecOps 集成

本文档介绍了如何配置 Google 翻译并将其与 Google Security Operations (Google SecOps) 集成。

准备工作

如需使用此集成,您需要创建并配置 API 密钥。

创建 API 密钥

如需创建 API 密钥,请完成以下步骤:

  1. 在 Google Cloud 控制台中,前往 API 和服务 > 凭据。

    进入“凭据”页面

  2. 点击 add 创建凭证。

  3. 选择 API 密钥以生成新的 API 密钥。系统会显示一个对话框,其中包含生成的 API 密钥。

  4. 如需复制 API 密钥,请点击 复制。

配置 API 密钥限制

如需为 API 密钥配置 API 限制,请完成以下步骤:

  1. 点击限制密钥。

  2. 在 API 限制下,选择限制密钥。

  3. 从 API 列表中选择 Cloud Translation API。

  4. 配置适用的限制。

  5. 点击保存,以保存 API 密钥配置。

集成参数

Google 翻译集成需要以下参数:

参数 说明
API Root

必填。

Google 翻译实例的 API 根。

默认值为 https://translation.googleapis.com。

如需详细了解 Cloud Translation API,请参阅 Cloud Translation API。

API Key

必填。

Google 翻译账号的 API 密钥。

Verify SSL

必填。

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

默认处于选中状态。

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

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

操作

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

列出语言

使用列出语言操作列出 Google 翻译中的可用语言。

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

操作输入

列出语言操作需要以下参数:

参数 说明
Filter Key

可选。

用于过滤语言的键。

可能的值如下:

  • Select One
  • Name

默认值为 Select One。

Filter Logic

可选。

要应用的过滤逻辑。

过滤逻辑使用您在 Filter Key 参数中设置的值。

可能的值如下:

  • Not Specified
  • Equal
  • Contains

默认值为 Not Specified。

Filter Value

可选。

要在过滤条件中使用的值。

过滤逻辑使用您在 Filter Key 参数中设置的值。

如果选择 Equal,则该操作会在结果中搜索完全匹配项。如果选择 Contains,则该操作会搜索包含指定子字符串的结果。

如果您未选择值,则操作会忽略过滤条件。

过滤逻辑会根据 Filter Key 参数中提供的值运行。

Max Records To Return

可选。

要返回的记录数上限。

最大值为 50。

如果您未设置值,则该操作默认返回 50 条记录。

操作输出

列出语言操作提供以下输出:

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

列出语言操作可以生成下表:

表名称:支持的语言

表列:Language Key

JSON 结果

以下示例展示了使用列出语言操作时收到的 JSON 结果输出:

{
    "data": {
        "languages": [
            {
                "language": "af"
            },
            {
                "language": "am"
            },
            {
                "language": "ar"
            }

        ]
    }
}
输出消息

列出语言操作可以返回以下输出消息:

输出消息 消息说明

Successfully found language for the provided criteria in Google Translate.

No languages were found for the provided criteria in Google Translate.

The filter was not applied, because parameter "Filter Value" has an empty value.

操作成功。
Error executing action "List Languages". Reason: ERROR_REASON

操作失败。

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

脚本结果

下表列出了使用列出语言操作时脚本结果输出的值:

脚本结果名称 值
is_success True 或 False

Ping

使用 Ping 操作测试与 Google 翻译的连接。

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

操作输入

无。

操作输出

Ping 操作提供以下输出:

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

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

输出消息 消息说明

Successfully connected to the Google Translate server with the provided connection parameters!

操作成功。
Failed to connect to the Google Translate server! Error is ERROR_REASON

操作失败。

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

脚本结果

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

脚本结果名称 值
is_success True 或 False

翻译文字

使用翻译文本操作通过 Google 翻译来翻译文本。

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

操作输入

翻译文本操作需要以下参数:

参数 说明
Source Language

可选。

文本的源语言。

如果您未配置此参数,该操作会自动检测语言。

Target Language

必填。

目标语言。

默认值为 en。

Text

必填。

要翻译的文本。

操作输出

翻译文本操作会提供以下输出:

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

以下示例展示了使用翻译文本操作时收到的 JSON 结果输出:

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}
输出消息

翻译文本操作可能会返回以下输出消息:

输出消息 消息说明

Successfully translated the provided text in Google Translate.

操作成功。
Error executing action "Translate Text". Reason: ERROR_REASON

操作失败。

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

脚本结果

下表列出了使用翻译文本操作时脚本结果输出的值:

脚本结果名称 值
is_success True 或 False

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