Ajouter des propriétés d'instance de cloud d'équipements via l'API REST

1. Dans un navigateur, accédez à l'explorateur d'API REST.
   L'URL est le nom d'hôte ou l'adresse IP de votre sonde ou console, suivi par /api/v1/explore/. Par exemple, si votre nom d'hôte est seattle-eda, l'URL est https://seattle-eda/api/v1/explore/.
2. Entrez les informations d'identification de votre API REST.
   • Pour les capteurs et les machines virtuelles ECA, cliquez Entrez la clé API puis collez ou saisissez votre clé API dans le Clé API champ.
   • Pour RevealX 360, cliquez sur Entrez les identifiants de l'API puis collez ou saisissez l'ID et le code secret de vos informations diciatives d'API dans le IDENTIFIANT et Secret champs.
3. Cliquez Autoriser puis cliquez sur Fermer.
4. Trouvez l'ID de l'équipement en recherchant son adresse MAC.
   1. Cliquez Appareil puis cliquez sur POST /dispositifs/search.
   2. Cliquez Essayez-le.
   3. Dans le champ du corps, spécifiez le JSON suivant, en remplaçant MACADDRESS par l'adresse MAC de votre équipement cloud :

      {
        "filter": {
          "field": "macaddr",
          "operand": "MACADDRESS",
          "operator": "="
        }
      }

      Copier
   4. Cliquez Envoyer la demande.
   5. Dans la section Corps de la réponse, visualisez et enregistrez la valeur de id champ pour chaque équipement renvoyé.
5. Ajoutez les métadonnées de l'équipement cloud.
   1. Cliquez PATCH /devices/ {id}.
   2. Cliquez Essayez-le.
   3. Dans le id champ, spécifiez un identifiant.
   4. Dans le champ du corps, spécifiez le JSON suivant, en remplaçant le string valeurs avec des propriétés issues de votre environnement cloud :

      {
        "cloud_account": "string",
        "cloud_instance_id": "string",
        "cloud_instance_name": "string",
        "cloud_instance_type": "string",
        "vpc_id": "string"
      }

      Copier
   5. Cliquez Envoyer la demande.

Vous pouvez ajouter des propriétés d'instance de cloud d'équipements AWS à RevealX 360 à l'aide d'un modèle CloudFormation accessible au public sur Amazon S3. Le modèle CloudFormation crée une fonction Lambda qui extrait les propriétés de l'instance AWS EC2 et les envoie à RevealX 360 via l'API REST. La fonction Lambda mappe les interfaces réseau des instances EC2 aux périphériques découverts sur le système ExtraHop par adresse MAC.

1. Accédez à la page CloudFormation dans AWS.
2. Créez une pile CloudFormation à partir de l'URL Amazon S3 suivante :

   https://s3.us-east-2.amazonaws.com/ct.s.extrahoplabs/Public/MDS.yml

   Copier
3. Configurez les variables suivantes :

   IDENTIFIANT API

   L'ID de vos informations d'identification de l'API REST RevealX 360.

   Secret de l'API

   Le secret de vos informations d'identification de l'API REST RevealX 360.

   Nom du locataire

   Le sous-domaine de votre console RevealX 360.

   Pour plus d'informations sur la configuration d'une pile CloudFormation, consultez Documentation AWS.

Vous pouvez ajouter des propriétés d'instance de cloud d'équipements AWS à RevealX Enterprise à l'aide d' un exemple de script Python. Le script mappe les interfaces réseau des instances EC2 aux périphériques découverts sur le système ExtraHop par adresse MAC.

requests.get(url, headers=headers, verify=False)

1. Accédez à l'ExtraHop référentiel GitHub d'exemples de code et téléchargez le add_cloud_props_lambda/add_cloud_props_lambda.py fichier sur votre machine locale.
2. Dans un éditeur de texte, ouvrez le add_cloud_props_lambda.py archivez et remplacez les variables de configuration suivantes par des informations provenant de votre environnement :

   NOM D'HÔTE: L'adresse IP privée ou le nom d'hôte de la sonde ou de l'instance EC2 de la console.

   UN RUCHER: La clé d'API ExtraHop.

3. Ajoutez le add_cloud_props_lambda.py fichier dans un fichier zip avec requests Module Python.
   Le script importe le requests Module Python, qui n'est pas disponible par défaut pour les fonctions Lambda. Pour plus d'informations sur la création d'un fichier zip pour importer des bibliothèques tierces dans Lambda, consultez Documentation AWS.
4. Dans AWS, créez une fonction Lambda.
   Pour plus d'informations sur la création de fonctions Lambda, consultez Documentation AWS.
5. Sur la page de la fonction Lambda, cliquez sur Actions et sélectionnez Téléchargez un fichier .zip dossier.
6. Sélectionnez le fichier zip que vous avez créé.

Le référentiel GitHub ExtraHop contient un exemple de script Python qui importe les propriétés des équipements Azure dans le système ExtraHop. Le script attribue des propriétés d'équipement cloud à chaque équipement découvert par le système ExtraHop avec une adresse MAC appartenant à une interface réseau Azure VM. Le script est conçu pour être exécuté selon un intervalle de temps défini. Chaque fois que le script est exécuté, il analyse chaque machine virtuelle et met à jour les périphériques correspondants dans ExtraHop.

1. Accédez au Référentiel GitHub d'exemples de code ExtraHop et téléchargez le add_cloud_props_azure/add_cloud_props_azure.py fichier sur votre machine locale.
2. Dans un éditeur de texte, ouvrez add_cloud_props_azure.py archivez et remplacez les variables de configuration suivantes par des informations provenant de votre environnement :

   NOM D'HÔTE: L'adresse IP ou le nom d'hôte de la sonde ou de la console.

   UN RUCHER: La clé d'API ExtraHop.

3. Exécutez la commande suivante :

   python3 add_cloud_props_azure.py

   Copier

   Remarque :

   Si le script renvoie un message d'erreur indiquant que la vérification du certificat TLS a échoué, assurez-vous que un certificat fiable a été ajouté à votre sonde ou à votre console. Vous pouvez également ajouter verify=False option permettant de contourner la vérification des certificats. Cependant, cette méthode n'est pas sûre et n'est pas recommandée. Le code suivant envoie une requête HTTP GET sans vérification du certificat : requests.get(url, headers=headers, verify=False) Copier