Integrar Cisco Vulnerability Management con Google SecOps

En este documento se describe cómo integrar Cisco Vulnerability Management con Google Security Operations (Google SecOps).

Versión de la integración: 1.0

Casos prácticos

Obtén las estadísticas contextuales y la inteligencia sobre amenazas que necesitas para interceptar la próxima vulnerabilidad y responder con precisión.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Raíz de la API Cadena Sí La raíz de la API de la integración de gestión de vulnerabilidades de Cisco.
Token de API Contraseña Sí El token de API de la integración de gestión de vulnerabilidades de Cisco.
Verificar SSL bool Marcada Sí Si se selecciona, la integración valida el certificado SSL al conectarse a Cisco Vulnerability Management. Esta opción está seleccionada de forma predeterminada.

Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configurar integraciones.

Si es necesario, puedes hacer cambios más adelante. Después de configurar una instancia de integración, puedes usarla en los cuadernos de estrategias. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Admitir varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Responder a acciones pendientes desde Tu espacio de trabajo y Realizar una acción manual.

Ping

Prueba la conectividad con Cisco Vulnerability Management.

Parámetros

N/A

Fecha de ejecución

La acción no usa entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Panel de casos
Tipo de resultado Descripción Tipo
Mensaje de salida* La acción no debe fallar ni detener la ejecución de un playbook:
Si se realiza correctamente:
print "Successfully connected to the Cisco Vulnerability Management server with the provided connection parameters!"

La acción debería fallar y detener la ejecución de un playbook:
Si no se ha completado correctamente:
print "Failed to connect to the Cisco Vulnerability Management server! Error: {0}".format(exception.stacktrace)
General

Enriquecer entidades

Enriquece las entidades con información de Cisco Vulnerability Management.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID externo CSV No Lista separada por comas de IDs externos asociados a un recurso. Los recursos buscados por ID externo se buscarán en paralelo a las entidades.

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • CVE
  • Dirección IP
  • Nombre de host

Resultados de la acción

Resultado de la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de 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
       }

}
Enriquecimiento de entidades

Prefijo: CiscoVM_

Nombre del campo de enriquecimiento Lógica: cuándo se aplica
prioridad Cuando esté disponible en JSON
gravedad Cuando esté disponible en JSON
amenaza Cuando esté disponible en JSON
solución Cuando esté disponible en JSON
patch_available Cuando esté disponible en JSON
description Cuando esté disponible en JSON
published_at Cuando esté disponible en JSON
risk_score Cuando esté disponible en JSON
Recurso de tabla de enriquecimiento

Prefijo: CiscoVM_

Nombre del campo de enriquecimiento Lógica: cuándo se aplica
os Cuando esté disponible en JSON
prioridad Cuando esté disponible en JSON
vulnerabilities_count Cuando esté disponible en JSON
status Cuando esté disponible en JSON
last_seen_time Cuando esté disponible en JSON
etiquetas Cuando esté disponible en JSON
ip_address Cuando esté disponible en JSON
nombre de host Cuando esté disponible en JSON
fqdn Cuando esté disponible en JSON
risk_score Cuando esté disponible en JSON
asset_groups Cuando esté disponible en JSON
Panel de casos
Tipo de resultado Descripción Tipo
Mensaje de salida* La acción no debe fallar ni detener la ejecución de un playbook:

Si hay datos disponibles para una entidad (is_success = true):
print "Successfully enriched the following entities in Cisco Vulnerability Management: {entity.identifier}".

Si no hay datos disponibles para una entidad (is_success=true):
print "No se ha podido enriquecer la siguiente entidad en Cisco Vulnerability Management: {entity.identifier}"

Si no hay datos disponibles para todas las entidades (is_success=false):
No se ha encontrado información sobre las entidades proporcionadas.

La acción debería fallar y detener la ejecución de un cuaderno de estrategias:

Si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error:
imprime "Error al ejecutar la acción "Enriquecer entidades". Motivo: {0}''.format(error.Stacktrace)
General

Actualizar recurso

Actualiza la información de los recursos asociados a entidades de Google SecOps desde Cisco Vulnerability Management.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID externo CSV No Lista separada por comas de IDs externos asociados a un recurso. Los recursos buscados por ID externo se buscarán en paralelo a las entidades.
Estado DDL Seleccionar uno

Valores posibles:
  • Activo
  • Inactiva
  • Selecciona una opción.
No Estado del recurso.
Nota Cadena No Nota del recurso.

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • Dirección IP
  • Nombre de host

Resultados de la acción

Resultado de la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False

Panel de casos

Tipo de resultado Descripción Tipo
Mensaje de salida* La acción no debe fallar ni detener la ejecución de un playbook:

Si hay datos disponibles para una entidad (is_success = true):
print "Successfully updated the following entities in Cisco Vulnerability Management: {entity.identifier}".

Si no se encuentra una entidad (is_success=true):
print "The action wasn't able to update the following entities in Cisco Vulnerability Management: {entity.identifier}"

Si los datos no están disponibles para todas las entidades (is_success=false):
No se ha actualizado ninguna de las entidades proporcionadas.


La acción debería fallar y detener la ejecución de un cuaderno de estrategias:

Si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error:
imprime "Error al ejecutar la acción "Update Asset". Motivo: {0}''.format(error.Stacktrace)
General

List Asset Vulnerabilities

Devuelve información sobre las vulnerabilidades asociadas a entidades de Cisco Vulnerability Management.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID externo CSV No Lista separada por comas de IDs externos asociados a un recurso. Los recursos buscados por ID externo se buscarán en paralelo a las entidades.
Puntuación de riesgo más baja que se devolverá Entero No Puntuación de riesgo asociada a vulnerabilidades. Si se proporciona, action filtrará todas las vulnerabilidades que tengan una puntuación de riesgo inferior a la proporcionada en Puntuación de riesgo más baja que se va a devolver.

Fecha de ejecución

Esta acción se ejecuta en las siguientes entidades:

  • Dirección IP
  • Nombre de host

Resultados de la acción

Resultado de la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de 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
       }
   ]
}
Panel de casos
Tipo de resultado Descripción Tipo
Mensaje de salida* La acción no debe fallar ni detener la ejecución de un playbook:

Si hay datos disponibles para una entidad (is_success = true):
print "Successfully listed vulnerabilities for the following entities in Cisco Vulnerability Management: {entity.identifier}".

Si no se encuentra ninguna entidad (is_success=true):
print "No se ha podido encontrar la siguiente entidad en Cisco Vulnerability Management: {entity.identifier}"

Si no hay datos disponibles para todas las entidades (is_success=false):
No se ha encontrado ninguna de las entidades proporcionadas.

Si no hay vulnerabilidades en algunos casos (is_success=true):

No se han encontrado vulnerabilidades en las siguientes entidades de Cisco Vulnerability Management según los criterios proporcionados: {entity.identifier}

Si no hay vulnerabilidades en todos los casos (is_success=true):

No se han encontrado vulnerabilidades en las entidades proporcionadas según los criterios proporcionados.

La acción debería fallar y detener la ejecución de un libro de jugadas:

Si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error:
print "Error executing action "List Asset Vulnerabilities". Motivo: {0}''.format(error.Stacktrace)
General

Solicitar exportación de datos

Solicita la exportación de datos de Cisco Vulnerability Management y adjunta los resultados al muro del caso. Esta acción no se ejecuta en entidades de Google SecOps.

Esta acción es asíncrona. Ajusta el valor de tiempo de espera de la secuencia de comandos en el IDE de Google SecOps para la acción según sea necesario.

Parámetros

Nombre del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Formato de exportación DDL JSON

Valores posibles:
  • JSON
  • JSONL
  • XML
Sí Formato de la exportación de datos.
Exportar modelo DDL Recurso

Valores posibles:
  • Recurso
  • Vulnerabilidad
  • Solucionar
  • Hallazgo
Sí Modelo del objeto que se debe exportar.
Exportar campos CSV No Lista separada por comas de los campos que quieres devolver.
Filtro de consulta Cadena No Consulta para filtrar los datos que se deben exportar.

Fecha de ejecución

N/A

Resultados de la acción

Resultado de la secuencia de comandos
Nombre del resultado del script Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Panel de casos
Tipo de resultado Descripción Tipo
Mensaje de salida* La acción no debe fallar ni detener la ejecución de un libro de jugadas:

Si hay datos disponibles(is_success = true):
print "Se ha realizado correctamente la exportación de datos en Cisco Vulnerability Management.".

Mensaje asíncrono:
Esperando a que se complete la exportación de datos…


La acción debería fallar y detener la ejecución de un playbook:

Si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error:
print "Error al ejecutar la acción "Solicitar exportación de datos". Motivo: {0}''.format(error.Stacktrace)

If error_message in response:

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

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.