Integrar o Google Tradutor ao Google SecOps

Este documento explica como configurar e integrar o Google Tradutor ao Google Security Operations (Google SecOps).

Versão da integração: 4.0

Antes de começar

Para usar a integração, crie e configure uma chave de API.

Criar a chave de API

Para criar a chave de API, siga estas etapas:

  1. No console Google Cloud , acesse APIs e serviços > Credenciais.

    Ir para Credenciais

  2. Clique em add Criar credenciais.

  3. Selecione Chave de API para gerar uma nova chave. Uma caixa de diálogo vai aparecer com uma chave de API gerada.

  4. Para copiar a chave de API, clique em Copiar.

Configurar as restrições de chave de API

Para configurar a restrição de API para a chave de API, siga estas etapas:

  1. Clique em Restringir chave.

  2. Em Restrições de API, selecione Restringir chave.

  3. Selecione API Cloud Translation na lista de APIs.

  4. Configure as restrições aplicáveis.

  5. Clique em Salvar para salvar a configuração da chave de API.

Parâmetros de integração

A integração com o Google Tradutor exige os seguintes parâmetros:

Parâmetro Descrição
API Root

Obrigatório.

A raiz da instância do Google Tradutor.

O valor padrão é https://translation.googleapis.com.

Para mais informações sobre a API Cloud Translation, consulte API Cloud Translation.
API Key

Obrigatório.

A chave de API da conta do Google Tradutor.
Verify SSL

Obrigatório.

Se selecionada, a integração valida o certificado SSL ao se conectar ao servidor do Google Tradutor.

Essa opção é selecionada por padrão.

Para instruções sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

É possível fazer mudanças mais tarde, se necessário. Depois de configurar uma instância de integração, você pode usá-la em playbooks. Para mais informações sobre como configurar e oferecer suporte a várias instâncias, consulte Suporte a várias instâncias.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes da sua mesa de trabalho e Realizar uma ação manual.

Listar idiomas

Use a ação List Languages para listar os idiomas disponíveis no Google Tradutor.

Essa ação não é executada em entidades do Google SecOps.

Entradas de ação

A ação List Languages exige os seguintes parâmetros:

Parâmetro Descrição
Filter Key

Opcional.

Uma chave para filtrar idiomas.

Os valores possíveis são:

  • Select One
  • Name

O valor padrão é Select One.
Filter Logic

Opcional.

Uma lógica de filtro a ser aplicada.

A lógica de filtragem usa o valor definido no parâmetro Filter Key.

Os valores possíveis são:

  • Not Specified
  • Equal
  • Contains

O valor padrão é Not Specified.
Filter Value

Opcional.

Um valor a ser usado no filtro.

A lógica de filtragem usa o valor definido no parâmetro Filter Key.

Se Equal estiver selecionado, a ação vai procurar a correspondência exata entre os resultados. Se Contains estiver selecionado, a ação vai pesquisar resultados que contenham a substring especificada.

Se você não selecionar um valor, a ação vai ignorar o filtro.

A lógica de filtragem está funcionando com base no valor fornecido no parâmetro Filter Key.
Max Records To Return

Opcional.

O número máximo de registros a serem retornados.

O valor máximo é 50.

Se você não definir um valor, a ação vai retornar 50 registros por padrão.

Saídas de ação

A ação List Languages fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Disponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Tabela do painel de casos

A ação List Languages pode gerar a seguinte tabela:

Nome da tabela: Available Languages

Coluna da tabela: Chave do idioma

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação List Languages:

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

        ]
    }
}
Mensagens de saída

A ação List Languages pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

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.

 A ação foi concluída.
Error executing action "List Languages". Reason: ERROR_REASON

A ação falhou.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação List Languages:

Nome do resultado do script Valor
is_success True ou False

Ping

Use a ação Ping para testar a conectividade com o Google Tradutor.

Essa ação não é executada em entidades do Google SecOps.

Entradas de ação

Nenhuma.

Saídas de ação

A ação Ping fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Indisponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Ping pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

Successfully connected to the Google Translate server with the provided connection parameters!

 A ação foi concluída.
Failed to connect to the Google Translate server! Error is ERROR_REASON

A ação falhou.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Ping:

Nome do resultado do script Valor
is_success True ou False

Traduzir textos

Use a ação Traduzir texto para traduzir textos com o Google Tradutor.

Essa ação não é executada em entidades do Google SecOps.

Entradas de ação

A ação Traduzir texto exige os seguintes parâmetros:

Parâmetro Descrição
Source Language

Opcional.

Um idioma de origem do texto.

Se você não configurar esse parâmetro, a ação vai detectar o idioma automaticamente.
Target Language

Obrigatório.

Um idioma de destino.

O valor padrão é en.
Text

Obrigatório.

Um texto a ser traduzido.

Saídas de ação

A ação Traduzir texto oferece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Traduzir texto:

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}
Mensagens de saída

A ação Traduzir texto pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

Successfully translated the provided text in Google Translate.

 A ação foi concluída.
Error executing action "Translate Text". Reason: ERROR_REASON

A ação falhou.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Traduzir texto:

Nome do resultado do script Valor
is_success True ou False

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.