ForeScout CounterACT
Ce document explique comment intégrer FireEye NX à Google Security Operations.
Cas d'utilisation
Effectuer des actions d'enrichissement
Configurer l'intégration de ForeScout CounterACT 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 | https://<adresse IP> |
Oui | Racine de l'API ForeScout CounterACT |
| Nom d'utilisateur | Chaîne | N/A | Oui | Nom d'utilisateur de l'API ForeScout CounterACT. |
| Mot de passe | Mot de passe | N/A | Oui | Mot de passe de l'API ForeScout CounterACT. |
| Fichier de certificat CA | Chaîne | N/A | Non | Fichier de certificat CA encodé en base64. |
| Vérifier le protocole SSL | Case à cocher | Cochée | Oui | Si cette option est activée, elle vérifie que le certificat SSL de la connexion au serveur Armis est valide. |
Actions
Ping
Description
Testez la connectivité à ForeScout CounterACT avec les paramètres fournis sur la page de configuration de l'intégration dans la page Google SecOps Content Hub.
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* | L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : L'action doit échouer et arrêter l'exécution d'un playbook : |
Général |
Enrichir les entités
Description
Enrichissez les entités à l'aide des informations de ForeScout CounterACT. Entités compatibles : IP, adresse MAC.
Paramètres
| Nom à afficher du paramètre | Type | Valeur par défaut | Is Mandatory | Description |
|---|---|---|---|---|
| Créer un insight | Case à cocher | Cochée | Non | Si cette option est activée, l'action créera des insights contenant des informations d'enrichissement. |
Exécuter sur
Cette action s'exécute sur les entités suivantes :
- Adresse IP
- Adresse MAC
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
{
"ip": "172.30.202.30",
"mac": "005056a2196c",
"fields": {
"channel": {
"timestamp": 1623834301,
"value": "eth1.-1"
},
"nmap_banner7": [
{
"timestamp": 1623834430,
"value": "80/tcp Apache httpd 2.4.6 (CentOS)"
},
{
"timestamp": 1623834430,
"value": "22/tcp OpenSSH 7.4 protocol 2.0"
}
],
"onsite": {
"timestamp": 1623834301,
"value": "true"
},
"classification_source_os": {
"timestamp": 1623838175,
"value": "engine"
},
"linux_manage": {
"timestamp": 1623838175,
"value": "false"
},
"access_ip": {
"timestamp": 1623838175,
"value": "172.30.202.30"
},
"classification_source_vendor": {
"timestamp": 1623838175,
"value": "engine"
},
"mac_vendor_string": {
"timestamp": 1623834302,
"value": "VMWARE, INC."
},
"openports": [
{
"timestamp": 1623834384,
"value": "22/TCP"
},
{
"timestamp": 1623834397,
"value": "161/UDP"
},
{
"timestamp": 1623834384,
"value": "80/TCP"
}
]
},
"id": 2887698974
}
Enrichissement d'entités
| Nom du champ d'enrichissement | Logique : quand l'appliquer |
|---|---|
| ip | Lorsqu'il est disponible au format JSON |
| mac | Lorsqu'il est disponible au format JSON |
| sur site | Lorsqu'il est disponible au format JSON |
| guest_corporate_state | Lorsqu'il est disponible au format JSON |
| fingerprint | Lorsqu'il est disponible au format JSON |
| vendor | Lorsqu'il est disponible au format JSON |
| classification | Lorsqu'il est disponible au format JSON |
| agent_version | Lorsqu'il est disponible au format JSON |
| En ligne | Lorsqu'il est disponible au format JSON |
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 certaines entités n'ont pas été enrichies (is_success = true) : "Action wasn't able to enrich the following entities using ForeScout CounterACT:\n".format(entity.identifier) Si l'enrichissement n'a pas été effectué 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 |
Général |
| Tableau des entités | Mêmes colonnes que dans la table d'enrichissement, mais sans préfixe. | Entité |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.