Ändern Sie einen Dashboard-Besitzer über die REST-API

Dashboards gehören dem angemeldeten Benutzer, der sie erstellt hat. Wenn ein Benutzer nicht mehr in Ihrem Unternehmen ist, müssen Sie möglicherweise den Besitzer des Dashboards ändern, um das Dashboard zu verwalten.

Um die Inhaberschaft an einem Dashboard zu übertragen, benötigen Sie die Dashboard-ID und den Benutzernamen des Dashboard-Inhabers. Sie können den Benutzernamen des Besitzers eines Dashboard nur über die REST-API anzeigen.

Before you begin

Rufen Sie die Dashboard-IDs ab

  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 Autorisieren und klicken Sie dann Schliessen.
  4. klicken Armaturenbrett um Dashboard-Operationen anzuzeigen.
  5. klicken GET /dashboards.
  6. klicken Probiere es aus und klicken Sie dann Anfrage senden um die Anfrage an Ihren Sensor oder Ihre Konsole zu senden.
  7. Suchen Sie nach den Dashboards anhand des Dashboard-Namens oder anhand des Benutzerkonto, das in der "owner" Feld. Wenn Ihre Liste von Dashboards lang ist, können Sie Strg-F drücken und den Antworttext durchsuchen.
    Für unser Beispiel wollen wir das ändern "LDAP Server Health" Dashboard erstellt vom Benutzerkonto für "marksmith":
    {
        "id": 1876,
        "comment": null,
        "mod_time": 1507576983922,
        "author": "Mark Smith",
        "name": "LDAP Server Health",
        "owner": "marksmith",
        "built-in": false,
        "short_code": "MpXgk",
        "rights": [
          "transfer",
          "view",
          "edit",
          "share",
          "delete"
        ]
    }
  8. Notieren Sie sich die Zahl in der "id" Feld für jedes Dashboard, das Sie ändern möchten.

Den Besitzer des Dashboard ändern

  1. Scrollen Sie auf der Seite mit den Dashboard-Vorgängen zum Abschnitt /dashboards/ {id}.
  2. klicken PATCH /dashboards/ {id}.
  3. klicken Probiere es aus.
    Das JSON-Schema wird automatisch zum Textfeld für den Body-Parameter hinzugefügt.
  4. Im Textfeld Textkörper, in der "owner" Feld, ersetzen string mit dem Benutzernamen des neuen Besitzers.
  5. In der id Feld, geben Sie die Nummer ein, die Sie zuvor für das Dashboard notiert haben.
    In unserem Beispiel ist dieser Wert 1876. (Sie können jeweils nur ein Dashboard über den REST API Explorer ändern.)
    In der folgenden Abbildung haben wir das JSON hinzugefügt "string" für die "owner" Parameter zum Körper Parameter-Textfeld, geändert "string" zu "paulanderson", und getippt "1876" in der id Feld.
  6. klicken Anfrage senden um die Anfrage an Ihren Sensor oder Ihre Konsole zu senden.
    Unter Antwort des Servers, das Kode Spaltenanzeigen 204 wenn die Operation erfolgreich ist. Du kannst klicken GET /dashboards noch einmal, um zu überprüfen, ob "owner" Feld hat sich geändert. Beachten Sie, dass Sie nur den Dashboard-Besitzer ändern können. Sie können den Dashboard-Namen oder die Autorenfelder nicht über die REST-API ändern.

    Das Dashboard ist jetzt verfügbar unter Meine Dashboards im ExtraHop-System für den neuen Benutzer. Als neuer Besitzer können Sie sich jetzt in Ihr ExtraHop-System einloggen und andere Dashboard-Eigenschaften wie den Dashboard-Namen oder den Autor ändern.

Hinweis:Nachdem Sie geklickt haben Anfrage senden, der REST API Explorer stellt Skripte für die Operation in Curl, Python 2.7 oder Ruby bereit.

Python-Skriptbeispiel

Das ExtraHop GitHub-Repository enthält ein Python-Beispielskript, das nach allen Dashboards sucht, die einem Benutzerkonto auf einem Sensor oder Konsole und ändert dann den Besitzer für all diese Dashboards in ein anderes Benutzerkonto.

Wichtig:Das Beispiel-Python-Skript authentifiziert sich beim Sensor oder der Konsole über einen API-Schlüssel, der nicht mit der RevealX 360-REST-API kompatibel ist. Um dieses Skript mit RevealX 360 auszuführen, müssen Sie das Skript so ändern, dass es sich mit API-Token authentifiziert. Sehen Sie die py_rx360_auth.py Skript im ExtraHop GitHub-Repository für ein Beispiel für die Authentifizierung mit API-Token.
  1. Gehe zum GitHub-Repository mit ExtraHop-Codebeispielen und laden Sie die change_dashboard_owner/change_dashboard_owner.py Datei auf Ihrem lokalen Computer.
  2. Öffnen Sie in einem Texteditor den change_dashboard_owner.py archivieren und ersetzen Sie die folgenden Konfigurationsvariablen durch Informationen aus Ihrer Umgebung:

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

    API_KEY: Der API-Schlüssel.

    AKTUELL: Der Benutzername des aktuellen Dashboard-Besitzers.

    NEU: Der Benutzername des neuen Dashboard-Besitzers.

  3. Führen Sie den folgenden Befehl aus:
    python3 change_dashboard_owner.py
    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)
Last modified 2024-09-26