Erkennung über einen HTTP- oder HTTPS REST-Aufruf ausführen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer
  • Discovery kann Geräte klassifizieren, die das HTTP(S)-Protokoll nutzen. Anstatt SNMP- oder SSH-Anmeldeinformationen zu verwenden, können Sie Ihren eigenen HTTP-Klassifizierer erstellen, um Geräte zu erkennen und mit Anmeldeinformationen der Standardauthentifizierung darauf zuzugreifen.

    Vorbereitungen

    Erforderliche Rolle: discovery_admin

    Prozedur

    1. Navigieren zu Alle > Discovery > Berechtigungen.
    2. Klicken Sie auf Neu.
    3. Klicken Sie auf Basisanmeldedaten.
      In den meisten Fällen können Sie über einen HTTP- oder HTTPS REST-Aufruf mit Standardauthentifizierungsinformationen auf ein Gerät zugreifen.
    4. Fügen Sie den Benutzernamen und das Passwort hinzu, die Sie für den Zugriff auf das Gerät benötigen.
    5. Klicken Sie auf Absenden.
    6. Richten Sie einen HTTP-Klassifizierer ein, indem Sie zu navigieren Discovery-Definition > CI-Klassifizierung > HTTP.
    7. Klicken Sie auf Neu.
    8. Füllen Sie die Formularfelder aus (siehe Tabelle):
      Abbildung : 1. Die F5-HTTP-Klassifizierung
      HTTP-Klassifizierung
      Feld Beschreibung
      Name Geben Sie einen Namen für den Klassifizierer ein.
      Pfad Geben Sie den Pfad für die HTTP-GET-Anforderung ein.
      Header Fügen Sie einen Optionsheader mit einem Wert hinzu. Sie können eine Variable im Format ${variable} anstatt eines statischen Wertes verwenden.

      Unterstützte Header hängen vom REST-Webservice-Provider ab, zu dem Sie eine Verbindung herstellen möchten. In der Dokumentation Ihres Web Service Providers erfahren Sie, welche Header gültig oder erforderlich sind.

      Port (IP-Dienst)

      Wenn Sie möchten, dass dieser Klassifizierer einen benutzerdefinierten Port verwendet, der nicht bereits ein Standardwert in der Tabelle IP-Dienst [cmdb_ip_service] ist, führen Sie folgende Schritte aus:

      1. Klicken Sie auf das Suchsymbol, um die Liste der IP-Services anzuzeigen.
      2. Wählen Sie Neu aus, und erstellen Sie eine Port-zu-Protokoll-Zuordnung.
      3. Wählen Sie diese Port-zu-Protokoll-Zuordnung dafür im Feld Port.

      Viele häufig verwendete Protokolle sind standardmäßig bereits Ports zugeordnet, z. B. http zu Port 80 und https zu Port 443.

      Wenn Sie eine dieser standardmäßigen Port-zu-Protokoll-Zuordnungen verwenden möchten, geben Sie keine Werte in das Feld Port ein. Die HTTP-Port-Sonde verwendet standardmäßig den richtigen Port.

      Reihenfolge

      Geben Sie eine Zahl ein, die die Priorität dieses Klassifizierers darstellt. Wenn Discovery mehr als einen zutreffenden Klassifizierer verwendet, wird der Klassifizierer mit niedriger Rang-Nummer verwendet.

      Protokoll

      [optional]

      Dieses Feld ist standardmäßig nicht sichtbar. Sie müssen das Formular konfigurieren, um es hinzuzufügen.

      Wenn Sie eine eindeutige Port-zu-Protokoll-Zuordnung für das Fel Port konfigurieren, geben Sie in das Feld eine optionale Protokollüberschreibung ein, die Discovery mit diesem Klassifizierer verwendet.

      Wenn Sie beispielsweise Port 5000 und das HTTP-Protokoll verwenden möchten, fügen Sie die 5000/HTTP-Port-zu-Protokoll-Zuordnung zum Feld Port hinzu, und wählen Sie dann http im Feld Protokoll.
    9. Klicken Sie mit der rechten Maustaste auf die Kopfzeile und wählen Sie Speichern.
      Die zugehörige Liste „Übereinstimmung der HTTP-Klassifizierung“ wird angezeigt. Diese zugehörige Liste enthält Kriterien, die Sie für den Abgleich mit dem Hauptteil der Antwort auf die von Discovery gesendete GET-Anforderung konfigurieren können.
    10. Definieren Sie in der zugehörigen Liste „Übereinstimmung der HTTP-Klassifizierung“ die Abgleichskriterien, und geben Sie das für diesen Klassifizierer zu startende Muster an:
      1. Klicken Sie auf Neu.
      2. Füllen Sie die Felder des Formulars „Übereinstimmung der HTTP-Klassifizierung“ aus (siehe Tabelle).
        HTTP-Klassifizierungs-Übereinstimmung
        Feld Beschreibung
        Operator Wählen Sie den Operator aus, mit dem das System die Bedingung bewertet:
        • Enthält
        • Ist gleich
        • Regulärer Ausdruck
        Reihenfolge

        Geben Sie eine Zahl ein, die die Priorität dieser Bedingung darstellt. Wenn Discovery mehr als eine zutreffende Bedingung findet, wird die Bedingung mit niedriger Rang-Nummer verwendet.

        Muster Geben Sie das Muster an, das nach einer korrekten Übereinstimmung gestartet werden soll. Dieses Muster muss HTTP verwenden, um das Gerät zu ermitteln.
        Wert Geben Sie den Wert ein, den der Rumpf der zurückgegebenen REST-Methode haben muss.
      3. Klicken Sie auf Absenden.
      4. Definieren Sie so viele Übereinstimmungen der HTTP-Klassifizierung wie erforderlich.
        Das ist hilfreich, wenn für die verschiedenen Versionen des zu erkennenden Geräts verschiedene Muster vorhanden sind.

    Beispiel

    In diesem Beispiel ist die HTTP-Klassifizierung für die Verwendung der API des F5-Lastenausgleichsmoduls konfiguriert:

    Nächste Maßnahme

    Wenn Sie keine andere Arten von Anmeldeinformationen haben, die Geräte erkennen können, zum Beispiel Linux-Anmeldeinformationen oder SNMP-Anmeldeinformationen, können Sie sehen, wie die Discovery-Anwendung die HTTP-Erkennung verarbeitet:
    1. Navigieren zu Discovery > Discovery-Zeitpläne und führen eine Erkennung aus.
    2. Überprüfen Sie nach Abschluss des Discovery-Prozesses die ECC-Warteschlange, um die Ergebnisse der HTTP-Erkennung anzuzeigen.

      Sie sollten sehen, dass die Klassifizierungs-Probes „Unix“ und „SNMP“ fehlgeschlagen sind, nachdem die Shazzam-Probe gestartet wurde. Es sollte sowohl die Probe „HTTP - Classify“ als auch das Muster gestartet werden, die Sie im HTTP-Klassifizierungsdatensatz angeben.

      ECC-Warteschlangen-Datensätze zur HTTP-Klassifizierung