Integrar Traductor de Google con Google SecOps

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

Versión de integración: 4.0

Antes de empezar

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

Crear la clave de API

Para crear la clave de API, sigue estos pasos:

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

   Ir a Credenciales

2. Haz clic en Añadir Crear credenciales.

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

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

Configurar las restricciones de la clave de API

Para configurar la restricción de la API en la clave de API, sigue estos pasos:

1. Haz clic en Restringir clave.

2. En Restricciones de API, selecciona Restringir clave.

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

4. Configura las restricciones aplicables.

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

Parámetros de integración

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

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

Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configurar integraciones.

Si es necesario, puedes hacer cambios más adelante. Después de configurar una instancia de integración, puedes usarla en los cuadernos de estrategias. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Admitir varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Responder a acciones pendientes desde Tu espacio de trabajo y Realizar una acción manual.

List Languages

Usa la acción List Languages (Listar idiomas) para ver los idiomas disponibles en el Traductor de Google.

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

Entradas de acciones

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

Parámetro	Descripción
Filter Key	Opcional. Una clave para filtrar idiomas. Estos son los valores posibles: Select One Name El valor predeterminado es Select One.
Filter Logic	Opcional. Lógica de filtro que se va a aplicar. La lógica de filtrado usa el valor que hayas definido en el parámetro Filter Key. Estos son los valores posibles: Not Specified Equal Contains El valor predeterminado es Not Specified.
Filter Value	Opcional. Valor que se usará en el filtro. La lógica de filtrado usa el valor que hayas definido 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 selecciona ningún valor, la acción ignorará el filtro. La lógica de filtrado funciona en función del valor proporcionado en el parámetro Filter Key.
Max Records To Return	Opcional. Número máximo de registros que se devolverán. El valor máximo es 50. Si no define ningún valor, la acción devuelve 50 registros de forma predeterminada.

Resultados de la acción

La acción List Languages (Listar idiomas) proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del panel de casos	No disponible
Enlace del panel de casos	No disponible
Tabla del panel de casos	Disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de la secuencia de comandos	Disponible

Tabla del panel de casos

La acción List Languages (Lista de idiomas) 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 la salida del resultado JSON recibida al usar la acción List Languages (Listar idiomas):

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

        ]
    }
}

Mensajes de salida

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

Mensaje resultante	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 ha realizado correctamente.
Error executing action "List Languages". Reason: ERROR_REASON	No se ha podido realizar la acción. Comprueba la conexión al servidor, los parámetros de entrada o las credenciales.

Resultado de la secuencia de comandos

En la siguiente tabla se muestra el valor de la salida del resultado de la secuencia de comandos al usar la acción List Languages (Listar idiomas):

Nombre del resultado del script	Valor
is_success	True o False

Ping

Usa la acción Ping para probar la conectividad con el Traductor de Google.

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

Entradas de acciones

Ninguno

Resultados de la acción

La acción Ping proporciona las siguientes salidas:

Tipo de salida de la acción	Disponibilidad
Adjunto del panel de casos	No disponible
Enlace del panel de casos	No disponible
Tabla del panel de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de la secuencia de comandos	Disponible

Mensajes de salida

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

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

Resultado de la secuencia de comandos

En la siguiente tabla se muestra el valor de la salida del resultado de la secuencia de comandos al usar la acción Ping:

Nombre del resultado del script	Valor
is_success	True o False

Traducción de texto

Usa la acción Traducir texto para traducir texto con el Traductor de Google.

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

Entradas de acciones

La acción Traducir texto requiere los siguientes parámetros:

Parámetro	Descripción
Source Language	Opcional. Idioma de origen del texto. Si no lo configuras, la acción detectará el idioma automáticamente.
Target Language	Obligatorio. Un idioma de destino. El valor predeterminado es en.
Text	Obligatorio. Un texto que traducir.

Resultados de la acción

La acción Traducir texto proporciona los siguientes resultados:

Tipo de salida de la acción	Disponibilidad
Adjunto del panel de casos	No disponible
Enlace del panel de casos	No disponible
Tabla del panel de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de la secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo se muestra la salida del resultado JSON recibida al usar la acción Traducir texto:

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

Mensajes de salida

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

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

Resultado de la secuencia de comandos

En la siguiente tabla se muestra el valor de la salida del resultado de la secuencia de comandos al usar la acción Traducir texto:

Nombre del resultado del script	Valor
is_success	True o False

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.