將 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 restrictions」下方，選取「Restrict key」。

  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 中設定整合功能的操作說明，請參閱「設定整合功能」。

如有需要，您可以在稍後階段進行變更。設定整合執行個體後，您就可以在劇本中使用該執行個體。如要進一步瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作，請參閱「 從工作台回覆待處理動作」和「執行手動動作」。

列出語言

使用「列出語言」動作，列出 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」動作測試與 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 專業人員尋求答案。