將 Google 翻譯與 Google SecOps 整合

本文說明如何設定 Google 翻譯，並與 Google Security Operations (Google SecOps) 整合。

事前準備

如要使用整合功能，您必須建立及設定 API 金鑰。

建立 API 金鑰

如要建立 API 金鑰，請完成下列步驟：

  1. 在 Google Cloud 控制台中，依序前往「APIs & Services」(API 和服務) > 「Credentials」(憑證)。

    前往「憑證」

  2. 按一下「add Create credentials」(建立憑證)。

  3. 選取「API 金鑰」，產生新的 API 金鑰。畫面上會顯示對話方塊，其中包含產生的 API 金鑰。

  4. 如要複製 API 金鑰，請按一下 「Copy」(複製)。

設定 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 實體上執行。

動作輸入內容

List Languages 動作需要下列參數：

參數 說明
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 筆記錄。

動作輸出內容

「List Languages」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 可用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
案件總覽表格

「List Languages」動作可產生下列資料表：

表格名稱：支援的語言

資料表欄：Language Key

JSON 結果

以下範例顯示使用「List Languages」動作時，收到的 JSON 結果輸出內容：

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

        ]
    }
}
輸出訊息

List Languages 動作可能會傳回下列輸出訊息：

輸出訊息 訊息說明

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

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼執行結果

下表列出使用「List Languages」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
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

使用「Translate Text」(翻譯文字) 動作，透過 Google 翻譯翻譯文字。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Translate Text」(翻譯文字) 動作需要下列參數：

參數 說明
Source Language

選填。

文字的原文語言。

如未設定這項參數，動作會自動偵測語言。
Target Language

這是必填欄位。

譯文語言。

預設值為 en。
Text

這是必填欄位。

要翻譯的文字。

動作輸出內容

「翻譯文字」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用「Translate Text」(翻譯文字) 動作時，收到的 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 專業人員尋求解答。