Integra Google Translate con Google SecOps

En este documento, se explica cómo configurar e integrar Google Translate con Google Security Operations (Google SecOps).

Versión de integración: 4.0

Antes de comenzar

Para usar la integración, debes crear y configurar una clave de API.

Crea la clave de API

Para crear la clave de API, completa los siguientes pasos:

1. En la consola de Google Cloud , ve a APIs y servicios > Credenciales.

   Ir a Credenciales

2. Haz clic en add Crear credenciales.

3. Selecciona Clave de API para generar una clave de API nueva. Aparecerá un diálogo con una clave de API generada.

4. Para copiar la clave de API, haz clic en Copiar.

Configura las restricciones de la clave de API

Para configurar la restricción de la API para la clave de API, completa los siguientes pasos:

1. Haz clic en Restringir clave.

2. En Restricciones de API, selecciona Restringir clave.

3. Selecciona API de Cloud Translation en la lista de APIs.

4. Configura las restricciones correspondientes.

5. Haz clic en Guardar para guardar la configuración de la clave de API.

Parámetros de integración

La integración de Google Translate requiere los siguientes parámetros:

Parámetro	Descripción
API Root	Obligatorio. Es la raíz de la API de la instancia de Google Traductor. El valor predeterminado es https://translation.googleapis.com. Para obtener más información sobre la API de Cloud Translation, consulta API de Cloud Translation.
API Key	Obligatorio. Es la clave de API de la cuenta de Google Traductor.
Verify SSL	Obligatorio. Si se selecciona esta opción, la integración valida el certificado SSL cuando se conecta al servidor de Google Translate. Esta opción se selecciona de forma predeterminada.

Si quieres obtener instrucciones para configurar una integración en Google SecOps, consulta Configura integraciones.

Si es necesario, puedes hacer cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Compatibilidad con varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Cómo responder a las acciones pendientes desde Tu escritorio y Cómo realizar una acción manual.

List Languages

Usa la acción List Languages para enumerar los idiomas disponibles en Google Traductor.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción List Languages requiere los siguientes parámetros:

Parámetro	Descripción
Filter Key	Opcional. Es una clave para filtrar idiomas. Los valores posibles son los siguientes: Select One Name El valor predeterminado es Select One.
Filter Logic	Opcional. Es la lógica de filtro que se aplicará. La lógica de filtrado usa el valor que estableces en el parámetro Filter Key. Los valores posibles son los siguientes: Not Specified Equal Contains El valor predeterminado es Not Specified.
Filter Value	Opcional. Es un valor para usar en el filtro. La lógica de filtrado usa el valor que estableces en el parámetro Filter Key. Si se selecciona Equal, la acción busca la coincidencia exacta entre los resultados. Si se selecciona Contains, la acción busca resultados que contengan la subcadena especificada. Si no seleccionas un valor, la acción ignorará el filtro. La lógica de filtrado funciona según el valor proporcionado en el parámetro Filter Key.
Max Records To Return	Opcional. Es la cantidad máxima de registros que se devolverán. El valor máximo es 50. Si no estableces un valor, la acción devolverá 50 registros de forma predeterminada.

Resultados de la acción

La acción List Languages proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	Disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Tabla del muro de casos

La acción List Languages puede generar la siguiente tabla:

Nombre de la tabla: Available Languages

Columna de la tabla: Clave de idioma

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción List Languages:

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

        ]
    }
}

Mensajes de salida

La acción List Languages puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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.	La acción se completó correctamente.
Error executing action "List Languages". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado del script cuando se usa la acción List Languages:

Nombre del resultado de la secuencia de comandos	Valor
is_success	True o False

Ping

Usa la acción Ping para probar la conectividad con Google Translate.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Ping proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Ping puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully connected to the Google Translate server with the provided connection parameters!	La acción se completó correctamente.
Failed to connect to the Google Translate server! Error is ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Ping:

Nombre del resultado de la secuencia de comandos	Valor
is_success	True o False

Traducir texto

Usa la acción Translate Text para traducir texto con Google Traductor.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Translate Text requiere los siguientes parámetros:

Parámetro	Descripción
Source Language	Opcional. Es el idioma de origen del texto. Si no configuras este parámetro, la acción detectará el idioma automáticamente.
Target Language	Obligatorio. Es un idioma objetivo. El valor predeterminado es en.
Text	Obligatorio. Es un texto que se debe traducir.

Resultados de la acción

La acción Translate Text proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Traducir texto:

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}

Mensajes de salida

La acción Translate Text puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully translated the provided text in Google Translate.	La acción se completó correctamente.
Error executing action "Translate Text". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Translate Text:

Nombre del resultado de la secuencia de comandos	Valor
is_success	True o False

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.