McAfee ePO

Este documento fornece orientações sobre como integrar o McAfee ePO ao Google SecOps.

Configurar a integração do McAfee ePO no Google Security Operations

Configurar a integração do McAfee ePO com um certificado de CA

Se necessário, verifique sua conexão com um arquivo de certificado de CA.

Antes de começar, verifique se você tem o seguinte:

  • O arquivo de certificado de CA
  • A versão mais recente da integração do McAfee ePO

Para configurar a integração com um certificado de CA, siga estas etapas:

  1. Analise o arquivo de certificado de CA em uma string Base64.
  2. Abra a página de parâmetros de configuração da integração.
  3. Insira a string no campo Arquivo de certificado de CA.
  4. Para testar se a integração foi configurada, marque a caixa de seleção Verificar SSL e clique em Testar.

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
Nome da instância String N/A Não Nome da instância em que você quer configurar a integração.
Descrição String N/A Não Descrição da instância.
Endereço do servidor String https://<ServerAddress>:8443/remote/ Sim Endereço do servidor do Trellix ePO. Exemplo: https://127.0.0.1:8443/remote/
Nome de usuário String N/A Sim O nome de usuário para autenticação do servidor.
Senha Senha N/A Sim A senha para autenticação do servidor.
Nome do grupo String N/A Não Nome do grupo.
Arquivo de certificado de CA: analisado em uma string Base64 String N/A Não N/A
Executar remotamente Caixa de seleção Desmarcado Não Marque o campo para executar a integração configurada remotamente. Depois de marcada, a opção de selecionar o usuário remoto (agente) aparece.

Ações

Adicionar tag

Descrição

Adicione uma tag a um endpoint no Trellix ePO. Observação: só é possível aplicar tags que existem no sistema. Entidades compatíveis: nome do host, IP.

Parâmetros

Parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da tag String N/A Sim Especifique o nome da tag que precisa ser adicionada aos endpoints.

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

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
N/A
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

Se houver sucesso para um (is_success=true):

A tag "{tag name}" foi adicionada aos seguintes endpoints em

Trellix ePO: {entity.identifier}

Se a tag já fizer parte do endpoint (is_success=true):

A tag "{tag}" já fazia parte dos seguintes endpoints no Trellix ePO: {entity.identifier}

Se não houver sucesso para um (is_success=true)

A ação não conseguiu adicionar a tag "{tag name}" aos seguintes endpoints no Trellix ePO: {entity.identifier}

Se não houver sucesso para todos (is_success=false):

A tag "{tag}" não foi adicionada aos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Adicionar tag". Motivo: {traceback}

Se a tag for inválida (falha)

Erro ao executar a ação "Adicionar tag". Motivo: a tag "{tag name}" não foi encontrada no Trellix ePO.

Geral

Comparar o DAT do servidor e do agente

Descrição

Recuperar informações de DAT do servidor e do agente dos endpoints no Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

N/A

Casos de uso

N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Enriquecimento de entidades
Nome do campo de aprimoramento Lógica: quando aplicar
Alert.DstPort Retorna se existir no resultado JSON
Rule.msg Retorna se existir no resultado JSON
Alert.IPSIDAlertID Retorna se existir no resultado JSON
Alert.SrcIP Retorna se existir no resultado JSON
Alert.LastTime Retorna se existir no resultado JSON
Alert.Protocol Retorna se existir no resultado JSON
Alert.SrcPort Retorna se existir no resultado JSON
Alert.DstIP Retorna se existir no resultado JSON
Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
null N/A N/A
Resultado do JSON
{

"server_version": {server_version}

"dat_version": {dat_version}

"equal": true → if server_version == dat_version, else false

}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

se o sucesso de um

As informações de DAT do servidor e do agente foram recuperadas dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para um

A ação não conseguiu recuperar as informações de DAT do servidor e do agente dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não for bem-sucedido para todos

Nenhuma informação sobre o DAT do servidor e do agente foi encontrada nos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Comparar DAT do servidor e do agente". Motivo: {traceback}

Geral

Receber informações do agente

Descrição

Recuperar informações sobre os agentes do endpoint do Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

N/A

Casos de uso

N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Enriquecimento de entidades
Nome do campo de aprimoramento Lógica: quando aplicar
EPO_LastUpdate Retorna se existir no resultado JSON
EPO_ManagedState Retorna se existir no resultado JSON
EPO_Tags Retorna se existir no resultado JSON
EPO_ExcludedTags Retorna se existir no resultado JSON
EPO_AgentVersion Retorna se existir no resultado JSON
EPO_AgentGUID Retorna se existir no resultado JSON
Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_success Verdadeiro/falso is_success:False
Resultado do JSON
[
    {
        "EntityResult":
        {
            "LastUpdate": "2019-01-22T13:04:49+02:00",
            "ManagedState": "1",
            "Tags": "Server, Workstation",
            "ExcludedTags": "",
            "AgentVersion": "1.1.1.1",
            "AgentGUID": "F673D1DF-786C-41E5-A84D-1676A39F7AE8"
        },
        "Entity": "1.1.1.1"
    }
]
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

Se houver sucesso para um (is_success=true):

As informações do agente sobre os seguintes endpoints no Trellix ePO foram recuperadas: {entity.identifier}

Se não houver sucesso para um (is_success=true)

A ação não conseguiu recuperar informações do agente sobre os seguintes endpoints no Trellix ePO: {entity.identifier}

Se não houver sucesso para todos (is_success=false):

Nenhuma informação de agend foi encontrada para os hosts fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Receber informações do agente". Motivo: {traceback}

Geral

Acessar a versão do Dat

Descrição

Recuperar informações de DAT dos endpoints no Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
Versão do Dat N/A N/A
Resultado do JSON
{
"DAT_version": {DAT version}
}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

se o sucesso de um

As informações de DAT foram recuperadas dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para um

A ação não conseguiu recuperar as informações de DAT dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para todos

Nenhuma informação sobre DAT foi encontrada nos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Get Dat Version". Motivo: {traceback}

Geral

Receber eventos para hash

Descrição

Recuperar informações sobre eventos relacionados a hashes. Observação: somente hashes MD5 são compatíveis.

Parâmetros

Nome Tipo Valor padrão É obrigatório Descrição
Buscar eventos da tabela EPExtendedEvent Caixa de seleção Desmarcado Não Se ativada, a ação também vai usar a tabela "EPExtendedEvent" para encontrar informações sobre hashes.
Marcar como suspeito Caixa de seleção Sim Falso Se ativada, a ação vai marcar como suspeitos todos os hashes para os quais os eventos foram encontrados.
Criar insight Caixa de seleção Não Falso Se ativada, a ação vai criar um insight com informações sobre quais hashes têm eventos associados.
Campos a serem retornados CSV

EPOEvents.ThreatName,
EPOEvents.ThreatType,
EPOEvents.ThreatActionTaken,
EPOEvents.ThreatHandled,
EPOEvents.ThreatCategory
,EPOEvents.TargetHostName,
EPOEvents.TargetUserName,
EPOEvents.TargetFileName,
EPOEvents.TargetProcessName,
EPOEvents.TargetPort,EPOEvents.
TargetProtocol,EPOEvents.
ThreatCategory,EPOEvents.
TargetIPV4,EPOEvents.
SourceHostName,EPOEvents.
SourceIPV4,EPOEvents.
SourceUserName,EPOEvents.
SourceProcessName,EPOEvents.
SourceURL

Falso Especifique quais campos retornar. Se nada for especificado, a ação vai retornar todos os campos disponíveis.
Campo de classificação String N/A Falso Especifique qual campo deve ser usado para ordenar os resultados.
Ordem de classificação DDL

ASC

Valores possíveis:

ASC

DESC

Falso Especifique qual ordem de classificação deve ser aplicada à consulta.
Período DDL

Última hora

Valores possíveis:

Última hora

Últimas 6 horas

Últimas 24 horas

Última semana

Mês anterior

Personalizado

Falso Especifique um período para os eventos. Se "Personalizado" estiver selecionado, você também precisará informar o "Horário de início".
Horário de início String N/A Falso Especifique o horário de início dos eventos. Esse parâmetro é obrigatório se "Personalizado" estiver selecionado para o parâmetro "Período". Formato: ISO 8601
Horário de término String N/A Falso Especifique o horário de término dos eventos. Formato: ISO 8601. Se nada for fornecido e "Personalizado" for selecionado para o parâmetro "Período", esse parâmetro vai usar o horário atual.
Número máximo de eventos a serem retornados Inteiro 50 Falso Especifique quantos eventos serão retornados. Padrão: 50.

Corrida

Essa ação é executada na entidade Filehash.

Resultados da ação

Enriquecimento de entidades
Nome do campo de aprimoramento Lógica: quando aplicar
EPOEvents.ThreatCategory Retorna se existir no resultado JSON
EPOEvents.TargetUserName Retorna se existir no resultado JSON
EPOEvents.TargetPort Retorna se existir no resultado JSON
EPOEvents.TargetFileName Retorna se existir no resultado JSON
EPOEvents.TargetIPV4 Retorna se existir no resultado JSON
EPO_AgentGUID Retorna se existir no resultado JSON
Insights

O insight será criado para eventos encontrados no Trellix ePO para o hash atual.

Resultado do JSON
[
    {
        "EntityResult":
        [
            {
                "EPOEvents.ThreatCategory": "av.detect",
                "EPOEvents.TargetUserName": "VM-EPOAGENTTEST\\\\\\\\Admin",
                "EPOEvents.TargetPort": "None",
                "EPOEvents.TargetFileName": "C:\\\\\\\\Users\\\\\\\\Admin\\\\\\\\Desktop\\\\\\\\eicar.txt",
                "EPOEvents.TargetIPV4": -1979711347,
                "EPOEvents.ThreatName": "EICAR test file",
                "EPOEvents.SourceUserName": "None",
                "EPOEvents.TargetProcessName": "None",
                "EPOEvents.SourceProcessName": "None",
                "EPOEvents.ThreatType": "test",
                "EPOEvents.SourceIPV4": -1979711347,
                "EPOEvents.TargetProtocol": "None",
                "VSECustomEvent.MD5": "44d88612fea8a8f36de82e1278abb02f",
                "EPOEvents.SourceURL": "None",
                "EPOEvents.ThreatActionTaken": "deleted",
                "EPOEvents.TargetHostName": "VM-EPOAGENTTEST",
                "EPOEvents.ThreatHandled": "True",
                "EPOEvents.SourceHostName": "_"
            }, {
                "EPOEvents.ThreatCategory": "av.detect",
                "EPOEvents.TargetUserName": "VM-EPOAGENTTEST\\\\\\\\Admin",
                "EPOEvents.TargetPort": "None",
                "EPOEvents.TargetFileName": "C:\\\\\\\\Users\\\\\\\\Admin\\\\\\\\Desktop\\\\\\\\eicar.txt",
                "EPOEvents.TargetIPV4": -1979711347,
                "EPOEvents.ThreatName": "EICAR test file",
                "EPOEvents.SourceUserName": "None",
                "EPOEvents.TargetProcessName": "None",
                "EPOEvents.SourceProcessName": "None",
                "EPOEvents.ThreatType": "test",
                "EPOEvents.SourceIPV4": -1979711347,
                "EPOEvents.TargetProtocol": "None",
                "VSECustomEvent.MD5": "44d88612fea8a8f36de82e1278abb02f",
                "EPOEvents.SourceURL": "None",
                "EPOEvents.ThreatActionTaken": "deleted",
                "EPOEvents.TargetHostName": "VM-EPOAGENTTEST",
                "EPOEvents.ThreatHandled": "True",
                "EPOEvents.SourceHostName": "_"
            }],
        "Entity": "44d88612fea8a8f36de82e1278abb02f"
    }
]
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

Se a operação for bem-sucedida e os resultados estiverem disponíveis: (is_success=true)

"Os eventos disponíveis para os seguintes hashes no Trellix ePO foram retornados: {entity.identifier}"

Se não for bem-sucedido para um: (is_success=true)

"A ação não encontrou eventos para os seguintes hashes no Trellix ePO: {entity.identifier}"

Se não for bem-sucedido para todos (is_success=false):

"Nenhum evento foi encontrado para os endpoints fornecidos no Trellix ePO."

Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros (falha): "Erro ao executar a ação 'Receber ameaças de endpoint'. Motivo: {0}''.format(error.Stacktrace)

Se houver um erro na resposta (falha): "Erro ao executar a ação 'Executar consulta de entidade'. Motivo: {0}''.format( response text)

Se o horário de início estiver vazio, quando o "Período" for "Personalizado" (falha): "Erro ao executar a ação 'Receber ameaças de endpoint'. Motivo: o "Horário de início" precisa ser informado quando a opção "Personalizado" é selecionada no parâmetro "Período".

Geral

Receber o status dos IPs do host

Descrição

Recuperar informações de IPS dos endpoints no Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_status_received Verdadeiro/falso is_status_received:False
Resultado do JSON
{
"IPS_status": {IPS_status}
}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

se o sucesso de um

As informações do IPS foram recuperadas dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para um

A ação não conseguiu recuperar as informações de IPS dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não for bem-sucedido para todos

Nenhuma informação sobre IPS foi encontrada nos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Receber status do IPS do host". Motivo: {traceback}

Geral

Receber o status dos IPs da rede do host

Descrição

Recuperar informações do IPS de rede dos endpoints no Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
is_status_received Verdadeiro/falso is_status_received:False
Resultado do JSON
{
"Network_IPS_status": {Network_IPS_status}
}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

se o sucesso de um

As informações do IPS de rede foram recuperadas dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para um

A ação não conseguiu recuperar as informações de IPS de rede dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para todos

Nenhuma informação sobre o IPS de rede foi encontrada nos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Receber status do IPS da rede do host". Motivo: {traceback}

Geral

Receber o horário da última comunicação

Descrição

Recuperar informações sobre o horário da última comunicação dos endpoints no Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

N/A

Casos de uso

N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
isSuccess Verdadeiro/falso isSuccess:False
Resultado do JSON
{
"last_communication_time": {last_communication_time}
}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

se o sucesso de um

As informações de horário da última comunicação foram recuperadas dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para um

A ação não conseguiu recuperar as informações de horário da última comunicação dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não for bem-sucedido para todos

Nenhuma informação sobre o horário da última comunicação foi encontrada nos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Receber o horário da última comunicação". Motivo: {traceback}

Geral

Receber a versão do agente do McAfee ePO

Descrição

Recuperar informações sobre a versão do agente nos endpoints no Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

N/A

Casos de uso

N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
Versão do agente da McAfee N/A N/A
Resultado do JSON
{
"ePO_agent_version": ePO_agent_version
}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

se o sucesso de um

As informações da versão do agente foram recuperadas dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para um

A ação não conseguiu recuperar as informações da versão do agente dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para todos

Nenhuma informação sobre a versão do agente foi encontrada nos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Receber o horário da última comunicação". Motivo: {traceback}

Geral

Receber informações do sistema

Descrição

Retornar informações do sistema sobre os endpoints do Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

Parâmetro Tipo Valor padrão É obrigatório Descrição
Criar insight Caixa de seleção Caixa de seleção marcada Se ativada, a ação vai criar um insight com informações sobre o endpoint.

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Enriquecimento de entidades
Nome do campo de aprimoramento Lógica: quando aplicar
FreeDiskSpace Retorna se existir no resultado JSON
Nome de usuário Retorna se existir no resultado JSON
DomainName Retorna se existir no resultado JSON
LastAgentHandler Retorna se existir no resultado JSON
IPV4x Retorna se existir no resultado JSON
OSBitMode Retorna se existir no resultado JSON
IPV6 Retorna se existir no resultado JSON
OSType Retorna se existir no resultado JSON
SysvolFreeSpace Retorna se existir no resultado JSON
IPHostName Retorna se existir no resultado JSON
CPUSerialNum Retorna se existir no resultado JSON
IPSubnetMask Retorna se existir no resultado JSON
SysvolTotalSpace Retorna se existir no resultado JSON
IPSubnet Retorna se existir no resultado JSON
Descrição Retorna se existir no resultado JSON
FreeMemory Retorna se existir no resultado JSON
CPUSpeed Retorna se existir no resultado JSON
SubnetMask Retorna se existir no resultado JSON
IPAddress Retorna se existir no resultado JSON
DefaultLangID Retorna se existir no resultado JSON
OSPlatform Retorna se existir no resultado JSON
NetAddress Retorna se existir no resultado JSON
TotalDiskSpace Retorna se existir no resultado JSON
SubnetAddress Retorna se existir no resultado JSON
NumOfCPU Retorna se existir no resultado JSON
TimeZone Retorna se existir no resultado JSON
SystemDescription Retorna se existir no resultado JSON
Vdi Retorna se existir no resultado JSON
OSBuildNum Retorna se existir no resultado JSON
OSVersion Retorna se existir no resultado JSON
IsPortable Retorna se existir no resultado JSON
TotalPhysicalMemory Retorna se existir no resultado JSON
IPXAddress Retorna se existir no resultado JSON
UserProperty7 Retorna se existir no resultado JSON
ParentID Retorna se existir no resultado JSON
CPUType Retorna se existir no resultado JSON
Insights

N/A

Resultado do JSON
[
    {
        "EntityResult":
        {
            "FreeDiskSpace": "444316",
            "UserName": "Admin",
            "OSServicePackVer": " ",
            "DomainName": "WORKGROUP",
            "LastAgentHandler": "1",
            "IPV4x": "-1979711239",
            "OSBitMode": "1",
            "IPV6": "0:0:0:0:0:FFFF:A00:F9",
            "OSType": "Windows Server 2012 R2",
            "SysvolFreeSpace": "94782",
            "IPHostName": "McAfee-ePO",
            "CPUSerialNum": "N/A",
            "IPSubnetMask": "0:0:0:0:0:FFFF:FFFF:FE00",
            "SysvolTotalSpace": "161647",
            "IPSubnet": "0:0:0:0:0:FFFF:A00:0",
            "Description": "None",
            "FreeMemory": "1626767360",
            "CPUSpeed": "2400",
            "SubnetMask": " ",
            "IPAddress": "1.1.1.1",
            "DefaultLangID": "0409",
            "OSPlatform": "Server",
            "ComputerName": "MCAFEE-EPO",
            "OSOEMID": "00252-00112-26656-AA653",
            "NetAddress": "005056A56847",
            "TotalDiskSpace": "511646",
            "SubnetAddress": " ",
            "NumOfCPU": "4",
            "TimeZone": "Jerusalem Standard Time",
            "SystemDescription": "N/A",
            "Vdi": "0",
            "OSBuildNum": "9600",
            "OSVersion": "6.3",
            "IsPortable": "0",
            "TotalPhysicalMemory": "6441984000",
            "IPXAddress": "N/A",
            "UserProperty7": " ",
            "UserProperty6": " ",
            "UserProperty5": " ",
            "UserProperty4": " ",
            "UserProperty3": " ",
            "UserProperty2": " ",
            "UserProperty1": " ",
            "ParentID": "8",
            "CPUType": "Intel(R) Xeon(R) CPU E5-2630 v3 @ 2.40GHz",
            "UserProperty8": " "
        },
        "Entity": "1.1.1.1"
    }
]
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

Se for bem-sucedido para um (is_success=true):

As informações do sistema sobre os seguintes endpoints foram recuperadas do Trellix ePO: {entity.identifier}

Se não for bem-sucedido para um (is_success=true):

A ação não conseguiu recuperar informações do sistema sobre os seguintes endpoints do Trellix ePO: {entity.identifier}

Se não for bem-sucedido para todos (is_success=false)

Nenhuma informação do sistema foi encontrada sobre os endpoints fornecidos.

Se houver um erro crítico:

Erro ao executar a ação "Receber informações do sistema". Motivo: {error.traceback}

Geral

Receber a versão do agente do mecanismo de vírus

Descrição

Recupere informações da versão do agente do mecanismo de vírus dos endpoints no McAfee ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

N/A

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
Versão do agente do mecanismo de vírus N/A N/A
Resultado do JSON
{
"Virus_Engine_Agent_version": {Virus_engine_agent_version}
}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

se o sucesso de um

As informações da versão do agente do mecanismo de vírus foram recuperadas dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não houver sucesso para um

A ação não conseguiu recuperar as informações da versão do agente do mecanismo de vírus dos seguintes endpoints no Trellix ePO: {entity.identifier}

se não for bem-sucedido para todos

Nenhuma informação sobre a versão do agente do Virus Engine foi encontrada nos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Get Virus Engine Agent Version". Motivo: {traceback}

Geral

Ping

Descrição

Teste a conectividade com o Trellix ePO usando os parâmetros fornecidos na página de configuração da integração na página do Google SecOps Content Hub.

Parâmetros

N/A

Casos de uso

N/A

Corrida

Essa ação é executada em todas as entidades.

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
null N/A N/A
Resultado do JSON
N/A

Remover tag

Descrição

Remova uma tag de um endpoint no Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

Parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da tag String N/A Sim Especifique o nome da tag que precisa ser removida dos endpoints.

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

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
N/A
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

Se houver sucesso para um (is_success=true):

A tag "{tag name}" foi removida dos seguintes endpoints

no Trellix ePO: {entity.identifier}

Se a tag não fizer parte do endpoint (is_success=true):

A tag "{tag}" não fazia parte dos seguintes endpoints no Trellix ePO: {entity.identifier}

Se não houver sucesso para um (is_success=true)

A ação não conseguiu remover a tag "{tag name}" dos seguintes endpoints no Trellix ePO: {entity.identifier}

Se não houver sucesso para todos (is_success=false):

A tag "{tag}" não foi removida dos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Remover tag". Motivo: {traceback}

Se a tag for inválida (falha)

Erro ao executar a ação "Remover tag". Motivo: a tag "{tag name}" não foi encontrada no Trellix ePO.

Geral

Executar verificação completa

Descrição

Execute uma verificação completa nos endpoints fornecidos no Trellix ePO. Entidades compatíveis: nome do host, IP.

Parâmetros

Parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da tarefa String Verificação sob demanda: verificação completa Sim Especifique qual tarefa deve ser executada para fazer uma verificação completa.

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
RunTask_Status N/A N/A
Resultado do JSON
{
"status": "success" or "failure"
}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

Se uma delas for bem-sucedida:

A verificação completa foi executada com base na tarefa "{task name}" nos seguintes endpoints no Trellix ePO: {entity.identifier}

Se não for bem-sucedido para um:

A ação não conseguiu executar uma verificação completa com base na tarefa "{task name}" nos seguintes endpoints no Trellix ePO: {entity.identifier}

Se não houver sucesso para todos:

A verificação completa não foi executada nos endpoints fornecidos.

se houver um erro crítico (falha):

Erro ao executar a ação "Executar verificação completa". Motivo: {error traceback}

se a tarefa não for encontrada (falha):

Erro ao executar a ação "Executar verificação completa". Motivo: a tarefa "{task name}" não foi encontrada no Trellix ePO. Verifique a ortografia.

Geral

Atualizar o agente da McAfee

Descrição

Atualize o McAfee Agent nos endpoints fornecidos no Trellix ePO. Tarefa para Windows: DAT_Update_Windows_CWS. Tarefa para Linux: DAT_Update_Linux_CWS. Entidades compatíveis: nome do host, IP.

Parâmetros

Parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da tarefa String DAT_Update_Windows_CWS Sim Especifique qual tarefa deve ser executada para atualizar o McAfee Agent. O padrão para Windows é DAT_Update_Windows_CWS. Para Linux, é DAT_Update_Linux_CWS

Corrida

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Enriquecimento de entidades

N/A

Insights

N/A

Resultado do script
Nome do resultado do script Opções de valor Exemplo
Update_Status N/A N/A
Resultado do JSON
{
"status": "success" or "failure"
}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

Se uma delas for bem-sucedida:

Os agentes foram atualizados com base na tarefa "{task name}" nos seguintes endpoints no Trellix ePO: {entity.identifier}

Se não for bem-sucedido para um:

A ação não conseguiu atualizar o agente com base na tarefa "{task name}" nos seguintes endpoints no Trellix ePO: {entity.identifier}

Se não houver sucesso para todos:

Nenhum dos agentes foi atualizado.

se houver um erro crítico (falha):

Erro ao executar a ação "Atualizar o agente da McAfee". Motivo: {error traceback}

se a tarefa não for encontrada (falha):

Erro ao executar a ação "Atualizar o agente da McAfee". Motivo: a tarefa "{task name}" não foi encontrada no Trellix ePO. Verifique a ortografia.

Geral

Conector

McAfee EPO - Conector de ameaças

Descrição

Extraia eventos da tabela EPOEvents para o Google SecOps. A lista de permissões funciona com nomes de analisadores.

Configurar o conector de ameaças do McAfee EPO no Google SecOps

Para instruções detalhadas sobre como configurar um conector no Google SecOps, consulte Configurar o conector.

Parâmetros do conector

Use os seguintes parâmetros para configurar o conector:

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome do campo do produto String Nome do produto Sim Insira o nome do campo de origem para recuperar o nome do campo do produto.
Nome do campo do evento String EPOEvents_ThreatType Sim Insira o nome do campo de origem para recuperar o nome do campo de evento.
Nome do campo do ambiente String "" Não

Descreve o nome do campo em que o nome do ambiente é armazenado.

Se o campo de ambiente não for encontrado, o ambiente será o padrão.

Padrão Regex do ambiente String .* Não

Um padrão de regex para ser executado no valor encontrado no campo "Nome do campo de ambiente".

O padrão é .* para capturar tudo e retornar o valor inalterado.

Usado para permitir que o usuário manipule o campo de ambiente usando a lógica de regex.

Se o padrão de regex for nulo ou vazio, ou se o valor do ambiente for nulo, o resultado final será o ambiente padrão.

Tempo limite de script (segundos) Inteiro 180 Sim Limite de tempo limite para o processo do Python que executa o script atual.
Raiz da API String http://x.x.x.x:8443/remote/ Sim Raiz da API da instância do Trellix ePO.
Nome de usuário String N/A Sim Nome de usuário da instância do Trellix ePO.
Senha Senha Sim Senha da instância do Trellix ePO.
Nome do grupo String Não Se fornecido, o conector vai buscar ameaças apenas de endpoints que fazem parte desse grupo.
Máximo de horas para trás Inteiro 1 Não Quantidade de horas de onde os eventos serão buscados.
Máximo de eventos a serem buscados Inteiro 10 Não Quantos eventos serão processados por iteração do conector. Padrão: 10.
Gravidade mais baixa para buscar String Média Não

A gravidade mais baixa dos eventos a serem buscados. Por padrão, o conector vai ingerir todos os eventos. Valores possíveis:

Informações, Baixo, Médio, Alto, Crítico.

Usar a lista de permissões como uma lista de bloqueio Caixa de seleção Selecionado Sim Se ativada, a lista de permissões será usada como uma lista de bloqueio.
Verificar SSL Caixa de seleção Desmarcado Sim Se estiver ativado, verifique se o certificado SSL da conexão com o servidor do Trellix ePO é válido.
Arquivo de certificado de CA String N/A Falso Arquivo de certificado de CA codificado em Base64.
Endereço do servidor proxy String N/A Não O endereço do servidor proxy a ser usado.
Nome de usuário do proxy String N/A Não O nome de usuário do proxy para autenticação.
Senha do proxy Senha Não A senha do proxy para autenticação.

Regras do conector

Suporte a proxy

O conector é compatível com proxy.

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