Integre a gestão de vulnerabilidades da Cisco com o Google SecOps

Este documento descreve como integrar a gestão de vulnerabilidades da Cisco com o Google Security Operations (Google SecOps).

Versão da integração: 1.0

Exemplos de utilização

Obtenha as estatísticas contextuais e as informações sobre ameaças necessárias para intercetar a próxima exploração e responder com precisão.

Parâmetros de integração

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

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
Raiz da API String Sim A raiz da API da integração da gestão de vulnerabilidades da Cisco.
Chave da API Palavra-passe Sim O token de API da integração do Cisco Vulnerability Management.
Validar SSL booleano Marcado Sim Se esta opção estiver selecionada, a integração valida o certificado SSL quando se liga ao Cisco Vulnerability Management. 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.

Tchim-tchim

Teste a conetividade à gestão de vulnerabilidades da Cisco.

Parâmetros

N/A

É apresentado em

A ação não usa entidades nem tem parâmetros de entrada obrigatórios.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valores Exemplo
is_success Verdadeiro/Falso is_success:False
Parede da caixa
Tipo de resultado Descrição Tipo
Mensagem de saída* A ação não deve falhar nem parar a execução de um manual de procedimentos:
Se for bem-sucedida:
imprima "Ligação estabelecida com êxito ao servidor do Cisco Vulnerability Management com os parâmetros de ligação fornecidos!"

A ação deve falhar e parar a execução de uma estratégia
Se não for bem-sucedida:
imprima "Falha ao estabelecer ligação ao servidor do Cisco Vulnerability Management! O erro é {0}".format(exception.stacktrace)
Geral

Enriquecer entidades

Enriqueça as entidades com informações da gestão de vulnerabilidades da Cisco.

Parâmetros

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
ID externo CSV Não Lista de IDs externos associados a um recurso separados por vírgulas. Os recursos pesquisados pelo ID externo vão ser pesquisados em paralelo com as entidades.

É apresentado em

Esta ação é executada nas seguintes entidades:

  • CVE
  • Endereço IP
  • Nome do anfitrião

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valores Exemplo
is_success Verdadeiro/Falso is_success:False
Resultado JSON
{
   "Entity": "Entity",
   "EntityResult":
       {
           "id": 1177,
           "status": "open",
           "closed_at": null,
           "created_at": "2025-02-06T09:00:16Z",
           "due_date": "2024-09-03",
           "notes": "Unknown",
           "port": [],
           "priority": 10,
           "identifiers": [
               "CVE-2024-38107"
           ],
           "last_seen_time": "2025-02-06T08:59:24.000Z",
           "scanner_score": null,
           "fix_id": 2692956,
           "scanner_vulnerabilities": [
               {
                   "port": null,
                   "external_unique_id": "CVE-2024-38107",
                   "open": true
               }
           ],
           "asset_id": 101,
           "connectors": [
               {
                   "id": 160084,
                   "name": "Custom CSV",
                   "connector_definition_name": "Custom CSV",
                   "vendor": "Cisco"
               }
           ],
           "service_ticket": null,
           "urls": {
               "asset": "api.trial1.eu.kennasecurity.com/assets/101"
           },
           "solution": "The following products are affected by this vulnerability:<ul><li><i>Operating System</i> <b>microsoft windows_10_1507</b></li><li><i>Operating System</i> <b>microsoft windows_10_1607</b></li><li><i>Operating System</i> <b>microsoft windows_10_1809</b></li><li><i>Operating System</i> <b>microsoft windows_10_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_10_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_23h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_24h2</b></li><li><i>Operating System</i> <b>microsoft windows_server_2012</b></li><li><i>Operating System</i> <b>microsoft windows_server_2016</b></li><li><i>Operating System</i> <b>microsoft windows_server_2019</b></li><li><i>Operating System</i> <b>microsoft windows_server_2022</b></li><li><i>Operating System</i> <b>microsoft windows_server_2022_23h2</b></li></ul>The following remediations or software updates can fix your system:<ul><li><b>windows_11_24h2</b> version needs to be updated to version 10.0.26100.1457 or greater.</li><li><b>windows_server_2022_23h2</b> version needs to be updated to version 10.0.25398.1085 or greater.</li><li><b>Windows 10 Version 20H2 Build 10240</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041782\">5041782</a>.</li><li><b>Windows 10 Version 1607 Build 14393</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041773\">5041773</a>.</li><li><b>Windows 10 Version 1809 Build 17763</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041578\">5041578</a>.</li><li><b>Windows 10 Version 21H2 Build 19044</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041580\">5041580</a>.</li><li><b>Windows 10 Version 22H2 Build 19045</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041580\">5041580</a>.</li><li><b>Windows 11 Version 21H2 Build 22000</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041592\">5041592</a>.</li><li><b>Windows 11 Version 22H2 Build 22621</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041585\">5041585</a>.</li><li><b>Windows 11 Version 23H2 Build 22631</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041585\">5041585</a>.</li><li><b>Windows Server 2012</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041851\">5041851</a>.</li><li><b>Windows Server 2012 R2</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041828\">5041828</a>.</li><li><b>Windows Server 2016</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041773\">5041773</a>.</li><li><b>Windows Server 2019</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041578\">5041578</a>.</li><li><b>Windows Server 2022 Build 20348</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041160\">5041160</a>.</li></ul>Refer to these referenced URL(s) for more information on remediation:<br/><ul><li><a href=\"https://msrc.microsoft.com/update-guide/vulnerability/CVE-2024-38107\">https://msrc.microsoft.com/update-guide/vulnerability/CVE-2024-38107</a></li></ul>",
           "patch": true,
           "patch_published_at": "2024-08-13T18:15:10.000Z",
           "cve_id": "CVE-2024-38107",
           "cve_description": "Windows Power Dependency Coordinator Elevation of Privilege Vulnerability",
           "cve_published_at": "2024-08-13T18:15:10.000Z",
           "description": null,
           "wasc_id": null,
           "severity": 7,
           "threat": 3,
           "popular_target": false,
           "active_internet_breach": false,
           "easily_exploitable": false,
           "malware_exploitable": false,
           "remote_code_execution": false,
           "predicted_exploitable": false,
           "platform_types": [
               "operating system"
           ],
           "cvss_v2": {
               "exploit_subscore": 3.1,
               "impact_subscore": 10.0,
               "score": 6.8,
               "temporal_score": 5.6
           },
           "cvss_v3": {
               "exploit_subscore": 1.8,
               "impact_subscore": 5.9,
               "score": 7.8
           },
           "custom_fields": [],
           "first_found_on": "2024-08-13T00:00:00Z",
           "top_priority": false,
           "risk_meter_score": 28,
           "closed": false
       }

}
Enriquecimento de entidades

Prefixo: CiscoVM_

Nome do campo de enriquecimento Lógica: quando aplicar
prioridade Quando estiver disponível em JSON
gravidade Quando estiver disponível em JSON
ameaça Quando estiver disponível em JSON
solução Quando estiver disponível em JSON
patch_available Quando estiver disponível em JSON
descrição Quando estiver disponível em JSON
published_at Quando estiver disponível em JSON
risk_score Quando estiver disponível em JSON
Recurso de tabela de enriquecimento

Prefixo: CiscoVM_

Nome do campo de enriquecimento Lógica: quando aplicar
os Quando estiver disponível em JSON
prioridade Quando estiver disponível em JSON
vulnerabilities_count Quando estiver disponível em JSON
estado Quando estiver disponível em JSON
last_seen_time Quando estiver disponível em JSON
etiquetas Quando estiver disponível em JSON
ip_address Quando estiver disponível em JSON
hostname Quando estiver disponível em JSON
fqdn Quando estiver disponível em JSON
risk_score Quando estiver disponível em JSON
asset_groups Quando estiver disponível em JSON
Parede da caixa
Tipo de resultado Descrição Tipo
Mensagem de saída* A ação não deve falhar nem parar a execução de um playbook:

Se os dados estiverem disponíveis para uma entidade (is_success = true):
imprima "Enriqueci com êxito as seguintes entidades na gestão de vulnerabilidades da Cisco: {entity.identifier}".

Se os dados não estiverem disponíveis para uma entidade (is_success=true):
print "Não foi possível enriquecer as seguintes entidades no Cisco Vulnerability Management: {entity.identifier}"

Se os dados não estiverem disponíveis para todas as entidades (is_success=false):
Não foram encontradas informações para as entidades fornecidas.

A ação deve falhar e parar a execução de um playbook:

Se ocorrer um erro fatal, como credenciais incorretas, nenhuma ligação ao servidor, outro:
imprima "Erro ao executar a ação "Enriquecer entidades". Motivo: {0}''.format(error.Stacktrace)
Geral

Atualizar recurso

Atualize as informações dos recursos associadas a entidades do Google SecOps a partir da gestão de vulnerabilidades da Cisco.

Parâmetros

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
ID externo CSV Não Lista de IDs externos associados a um recurso separados por vírgulas. Os recursos pesquisados pelo ID externo vão ser pesquisados em paralelo com as entidades.
Estado LDD Selecione uma opção

Valores possíveis:
  • Ativo
  • Inativo
  • Selecione uma opção
Não Estado do recurso.
Nota String Não Nota para o recurso.

É apresentado em

Esta ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do anfitrião

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valores Exemplo
is_success Verdadeiro/Falso is_success:False

Parede da caixa

Tipo de resultado Descrição Tipo
Mensagem de saída* A ação não deve falhar nem parar a execução de um manual de soluções:

Se os dados estiverem disponíveis para uma entidade (is_success = true):
imprima "As seguintes entidades foram atualizadas com êxito na gestão de vulnerabilidades da Cisco: {entity.identifier}".

Se 1 entidade não for encontrada (is_success=true):
print "Não foi possível atualizar as seguintes entidades no Cisco Vulnerability Management: {entity.identifier}"

Se os dados não estiverem disponíveis para todos (is_success=false):
Nenhuma das entidades fornecidas foi atualizada.


A ação deve falhar e parar a execução de um playbook:

Se ocorrer um erro fatal, como credenciais incorretas, nenhuma ligação ao servidor, outro:
imprima "Erro ao executar a ação "Atualizar recurso". Motivo: {0}''.format(error.Stacktrace)
Geral

Apresentar vulnerabilidades de recursos

Devolva informações sobre vulnerabilidades associadas a entidades do Cisco Vulnerability Management.

Parâmetros

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
ID externo CSV Não Lista de IDs externos associados a um recurso separados por vírgulas. Os recursos pesquisados pelo ID externo vão ser pesquisados em paralelo com as entidades.
Pontuação de risco mais baixa a devolver Int Não Pontuação de risco associada a vulnerabilidades. Se for fornecido, a ação filtra todas as vulnerabilidades que tenham uma pontuação de risco inferior à fornecida em Pontuação de risco mais baixa a devolver.

É apresentado em

Esta ação é executada nas seguintes entidades:

  • Endereço IP
  • Nome do anfitrião

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valores Exemplo
is_success Verdadeiro/Falso is_success:False
Resultado JSON
{
   "Entity": "Entity",
   "EntityResult": [
       {
           "id": 1177,
           "status": "open",
           "closed_at": null,
           "created_at": "2025-02-06T09:00:16Z",
           "due_date": "2024-09-03",
           "notes": "Unknown",
           "port": [],
           "priority": 10,
           "identifiers": [
               "CVE-2024-38107"
           ],
           "last_seen_time": "2025-02-06T08:59:24.000Z",
           "scanner_score": null,
           "fix_id": 2692956,
           "scanner_vulnerabilities": [
               {
                   "port": null,
                   "external_unique_id": "CVE-2024-38107",
                   "open": true
               }
           ],
           "asset_id": 101,
           "connectors": [
               {
                   "id": 160084,
                   "name": "Custom CSV",
                   "connector_definition_name": "Custom CSV",
                   "vendor": "Cisco"
               }
           ],
           "service_ticket": null,
           "urls": {
               "asset": "api.trial1.eu.kennasecurity.com/assets/101"
           },
           "solution": "The following products are affected by this vulnerability:<ul><li><i>Operating System</i> <b>microsoft windows_10_1507</b></li><li><i>Operating System</i> <b>microsoft windows_10_1607</b></li><li><i>Operating System</i> <b>microsoft windows_10_1809</b></li><li><i>Operating System</i> <b>microsoft windows_10_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_10_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_23h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_24h2</b></li><li><i>Operating System</i> <b>microsoft windows_server_2012</b></li><li>",
           "patch": true,
           "patch_published_at": "2024-08-13T18:15:10.000Z",
           "cve_id": "CVE-2024-38107",
           "cve_description": "Windows Power Dependency Coordinator Elevation of Privilege Vulnerability",
           "cve_published_at": "2024-08-13T18:15:10.000Z",
           "description": null,
           "wasc_id": null,
           "severity": 7,
           "threat": 3,
           "popular_target": false,
           "active_internet_breach": false,
           "easily_exploitable": false,
           "malware_exploitable": false,
           "remote_code_execution": false,
           "predicted_exploitable": false,
           "platform_types": [
               "operating system"
           ],
           "cvss_v2": {
               "exploit_subscore": 3.1,
               "impact_subscore": 10.0,
               "score": 6.8,
               "temporal_score": 5.6
           },
           "cvss_v3": {
               "exploit_subscore": 1.8,
               "impact_subscore": 5.9,
               "score": 7.8
           },
           "custom_fields": [],
           "first_found_on": "2024-08-13T00:00:00Z",
           "top_priority": false,
           "risk_meter_score": 28,
           "closed": false
       }
   ]
}
Parede da caixa
Tipo de resultado Descrição Tipo
Mensagem de saída* A ação não deve falhar nem parar a execução de um manual de procedimentos:

Se os dados estiverem disponíveis para uma entidade (is_success = true):
imprima "Foram listadas com êxito vulnerabilidades para as seguintes entidades na gestão de vulnerabilidades da Cisco: {entity.identifier}".

Se 1 entidade não for encontrada (is_success=true):
print "Não foi possível encontrar as seguintes entidades na gestão de vulnerabilidades da Cisco: {entity.identifier}"

Se os dados não estiverem disponíveis para todos (is_success=false):
Nenhuma das entidades fornecidas foi encontrada.

Se não existirem vulnerabilidades para algumas (is_success=true):

Não foram encontradas vulnerabilidades com base nos critérios fornecidos para as seguintes entidades na gestão de vulnerabilidades da Cisco: {entity.identifier}

Se não existirem vulnerabilidades para todas (is_success=true):

Não foram encontradas vulnerabilidades com base nos critérios fornecidos para as entidades fornecidas.

A ação deve falhar e parar a execução de um playbook:

Se ocorrer um erro fatal, como credenciais incorretas, nenhuma ligação ao servidor, outro:
imprima "Erro ao executar a ação "List Asset Vulnerabilities". Motivo: {0}''.format(error.Stacktrace)
Geral

Pedir exportação de dados

Peça a exportação de dados do Cisco Vulnerability Management e anexe os resultados à cronologia do registo. Esta ação não é executada em entidades do Google SecOps.

Esta ação é assíncrona. Ajuste o valor do limite de tempo do script no IDE do Google SecOps para a ação, conforme necessário.

Parâmetros

Nome do parâmetro Tipo Valor predefinido É obrigatório Descrição
Formato de exportação LDD JSON

Valores possíveis:
  • JSON
  • JSONL
  • XML
Sim Formato da exportação de dados.
Exportar modelo LDD Asset

Valores possíveis:
  • Recurso
  • Vulnerabilidade
  • Corrigir
  • Encontrar
Sim Modelo do objeto que tem de ser exportado.
Campos de exportação CSV Não Lista separada por vírgulas dos campos que quer devolver.
Filtro de consulta String Não Consulta para filtrar os dados que devem ser exportados.

É apresentado em

N/A

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valores Exemplo
is_success Verdadeiro/Falso is_success:False
Parede da caixa
Tipo de resultado Descrição Tipo
Mensagem de saída* A ação não deve falhar nem parar a execução de um playbook:

Se os dados estiverem disponíveis(is_success = true):
print "A exportação de dados foi realizada com êxito na gestão de vulnerabilidades da Cisco.".

Mensagem assíncrona:
A aguardar a conclusão da exportação de dados…


A ação deve falhar e parar a execução de um manual de procedimentos:

Se ocorrer um erro fatal, como credenciais incorretas, sem ligação ao servidor, outro:
imprima "Erro ao executar a ação "Pedir exportação de dados". Reason: {0}''.format(error.Stacktrace)

If error_message in response:

print "Error executing action "Request Data Export". Motivo: {error_message}''.
Geral

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