Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info
Sie können Apigee Sense so konfigurieren, dass Sie über eine Liste der erkannten API-Anfragen informiert werden, die möglicherweise unerwünscht sind. Nachdem Sie Benachrichtigungen eingerichtet haben, sendet Apigee Sense alle 5 Minuten einen Bericht an einen von Ihnen angegebenen Webhook-URI.
Über den Webhook-URI sendet Apigee Sense einen String in JSON-Form. Sie benötigen Code, der den String in JSON parst. Das folgende kurze Beispiel für einen Bericht 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 Meldung.
- Die Anzahl der IP-Adressen, von denen möglicherweise unerwünschte Anfragen stammen.
Ein Array der Clientdaten für die IP-Adressen, von denen potenziell unerwünschte Anfragen stammen (z. B. von Bots). Der Bericht enthält für jeden Kunden folgende Informationen:
Clienteigenschaft Beschreibung ipAddress IP-Adresse des Clients. botDetectedLast Zeitstempel der letzten Anfrage vom Client. ipIsp Internetanbieter des Clients, der Anfragen stellt ipCountry Land, aus dem die Anfragen vom Client stammen. botReason Die Apigee Sense-Erkennungsregeln, denen Anfragen von dieser IP-Adresse entsprachen. 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:
- Öffnen Sie New Edge.
- Klicken Sie in der neuen Edge-Version auf das Menü Analysieren und dann auf Erkennen.
- Klicken Sie auf das Menü Einstellungen.
Geben Sie auf der Seite Einstellungen Werte ein, um Benachrichtigungen zu konfigurieren:
Einstellung Beschreibung Benachrichtigung Klicken Sie, um diese Benachrichtigung zu aktivieren oder zu deaktivieren. URI Der URI, den Apigee Sense beim Senden von Benachrichtigungen verwenden soll. Dies ist normalerweise ein Monitoringsystem, das eingehende Webhooks akzeptiert. Berichte von Apigee Sense werden an diesen URI gesendet. Name des API-Schlüssels Optional. Schlüsselname, den Apigee Sense für die Authentifizierung bei Ihrem System verwenden soll. Verwenden Sie einen API-Schlüssel, um die Sicherheit zu erhöhen. API-Schlüsselwert Optional. Schlüsselwert, den Apigee Sense bei der Authentifizierung bei Ihrem System verwenden soll. Verwenden Sie einen API-Schlüssel, um die Sicherheit zu erhöhen. Maximale Anzahl von IP-Adressen Maximale Anzahl (zwischen 1 und 300) der Client-IP-Adressen, die in den Bericht aufgenommen werden sollen. Apigee Sense fügt IP-Adressen in der Reihenfolge der Anzahl der verdächtigen Anfragen hinzu, von der größten Anzahl an Anfragen bis zur kleinsten, bis die Anzahl der hier angegebenen IPs erreicht ist.