Illusive Networks
Ce document explique comment intégrer Illusive Networks à Google SecOps.
Cas d'utilisation des produits
- Effectuer des actions actives : exécuter des analyses d'investigation, enrichir des entités, ajouter/supprimer des utilisateurs/serveurs de leurre.
- 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. |
| 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
- Accédez à la section "Settings" (Paramètres) de la console Illusive Networks.
- Dans la section "Général", faites défiler la page jusqu'à la partie "Clés API".
- Appuyez sur le bouton "Ajouter une clé".
- Il est recommandé d'ajouter toutes les autorisations à la clé API.
- Dans la chaîne fournie, vous devez copier tout sauf la chaîne "Basic".
- 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 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 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'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 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 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 : |
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.