Sense'ten bildirim alma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
info

Apigee Sense'i, istenmeyen olabilecek API isteklerinin listesini size bildirecek şekilde yapılandırabilirsiniz. Bildirimleri ayarladıktan sonra Apigee Sense, belirttiğiniz bir webhook URI'sine 5 dakikada bir rapor gönderir.

Apigee Sense, webhook URI'sini kullanarak JSON biçiminde bir dize gönderir (dizeyi JSON olarak ayrıştıran bir koda ihtiyacınız vardır). Aşağıdaki kısa rapor örneği, okunabilirlik için dize yerine JSON biçimindedir:

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

Raporda, API'lerinize yönelik olası istenmeyen saldırılarla ilgili aşağıdaki bilgiler yer alır:

  • Bildirilen isteklerin toplandığı Apigee kuruluşu ve ortamı.
  • Raporun zaman damgası.
  • Bildirim mesajının kimliği.
  • İstenmeyen olabilecek isteklerde bulunan IP adreslerinin sayısı.
  • İstenmeyen olabilecek istekler (ör. bot'lar) gönderen IP adreslerine ait istemci verilerinin dizisi. Rapor her müşteri için şunları içerir:

    İstemci Özelliği Açıklama
    ipAddress İstemcinin IP adresi.
    botDetectedLast İstemciden gelen en son isteğin zaman damgası.
    ipIsp İstek gönderen istemcinin ISP'si.
    ipCountry İstemcinin isteklerinin geldiği ülke.
    botReason Bu IP adresinden gelen isteklerin uyduğu Apigee Sense algılama kuralları.
    callCount Bu IP adresinden gelen isteklerin sayısı.
    topUrl İstemci IP'si tarafından istenen en yaygın URL. Bu, istemci tarafından istenen API'dir.
    ipCity İsteğin alındığı şehir.

Bildirimleri ayarlamak için

  1. Yeni Edge deneyimini açın.
  2. Yeni Edge deneyiminde Analizin ardından Algı'yı tıklayın.
  3. Ayarlar menüsünü tıklayın.
  4. Ayarlar sayfasında bildirimleri yapılandırmak için değerleri girin:

    Yer Açıklama
    Bildirim Bu bildirimi etkinleştirmek veya devre dışı bırakmak için tıklayın.
    URI Apigee Sense'in bildirim gönderirken kullanmasını istediğiniz URI. Bu genellikle gelen webhook'ları kabul eden bir izleme sistemidir. Apigee Sense'ten gelen raporlar bu URI'ye gönderilir.
    API Anahtarı Adı İsteğe bağlı. Apigee Sense'in sisteminizle kimlik doğrulaması yaparken kullanacağı anahtar adı. Güvenliği artırmak için API anahtarı kullanın.
    API Anahtarı Değeri İsteğe bağlı. Apigee Sense'in sisteminizle kimlik doğrulaması yaparken kullanacağı anahtar/değer. Güvenliği artırmak için API anahtarı kullanın.
    Maksimum IP sayısı Rapora dahil edilecek maksimum istemci IP adresi sayısı (1 ila 300). Apigee Sense, şüpheli istek sayısına göre IP adreslerini en çok sayıdan en aza doğru, burada belirttiğiniz IP sayısına kadar dahil eder.