Integrar o Google Tradutor ao Google SecOps

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

Antes de começar

Para usar a integração, é necessário criar e configurar uma chave de API.

Criar a chave de API

Para criar a chave de API, siga estas etapas:

  1. No console do 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 de API. Uma caixa de diálogo aparece com uma chave de API gerada.

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

Configurar as restrições da chave de API

Para configurar a restrição da 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 do Google Tradutor requer os seguintes parâmetros:

Parâmetro Descrição
API Root

Obrigatório.

A raiz da API 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 configuração é selecionada por padrão.

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

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

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes na sua mesa de trabalho e Executar uma ação manual no seu caso.

Listar idiomas

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

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

Entradas da ação

A ação Listar idiomas requer os seguintes parâmetros:

Parâmetro Descrição
Filter Key

Opcional.

Uma chave para filtrar idiomas.

Os valores possíveis são os seguintes:

  • 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 os seguintes:

  • 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 funciona 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 da ação

A ação Listar idiomas 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 Listar idiomas pode gerar a seguinte tabela:

Nome da tabela: Idiomas disponíveis

Coluna da tabela: Language Key

Resultado JSON

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

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

        ]
    }
}
Mensagens de saída

A ação Listar idiomas 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 Listar idiomas:

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 da ação

Nenhuma.

Saídas da 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 da ação

A ação Traduzir texto requer 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-alvo.

O valor padrão é en.
Text

Obrigatório.

Um texto para traduzir.

Saídas da ação

A ação Traduzir texto 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 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.