FireEye AX

Neste documento, descrevemos como integrar o FireEye AX ao Google Security Operations.

Casos de uso

Enriquecer entidades.

Configurar a integração do FireEye AX 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:/<<ip address>> Sim Raiz da API da instância do Trellix Malware Analysis.
Nome de usuário String N/A Sim Nome de usuário da conta do Trellix Malware Analysis.
Senha Senha N/A Sim Senha da conta do Trellix Malware Analysis.
Verificar SSL Caixa de seleção Selecionado Sim Se ativado, verifique se o certificado SSL da conexão com o servidor do Trellix Malware Analysis é válido.

Ações

Ping

Descrição

Teste a conectividade com o Trellix Malware Analysis usando os parâmetros fornecidos na página de configuração da integração no 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*

A ação não pode falhar nem interromper a execução de um playbook:
se for bem-sucedida: "Successfully connected to the Trellix Malware Analysis server with the provided connection parameters!"

A ação deve falhar e interromper a execução de um playbook:
if not successful: "Failed to connect to the Trellix Malware Analysis server! O erro é {0}".format(exception.stacktrace)

Geral

Enviar URL

Descrição

Envie o arquivo para análise usando o URL no Trellix Malware Analysis. Entidades compatíveis: URL.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Perfil da VM String N/A Sim Especifique o perfil da máquina virtual que será usado durante a análise. Os perfis de VM disponíveis estão disponíveis na ação "Receber detalhes do dispositivo"
ID do aplicativo String N/A Não Especifique o ID do aplicativo que precisa ser usado durante a análise do arquivo. Por padrão, o Trellix Malware Analysis seleciona o aplicativo necessário automaticamente. Para ver uma lista de aplicativos disponíveis no perfil, execute a ação "Receber detalhes do dispositivo"
Prioridade DDL

Normal

Valores possíveis:

Normal

Urgente

Não Especifique a prioridade do envio. "Normal" coloca o envio no final da fila, enquanto "Urgente" coloca o envio no início da fila.
Forçar nova verificação Caixa de seleção Não Se ativada, a ação vai forçar o Trellix Malware Analysis a verificar novamente o arquivo enviado.
Analysis Type DDL

Ao vivo

Valores possíveis:

Ao vivo

Sandbox

Não Especifique o tipo de análise. Se "Live" estiver selecionado, o Trellix Malware Analysis vai analisar arquivos suspeitos em tempo real no mecanismo de análise de execução virtual multivetorial (MVX) do Malware Analysis. Se a opção "Sandbox" estiver selecionada, o Trellix Malware Analysis vai analisar os arquivos suspeitos em um ambiente fechado e protegido.
Criar insight Caixa de seleção Sim Se ativada, a ação vai criar um insight com informações sobre o arquivo enviado.

Corrida

Essa ação é executada na entidade de URL.

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
Resultado do JSON
 {
    "details":
        {
            "explanation": {
                "malwareDetected": {
                    "malware": [
                        {
                            "md5Sum": "29ef299c80d00ee4340b3694d870fe82",
                            "sha256": "0cff2d41a69d72de30607b8fc09da90e352393e154a342efcddb91e06b3a2147"
                        },
                        {
                            "note": "",
                            "md5Sum": "29ef299c80d00ee4340b3694d870fe82",
                            "sha256": "0cff2d41a69d72de30607b8fc09da90e352393e154a342efcddb91e06b3a2147",
                            "application": "application:0",
                            "user": "xxxxx",
                            "original": "vlc-3.0.16-win64.exe",
                            "type": "exe",
                            "origid": 176
                        }
                    ]
                },
                "osChanges": [],
                "staticAnalysis": {
                    "static": [
                        {}
                    ]
                },
                "stolenData": {
                    "info": {
                        "field": []
                    }
                }
            },
            "src": {},
            "alertUrl": "https://172.18.5.2/malware_analysis/analyses?maid=177",
            "action": "notified",
            "attackTime": "2021-09-13 11:15:56 +0000",
            "dst": {},
            "applianceId": "AC1F6B7A7C8C",
            "id": 177,
            "name": "xxxxx_xxxxx",
            "severity": "MINR",
            "uuid": "61330da9-20ad-4196-a901-02b2166ad36d",
            "ack": "no",
            "product": "MAS",
            "vlan": 0,
            "malicious": "no"
        }
    ],
    "appliance": "MAS",
    "version": "MAS (MAS) 9.1.0.950877",
    "msg": "extended",
    "alertsCount": 1
}
Tabela de enriquecimento
Nome do campo de enriquecimento Lógica: quando aplicar
Mal-intencionado Quando disponível em JSON
gravidade, Quando disponível em JSON
Insight de entidade

Exemplo de insight de entidade:

Mal-intencionado:verdadeiro

Gravidade:MINR Contagem de serviços de C&C:0 Contagem de processos executados:0 Contagem de alterações no registro:0 Contagem de arquivos extraídos:0

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

A ação não pode falhar nem interromper a execução de um playbook:
Se os dados estiverem disponíveis para um(is_success = true): "As seguintes entidades foram enriquecidas com sucesso usando informações do Trellix Malware Analysis: {entity.identifier}".

Se os dados não estiverem disponíveis para um (is_success=true): "A ação não conseguiu enriquecer as seguintes entidades usando informações do Trellix Malware Analysis: {entity.identifier}"

Se os dados não estiverem disponíveis para todas as entidades (is_success=false): nenhuma das entidades fornecidas foi enriquecida.

Mensagem assíncrona:aguardando o processamento dos seguintes arquivos: {pending files}

A ação deve falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: "Erro ao executar a ação 'Enriquecer entidades'. Motivo: {0}''.format(error.Stacktrace)

Se houver tempo limite: "Erro ao executar a ação 'Enriquecer entidades'. Motivo: a ação atingiu o tempo limite. Os seguintes arquivos ainda estão sendo processados: {pending urls}. Aumente o tempo limite no ambiente de desenvolvimento integrado. Observação: adicionar os mesmos arquivos vai criar um job de análise separado no Trellix Malware Analysis.

Geral
Tabela do painel de casos Título: {entity.identifier} Entidade

Enviar arquivo

Descrição

Envie o arquivo para análise no Trellix Malware Analysis.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Caminhos de arquivos CSV N/A Sim Especifique uma lista separada por vírgulas de caminhos de arquivo absolutos para envio.
Perfil da VM String N/A Sim Especifique o perfil da máquina virtual que será usado durante a análise. Os perfis de VM disponíveis estão disponíveis na ação "Receber detalhes do dispositivo"
ID do aplicativo String N/A Não Especifique o ID do aplicativo que precisa ser usado durante a análise do arquivo. Por padrão, o Trellix Malware Analysis seleciona o aplicativo necessário automaticamente. Para ver uma lista de aplicativos disponíveis no perfil, execute a ação "Receber detalhes do dispositivo"
Prioridade DDL

Normal

Valores possíveis:

Normal

Urgente

Não Especifique a prioridade do envio. "Normal" coloca o envio no final da fila, enquanto "Urgente" coloca o envio no início da fila.
Forçar nova verificação Caixa de seleção Não Se ativada, a ação vai forçar o Trellix Malware Analysis a verificar novamente o arquivo enviado.
Analysis Type DDL

Ao vivo

Valores possíveis:

Ao vivo

Sandbox

Não Especifique o tipo de análise. Se "Live" estiver selecionado, o Trellix Malware Analysis vai analisar arquivos suspeitos em tempo real no mecanismo de análise de execução virtual multivetorial (MVX) do Malware Analysis. Se a opção "Sandbox" estiver selecionada, o Trellix Malware Analysis vai analisar os arquivos suspeitos em um ambiente fechado e protegido.
Criar insight Caixa de seleção Sim Se ativada, a ação vai criar um insight com informações sobre o arquivo enviado.

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
Resultado do JSON
{
    "absolute_path": "/opt/wow/koko.exe",
    "details":
        {
            "explanation": {
                "malwareDetected": {
                    "malware": [
                        {
                            "md5Sum": "29ef299c80d00ee4340b3694d870fe82",
                            "sha256": "0cff2d41a69d72de30607b8fc09da90e352393e154a342efcddb91e06b3a2147"
                        },
                        {
                            "note": "",
                            "md5Sum": "29ef299c80d00ee4340b3694d870fe82",
                            "sha256": "0cff2d41a69d72de30607b8fc09da90e352393e154a342efcddb91e06b3a2147",
                            "application": "application:0",
                            "user": "xxxxx",
                            "original": "vlc-3.0.16-win64.exe",
                            "type": "exe",
                            "origid": 176
                        }
                    ]
                },
                "osChanges": [],
                "staticAnalysis": {
                    "static": [
                        {}
                    ]
                },
                "stolenData": {
                    "info": {
                        "field": []
                    }
                }
            },
            "src": {},
            "alertUrl": "https://172.18.5.2/malware_analysis/analyses?maid=177",
            "action": "notified",
            "attackTime": "2021-09-13 11:15:56 +0000",
            "dst": {},
            "applianceId": "AC1F6B7A7C8C",
            "id": 177,
            "name": "xxxxx_xxxxx",
            "severity": "MINR",
            "uuid": "61330da9-20ad-4196-a901-02b2166ad36d",
            "ack": "no",
            "product": "MAS",
            "vlan": 0,
            "malicious": "no"
        }
    ],
    "appliance": "MAS",
    "version": "MAS (MAS) 9.1.0.950877",
    "msg": "extended",
    "alertsCount": 1
}
Insight de entidade

Exemplo de insight de entidade:

Mal-intencionado:verdadeiro

Gravidade:MAJR Contagem de serviços de C&C:15 Contagem de processos executados:0 Contagem de alterações no registro:13 Contagem de arquivos extraídos:10

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

A ação não pode falhar nem interromper a execução de um playbook:
Se concluída para um caminho de arquivo (is_success = true): "Successfully retrieved details for the following files in Trellix Malware Analysis: {submitted files}.".

Mensagem assíncrona:aguardando o processamento dos seguintes arquivos: {pending files}

A ação deve falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: "Erro ao executar a ação 'Enviar arquivo'. Motivo: {0}''.format(error.Stacktrace)

Se houver um tempo limite: "Erro ao executar a ação 'Enviar arquivo'. Motivo: a ação atingiu o tempo limite. Os seguintes arquivos ainda estão sendo processados: {pending files}. Aumente o tempo limite no ambiente de desenvolvimento integrado. Observação: adicionar os mesmos arquivos vai criar um job de análise separado no Trellix Malware Analysis.

Se pelo menos um arquivo não for encontrado: "Erro ao executar a ação 'Anexar arquivo ao caso'. Motivo: os seguintes arquivos não foram encontrados ou a ação não tem permissões suficientes para acessá-los: {not available files}'

Geral

Receber detalhes do dispositivo

Descrição

Recuperar informações sobre o appliance Trellix Malware Analysis.

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
Resultado do JSON
{
    "absolute_path": "/opt/wow/koko.exe",
    "details":
        {
            "explanation": {
                "malwareDetected": {
                    "malware": [
                        {
                            "md5Sum": "29ef299c80d00ee4340b3694d870fe82",
                            "sha256": "0cff2d41a69d72de30607b8fc09da90e352393e154a342efcddb91e06b3a2147"
                        },
                        {
                            "note": "",
                            "md5Sum": "29ef299c80d00ee4340b3694d870fe82",
                            "sha256": "0cff2d41a69d72de30607b8fc09da90e352393e154a342efcddb91e06b3a2147",
                            "application": "application:0",
                            "user": "xxxxx",
                            "original": "vlc-3.0.16-win64.exe",
                            "type": "exe",
                            "origid": 176
                        }
                    ]
                },
                "osChanges": [],
                "staticAnalysis": {
                    "static": [
                        {}
                    ]
                },
                "stolenData": {
                    "info": {
                        "field": []
                    }
                }
            },
            "src": {},
            "alertUrl": "https://172.18.5.2/malware_analysis/analyses?maid=177",
            "action": "notified",
            "attackTime": "2021-09-13 11:15:56 +0000",
            "dst": {},
            "applianceId": "AC1F6B7A7C8C",
            "id": 177,
            "name": "xxxxx_xxxxx",
            "severity": "MINR",
            "uuid": "61330da9-20ad-4196-a901-02b2166ad36d",
            "ack": "no",
            "product": "MAS",
            "vlan": 0,
            "malicious": "no"
        }
    ],
    "appliance": "MAS",
    "version": "MAS (MAS) 9.1.0.950877",
    "msg": "extended",
    "alertsCount": 1
}
Painel de casos
Tipo de resultado Valor/Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
Se concluída para um caminho de arquivo (is_success = true): "Successfully retrieved details about Trellix Malware Analysis.".

A ação deve falhar e interromper a execução de um playbook:
Se houver um erro fatal, como credenciais incorretas, falta de conexão com o servidor, entre outros: "Erro ao executar a ação 'Receber detalhes do dispositivo'. Motivo: {0}''.format(error.Stacktrace)

Geral

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