Sense'ten bildirim alma

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

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

Apigee Sense, webhook URI'sını kullanarak JSON biçiminde bir dize gönderir (dizeyi JSON'a ayrıştıran koda ihtiyacınız vardır). Bir raporun aşağıdaki kısa örneği, okunabilirlik için dizeden JSON'a biçimlendirilmiştir:

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

Bu rapor, API'lerinize yönelik olası istenmeyen saldırılarla ilgili aşağıdaki bilgileri yakalar:

  • Bildirilen isteklerin toplandığı Apigee kuruluşu ve ortamı.
  • Raporun zaman damgası.
  • Rapor mesajının kimliği.
  • İstenmeyen istekler gönderen IP adreslerinin sayısı.
  • Potansiyel olarak istenmeyen istekler (ör. bot'lar) gönderen IP adresleri için istemci verileri dizisi. Her müşteri için rapor şunları içerir:

    Müşteri Özelliği Açıklama
    ipAddress İstemcinin IP adresi.
    botDetectedLast İstemciden gelen en son isteğin zaman damgası.
    ipIsp İstekte bulunan istemcinin İSS.
    ipCountry İstemciden gelen isteklerin geldiği ülke.
    botReason Bu IP adresinden gelen isteklerin uygun olduğu Apigee Sense algılama kuralları.
    callCount Bu IP adresinden gelen istek 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. New Edge deneyiminde Analiz menüsünü ve ardından Sens'i tıklayın.
  3. Ayarlar menüsünü tıklayın.
  4. Ayarlar sayfasında, bildirimleri yapılandırmak için değerleri girin:

    Ayar 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 alınan raporlar bu URI'ye gönderilecektir.
    API Anahtarı Adı İsteğe bağlı. Sisteminizle kimlik doğrularken Apigee Sense'in kullanması gereken anahtar adı. Güvenliği artırmak için API anahtarı kullanın.
    API Anahtarı Değeri İsteğe bağlı. Sisteminizle kimlik doğrularken Apigee Sense'in kullanması gereken 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 ile 300 arasında). Apigee Sense; IP adreslerini, burada belirttiğiniz IP sayısına kadar, şüpheli istek sayısına göre sıralayarak en fazla talep sayısından en az istek sayısına doğru sıralar.