API-Endpunkte ermitteln
Mit API Security können Sie die ermittelten API-Endpunkte in Ihrer Organisation anzeigen. NetScaler Console ermittelt die API-Endpunkte basierend auf dem API-Datenverkehr, der auf NetScaler-Instanzen und API-Bereitstellungen empfangen wird.
In NetScaler Console zeigt die Seite Security > API Security > API Discovery die ermittelten API-Endpunkte an.
-
Virtuelle Server – Die Registerkarte VServer zeigt die virtuellen Server Ihrer NetScaler-Instanzen an. Die virtuellen Server werden auf dieser Registerkarte angezeigt, wenn sie API-Anfragen für den angegebenen Zeitraum erhalten.
-
API-Bereitstellungen – Diese Registerkarte zeigt die API-Bereitstellungen an, die von NetScaler Console mithilfe einer API-Definition bereitgestellt werden. Diese Registerkarte ermittelt die API-Endpunkte, wenn API-Bereitstellungen die API-Anfragen für den angegebenen Zeitraum erhalten. Informationen zum Hinzufügen und Bereitstellen einer API-Definition finden Sie unter API-Definition hinzufügen und API-Definitionen bereitstellen.
Hinweis:
-
Stellen Sie sicher, dass Sie Analysen konfigurieren und Web Insights auf virtuellen Servern aktivieren. Siehe Web Insight auf API-Instanzen aktivieren.
-
Sie können Richtlinien nur zu den API-Endpunkten hinzufügen, die unter der Registerkarte API-Bereitstellungen ermittelt werden.
API-Endpunkte anzeigen
Wenn Sie in API Discovery einen virtuellen Server oder eine API-Bereitstellung auswählen, zeigt die NetScaler Console-GUI die API-Endpunkte und deren Details an, wie zum Beispiel:
-
Methode – Sie zeigt die in einem API-Endpunkt verwendete Methode an. Zum Beispiel die Methoden
GETundPOST. -
Gesamtanfragen – Sie zeigt die Anzahl der API-Anfragen am API-Endpunkt an.
-
Antwortstatus – Sie zeigt die Anzahl für jeden Antwortstatus an. Zum Beispiel
2xx,3xx,4xxund5xx. -
In Spezifikation gefunden – Diese Spalte wird nur für API-Bereitstellungen angezeigt. Manchmal erhalten interne APIs, die nicht Teil der API-Definition sind, möglicherweise Datenverkehr von außen. Diese Spalte hilft Ihnen zu erkennen, ob der API-Endpunkt und die beobachtete Methode Teil der API-Definition sind.
Die API-Endpunkte in einem virtuellen Server sind wie folgt verfügbar:
Die API-Endpunkte in API-Bereitstellungen sind wie folgt verfügbar:
Sie können auch den gewünschten API-Endpunkt auswählen, um dessen detaillierten Analysebericht anzuzeigen.
Weitere Informationen zu jedem Abschnitt finden Sie unter API-Analysen anzeigen.
API-Definitionen aus erkannten API-Endpunkten erstellen
So erstellen Sie API-Definitionen aus erkannten API-Endpunkten (API-Ressourcen und -Methoden):
-
Navigieren Sie zu Security > API Security > API Discovery, um die Liste der virtuellen Server und API-Bereitstellungen anzuzeigen.
-
Klicken Sie auf einen beliebigen virtuellen Server auf der Registerkarte VServers.
-
Die Seite des virtuellen Servers zeigt die Liste der erkannten Endpunkte an. Wählen Sie einen beliebigen Endpunkt aus und klicken Sie auf Create API Definition.
Hinweis:
Wenn Sie keinen Endpunkt auswählen und auf Create API Definition klicken, wird ein Pop-up-Fenster angezeigt, in dem Sie bestätigen können, ob Sie eine API-Definition für alle Endpunkte erstellen möchten. Klicken Sie auf Yes, um die API-Definition mit allen Endpunkten zu erstellen, andernfalls klicken Sie auf No.
-
Geben Sie unter API-Definition erstellen Folgendes an:
-
Name – Ein Name für die API-Definition.
-
API-Definition – Eine Definition muss Titel, Version, Basispfad und Host enthalten. Sie können einen Domänennamen oder eine IP-Adresse im Feld Host angeben.
-
API-Ressourcen – Fügen Sie Ihrer Definition mehrere API-Ressourcen hinzu. Jede Ressource hat einen Pfad und eine unterstützte Methode.
-
-
Klicken Sie auf Definition erstellen, um die API-Definition zu erstellen.
Hinweis:
Wenn Sie einen API-Ressourcenpfad bearbeiten möchten, bevor Sie ihn zur API-Definition hinzufügen, verwenden Sie die Sortier- oder Suchfunktion für die API-Ressourcen auf dem Bildschirm der API-Definition.
Betrachten Sie beispielsweise eine API-Ressource namens „/api/products/123-3243-2344334/reviews“, wobei das Pfadsegment „123-3243-2344334“ eine variable Produkt-ID ist. Sie können nun die API-Ressourcen sortieren, den Ressourcenpfad als „/api/products/{id}/reviews“ hinzufügen und alle API-Endpunkte mit IDs wie „/api/products/123-3243-2344334/reviews“ löschen.
Vorhandene API-Definition mit erkannten API-Endpunkten aktualisieren
So aktualisieren Sie eine vorhandene API-Definition mit API-Endpunkten (API-Ressourcen und -Methoden):
-
Navigieren Sie zu Security > API Security > API Discovery, um die Liste der virtuellen Server und API-Bereitstellungen anzuzeigen.
-
Klicken Sie auf einen beliebigen virtuellen Server auf der Registerkarte VServer.
-
Die Seite des virtuellen Servers zeigt die Liste der erkannten Endpunkte an. Wählen Sie den Endpunkt aus, den Sie einer vorhandenen API-Definition hinzufügen möchten. Klicken Sie auf Vorhandene API-Definition aktualisieren.

-
Wählen Sie aus der Dropdown-Liste Vorhandene API-Definition auswählen die API-Definition aus, die Sie aktualisieren möchten. Klicken Sie auf Definition aktualisieren.
-
Die Seite Vorhandene API-Definition aktualisieren wird angezeigt. Der Abschnitt API-Ressourcen zeigt die folgenden Tabellen an:
-
Hinzugefügte Ressourcen – Die von Ihnen ausgewählten API-Endpunkte
-
Vorhandene Ressourcen – Die API-Endpunkte, die bereits in der API-Definition verfügbar sind
Hinweis:Wenn derselbe API-Endpunkt in Hinzugefügte Ressourcen und Vorhandene Ressourcen verfügbar ist, wird der Endpunkt nur einmal zur API-Definition hinzugefügt. -
-
Klicken Sie auf Definition aktualisieren.