Illusive Networks

Ce document explique comment intégrer Illusive Networks à Google SecOps.

Cas d'utilisation des produits

  1. Effectuer des actions actives : exécuter des analyses d'investigation, enrichir des entités, ajouter/supprimer des utilisateurs/serveurs de leurre.
  2. Ingérer des incidents dans Simplify.

Configurer l'intégration d'Illusive Networks dans Google Security Operations

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 Is Mandatory Description
Racine de l'API Chaîne http://x.x.x.x Oui Racine de l'API de l'instance Illusive Networks.
Clé API Mot de passe N/A Oui

Clé API d'Illusive Networks.
Remarque : La chaîne "Basic" ne doit pas faire partie de la valeur.

Fichier de certificat CA Chaîne Faux Fichier de certificat CA encodé en base64.
Vérifier le protocole SSL Case à cocher Cochée Oui Si cette option est activée, vérifiez que le certificat SSL de la connexion au serveur Illusive Networks est valide.

Générer une clé API

  1. Accédez à la section "Settings" (Paramètres) de la console Illusive Networks.
  2. Dans la section "Général", faites défiler la page jusqu'à la partie "Clés API".
  3. Appuyez sur le bouton "Ajouter une clé".
  4. Il est recommandé d'ajouter toutes les autorisations à la clé API.
  5. Dans la chaîne fournie, vous devez copier tout sauf la chaîne "Basic".
  6. Saisissez cette valeur dans le paramètre "Clé API" de l'intégration Google SecOps.

Mettre à jour la limite de débit

Une limite de débit s'applique à certains points de terminaison dans Illusive Networks. Pour le connecteur, il est essentiel que la limite soit suffisamment élevée pour que tous les incidents soient ingérés. Pour mettre à jour la limite de débit, vous devez vous connecter au serveur de gestion et accéder à : C:\Program Files\illusive-Management-Server-3.1.XXX.XXXX\conf\general.properties.txt

Dans le fichier, recherchez les propriétés suivantes :

  • api.incident.rate.limit.maximum.num.requests
  • api.rate.limit.windows.duration.minutes

Nous vous recommandons de configurer les éléments suivants :

  • api.incident.rate.limit.maximum.num.requests=100
  • api.rate.limit.windows.duration.minutes=1
  • api.monitoring.rate.limit.maximum.num.requests = 100
  • api.forensics.rate.limit.maximum.num.requests = 100

Actions

Ping

Description

Testez la connectivité à Illusive Networks 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

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

En cas de réussite : "Successfully connected to the Illusive Networks server with the provided connection parameters!" (Connexion au serveur Illusive Networks établie avec les paramètres de connexion fournis)

Échec : échec de la connexion au serveur Illusive Networks. Error is {0}".format(exception.stacktrace)

Général

Enrichir les entités

Description

Enrichissez les entités à l'aide des informations d'Illusive Networks. Entités compatibles : nom d'hôte.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Is Mandatory Description
N/A

Exécuter sur

Cette action s'exécute sur l'entité Host.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat JSON
{
    "machineId": "00428a29-0343-4e13-aa97-3b624739c509",
    "machineName": "HELLO",
    "isHealthy": false,
    "lastDeploymentMethodType": "WMI",
    "distinguishedName": "CN=HELLO,CN=Computers,dc=iln,dc=local",
    "groupName": null,
    "sourceDiscoveryName": "iln.local",
    "collectData": true,
    "policyName": null,
    "assignmentStatus": "ANALYSIS",
    "operatingSystemType": "Windows",
    "operatingSystemName": "Windows Server 2016 Standard Evaluation",
    "operatingSystemVersion": "10.0 (14393)",
    "agentVersion": null,
    "bitness": null,
    "loggedInUserName": null,
    "lastLogonTime": 1613078764501,
    "succeededDeceptionFamilies": 0,
    "shouldBeUninstalledDeceptionFamilies": 0,
    "desiredDeceptionFamilies": 0,
    "deceptionFamiliesPercentages": null,
    "lastExecutionType": "AGENT",
    "machineLastExecutionPhaseType": "CONNECTION",
    "machineLastExecutionPhaseStatus": "FAILURE",
    "machineLastExecutionPhaseErrorMessage": "Unreachable - no ping",
    "mitigationStatusType": null,
    "machineExecutionUnifiedStatus": "FAILURE_CONNECTION",
    "machineLastExecutionPhaseFinishDate": "2021-02-12T10:17:30.623Z",
    "endpointTrapHealthCheckHostStatus": "NotTested",
    "endpointTrapHealthCheckHostStatusLastUpdated": null,
    "failedDeceptionFamilies": 0,
    "inProgressDeceptionFamilies": 0,
    "notDeployedDeceptionFamilies": 0,
    "policyId": null,
    "ghost": false
}
Enrichissement d'entités
Nom du champ d'enrichissement Logique : quand l'appliquer
ILLNET_machineName Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_isHealthy Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_host Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_distinguishedName Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_sourceDiscoveryName Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_policyName Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_operatingSystemName Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_agentVersion Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_loggedInUserName Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_machineExecutionUnifiedStatus Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_bitness Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
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 des données sont disponibles pour au moins une entité (is_success = true) : "Successfully enriched the following entities using Illusive Networks: \n {entity.identifier}".

Si les données ne sont pas disponibles pour au moins une entité (is_success = true) : "Action wasn't able to enrich the following entities using Illusive Networks: \n {entity.identifier}".

Si les données ne sont pas disponibles pour toutes les entités (is_success = false) : "Aucune entité n'a été enrichie".

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. : "Error executing action "Enrich Entities". Reason: {0}''.format(error.Stacktrace)

Si le code d'état est 429 : "Error executing action "Enrich Entities". Motif : erreur de limitation du débit. Veuillez consulter la documentation pour savoir comment augmenter la limite de débit."

Général
Tableau du mur des cas

Nom : {entity.identifier}

Il n'y aura que deux colonnes : "Clé" et "Valeur".

Entité

Exécuter une analyse d'investigation

Description

Exécutez une analyse d'investigation sur le point de terminaison dans Illusive Networks. Fonctionne avec les entités d'adresse IP et de nom d'hôte.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Is Mandatory Description
Inclure les informations système Case à cocher Cochée Oui Si cette option est activée, l'action renvoie des informations système.
Inclure les informations sur les fichiers de préchargement Case à cocher Cochée Oui Si cette option est activée, l'action renvoie des informations sur les fichiers de préchargement.
Inclure les informations sur l'ajout et la suppression de programmes Case à cocher Cochée Oui Si cette option est activée, l'action renvoie des informations sur les programmes d'ajout/suppression.
Inclure les informations sur les processus de démarrage Case à cocher Cochée Oui Si cette option est activée, l'action renvoie des informations sur les processus de démarrage.
Inclure les informations sur les processus en cours d'exécution Case à cocher Cochée Oui Si cette option est activée, l'action renvoie des informations sur les processus en cours d'exécution.
Inclure les informations sur les programmes d'assistance utilisateur Case à cocher Cochée Oui Si cette option est activée, l'action renvoie des informations sur les programmes d'assistance utilisateur.
Inclure l'historique PowerShell Case à cocher Cochée Oui Si cette option est activée, l'action renvoie des informations sur l'historique PowerShell.

Nombre maximal d'éléments à renvoyer

Integer 50 Non Spécifiez le nombre d'éléments à renvoyer. Si rien n'est fourni, l'action renvoie tout.

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
is_success is_success=False
is_success is_success=True
Résultat JSON
{
    "Entity.identifier": {
        "host_info": "{Host_info part}",
        "prefetch_info": "{prefetch_info}",
        "installed_programs_info": "{installed_programs_info}",
        "startup_processes": "{startup_processes}",
        "running_processes": "{running_processes}",
        "user_assist_info": "{user_assist_info}",
        "powershell_history": "{powershell history}"
    }
}
Enrichissement d'entités
Nom du champ d'enrichissement Logique : quand l'appliquer
ILLNET_osName Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_machineType Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_host Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_loggedInUser Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_userProfiles Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
ILLNET_operatingSystemType Lorsqu'elles sont disponibles au format JSON (informations sur l'hôte)
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'exécution a réussi pour au moins un point de terminaison (is_success = true) : "Successfully ran forensic scan on the following endpoints in Illusive Networks: {entity.identifier}"

Si l'opération échoue pour au moins un point de terminaison : "L'action n'a pas pu obtenir d'informations à partir de l'analyse d'investigation sur les points de terminaison suivants : {entity.identifier}"

Si aucun résultat n'est trouvé pour tous les points de terminaison : "Aucune information d'analyse n'a été trouvée sur les points de terminaison fournis."

Message asynchrone : "L'analyse d'investigation a démarré sur les points de terminaison suivants : {entity identifier}. \n

Analyse d'investigation terminée sur les points de terminaison suivants : "

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. : "Error executing action "Run Forensic Scan". Reason: {0}''.format(error.Stacktrace)

Si aucun des paramètres "inclure ..." n'est activé : "Erreur lors de l'exécution de l'action "Exécuter une analyse d'investigation". Motif : vous devez activer au moins l'un des paramètres "Inclure...".

Général
Informations sur l'hôte de la table du mur des cas

Nom : {entity.identifier}

Il n'y aura que deux colonnes : "Clé" et "Valeur".

Entité
Case Wall Table Prefetch_Info

Nom : "{entity.identifier} : Informations sur les fichiers de préchargement"

Colonnes :

Nom du fichier

Date et heure de la dernière exécution

Date et heure de modification du fichier

Nom du fichier de préchargement

Général

Tableau du mur des cas

INSTALLED_PROGRAMS_INFO

Nom : "{entity.identifier} : informations sur l'ajout/la suppression de programmes"

Colonnes :

Nom à afficher

Nom du fichier

Général

Tableau du mur des cas

STARTUP_PROCESSES

Nom : "{entity.identifier} : processus de démarrage"

Colonnes :

Nom

Commande

Emplacement

Utilisateur

Général

Tableau du mur des cas

RUNNING_PROCESSES

Nom : "{entity.identifier} : processus en cours d'exécution"

Colonnes :

Utilisateur

Droits d'administrateur

Commande

Identifiant de processus

Nom du processus

Heure de début

Général

Tableau du mur des cas

USER_ASSIST_INFO

Nom : "{entity.identifier} : Informations sur les programmes d'assistance utilisateur"

Colonnes :

Nom du fichier

Nom d'utilisateur

Dernière utilisation

****

Tableau du mur des cas

POWER_SHELL_HISTORY

Nom : "{entity.identifier} : historique PowerShell"

Colonnes :

Nom d'utilisateur

Commande

Lister les éléments trompeurs

Description

Répertoriez les éléments trompeurs disponibles dans Illusive Networks.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Is Mandatory Description
Type trompeur LDD

Tous

Valeurs possibles :

Tous

Utilisateurs uniquement

Serveurs uniquement

Oui Spécifiez le type d'éléments trompeurs à renvoyer.
État trompeur LDD

Tous

Valeurs possibles :

Tous

"Uniquement approuvées", "Uniquement suggérées"

Oui Spécifiez le type d'éléments trompeurs à renvoyer en fonction de l'état.
Nombre maximal d'éléments à renvoyer Integer 50 Non Spécifiez le nombre d'éléments à renvoyer. Valeur par défaut : 50. Si rien n'est spécifié, l'action renvoie tous les éléments.

Exécuter sur

Cette action ne s'exécute pas sur les entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat JSON
{
    "users": [
        {
            "username": "backupad",
            "password": "5437niwY",
            "domainName": "intw-lab.local",
            "policyNames": [
                "Full Protection"
            ],
            "adUser": false,
            "activeUser": false,
            "deceptiveState": "APPROVED"
        },
        {
            "username": "jvillar",
            "password": "ritA1102",
            "domainName": "intw-lab.local",
            "policyNames": [],
            "adUser": true,
            "activeUser": false,
            "deceptiveState": "SUGGESTED"
        },
        {
            "username": "gaccess.user",
            "password": "psUiS01",
            "domainName": "intw-lab.local",
            "policyNames": [],
            "adUser": true,
            "activeUser": false,
            "deceptiveState": "SUGGESTED"
        },
        {
            "username": "service.user",
            "password": "mAkaYe4",
            "domainName": "intw-lab.local",
            "policyNames": [],
            "adUser": true,
            "activeUser": false,
            "deceptiveState": "SUGGESTED"
        }
    ],
    "servers": [
        {
            "host": "10.0.0.2",
            "serviceTypes": [
                "DB"
            ],
            "policyNames": [
                "Full Protection"
            ],
            "adHost": false,
            "deceptiveState": "APPROVED"
        },
        {
            "host": "10.0.0.1",
            "serviceTypes": [
                "DB"
            ],
            "policyNames": [
                "Full Protection"
            ],
            "adHost": false,
            "deceptiveState": "APPROVED"
        }
    ]
}
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 le code est 200 et que les données sont disponibles (is_success = true) : "Successfully returned available deceptive items from Illusive Networks".

Si le code 200 est renvoyé et qu'aucune donnée n'est disponible (is_success=false) : "No data was found regarding deceptive items based on the provided criteria in Illusive Networks."

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. : "Error executing action "List Deceptive Items". Reason: {0}''.format(error.Stacktrace)

Général
Tableau du mur des cas

Nom : "Utilisateurs trompeurs"

Colonne :

Nom d'utilisateur

Mot de passe

Domaine

Règles

Utilisateur AD

Actif

État

Général
Tableau du mur des cas

Nom : "Serveurs trompeurs"

Colonne :

Hôte

Services

Règles

Serveur AD

État

Général

Ajouter un utilisateur trompeur

Description

Ajoutez des utilisateurs trompeurs dans Illusive Networks.

Paramètres

Nom Valeur par défaut Is Mandatory Description
Nom d'utilisateur N/A Oui Spécifiez le nom d'utilisateur du nouvel utilisateur trompeur.
Mot de passe N/A Oui Spécifiez le mot de passe du nouvel utilisateur leurre.
Domaine DNS N/A Non Spécifiez le nom de domaine du nouvel utilisateur trompeur.
Noms des règles N/A Non Spécifiez une liste de règles séparées par une virgule à appliquer au nouvel utilisateur trompeur. Si rien n'est fourni, l'action utilisera toutes les règles par défaut.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

Réussite (is_success=true) : l'utilisateur trompeur a bien été ajouté aux réseaux Illusive.

Cas 1. User Already Exists (fail) - Error executing action "{action name}". Motif : l'utilisateur trompeur "{username}" existe déjà.

Cas 2 : Code d'état 400 (échec) : erreur lors de l'exécution de l'action "{action name}". Motif : {message d'erreur}.

Cas 3 : Erreur générale (échec) : erreur lors de l'exécution de l'action "{action name}". Motif : {error traceback}.

Général

Supprimer l'utilisateur trompeur

Description

Supprimez l'utilisateur trompeur d'Illusive Networks.

Paramètres

Nom Valeur par défaut Is Mandatory Description
Nom d'utilisateur N/A Oui Spécifiez le nom de l'utilisateur trompeur à supprimer.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

Réussite → L'utilisateur trompeur a bien été supprimé dans les réseaux Illusive.

Cas 1. L'utilisateur n'existe pas (is_success=false) : l'action n'a pas pu supprimer l'utilisateur trompeur "{username}". Motif : l'utilisateur trompeur "{username}" n'existe pas.

Cas 2 : Erreur générale (échec) - Erreur lors de l'exécution de l'action "{action name}". Motif : {error traceback}.

Général

Ajouter un serveur trompeur

Description

Ajoutez des serveurs trompeurs dans Illusive Networks.

Paramètres

Nom Valeur par défaut Is Mandatory Description
Nom du serveur N/A Oui Spécifiez le nom du nouveau serveur trompeur.
Types de services DB Oui Spécifiez une liste de types de services séparés par une virgule pour le nouveau serveur trompeur.
Noms des règles Non Spécifiez une liste de règles à appliquer au nouveau serveur leurre, séparées par une virgule. Si rien n'est fourni, l'action utilisera toutes les règles par défaut.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

Réussite (is_success=true) : le serveur trompeur a bien été ajouté dans Illusive Networks.

Cas 1. Le serveur existe déjà (échec) - Erreur lors de l'exécution de l'action "{action name}". Motif : Le serveur trompeur "{server name}" existe déjà.

Cas 2 : État 400 (échec) - Erreur lors de l'exécution de l'action "{action name}". Motif : {message d'erreur}.

Cas 3 : Erreur générale : erreur lors de l'exécution de l'action "{action name}". Motif : {error traceback}.

Général

Supprimer le serveur trompeur

Description

Supprimez le serveur trompeur d'Illusive Networks.

Paramètres

Nom Valeur par défaut Is Mandatory Description
Nom du serveur N/A Oui Spécifiez le nom du serveur trompeur à supprimer.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur / Description Type
Message de sortie*

Réussite → Suppression du serveur trompeur dans les réseaux Illusive.

Cas 1. Le serveur n'existe pas (is_success=false) : l'action n'a pas pu supprimer le serveur trompeur "{server name}". Motif : Le serveur trompeur "{server name}" n'existe pas.

Cas 2 : Erreur générale : erreur lors de l'exécution de l'action "{action name}". Motif : {error traceback}.

Général

Connecteurs

Illusive Networks - Incidents Connector

Description

Récupérez les incidents avec la chronologie d'analyse d'Illusive Networks.

Configurer le connecteur Illusive Networks - Incidents dans Google SecOps

Pour obtenir des instructions détaillées sur la configuration d'un connecteur dans Google SecOps, consultez Configurer le connecteur.

Paramètres du connecteur

Utilisez les paramètres suivants pour configurer le connecteur :

Nom à afficher du paramètre Type> Valeur par défaut Est obligatoire Description
Nom du champ de produit Chaîne Nom du produit Oui Saisissez le nom du champ source pour récupérer le nom du champ produit.
Nom du champ d'événement Chaîne details_serviceType Oui Saisissez le nom du champ source pour récupérer le nom du champ d'événement.
Nom du champ d'environnement Chaîne "" Non

Nom du champ dans lequel le nom de l'environnement est stocké.

Si le champ d'environnement n'est pas trouvé, l'environnement par défaut est utilisé.

Modèle d'expression régulière de l'environnement Chaîne .* Non

Modèle d'expression régulière à exécuter sur la valeur trouvée dans le champ "Nom du champ d'environnement".

La valeur par défaut est ".*" pour tout récupérer et renvoyer la valeur inchangée.

Permet à l'utilisateur de manipuler le champ "environment" à l'aide d'une logique d'expression régulière.

Si le modèle d'expression régulière est nul ou vide, ou si la valeur de l'environnement est nulle, le résultat final est l'environnement par défaut.

Délai avant expiration du script (en secondes) Entier 180 Oui Délai avant expiration du processus Python exécutant le script actuel.
Racine de l'API Chaîne http://x.x.x.x Oui Racine de l'API de l'instance Illusive Networks.
Clé API Chaîne N/A Oui Clé API d'Illusive Networks. Remarque : La chaîne "Basic" ne doit pas faire partie de la valeur.
Gravité de l'alerte Chaîne Moyenne Oui

Gravité de l'alerte Google SecOps qui sera créée en fonction des incidents d'Illusive Networks.

Valeurs possibles :

Informatif

Faible

Moyen

Élevée

Critique

Nombre maximal d'heures en arrière Entier 1 Non Nombre d'heures dans le passé à partir desquelles récupérer les incidents.
Nombre maximal d'incidents à récupérer Integer 10 Non Nombre d'incidents à traiter par itération de connecteur. La valeur maximale est de 1 000.
Utiliser la liste d'autorisation comme liste de blocage Case à cocher Cochée Oui Si cette option est activée, la liste d'autorisation sera utilisée comme liste de blocage.
Vérifier le protocole SSL Case à cocher Décochée Oui Si cette option est activée, vérifiez que le certificat SSL de la connexion au serveur Illusive Networks est valide.
Fichier de certificat CA Chaîne N/A Non Fichier de certificat CA encodé en base64.
Adresse du serveur proxy Chaîne N/A Non Adresse du serveur proxy à utiliser.
Nom d'utilisateur du proxy Chaîne N/A Non Nom d'utilisateur du proxy pour l'authentification.
Mot de passe du proxy Mot de passe N/A Non Mot de passe du proxy pour l'authentification.

Règles du connecteur

Assistance de proxy

Le connecteur est compatible avec les proxys.

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