Intégrer Cisco Vulnerability Management à Google SecOps

Ce document explique comment intégrer Cisco Vulnerability Management à Google Security Operations (Google SecOps).

Cas d'utilisation

Obtenez les insights contextuels et les renseignements sur les menaces nécessaires pour intercepter le prochain exploit et y répondre avec précision.

Paramètres d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom du paramètre Type Valeur par défaut Est obligatoire Description
Racine de l'API Chaîne Oui Racine de l'API de l'intégration Cisco Vulnerability Management.
Jeton d'API Mot de passe Oui Jeton d'API de l'intégration Cisco Vulnerability Management.
Vérifier le protocole SSL Bool Cochée Oui Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion à Cisco Vulnerability Management. Cette option sera sélectionnée par défaut.

Pour savoir comment configurer une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement si nécessaire. Après avoir configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour en savoir plus sur la configuration et la prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis votre bureau et Exécuter une action manuelle dans votre demande.

Ping

Testez la connectivité à Cisco Vulnerability Management.

Paramètres

N/A

Exécution

L'action n'utilise pas d'entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Description Type
Message de sortie* L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
En cas de réussite :
print "Successfully connected to the Cisco Vulnerability Management server with the provided connection parameters!"

L'action doit échouer et arrêter l'exécution d'un playbook :
If not successful:
print "Failed to connect to the Cisco Vulnerability Management server! Error is {0}".format(exception.stacktrace)
Général

Enrichir les entités

Enrichissez les entités à l'aide des informations de Cisco Vulnerability Management.

Paramètres

Nom du paramètre Type Valeur par défaut Est obligatoire Description
ID externe CSV Non Liste d'ID externes associés à un élément, séparés par une virgule. Les éléments recherchés par ID externe seront recherchés en parallèle des entités.

Exécution

Cette action s'exécute sur les entités suivantes :

  • CVE
  • Adresse IP
  • Nom d'hôte

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat 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
       }

}
Enrichissement d'entités

Préfixe : CiscoVM_

Nom du champ d'enrichissement Logique : quand l'appliquer
priorité Lorsqu'il est disponible au format JSON
de gravité, Lorsqu'il est disponible au format JSON
menace Lorsqu'il est disponible au format JSON
solution Lorsqu'il est disponible au format JSON
patch_available Lorsqu'il est disponible au format JSON
description Lorsqu'il est disponible au format JSON
published_at Lorsqu'il est disponible au format JSON
risk_score Lorsqu'il est disponible au format JSON
Élément de table d'enrichissement

Préfixe : CiscoVM_

Nom du champ d'enrichissement Logique : quand l'appliquer
os Lorsqu'il est disponible au format JSON
priorité Lorsqu'il est disponible au format JSON
vulnerabilities_count Lorsqu'il est disponible au format JSON
état Lorsqu'il est disponible au format JSON
last_seen_time Lorsqu'il est disponible au format JSON
tags Lorsqu'il est disponible au format JSON
ip_address Lorsqu'il est disponible au format JSON
nom d'hôte Lorsqu'il est disponible au format JSON
fqdn Lorsqu'il est disponible au format JSON
risk_score Lorsqu'il est disponible au format JSON
asset_groups Lorsqu'il est disponible au format JSON
Mur des cas
Type de résultat Description Type
Message de sortie* L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des données sont disponibles pour une entité (is_success = true) :
print "Successfully enriched the following entities in Cisco Vulnerability Management: {entity.identifier}".

Si les données ne sont pas disponibles pour une entité (is_success=true) :
print "The action wasn't able to enrich the following entities in Cisco Vulnerability Management: {entity.identifier}"

Si les données ne sont pas disponibles pour toutes les entités (is_success=false) :
No information was found for the provided entities.

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. :
print "Error executing action "Enrich Entities". Reason: {0}''.format(error.Stacktrace)
Général

Mettre à jour l'élément

Mettez à jour les informations sur les éléments associés aux entités Google SecOps à partir de Cisco Gestion des failles.

Paramètres

Nom du paramètre Type Valeur par défaut Est obligatoire Description
ID externe CSV Non Liste d'ID externes associés à un élément, séparés par une virgule. Les éléments recherchés par ID externe seront recherchés en parallèle des entités.
État LDD Sélectionnez une option

Valeurs possibles :
  • Actif
  • Inactif
  • Sélectionnez une réponse
Non État de l'asset.
Remarque Chaîne Non Note pour l'élément.

Exécution

Cette action s'exécute sur les entités suivantes :

  • Adresse IP
  • Nom d'hôte

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False

Mur des cas

Type de résultat Description Type
Message de sortie* L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des données sont disponibles pour une entité (is_success = true) :
print "Successfully updated the following entities in Cisco Vulnerability Management: {entity.identifier}".

Si une entité n'est pas trouvée (is_success=true) :
print "The action wasn't able to update the following entities in Cisco Vulnerability Management: {entity.identifier}"

Si les données ne sont pas disponibles pour toutes les entités (is_success=false) :
None of the provided entities were updated.


L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. :
print "Error executing action "Update Asset". Reason: {0}''.format(error.Stacktrace)
Général

Lister les failles des éléments

Renvoie des informations sur les failles associées aux entités de Cisco Vulnerability Management.

Paramètres

Nom du paramètre Type Valeur par défaut Est obligatoire Description
ID externe CSV Non Liste d'ID externes associés à un élément, séparés par une virgule. Les éléments recherchés par ID externe seront recherchés en parallèle des entités.
Score de risque le plus bas à renvoyer Int Non Score de risque associé aux failles. Si cette option est fournie, l'action filtrera toutes les failles dont le score de risque est inférieur à celui fourni dans "Lowest Risk Score To Return" (Score de risque le plus bas à renvoyer).

Exécution

Cette action s'exécute sur les entités suivantes :

  • Adresse IP
  • Nom d'hôte

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Résultat 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
       }
   ]
}
Mur des cas
Type de résultat Description Type
Message de sortie* L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des données sont disponibles pour une entité (is_success = true) :
print "Successfully listed vulnerabilities for the following entities in Cisco Vulnerability Management: {entity.identifier}".

Si une entité est introuvable (is_success=true) :
print "The action wasn't able to find the following entities in Cisco Vulnerability Management: {entity.identifier}"

Si les données ne sont pas disponibles pour toutes les entités (is_success=false) :
None of the provided entities were found.

Si aucune faille n'est détectée pour certaines entités (is_success=true) :

Aucune faille basée sur les critères fournis n'a été détectée pour les entités suivantes dans Cisco Vulnerability Management : {entity.identifier}

Si aucune faille n'est détectée pour toutes les entités (is_success=true) :

Aucune faille basée sur les critères fournis n'a été détectée pour les entités fournies.

L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. :
print "Error executing action "List Asset Vulnerabilities". Reason: {0}''.format(error.Stacktrace)
Général

Demander l'exportation de données

Demandez l'exportation des données depuis Cisco Vulnerability Management et joignez les résultats au mur de la demande. Cette action ne s'exécute pas sur les entités Google SecOps.

Cette action est asynchrone. Ajustez la valeur du délai avant expiration du script dans l'IDE Google SecOps pour l'action, si nécessaire.

Paramètres

Nom du paramètre Type Valeur par défaut Est obligatoire Description
Format d'exportation LDD JSON

Valeurs possibles :
  • JSON
  • JSONL
  • XML
Oui Format de l'exportation de données.
Exporter le modèle LDD Asset

Valeurs possibles :
  • Élément
  • Faille
  • Corriger
  • Résultat
Oui Modèle de l'objet à exporter.
Champs "Exporter" CSV Non Liste de champs à renvoyer, séparés par une virgule.
Filtre de requête Chaîne Non Requête permettant de filtrer les données à exporter.

Exécution

N/A

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur Exemple
is_success Vrai/Faux is_success:False
Mur des cas
Type de résultat Description Type
Message de sortie* L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si des données sont disponibles(is_success = true) :
print "Successfully performed data export in Cisco Vulnerability Management.".

Message asynchrone :
En attente de la fin de l'exportation des données…


L'action doit échouer et arrêter l'exécution d'un playbook :

En cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. :
print "Error executing action "Request Data Export". Reason: {0}''.format(error.Stacktrace)

If error_message in response:

print "Error executing action "Request Data Export". Reason: {error_message}''.
Général

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.