Otrzymywanie powiadomień z Sense

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
Informacje

Apigee Sense możesz skonfigurować w taki sposób, aby powiadamiał Cię o liście wykrytych żądań do interfejsu API, które mogą być niepożądane. Po skonfigurowaniu powiadomień Apigee Sense wysyła raport co 5 minut do podanego przez Ciebie identyfikatora URI webhooka.

Korzystając z identyfikatora URI webhooka, Apigee Sense wyśle ciąg znaków w formie JSON (potrzebny będzie kod, który analizuje ten ciąg do formatu JSON). Ten krótki przykład raportu został sformatowany z ciągu znaków na format JSON, aby był bardziej czytelny:

{
    "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"
            }
        ]
    }
}

Raport zawiera te informacje o możliwych niepożądanych atakach na Twoje interfejsy API:

  • Organizacja i środowisko Apigee, w których zebrano zgłoszone żądania.
  • Sygnatura czasowa raportu.
  • Identyfikator wiadomości z prośbą o zgłoszenie.
  • Liczba adresów IP wysyłających żądania, które mogą być niechciane.
  • Tablica danych klienta dotyczących adresów IP wysyłających potencjalnie niechciane żądania (np. boty). W przypadku każdego klienta raport zawiera te informacje:

    Cechy klienta Opis
    ipAddress Adres IP klienta.
    botDetectedLast Sygnatura czasowa ostatniego żądania od klienta.
    ipIsp Dostawca usług internetowych klienta obsługującego żądania.
    ipCountry Kraj, z którego pochodzą żądania od klienta.
    botReason Reguły wykrywania Apigee Sense, które spełniają żądania z tego adresu IP.
    callCount Liczba żądań z tego adresu IP.
    topUrl Najpopularniejszy adres URL, którego żąda adres IP klienta. Jest to interfejs API żądany przez klienta.
    ipCity Miasto, z którego otrzymaliśmy prośbę.

Aby skonfigurować powiadomienia

  1. Otwórz nową wersję Edge.
  2. W nowej wersji Edge kliknij menu Analyze (Analizuj), a następnie kliknij Sense.
  3. Kliknij menu Ustawienia.
  4. Na stronie Ustawienia wpisz wartości, aby skonfigurować powiadomienia:

    lokalizacji, Opis
    Powiadomienie Kliknij, aby włączyć lub wyłączyć to powiadomienie.
    Identyfikator URI Identyfikator URI, którego Apigee Sense ma używać do wysyłania powiadomień. Zwykle jest to system monitorowania, który akceptuje przychodzące webhooki. Raporty z Apigee Sense będą wysyłane do tego identyfikatora URI.
    Nazwa klucza interfejsu API Opcjonalnie. Nazwa klucza, której Apigee Sense ma używać podczas uwierzytelniania w systemie. Używaj klucza interfejsu API, aby zwiększyć bezpieczeństwo.
    Wartość klucza interfejsu API Opcjonalnie. Wartość klucza, której Apigee Sense ma używać podczas uwierzytelniania w systemie. Używaj klucza interfejsu API, aby zwiększyć bezpieczeństwo.
    Maksymalna liczba adresów IP Maksymalna liczba adresów IP klientów (od 1 do 300) do uwzględnienia w raporcie. Apigee Sense uwzględni adresy IP w kolejności od największej do najmniejszej liczby podejrzanych żądań, aż do podanej tutaj liczby adresów IP.