Trend Micro Cloud App Security

Este documento fornece orientações sobre como integrar o Trend Micro Cloud App Security ao Google SecOps.

Casos de uso do produto

Realizar ações ativas: enriquecer entidades, pesquisar e-mails, atualizar a lista de bloqueio, mitigar e-mails/contas etc.

Como gerar um token de API

  1. Acesse Administração > APIs Automation e integração.
  2. Pressione o botão "Adicionar".
  3. Selecione "Para aplicativo externo".
  4. Insira um "Nome" e marque todas as caixas de seleção.
  5. Pressione "Criar token".
  6. Copie o "Token".
  7. Atualize o parâmetro "Chave de API" na configuração da integração.
  8. Testar a conectividade.

Configurar a integração do Trend Micro Cloud App Security no Google Security Operations

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

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Raiz da API String https://api-eu.tmcas.trendmicro.com Sim Raiz da API da instância do Trend Micro Cloud App Security.
Chave de API Senha N/A Sim Chave de API da instância do Trend Micro Cloud App Security.
Verificar SSL Caixa de seleção Selecionado Sim Se ativada, verifica se o certificado SSL para a conexão com o servidor do Trend Micro Cloud App Security é válido.

Ações

Ping

Descrição

Teste a conectividade com o Trend Micro Cloud App Security com os parâmetros fornecidos na página de configuração de integração na página do Google SecOps Content Hub.

Parâmetros

N/A

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

Se for bem-sucedido (is success = true): a conexão com o servidor do Trend Micro Cloud App Security foi estabelecida com os parâmetros fornecidos.

Se não for bem-sucedido (is success = false): falha ao se conectar ao servidor do Trend Micro Cloud App Security. Erro: {0}".format(exception.stacktrace)

 Geral

Adicionar entidades à lista de bloqueio

Descrição

Adicione entidades a uma lista de bloqueio no Trend Micro Cloud App Security. Entidades compatíveis: URL, hash e e-mail (entidade de usuário que corresponde ao padrão de endereço de e-mail).

Parâmetros

Nome Valor padrão É obrigatório Descrição
N/A N/A N/A N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • URL
  • Hash
  • E-mail

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Painel de casos
Caso Sucesso Reprovado Mensagem
se for bem-sucedido para 1 entidade verdadeiro falso As seguintes entidades foram adicionadas à lista de bloqueio no Trend Micro Cloud App Security: {\n entity.identifier}
se não for bem-sucedida para 1 entidade verdadeiro falso A ação não conseguiu adicionar as seguintes entidades à lista de bloqueio no Trend Micro Cloud App Security: {\n entity.identifier}
Se houver duplicatas verdadeiro falso As seguintes entidades já fazem parte da lista de bloqueio no Trend Micro Cloud App Security: {\n entity.identifier}
não é bem-sucedida para todos falso falso Nenhuma entidade foi adicionada usando informações do Trend Micro Cloud App Security
Erro fatal, credenciais inválidas, raiz da API falso verdadeiro Erro ao executar a ação "Adicionar entidades à lista de bloqueio". Motivo: {error traceback}

Mitigar e-mails

Descrição

Exclua ou coloque e-mails em quarentena usando o Trend Micro Cloud App Security. Observação: no Gmail, só é possível excluir e-mails.

Parâmetros

Nome Valor padrão É obrigatório Descrição
IDs de mensagens N/A Sim Especifique uma lista separada por vírgulas de IDs de mensagens que precisam ser mitigadas.
Ação de mitigação

Excluir

Valores possíveis:

Excluir

Quarentena

 Sim Especifique qual ação de mitigação deve ser aplicada.
Serviço

Gmail

Valores possíveis

Gmail

Troca

 Sim Especifique o serviço usado para e-mails.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Painel de casos
Caso Sucesso Reprovado Mensagem
se for bem-sucedido para 1 message_id Verdadeiro falso Os seguintes e-mails foram mitigados no Trend Micro Cloud App Security: {\n unique message ids}
Se não for bem-sucedido para 1 message_id Verdadeiro falso A ação não conseguiu mitigar os seguintes e-mails no Trend Micro Cloud App Security: {\n IDs de mensagem exclusivos}
não é bem-sucedida para todos falso falso Nenhum e-mail foi mitigado pelo Trend Micro Cloud App Security.
Erro fatal, credenciais inválidas, raiz da API falso verdadeiro Erro ao executar a ação "Mitigar e-mails". Motivo: {error traceback}
Se "Quarentena" estiver selecionada e "Gmail" for o serviço falso verdadeiro Erro ao executar a ação "Mitigar e-mails". Motivo: só é possível excluir e-mails no serviço do Gmail.

Descrição

Pesquise e-mails com base em entidades no Trend Micro Cloud App Security. Entidades compatíveis: URL, hash, e-mail (entidade de usuário que corresponde ao padrão de endereço de e-mail), assunto do e-mail, nome do arquivo, IP.

Parâmetros

Nome Valor padrão É obrigatório Descrição
Máximo de dias para trás 30 Não Especifique quantos dias no passado devem ser analisados para encontrar e-mails. O máximo é 90. Padrão: 30.
Número máximo de e-mails a serem retornados 100 Não Especifique quantos e-mails serão retornados. Padrão: 100;

Corrida

Essa ação é executada nas seguintes entidades:

  • URL
  • Hash
  • E-mail
  • Assunto do e-mail
  • Nome do arquivo
  • Endereço IP

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
emails=[{list of unique emails}]
Painel de casos
Caso Sucesso Reprovado Mensagem
se os dados estiverem disponíveis: verdadeiro falso As informações sobre e-mails relacionados às entidades fornecidas no Trend Micro Cloud App Security foram retornadas.
se os dados não estiverem disponíveis falso falso Nenhuma informação sobre e-mails relacionados a entidades foi encontrada no Trend Micro Cloud App Security.
Erro fatal, credenciais inválidas, raiz da API falso verdadeiro Erro ao executar a ação "Pesquisa de e-mail de entidade". Motivo: {error traceback}
Se "Máximo de dias anteriores" > 90 falso verdadeiro Erro ao executar a ação "Pesquisa de e-mail de entidade". Motivo: o valor de "Máximo de dias anteriores" precisa estar entre 1 e 90.

Enriquecer entidades

Descrição

Enriqueça as entidades com informações do Trend Micro Cloud App Security. Entidades compatíveis: URL, hash e e-mail (entidade de usuário que corresponde ao padrão de endereço de e-mail).

Parâmetros

Nome Valor padrão É obrigatório Descrição
N/A N/A N/A N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • URL
  • Hash
  • E-mail

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
blocked_url = [URL entities that were found]
blocked_hashes = [hashes entities that were found]
blocked_senders = [User entities that were found]
Painel de casos
Caso Sucesso Reprovado Mensagem
se for bem-sucedido para 1 entidade verdadeiro falso As informações sobre as seguintes entidades foram recuperadas do Trend Micro Cloud App Security: {\n entity.identifier}
se não for bem-sucedida para 1 entidade verdadeiro falso A ação não conseguiu recuperar informações sobre as seguintes entidades do Trend Micro Cloud App Security: {\n entity.identifier}
não é bem-sucedida para todos falso falso Nenhuma entidade foi enriquecida usando informações do Trend Micro Cloud App Security
Erro fatal, credenciais inválidas, raiz da API falso verdadeiro Erro ao executar a ação "Enriquecer entidades". Motivo: {error traceback}

Mitigar contas

Descrição

Realizar ações de mitigação na conta de usuário pelo Trend Micro Security de App na Nuvem.

Parâmetros

Nome Valor padrão É obrigatório Descrição
Endereços de e-mail N/A Sim Especifique uma lista separada por vírgulas de endereços de e-mail que precisam ser mitigados.
Ação de mitigação

Desativar conta

Ative a MFA

Redefinir senha

Revogar sessões de login

 Sim Especifique qual ação de mitigação deve ser aplicada.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Painel de casos
Caso Sucesso Reprovado Mensagem
se for bem-sucedido para um endereço de e-mail. verdadeiro falso As seguintes contas foram mitigadas no Trend Micro Cloud App Security: {\n endereços de e-mail}
se não for bem-sucedida para 1 entidade verdadeiro falso A ação não conseguiu mitigar as seguintes contas no Trend Micro Cloud App Security: {\n endereços de e-mail}
não é bem-sucedida para todos falso falso Nenhuma conta foi mitigada usando informações do Trend Micro Cloud App Security.
Mensagem assíncrona falso falso Aguardando a conclusão das ações de mitigação…
Erro fatal, credenciais inválidas, raiz da API falso verdadeiro Erro ao executar a ação "Mitigar conta". Motivo: {error traceback}

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