Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu
Apigee X. info
Sie können Apigee Sense-Erkennungsregeln ansehen oder anpassen, um sicherzustellen, dass nur die Anfragen erfasst werden, die möglicherweise unerwünscht sind. In Apigee Sense-Erkennungsregeln werden Muster definiert, die möglicherweise unerwünschte Clientanfragen darstellen.
Weitere Informationen zum Ansehen der Ergebnisse von Erkennungsregeln finden Sie unter Erste Schritte mit der Apigee Sense-Konsole.
Beispiel für die Optimierung
In Ihren Erkennungsberichten haben Sie beispielsweise möglicherweise festgestellt, dass einige unerwünschte Anfragen dem Muster „Brute Guessor“ entsprechen, bei dem ein größerer Anteil an Antwortfehlern innerhalb eines Zeitraums von 24 Stunden gemeldet wird. Sie stellen aber auch fest, dass mit dem Muster Anfragen erfasst werden, die Sie über Ihre API-Proxys zulassen möchten.
Durch Anpassen des Musters „Brute Guessor“ (siehe folgende Tabelle) können Sie es so optimieren, dass Anfragen, die Sie zulassen möchten, besser zugelassen und Anfragen, die Sie nicht zulassen möchten, besser erfasst werden. Im Muster „Brute Guessor“ werden die in der folgenden Tabelle gezeigten Bedingungen und Werte definiert. Wenn eine Reihe von Anfragen diese Bedingungen über einen Zeitraum von 24 Stunden erfüllt, meldet Apigee Sense, dass diese Anfragen dem Muster „Brute Guessor“ entsprechen.
| Bedingungen | Wert |
|---|---|
| Mindestanzahl von Aufrufen über IP | 100 |
| Mindestprozentsatz der Fehler (Schwellenwert) | 90 |
Es kann Szenarien geben, in denen Ihr Design > 90% Fehler in einem Zeitraum von 24 Stunden zulässt. In diesem Fall können aufgrund der Schutzeinstellung der Regel legitime Quellen blockiert werden. Mit dieser Funktion können Sie die Werte der Bedingungen ändern. Im vorherigen Beispiel könnten Sie zuerst die Werte der Bedingungen so ändern:
| Bedingungen | Wert |
|---|---|
| Mindestanzahl von Aufrufen über IP | 100 |
| Mindestprozentsatz der Fehler (Schwellenwert) | 95 |
Die spezifischen Anpassungen, die Sie vornehmen, hängen davon ab, was Ihre Anfragedaten darüber aussagen, wie gültige Clients Ihre APIs verwenden. Wahrscheinlich werden Sie feststellen, dass der Prozess iterativ ist und Sie schrittweise Änderungen vornehmen, bis Sie eine nützliche Regeldefinition erhalten.
Erkennung iterativ optimieren
Für Erkennungsregeln, die optimiert werden müssen, ist es möglicherweise am besten, einen schrittweisen und iterativen Ansatz zu verfolgen. Jede Iteration kann aufgrund der Funktionsweise des Erkennungs- und Analysezyklus von Apigee Sense einen Tag oder länger dauern. In diesem Zyklus speichert Apigee Sense Metadaten zu Clientanfragen, analysiert diese Daten in einem Batch und präsentiert Ihnen dann die Ergebnisse in der Apigee Sense-Konsole.
Sie können beispielsweise so vorgehen:
- Verwenden Sie die Erkennungsberichte der Apigee Sense-Konsole, um eine Erkennungsregel zu identifizieren, die optimiert werden könnte, z. B. eine Regel, mit der zu viele Anfragen erkannt werden, die eigentlich nützlich sind.
- Ermitteln Sie, welche Bedingungen der Regel angepasst werden müssen, damit der Prozentsatz der erfassten unerwünschten Anfragen höher ist.
- Bearbeiten Sie die Regel in der Apigee Sense-Konsole, um eine geringfügige schrittweise Änderung an den von Ihnen ermittelten Werten der Bedingungen vorzunehmen.
- Nach einer Stunde können Sie anhand der Erkennungsberichte prüfen, ob Ihre Änderung die gewünschte Wirkung erzielt hat.
- Wiederholen Sie die Schritte nach Bedarf, bis Sie nützliche Ergebnisse erhalten.
Richtlinien und Best Practices
Beachten Sie beim Anpassen von Erkennungsregeln Folgendes.
- Die Bedingungen einer Regel werden mit einem logischen AND verknüpft. Wenn es also drei Bedingungen gibt, müssen alle drei Bedingungen erfüllt sein, damit Anfragen dem Muster der Regel entsprechen.
- Einige Regelbedingungen definieren Mindestschwellenwerte, andere definieren Höchstschwellenwerte.
- Optimieren Sie Regeln so, dass genügend Anfragen erfasst werden, um unerwünschten Traffic zu identifizieren, aber nicht so viele, dass nützlicher Traffic erfasst wird. Es ist eine bewährte Vorgehensweise, weniger Anfragen zu erfassen, um zu vermeiden, dass nützlicher Traffic erfasst wird.
- Sehr kleine Änderungen an den Werten der Bedingungen machen möglicherweise keinen spürbaren Unterschied. Sie müssen selbst entscheiden, wie groß die Änderung sein soll.
Weitere Informationen zu Mustern, Bedingungen und Zeitfenstern finden Sie unter Maßnahmen bei verdächtigen Aktivitäten.
Erkennungsregel anpassen
Nachdem Sie eine Erkennungsregel identifiziert haben, die optimiert werden könnte, führen Sie die folgenden Schritte aus, um eine Erkennungsregel anzusehen oder anzupassen oder Regeln sogar zu deaktivieren, wenn Sie sie für ungeeignet halten. Sie können auch sehen, wer die Regel zuletzt bearbeitet hat.
- Öffnen Sie die neue Edge-Benutzeroberfläche.
- Klicken Sie auf der neuen Edge-Benutzeroberfläche auf das Menü Analysieren und dann auf Sense.
- Klicken Sie in der Navigationsleiste auf Erkennung > Regeln.
- Suchen Sie auf der Seite Erkennungsregeln die Regel, die Sie ansehen oder anpassen möchten.
- Bewegen Sie den Mauszeiger auf die Zeile der Regel in der Liste und klicken Sie dann auf die Schaltfläche ganz rechts in der Zeile.
Die folgende Abbildung zeigt die Schaltfläche „Bearbeiten“, die für Administratoren verfügbar ist. Sie können Regeln auch deaktivieren. In diesem Fall werden Anfragen an Ihre APIs von Apigee Sense nicht mehr anhand dieses Musters ausgewertet.
- Sehen Sie sich im Dialogfeld der Regel die Werte der Bedingungen an oder passen Sie sie an.
- Klicken Sie auf Speichern.
- Sehen Sie sich nach einer Stunde die Analyseergebnisse im Erkennungsbericht an, um zu prüfen, ob Ihre Änderungen das gewünschte Ergebnis erzielt haben.