Cisco AMP

Este documento descreve como integrar o Cisco Secure Endpoint ao Google Security Operations.

Configurar o Cisco Secure Endpoint para trabalhar com o Google Security Operations

Como gerar ID do cliente e chave de API:

  1. Faça login no console do Cisco Secure Endpoint para a América do Norte ou no console do Cisco Secure Endpoint para a Europa.

  2. Acesse Contas > Empresa e clique em Editar.

  3. Em "Recursos", clique em Regenerar para gerar o ID do cliente e a chave de API segura.

Depois de ter o ID do cliente e a chave de API, você pode fazer as chamadas de API da seguinte forma: https://<your_client_id>:<your_api_key>@<api_endpoint>

Como alternativa, use a autenticação HTTP básica. Codifique a string ":" em Base64 e envie o prefixo com a string "Basic" como o cabeçalho de autorização. Por exemplo, se o client_id for 1234 e a api_key for "atest", ele será codificado em base64 como MTIzNDphdGVzdA==, e o cabeçalho será:

Autorização:Basic MTIzNDphdGVzdA==

Codificação Base64

O ID do cliente e a chave de API podem ser codificados usando Base64 Decode and Encode (Decodificação e codificação em Base64).

Digite o ID do cliente e a chave de API no formato Client_ID:API key e codifique para gerar uma autenticação HTTP básica.

Rede

Função Porta padrão Direção Protocolo
API Multivalores Saída apikey

Configurar a integração do Cisco AMP no Google SecOps

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ê pretende configurar a integração.
Descrição String N/A Não Descrição da instância.
Raiz da API String https://api.amp.cisco.com Sim Especifique o URL raiz da API do Cisco Secure Endpoint.
ID do cliente String N/A Sim Especifique o ID do cliente.
Chave de API Senha N/A Sim Especifique a chave de API do Cisco Secure Endpoint.
Usar SSL Caixa de seleção Desmarcado Não Se ativada, verifica se o certificado SSL da conexão com o servidor do Cisco Secure Endpoint é válido.
Executar remotamente Caixa de seleção Desmarcado Não Marque a caixa para executar a integração configurada remotamente. Depois de marcada, a opção aparece para selecionar o usuário remoto (agente).

Ações

Adicionar arquivo à lista de arquivos

Descrição

Adicione um SHA-256 para uma lista de arquivos específica.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Lista de nomes de arquivos String N/A Sim Lista de proibições de arquivos.
Descrição String N/A Sim Descrição do arquivo.

Executar em

Essa ação é executada na entidade "Arquivo".

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
sucesso Verdadeiro/falso success:False

Criar grupo

Descrição

Crie um grupo.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome do grupo String N/A Sim O nome do novo grupo.
Descrição do grupo String N/A Sim A descrição do novo grupo.

Executar em

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
group_name Verdadeiro/falso group_name:False
Resultado do JSON
{
   "source": "CreatedviaAPI",
   "guid": "c5e2099d-3aeb-4dc2-add4-42fb01d05c51",
   "name": "test", "policies":
       [{
          "product": "windows",
          "description": "ThispolicyputstheAMPforEndpointsConnectorinamodethatwillonlydetectmaliciousfilesbutnotquarantinethem.Maliciousnetworktrafficisalsodetectedbutnotblocked.",
          links":
                 {
                   "policy": "https: //api.amp.cisco.com/v1/policies/a8ba7d10-de10-42a6-a6e4-8d679f5b1ec2", "policy_xml": "https: //api.amp.cisco.com/v1/policies/a8ba7d10-de10-42a6-a6e4-8d679f5b1ec2.xml"
                },
            "default": true,
            "File_lists":
                  [{
                    "guid": "cef9b12e-4a25-4f1a-93f4-3836ebd97ed5",
                    "type": "simple_custom_detections",
                    "name": "FileBlacklist"
                   },
                  {
                    "guid": "38c1a9eb-0389-4f12-8084-96f5ee62d72e",
                    "type": "application_blocking",
                    "name": "ExecutionBlacklist"
                   },
                   {
                    "guid": "3133128e-5455-4e74-82c5-1ff3c816c414",
                    "type": "application_whitelist",
                    "name": "FileWhitelist"
                   }],
            "ip_lists": [],
            "Used_in_groups":
                  [{
                    "guid": "d3f8be3c-e53b-4b31-a8b7-a78a69b74ea1",
                    "name": "Audit",
                    "description": "AuditGroupforPartner-Siemplify"
                  }],
           "inherited": false,
           "serial_number": 28,
           "guid": "a8ba7d10-de10-42a6-a6e4-8d679f5b1ec2",
           "Exclusion_sets":
                 [{
                    "guid": "43fc08b5-c603-4c24-9b4d-501d342f443c",
                    "name": "WorkstationExclusions"
                  }],
           "name": "Audit"
        }],
   "description": "added by siemplify!"
}

Receber informações do computador

Descrição

Receber detalhes sobre um computador.

Parâmetros

N/A

Executar em

Essa ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do host

Resultados da ação

Enriquecimento de entidade

As entidades são marcadas como "Suspeitas (True)" se excederem o limite. Caso contrário: False.

Nome do campo de enriquecimento Lógica: quando aplicar
Demo_AMP Retorna se ele existe no resultado JSON
Resultado do script
Nome do resultado do script Opções de valor Exemplo
sucesso Verdadeiro/falso success:False
Resultado do JSON
{
   "Demo_AMP":
         {
           "operating_system": "Windows 7, SP 1.0",
           "connector_guid": "f719857b-5474-467f-803c-00393616cdcf",
           "network_addresses":
              [{
                 "ip": "1.1.1.1",
                 "mac": "18:ac:08:1f:49:13"
               }],
           "faults": [],
           "external_ip": "1.1.1.1",
           "group_guid": "bcaafdfb-bf15-4f65-81e0-58b14624ff26",
           "hostname": "Demo_AMP",
           "install_date": "2018-05-09T14:51:04Z",
           "connector_version": "1.1.1.1",
           "internal_ips": ["92.168.133.146"],
           "Policy":
               {
                 "guid": "d04fbbc0-fc5d-45d9-94f6-9e53f5079c2f",
                 "name": "Triage"
               },
           "active": true,
           "last_seen": "2018-05-09T14:51:04Z"
           }
}

Receber computadores por hash de arquivo

Descrição

Extrai uma lista de computadores que têm arquivos observados com o valor SHA-256 especificado.

Executar em

Essa ação é executada na entidade "Filehash".

Resultados da ação

Enriquecimento de entidade

As entidades são marcadas como "Suspeitas (True)" se excederem o limite. Caso contrário: False.

Resultado do script
Nome do resultado do script Opções de valor Exemplo
sucesso Verdadeiro/falso success:False
Resultado do JSON
[{
   "EntityResult":
       {
        "0":
           {
            "connector_guid": "abfe956e-8b67-4d5c-9353-1b490cdad8b2",
            "links":
               {
                "trajectory": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2/trajectory",
                "computer": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2",
                "group": "https://api.amp.cisco.com/v1/groups/1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4"
                },
            "group_guid": "1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4",
            "active": "True",
            "operating_system": "Windows Server 2012 R2, SP 0.0",
            "network_addresses":
               [{
                  "ip": "10.0.0.4",
                  "mac": "00:0d:3a:4e:fc:6e"
                 },
                 {
                   "ip": "10.212.134.201",
                   "mac": "00:09:0f:aa:00:01"
                 }],
            "faults": [],
            "external_ip": "13.72.107.194",
            "hostname": "poc-JuanV",
            "install_date": "2019-04-29T19:37:06Z",
            "connector_version": "6.2.9.10881",
            "internal_ips": ["10.0.0.4", " 10.212.134.201"],
            "policy":
                {
                   "guid": "9d8be508-fbec-457a-a0eb-c0cb82be482c",
                   "name": "Server"
                },
            "last_seen": "2019-05-28T11:46:32Z"
            }
       },
  "Entity": "entityIdentifier"
 }]

Receber computadores por nome de arquivo

Descrição

Extrai uma lista de computadores que têm arquivos observados com o nome de arquivo especificado.

Executar em

Essa ação é executada na entidade "Filehash".

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
sucesso Verdadeiro/falso success:False
Resultado do JSON
[{
   "EntityResult":
     {
      "0":
        {
         "connector_guid": "abfe956e-8b67-4d5c-9353-1b490cdad8b2",
          "Links":
             {
              "trajectory": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2/trajectory",
              "computer": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2",
              "group": "https://api.amp.cisco.com/v1/groups/1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4"
              },
          "group_guid": "1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4",
          "active": "True",
          "operating_system": "Windows Server 2012 R2, SP 0.0",
           "network_addresses":
              [{
                 "ip": "10.0.0.4",
                 "mac": "00:0d:3a:4e:fc:6e"
               },
               {
                 "ip": "10.212.134.201",
                 "mac": "00:09:0f:aa:00:01"
               }],
           "faults": [],
           "external_ip": "13.72.107.194",
           "hostname": "poc-JuanV",
           "install_date": "2019-04-29T19:37:06Z",
           "connector_version": "6.2.9.10881",
           "internal_ips": ["10.0.0.4", " 10.212.134.201"],
           "policy":
               {
                  "guid": "9d8be508-fbec-457a-a0eb-c0cb82be482c",
                  "name": "Server"
               },
           "last_seen": "2019-05-28T11:46:32Z"
          }
     },
   "Entity": "entityIdentifier"
 }]

Receber computadores por atividade de rede (IP)

Descrição

Extrai uma lista de computadores que se conectaram ao endereço IP especificado.

Parâmetro

N/A

Executar em

Essa ação é executada na entidade "Endereço IP".

Resultados da ação

Enriquecimento de entidade

As entidades são marcadas como "Suspeitas (True)" se excederem o limite. Caso contrário: False.

Resultado do script
Nome do resultado do script Opções de valor Exemplo
sucesso Verdadeiro/falso success:False
Resultado do JSON
[{
  "EntityResult":
    {
     "0":
       {
        "connector_guid": "abfe956e-8b67-4d5c-9353-1b490cdad8b2",
        "links":
           {
             "trajectory": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2/trajectory",
             "computer": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2",
             "group":
 "https://api.amp.cisco.com/v1/groups/1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4"
            },
        "group_guid": "1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4",
        "active": "True",
        "operating_system": "Windows Server 2012 R2, SP 0.0",
       "network_addresses":
            [{
               "ip": "10.0.0.4",
               "mac": "00:0d:3a:4e:fc:6e"
             },
             {
               "ip": "10.212.134.201",
               "mac": "00:09:0f:aa:00:01"
            }],
       "faults": [],
       "external_ip": "13.72.107.194",
       "hostname": "poc-JuanV",
       "install_date": "2019-04-29T19:37:06Z",
       "connector_version": "6.2.9.10881",
       "internal_ips": ["10.0.0.4", " 10.212.134.201"],
       "policy":
           {
              "guid": "9d8be508-fbec-457a-a0eb-c0cb82be482c",
              "name": "Server"
           },
       "last_seen": "2019-05-28T11:46:32Z"
      }
    },
 "Entity": "entityIdentifier"
}]

Receber computadores por atividade de rede (URL)

Descrição

Extrai uma lista de computadores que se conectaram ao nome do host ou URL especificado.

Executar em

Essa ação é executada nas seguintes entidades:

  • Nome do host
  • URL

Resultados da ação

Enriquecimento de entidade

As entidades são marcadas como "Suspeitas (True)" se excederem o limite. Caso contrário: False.

Resultado do script
Nome do resultado do script Opções de valor Exemplo
sucesso Verdadeiro/falso success:False
Resultado do JSON
[{
  "EntityResult":
     {
      "0":
         {
          "connector_guid": "abfe956e-8b67-4d5c-9353-1b490cdad8b2",
          "links":
             {
              "trajectory": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2/trajectory",
              "computer": "https://api.amp.cisco.com/v1/computers/abfe956e-8b67-4d5c-9353-1b490cdad8b2",
              "group": "https://api.amp.cisco.com/v1/groups/1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4"
             },
         "group_guid": "1d7e90f6-b6b6-49ba-90ab-a8fe13d8f3d4",
         "active": "True",
         "operating_system": "Windows Server 2012 R2, SP 0.0",
         "Network_addresses":
             [{
               "ip": "10.0.0.4",
               "mac": "00:0d:3a:4e:fc:6e"
              },
              {
               "ip": "10.212.134.201",
               "mac": "00:09:0f:aa:00:01"
             }],
        "faults": [],
        "external_ip": "13.72.107.194",
        "hostname": "poc-JuanV",
        "install_date": "2019-04-29T19:37:06Z",
        "connector_version": "6.2.9.10881",
        "internal_ips": ["10.0.0.4", " 10.212.134.201"],
        "policy":
            {
              "guid": "9d8be508-fbec-457a-a0eb-c0cb82be482c",
              "name": "Server"
            },
       "last_seen": "2019-05-28T11:46:32Z"
       }
    },
 "Entity": "entityIdentifier"
}]

Itens da lista de arquivos

Descrição

Recebe os itens listados em uma determinada lista de arquivos.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da lista de arquivos String N/A Sim Exemplo: lista de proibições de arquivos

Executar em

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
Itens Verdadeiro/falso items:False
Resultado do JSON
{
  "Items":
    [{
      "source": "Created by uploading 1_Credit Card Magnetic Tracks - Notepad (2).TXT via Web from 1.1.1.1.",
      "sha256": "640e9583763fa553069a4984f8df5e81d6890897a6eb0f5de881218e3ed409c8", "description": ""
      },
     {
      "source": "Created by entering SHA-256 via Public api.",
      "sha256": "5fd924625f6ab16a19cc9807c7c506ae1813490e4ba675f843d5a10e0baacdb8",
      "description": "Added by Siemplify"
     },
     {
      "source": "Created by entering SHA-256 via Public api.",
      "sha256": "1248712441dbbf43bb37f91d626a020e7e0f4486f050142034b8a267b06a2f0c",
      "description": "Added by Siemplify"
   }],
 "guid": "cef9b12e-4a25-4f1a-93f4-3836ebd97ed5",
 "name": "File Blacklist"
}

Receber listas de arquivos por política

Descrição

Receba as listas de arquivos atribuídas a uma política.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome da política String N/A Sim O nome da política, por exemplo, "Triagem".

Executar em

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
File_Lists N/A N/A
Resultado do JSON
{
  "1":
    {
     "guid": "38c1a9eb-0389-4f12-8084-96f5ee62d72e",
     "type": "application_blocking",
     "name": "Execution Blacklist"},
     "0":
       {
         "guid": "cef9b12e-4a25-4f1a-93f4-3836ebd97ed5",
         "type": "simple_custom_detections",
         "name": "File Blacklist"
       },
    "2":
      {
         "guid": "3133128e-5455-4e74-82c5-1ff3c816c414",
         "type": "application_whitelist",
         "name": "File Whitelist"
    }
}

Receber grupos

Descrição

Receba detalhes do grupo.

Parâmetros

N/A

Executar em

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
Grupos N/A N/A
Resultado do JSON
{
  "1":
    {
     "source": "CreatedviaAPI",
     "guid": "1111111111111111111111",
     "name": "TestGroup",
     "description": "GroupcreatedbySiemplify"
    },
  "0":
    {
     "source": null,
     "guid": "1111111111111111111111",
     "name": "Audit",
     "description": "AuditGroupforPartner-Siemplify"
    }
}

Receber políticas

Descrição

Receba detalhes da política.

Parâmetros

N/A

Executar em

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
Políticas N/A N/A
Resultado do JSON
{
  "1":
    {
     "product": "ios",
     "name": "Audit",
     "default": true,
     "serial_number": 38,
     "guid": "1111111111111111",
     "description": "ThispolicyputsClarityinamodethatwilllogandalertonconvictionsbutnotblocktraffic."
    },
  "0":
    {
     "product": "android",
     "name": "Protect",
     "default": true,
     "serial_number": 11,
     "guid": "1111111111111111",
     "description": "ThisisthestandardpolicyfortheAMPforEndpointsConnectorthatwillquarantinemaliciousfilesandblockmaliciousnetworkconnections."
   }
}

Ping

Descrição

Teste a conectividade com o Cisco Secure Endpoint.

Parâmetros

N/A

Executar em

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

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor Exemplo
sucesso Verdadeiro/falso success:False

Isolar máquina

Descrição

Isolar um host para que ele pare de enviar e receber tráfego de rede.

Parâmetros

N/A

Casos de uso

Ransomware detectado em um host:

  1. Interrompa o processo de ransomware.
  2. Exclua o ransomware, se possível.
  3. Isolar host.

Executar em

Essa ação é executada nas seguintes entidades:

  • Host
  • IP interno
  • IP externo

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
"data": {
        "available": true,
        "status": "isolated",
        "unlock_code": "kzhduj",
        "comment": "Host pending investigation",
        "isolated_by": "Meny Har"
    }
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 a ação for bem-sucedida: "O host de destino foi isolado:{host}/{Internal IP}/{External IP}"

Se não der certo: "O host de destino não foi isolado"

A ação precisa falhar e interromper a execução de um playbook:

Se for um erro crítico, como credenciais incorretas ou perda de conectividade: "Ocorreram alguns erros. Confira o registro."

Geral

Unisolate Machine

Descrição

Interrompa o isolamento em um host para permitir o tráfego de rede para e do host isolado anteriormente.

Executar em

Essa ação é executada nas seguintes entidades:

  • Host
  • IP interno
  • IP externo

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
"data": {
        "available": true,
        "status": "isolated",
        "unlock_code": "kzhduj",
        "comment": "Host confirmed:Infection free",
        "isolated_by": "Meny Har"
    }
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 a operação for concluída:

print 'Target Host was unisolated successfully:{host}/{Internal IP}/{IP externo

Se não der certo:

print 'Target Host was not unisolated successfully'

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro crítico, como credenciais incorretas ou perda de conectividade:

"Ocorreram alguns erros. Confira o registro."

Geral

Conector

Cisco AMP: conector de eventos de segurança

Descrição

Extrair eventos de segurança do Cisco Secure Endpoint para o Google SecOps.

Configurar o conector de eventos de segurança do Cisco AMP 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 de evento String eventType Sim Insira o nome do campo de origem para recuperar o nome do campo de evento.
Nome do campo de 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 de regex do ambiente String .* Não

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

O padrão é ".*" para capturar tudo e retornar o valor sem alterações.

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 do script (segundos) Número inteiro 180 Sim Limite de tempo limite para o processo Python que executa o script atual.
Raiz da API String https:/{{ip address}} Sim Raiz da API da instância do Cisco Secure Endpoint.
ID do cliente String Sim ID do cliente do Cisco Secure Endpoint.
Chave de API Senha Sim Chave de API do Cisco Secure Endpoint.
Gravidade mínima a ser buscada String Não

Gravidade que será usada para buscar eventos. Se nada for especificado, o conector vai ingerir eventos de todas as gravidades. Os eventos sem dados de gravidade são processados pelo parâmetro "Buscar eventos sem gravidade". Valores possíveis:

Baixa, média, alta, crítica.

Buscar eventos sem gravidade Caixa de seleção Não Se ativado, o conector vai buscar eventos sem gravidade. Esses eventos vão receber a gravidade "Informativa".
Máximo de horas para trás Número inteiro 1 Não Número de horas de onde buscar eventos.
Número máximo de eventos a serem buscados Número inteiro 100 Não Quantos alertas processar por iteração de conector. O valor máximo é 1.000. Padrão: 100;
Usar a lista de permissões como uma lista de proibições Caixa de seleção Desmarcado Sim Se ativada, a lista de permissões será usada como uma lista de bloqueios.
Verificar SSL Caixa de seleção Selecionado Sim Se ativado, verifique se o certificado SSL da conexão com o servidor do Cisco Secure Endpoint é válido.
Endereço do servidor proxy String Não O endereço do servidor proxy a ser usado.
Nome de usuário do proxy String 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 de 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.