Ajoutez les propriétés de l'instance cloud de l'équipement via l'API REST

1. Dans un navigateur, accédez à l'explorateur d'API ExtraHop.
   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. Cliquez Entrez la clé API puis collez ou saisissez votre clé API dans le Clé API champ.
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 du 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.

Le référentiel GitHub d'ExtraHop contient un exemple de script Python qui importe les propriétés d'une instance AWS EC2 dans le système ExtraHop. Le script mappe les interfaces réseau des instances EC2 aux appareils 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 l'instance EC2 de la sonde ou de la console.

   APIKEY: La clé API ExtraHop.

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

Le référentiel GitHub d'ExtraHop contient un exemple de script Python qui importe les propriétés de l'équipement 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é à un intervalle de temps défini. Chaque fois que le script est exécuté, il analyse chaque machine virtuelle et met à jour les appareils 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.

   APIKEY: La clé 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 SSL a échoué, assurez-vous que un certificat fiable a été ajouté à votre sonde ou à votre console. Vous pouvez également ajouter le 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