Benachrichtigungen von Sense erhalten

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Sie können Apigee Sense so konfigurieren, dass Sie mit einer Liste erkannter, möglicherweise unerwünschter API-Anfragen benachrichtigt werden. Nachdem Sie Benachrichtigungen eingerichtet haben, sendet Apigee Sense alle fünf Minuten einen Bericht an einen von Ihnen angegebenen Webhook-URI.

Mithilfe des Webhook-URI sendet Apigee Sense einen String in JSON-Form. Sie benötigen Code, der den String in JSON parst. Der folgende kurze Beispielbericht wurde zur besseren Lesbarkeit von einem String in JSON formatiert:

{
    "text": {
        "metadata": {
            "org": "my-org",
            "env": "prod",
            "reportTimestamp": "2018-10-09T17:25:12Z",
            "messageId": "1539105912220"
        },
        "totalNumberOfBots": 1,
        "bots": [
            {
                "ipAddress": "11.111.111.11",
                "botDetectedLast": "2018-10-0917:04:48Z",
                "ipIsp": "Their ISP",
                "ipCountry": "United States",
                "botReason": [
                    "Flooder",
                    "Content Robber"
                ],
                "callCount": "274529",
                "topUrl": "/v1/my/url",
                "ipCity": "Los Angeles"
            }
        ]
    }
}

Der Bericht enthält die folgenden Informationen zu möglichen unerwünschten Angriffen auf Ihre APIs:

  • Die Apigee-Organisation und -Umgebung, in der gemeldete Anfragen erfasst wurden.
  • Der Zeitstempel des Berichts.
  • ID der Berichtsnachricht.
  • Die Anzahl der IP-Adressen, von denen unerwünschte Anfragen gesendet werden.
  • Ein Array der Clientdaten für die IP-Adressen, die potenziell unerwünschte Anfragen stellen (z. B. Bots). Der Bericht enthält für jeden Kunden Folgendes:

    Kundenmerkmal Beschreibung
    ipAddress IP-Adresse des Clients.
    botDetectedLast Zeitstempel der letzten Anfrage vom Client.
    ipIsp ISP des Clients, der die Anfrage stellt.
    ipCountry Land, aus dem Anfragen des Clients stammen.
    botReason Die Apigee Sense-Erkennungsregeln, denen die Anfragen von dieser IP-Adresse entsprochen haben.
    callCount Anzahl der Anfragen von dieser IP-Adresse.
    topUrl Die am häufigsten von der Client-IP angeforderte URL. Dies ist die vom Client angeforderte API.
    ipCity Stadt, von der das Ersuchen eingegangen ist.

So richten Sie Benachrichtigungen ein:

  1. Öffnen Sie New Edge.
  2. Klicken Sie in der New Edge-Umgebung auf das Menü Analysieren und dann auf Sense.
  3. Klicken Sie auf das Menü Einstellungen.
  4. Geben Sie auf der Seite Einstellungen Werte ein, um Benachrichtigungen zu konfigurieren:

    Einstellung Beschreibung
    Meldung Klicken Sie hier, um diese Benachrichtigung zu aktivieren oder zu deaktivieren.
    URI Der URI, den Apigee Sense beim Senden von Benachrichtigungen verwenden soll. Dies ist in der Regel ein Überwachungssystem, das eingehende Webhooks akzeptiert. Berichte von Apigee Sense werden an diesen URI gesendet.
    Name des API-Schlüssels Optional. Der Schlüsselname, den Apigee Sense für die Authentifizierung bei Ihrem System verwenden soll. Verwenden Sie einen API-Schlüssel, um die Sicherheit zu verbessern.
    API-Schlüsselwert Optional. Schlüssel/Wert-Paar, das Apigee Sense für die Authentifizierung bei Ihrem System verwenden soll. Verwenden Sie einen API-Schlüssel, um die Sicherheit zu verbessern.
    Max. Anzahl von IP-Adressen Maximale Anzahl (1 bis 300) von Client-IP-Adressen für den Bericht Apigee Sense berücksichtigt IP-Adressen in der Reihenfolge der Anzahl verdächtiger Anfragen, von der meisten bis zur geringsten Anzahl von Anfragen bis zur Anzahl der IP-Adressen, die Sie hier angeben.