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 で統合を構成する方法については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。

言語の一覧表示

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 件のレコードを返します。

アクションの出力

言語を一覧表示アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用可能
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
ケースウォール テーブル

List Languages アクションは、次の表を生成できます。

テーブル名: Available 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

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 のプロフェッショナルから回答を得ることができます。