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:
|
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:
|
Sí | Formato de la exportación de datos. |
| Exportar modelo | DDL | Recurso Valores posibles:
|
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.