Integre o Google Tradutor com o Google SecOps

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

Versão da integração: 4.0

Antes de começar

Para usar a integração, tem de criar e configurar uma chave da API.

Crie a chave da API

Para criar a chave da API, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda a APIs e serviços > Credenciais.

    Aceder a Credenciais

  2. Clique em adicionar Criar credenciais.

  3. Selecione Chave da API para gerar uma nova chave da API. É apresentada uma caixa de diálogo com uma chave da API gerada.

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

Configure as restrições da chave de API

Para configurar a restrição da API para a chave da API, conclua os seguintes passos:

  1. Clique em Restringir chave.

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

  3. Selecione Cloud Translation API na lista de APIs.

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

  5. Clique em Guardar para guardar a configuração da chave da 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 predefinido é https://translation.googleapis.com.

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

Obrigatório.

A chave da API da conta do Google Translate.
Verify SSL

Obrigatório.

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

Selecionado por predefinição.

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

Se necessário, pode fazer alterações numa fase posterior. Depois de configurar uma instância de integração, pode usá-la em manuais de soluções. Para mais informações sobre como configurar e suportar várias instâncias, consulte o artigo Suporte de várias instâncias.

Ações

Para mais informações sobre ações, consulte os artigos Responda a ações pendentes da sua mesa de trabalho e Execute uma ação manual.

Listar idiomas

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

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

Dados de ações

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

Parâmetro Descrição
Filter Key

Opcional.

Uma tecla para filtrar idiomas.

Os valores possíveis são os seguintes:

  • Select One
  • Name

O valor predefinido é Select One.
Filter Logic

Opcional.

Uma lógica de filtro a aplicar.

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

Os valores possíveis são os seguintes:

  • Not Specified
  • Equal
  • Contains

O valor predefinido é Not Specified.
Filter Value

Opcional.

Um valor a usar no filtro.

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

Se Equal estiver selecionado, a ação procura a correspondência exata entre os resultados. Se Contains estiver selecionado, a ação procura resultados que contenham a subcadeia de carateres especificada.

Se não selecionar um valor, a ação ignora o filtro.

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

Opcional.

O número máximo de registos a devolver.

O valor máximo é 50.

Se não definir um valor, a ação devolve 50 registos por predefinição.

Resultados da ação

A ação List Languages fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Disponível
Tabela de enriquecimento Não disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mesa de parede para caixas

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

Nome da tabela: Idiomas disponíveis

Coluna da tabela: Chave do idioma

Resultado JSON

O exemplo seguinte mostra o resultado JSON recebido quando usa a ação List Languages:

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

        ]
    }
}
Mensagens de saída

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

Mensagem de saída 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 bem-sucedida.
Error executing action "List Languages". Reason: ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa a ação List Languages:

Nome do resultado do script Valor
is_success True ou False

Tchim-tchim

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

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

Dados de ações

Nenhum.

Resultados da ação

A ação Ping fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Não disponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

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

Mensagem de saída Descrição da mensagem

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

 A ação foi bem-sucedida.
Failed to connect to the Google Translate server! Error is ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte lista o valor do resultado do script quando usa a ação Ping:

Nome do resultado do script Valor
is_success True ou False

Traduza o texto

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

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

Dados de ações

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

Parâmetro Descrição
Source Language

Opcional.

Um idioma de origem do texto.

Se não configurar este parâmetro, a ação deteta o idioma automaticamente.
Target Language

Obrigatório.

Um idioma de destino.

O valor predefinido é en.
Text

Obrigatório.

Um texto a traduzir.

Resultados da ação

A ação Traduzir texto fornece os seguintes resultados:

Tipo de saída da ação Disponibilidade
Fixação à parede da caixa Não disponível
Link da parede da caixa Não disponível
Mesa de parede para caixas Não disponível
Tabela de enriquecimento Não disponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo seguinte mostra a saída do resultado JSON recebida quando usa a ação Traduzir texto:

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

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

Mensagem de saída Descrição da mensagem

Successfully translated the provided text in Google Translate.

 A ação foi bem-sucedida.
Error executing action "Translate Text". Reason: ERROR_REASON

A ação falhou.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.
Resultado do script

A tabela seguinte lista o valor da saída do resultado do script quando usa 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 da Google SecOps.