Google SecOps と Google 翻訳を統合する

このドキュメントでは、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 で統合を構成する手順については、統合を構成するをご覧ください。

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

操作

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

言語の一覧表示

言語を一覧表示アクションを使用して、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 のプロフェッショナルから回答を得ることができます。