将 Google 翻译与 Google SecOps 集成

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

集成版本：4.0

准备工作

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

创建 API 密钥

如需创建 API 密钥，请完成以下步骤：

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

    进入“凭据”页面

  2. 点击添加 创建凭据。

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

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

操作

如需详细了解操作，请参阅 在工作台页面中处理待处理的操作和执行手动操作。

列出语言

使用 List Languages 操作列出 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 结果 可用
输出消息 可用
脚本结果 可用
“支持请求墙”表格

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

表格名称：Available Languages

表格列：语言键

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

翻译文字

使用 Translate Text 操作通过 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 专业人士那里获得解答。