Cisco Orbital

Ce document explique comment intégrer Cisco Orbital à Google Security Operations.

Cas d'utilisation

Effectuer des actions actives : exécuter des requêtes SQL pour obtenir plus d'informations sur le point de terminaison.

Configurer l'intégration de Cisco Orbital pour qu'elle fonctionne avec Google Security Operations

Autorisation de produit

Pour vous authentifier, vous devez générer un jeton et l'utiliser dans les requêtes API.

Générer un ID client et un code secret du client

Pour générer un ID client et un code secret du client, procédez comme suit :

  1. Connectez-vous à Cisco Orbital.
  2. Accédez aux paramètres du compte, puis cliquez sur Créer des identifiants d'API.
  3. Remplissez les champs.
  4. Copiez l'ID client et le code secret du client.

Configurer l'intégration de Cisco Orbital dans Google SecOps

Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Paramètres d'intégration

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

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Nom de l'instance Chaîne N/A Non Nom de l'instance pour laquelle vous souhaitez configurer l'intégration.
Description Chaîne N/A Non Description de l'instance.
ID client Chaîne N/A Oui ID client du compte Cisco Orbital.
Code secret du client Mot de passe N/A Oui Code secret du client du compte Cisco Orbital.
Vérifier le protocole SSL Case à cocher Cochée Non Si cette option est activée, vérifie que le certificat SSL de la connexion au serveur Cisco Orbital est valide.
Exécuter à distance Case à cocher Décochée Non Cochez le champ pour exécuter l'intégration configurée à distance. Une fois cette option cochée, l'option permettant de sélectionner l'utilisateur distant (agent) s'affiche.

Actions

Ping

Description

Testez la connectivité à Cisco Orbital avec les paramètres fournis sur la page de configuration de l'intégration dans la page du hub de contenus Google SecOps.

Paramètres

N/A

Exécuter sur

L'action ne s'exécute pas sur les 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 Valeur / Description Type
Message de sortie*

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

Si l'opération réussit : "Successfully connected to the Cisco Orbital server with the provided connection parameters!" (Connexion au serveur Cisco Orbital établie avec les paramètres de connexion fournis)

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

Si l'opération échoue : "Failed to connect to the Cisco Orbital server! Error is {0}".format(exception.stacktrace)

Général

Exécuter la requête

Description

Exécutez des requêtes sur des points de terminaison en fonction des entités d'adresse IP et de nom d'hôte dans Cisco Orbital.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Est obligatoire Description
Query Chaîne N/A Oui Spécifiez la requête à exécuter.
Nom Chaîne N/A Non Spécifiez le nom du job de requête. Si aucun nom n'est spécifié, l'action utilise un nom au format suivant : PRODUCT_NAME-GUID.
Champs de contexte personnalisés Chaîne N/A Non Spécifiez les champs de contexte personnalisés supplémentaires à ajouter au job. Format : key_1:value_1,key_2:value_1.
Nombre maximal de résultats à renvoyer Integer 100 Non Spécifiez le nombre de résultats à renvoyer.
Masquer le tableau du mur des cas Case à cocher N/A Non Si cette option est activée, l'action ne préparera pas de tableau de mur des cas.
Timeout Integer 1 Non Spécifiez le nombre de minutes d'attente des résultats avant de terminer l'exécution de l'action. Maximum : 5 minutes. Par défaut : 1 minute.

Exécuter sur

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

  • Adresse IP
  • 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
{
    "results": [
        {
            "node": "eXHZw6pLMxepKQtf9B8VTQ",
            "osQuery": [
                {
                    "sql": "SELECT name,pid FROM processes;"
                }
            ],
            "osQueryResult": [
                {
                    "types": [
                        "",
                        ""
                    ],
                    "columns": [
                        "name",
                        "pid"
                    ],
                    "values": [
                        "[System Process]",
                        "0",
                        "System",
                        "4",
                        "Registry",
                        "88",
                        "smss.exe",
                        "516",
                        "csrss.exe",
                        "596",
                        "wininit.exe",
                        "672",
                        "csrss.exe",
                        "680",
                        "winlogon.exe",
                        "724",
                        "services.exe",
                        "796",
                        "lsass.exe",
                        "804",
                        "svchost.exe",
                        "916",
                        "fontdrvhost.exe",
                        "936",
                        "svchost.exe",
                        "944",
                        "svchost.exe",
                        "1020",
                        "svchost.exe",
                        "296",
                        "fontdrvhost.exe",
                        "560",
                        "dwm.exe",
                        "1048",
                        "svchost.exe",
                        "1136",
                        "svchost.exe",
                        "1144",
                        "svchost.exe",
                        "1192",
                        "svchost.exe",
                        "1256",
                        "svchost.exe",
                        "1280",
                        "svchost.exe",
                        "1372",
                        "svchost.exe",
                        "1392",
                        "svchost.exe",
                        "1488",
                        "svchost.exe",
                        "1504",
                        "svchost.exe",
                        "1552",
                        "svchost.exe",
                        "1604",
                        "svchost.exe",
                        "1716",
                        "svchost.exe",
                        "1724",
                        "svchost.exe",
                        "1804",
                        "svchost.exe",
                        "1812",
                        "svchost.exe",
                        "1964"
                    ],
                    "error": "",
                    "secs": 0.06800670176744461,
                    "label": "",
                    "name": ""
                }
            ],
            "error": {
                "en": ""
            },
            "hostinfo": {
                "osinfo": {
                    "os": "windows",
                    "osname": "Windows 10 Enterprise Evaluation",
                    "release": "6.3",
                    "version": "10.0.18363",
                    "arch": "amd64"
                },
                "hostname": "TIP-HW-HOST-034",
                "interfaces": {
                    "Ethernet0": {
                        "name": "Ethernet0",
                        "mac": "00:50:56:a2:05:8b",
                        "ipv4": "172.30.202.128/24",
                        "ipv6": "fe80::983:e8ed:c392:3e3e/64",
                        "active": true
                    }
                },
                "external": {
                    "name": "",
                    "mac": "",
                    "ipv4": "185.180.102.139",
                    "active": true
                },
                "updated": "2020-10-12T12:03:30.1329732Z",
                "version": "v1.7.6"
            },
            "rowcount": 149,
            "context": {
                "description": "front desk",
                "lol": "kek",
                "value": "anything\"}"
            }
        },
        {
            "node": "oHNPQUeWwK1ql3R2J13GSw",
            "osQuery": [
                {
                    "sql": "SELECT name,pid FROM processes;"
                }
            ],
            "osQueryResult": [
                {
                    "types": [
                        "",
                        ""
                    ],
                    "columns": [
                        "name",
                        "pid"
                    ],
                    "values": [
                        "[System Process]",
                        "0",
                        "System",
                        "4",
                        "Registry",
                        "88",
                        "smss.exe",
                        "360",
                        "csrss.exe",
                        "440",
                        "wininit.exe",
                        "520",
                        "csrss.exe",
                        "536",
                        "winlogon.exe",
                        "616",
                        "services.exe",
                        "656",
                        "lsass.exe",
                        "664",
                        "svchost.exe",
                        "772",
                        "fontdrvhost.exe",
                        "784",
                        "fontdrvhost.exe",
                        "792",
                        "svchost.exe",
                        "864",
                        "svchost.exe",
                        "6852",
                        "SystemSettings.exe",
                        "7864",
                        "YourPhone.exe",
                        "5160",
                        "RuntimeBroker.exe",
                        "516",
                        "dllhost.exe",
                        "1496"
                    ],
                    "error": "",
                    "secs": 0.025061199441552162,
                    "label": "",
                    "name": ""
                }
            ],
            "error": {
                "en": ""
            },
            "hostinfo": {
                "osinfo": {
                    "os": "windows",
                    "osname": "Windows 10 Enterprise Evaluation",
                    "release": "6.3",
                    "version": "10.0.18363",
                    "arch": "amd64"
                },
                "hostname": "TIP-HW-HOST-033",
                "fqdn": {
                    "127.0.0.1": "www.virustotal.com"
                },
                "interfaces": {
                    "Ethernet0": {
                        "name": "Ethernet0",
                        "mac": "00:50:56:a2:66:8a",
                        "ipv4": "172.30.202.127/24",
                        "ipv6": "fe80::84:5a0f:7973:63/64",
                        "active": true
                    }
                },
                "external": {
                    "name": "",
                    "mac": "",
                    "ipv4": "185.180.102.139",
                    "active": true
                },
                "updated": "2020-10-07T00:11:31.0951018Z",
                "version": "v1.7.6"
            },
            "rowcount": 132,
            "context": {
                "description": "front desk",
                "lol": "kek",
                "value": "anything\"}"
            }
        }
    ],
    "error": {
        "en": ""
    },
    "next": ""
}
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie\*

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

Si la requête SQL est exécutée sans erreur sur l'une des entités (is_success=true) : "Successfully executed query and retrieved results from Cisco Orbital on the following entities:\n".format(entity.identifier)

Si la requête SQL n'est pas exécutée sur certaines entités (is_success=true) : "Action wasn't able to successfully execute query and retrieve results from Cisco Orbital on the following entities:\n".format(entity.identifier)

Si le code d'état 400 est signalé dans la première réponse (is_success=false) : "L'action n'a pas pu exécuter les requêtes dans Cisco Orbital. Reason: {0}".format(comma-separated list of errors)

Si tous les résultats comportent une erreur : "L'action n'a pas pu exécuter de requêtes sur toutes les entités fournies dans Cisco Orbital. Motif : erreurs dans la requête."

Message asynchrone : "Requête envoyée. En attente des résultats jusqu'au délai avant expiration."

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

Si une erreur fatale est signalée (par exemple, des identifiants incorrects, l'absence de connexion au serveur, etc.) : "Error executing action "List Buckets". Reason: {0}''.format(error.Stacktrace)

Si le paramètre "Timeout" n'est pas compris entre 1 et 5 : "La valeur du délai avant expiration doit être comprise entre 1 et 5."

Général

Tableau du mur des cas

Pour chaque résultat qui ne comporte pas d'erreur

Si le type d'entité est "hostname" :

Nom de la table : "Results for {0}".format(entity.identifier)

Si d'autres types d'entités sont concernés :

Nom du tableau : "Results for {0} ({1})".format(entity.identifier, hostinfo/hostname)

Toutes les colonnes de la réponse seront utilisées comme colonnes de table.

Général

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