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:
|
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:
|
Sim | Formato da exportação de dados. |
| Exportar modelo | LDD | Asset Valores possíveis:
|
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.