Google Translate

Integration version: 3.0

Configure Google Translate integration in Google Security Operations SOAR

For detailed instructions on how to configure an integration in Google Security Operations SOAR, see Configure integrations.

Integration parameters

Use the following parameters to configure the integration:

Parameter Display Name Type Default Value Is mandatory Description
API Root String https://translation.googleapis.com Yes API root of the Google Translate instance.
API Key Password N/A Yes API key of the Google Translate account.
Verify SSL Checkbox Checked Yes If enabled, verifies that the SSL certificate for the connection to the Google Translate server is valid.

How to generate API Key

  1. Navigate to your Google Cloud project.
  2. Go to API Services -> Credentials.
  3. Create a new API Key.
  4. Make sure to add Cloud Translation API to "Restrictions".

Product Use Cases

Translate texts.

Actions

Ping

Description

Test connectivity to Google Translate with parameters provided at the integration configuration page in the Google Security Operations Marketplace tab.

Parameters

N/A

Run On

The action doesn't run on entities, nor has mandatory input parameters.

Action Results

Script Result
Script Result Name Value Options Example
is_success True/False is_success=False
JSON Result
 N/A
Entity Enrichment

N/A

Insights

N/A

Case Wall
Result type Value/Description Type
Output message*

The action should not fail nor stop a playbook execution:

If successful: "Successfully connected to the Google Translate server with the provided connection parameters!"

The action should fail and stop a playbook execution:

If not successful: "Failed to connect to the Google Translate server! Error is {0}".format(exception.stacktrace)

General

Translate Text

Description

Translate text using Google Translate.

Parameters

Parameter Display Name Type Default Value Is Mandatory Description
Source Language String N/A No Specify the source language of the text. If nothing is provided, action will detect the language automatically.
Target Language String en Yes Specify the desired language.
Text String N/A Yes Specify the text that needs to be translated.

Run On

This action doesn't run on entities.

Action Results

Script Result
Script Result Name Value Options Example
is_success True/False is_success=False
JSON Result
{
    "data": {
        "translations": [
            {
                "translatedText": "La gran pirámide de giza"
            }
        ]
    }
}
Entity Enrichment

N/A

Insights

N/A

Case Wall
Result type Value/Description Type
Output message*

The action should not fail nor stop a playbook execution:

If the 200 status code is reported (is_success=true): "Successfully translated the provided text in Google Translate."

The action should fail and stop a playbook execution:

If a fatal error, like wrong credentials, no connection to the server, other is reported: "Error executing action "Translate Text". Reason: {0}''.format(error.Stacktrace)

General

List Languages

Description

List available languages in Google Translate.

Parameters

Parameter Display Name Type Default Value Is Mandatory Description
Filter Key DDL

Select One

Possible Values:

  • Name
No Specify the key that needs to be used to filter languages.
Filter Logic DDL

Not Specified

Possible Values:

  • Not Specified
  • Equal
  • Contains
No

Specify the filter logic that should be applied.

Filtering logic is working based on the value provided in the "Filter Key" parameter.

Filter Value String N/A No

Specify the value that should be used in the filter.

If "Equal" is selected, the action tries to find the exact match among results.

If "Contains" is selected, the action tries to find results that contain the specified substring.

If nothing is provided in this parameter, the filter is not applied.

Filtering logic is working based on the value provided in the "Filter Key" parameter.

Max Records To Return Integer 50 No Specify the number of records to return. If nothing is provided, the action returns 50 records.

Run On

This action doesn't run on entities.

Action Results

Script Result
Script Result Name Value Options Example
is_success True/False is_success=False
JSON Result
{
    "data": {
        "languages": [
            {
                "language": "af"
            },
            {
                "language": "am"
            },
            {
                "language": "ar"
            }

        ]
    }
}
Entity Enrichment

N/A

Insights

N/A

Case Wall
Result type Value/Description Type
Output message*

The action should not fail nor stop a playbook execution:

If data is available (is_success=true): "Successfully found language for the provided criteria in Google Translate."

If data is not available (is_success=false): "No languages were found for the provided criteria in Google Translate."

If the "Filter Value" parameter is empty (is_success=true): "The filter was not applied, because parameter "Filter Value" has an empty value."

The action should fail and stop a playbook execution:

If the "Filter Key" parameter is set to "Select One" and the "Filter Logic" parameter is set "Equal" or "Contains": "Error executing action "{action name}". Reason: you need to select a field from the "Filter Key" parameter."

If an invalid value is provided for the "Max Records to Return" parameter: "Error executing action "{action name}". Reason: "Invalid value was provided for "Max Records to Return": . Positive number should be provided."

If a fatal error, like wrong credentials, no connection to the server, other is reported: "Error executing action "{action name}". Reason: {0}''.format(error.Stacktrace)

General
Case Wall Table

Table Name: Available Languages

Table Columns:

Language Key

General