Fügen Sie Eigenschaften der Geräte-Cloud-Instanz über die REST-API hinzu

1. Navigieren Sie in einem Browser zum REST API Explorer.
   Die URL ist der Hostname oder die IP-Adresse Ihres Sensor oder Konsole, gefolgt von /api/v1/explore/. Wenn Ihr Hostname beispielsweise seattle-eda ist, lautet die URL https://seattle-eda/api/v1/explore/.
2. Geben Sie Ihre REST-API-Anmeldeinformationen Anmeldedaten.
   • Für Sensoren und ECA-VMs klicken Sie auf API-Schlüssel eingeben und fügen Sie dann Ihren API-Schlüssel ein oder geben Sie ihn in das API-Schlüssel Feld.
   • Klicken Sie für RevealX 360 auf Geben Sie die API-Anmeldeinformationen ein und fügen Sie dann die ID und das Geheimnis Ihrer API-Anmeldeinformationen ein oder geben Sie sie in das ID und Geheim Felder.
3. Klicken Sie Autorisieren und klicken Sie dann Schliessen.
4. Finden Sie die ID des Gerät, indem Sie nach der MAC-Adresse des Gerät suchen.
   1. Klicken Sie Gerät und klicken Sie dann POST /Geräte/Suche.
   2. Klicken Sie Probiere es aus.
   3. Geben Sie im Textfeld den folgenden JSON-Code an und ersetzen Sie MACADDRESS durch die MAC-Adresse Ihres Cloud-Geräts:

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

      Kopieren
   4. Klicken Sie Anfrage senden.
   5. Sehen Sie sich im Abschnitt Antworttext den Wert von an und Datensatz Sie ihn auf id Feld für jedes Gerät, das zurückgegeben wird.
5. Fügen Sie die Metadaten des Cloud-Geräts hinzu.
   1. Klicken Sie PATCH /geräte/ {id}.
   2. Klicken Sie Probiere es aus.
   3. In der id Feld, geben Sie eine ID an.
   4. Geben Sie im Textfeld den folgenden JSON-Code an und ersetzen Sie den string Werte mit Eigenschaften aus Ihrer Cloud-Umgebung:

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

      Kopieren
   5. Klicken Sie Anfrage senden.

Sie können RevealX 360 mit einer CloudFormation-Vorlage, die auf Amazon S3 öffentlich verfügbar ist, Eigenschaften der AWS-Geräte-Cloud-Instanz hinzufügen. Die CloudFormation-Vorlage erstellt eine Lambda-Funktion, die Eigenschaften der AWS EC2-Instanz abruft und sie über die REST-API an RevealX 360 sendet. Die Lambda-Funktion ordnet Netzwerkschnittstellen von EC2-Instances Geräten zu, die auf dem ExtraHop-System anhand der MAC-Adresse erkannt wurden.

1. Navigieren Sie zur CloudFormation-Seite in AWS.
2. Erstellen Sie einen CloudFormation-Stack aus der folgenden Amazon S3-URL:

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

   Kopieren
3. Konfigurieren Sie die folgenden Variablen:

   API-ID

   Die ID Ihrer RevealX 360 REST-API-Anmeldeinformationen.

   API-Geheimnis

   Das Geheimnis Ihrer RevealX 360 REST-API-Anmeldeinformationen.

   Name des Mieters

   Die Subdomain Ihrer RevealX 360-Konsole.

   Weitere Informationen zur Konfiguration eines CloudFormation-Stacks finden Sie in der AWS-Dokumentation.

Sie können RevealX Enterprise mit einem Python-Beispielskript die Eigenschaften der AWS-Geräte-Cloud-Instanz hinzufügen. Das Skript ordnet Netzwerkschnittstellen von EC2-Instances Geräten zu, die auf dem ExtraHop-System anhand der MAC-Adresse erkannt wurden.

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

1. Gehe zum ExtraHop Codebeispiele GitHub-Repository und laden Sie das herunter add_cloud_props_lambda/add_cloud_props_lambda.py Datei auf Ihrem lokalen Computer.
2. Öffnen Sie in einem Texteditor den add_cloud_props_lambda.py archivieren und ersetzen Sie die folgenden Konfigurationsvariablen durch Informationen aus Ihrer Umgebung:

   HOSTNAME: Die private IP-Adresse oder der Hostname der Sensor- oder Konsolen-EC2-Instance.

   EIN HAHN: Der ExtraHop API-Schlüssel.

3. Füge das add_cloud_props_lambda.py Datei in eine Zip-Datei mit dem requests Python-Modul.
   Das Skript importiert die requests Python-Modul, das standardmäßig nicht für Lambda-Funktionen verfügbar ist. Informationen zum Erstellen einer Zip-Datei zum Importieren von Bibliotheken von Drittanbietern in Lambda finden Sie in der AWS-Dokumentation.
4. Erstellen Sie in AWS eine Lambda-Funktion.
   Weitere Informationen zum Erstellen von Lambda-Funktionen finden Sie in der AWS-Dokumentation.
5. Klicken Sie auf der Lambda-Funktionsseite auf Aktionen und wähle Laden Sie eine.zip hoch Datei.
6. Wählen Sie die von Ihnen erstellte Zip-Datei aus.

Das ExtraHop GitHub-Repository enthält ein Python-Beispielskript, das Azure-Geräteeigenschaften in das ExtraHop-System importiert. Das Skript weist jedem Gerät, das vom ExtraHop-System mit einer MAC-Adresse erkannt wird, die zu einer Azure-VM-Netzwerkschnittstelle gehört, Cloud-Geräteeigenschaften zu. Das Skript ist so konzipiert, dass es in einem festgelegten Zeitintervall ausgeführt wird. Jedes Mal, wenn das Skript ausgeführt wird, scannt es jede VM und aktualisiert die entsprechenden Geräte in ExtraHop.

1. Gehe zum ExtraHop Codebeispiele GitHub-Repository und laden Sie das herunter add_cloud_props_azure/add_cloud_props_azure.py Datei auf Ihrem lokalen Computer.
2. Öffnen Sie in einem Texteditor den add_cloud_props_azure.py archivieren und ersetzen Sie die folgenden Konfigurationsvariablen durch Informationen aus Ihrer Umgebung:

   HOSTNAME: Die IP-Adresse oder der Hostname des Sensor oder der Konsole.

   EIN HÜNENSCHLÜSSEL: Der ExtraHop API-Schlüssel.

3. Führen Sie den folgenden Befehl aus:

   python3 add_cloud_props_azure.py

   Kopieren

   Hinweis:

   Wenn das Skript eine Fehlermeldung zurückgibt, dass die TLS-Zertifikatsüberprüfung fehlgeschlagen ist, stellen Sie sicher, dass Ihrem Sensor oder Ihrer Konsole wurde ein vertrauenswürdiges Zertifikat hinzugefügt. Alternativ können Sie das hinzufügen verify=False Option zur Umgehung der Zertifikatsüberprüfung. Diese Methode ist jedoch nicht sicher und wird nicht empfohlen. Der folgende Code sendet eine HTTP GET-Anfrage ohne Zertifikatsüberprüfung: requests.get(url, headers=headers, verify=False) Kopieren