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 listesini içeren bir bildirim gönderecek şekilde yapılandırabilirsiniz. Bildirimleri ayarladıktan sonra Apigee Sense, 5 dakikada bir belirttiğiniz webhook URI'sine rapor gönderir.

Apigee Sense, webhook URI'sini kullanarak JSON biçiminde bir dize gönderir (dizeyi JSON'a ayrıştıran bir koda ihtiyacınız olur). Aşağıdaki kısa rapor ö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 içerir:

  • Bildirilen isteklerin toplandığı Apigee kuruluşu ve ortamı.
  • Raporun zaman damgası.
  • Rapor edilen iletinin kimliği.
  • İstenmeyen isteklerde bulunabilecek IP adreslerinin sayısı.
  • Potansiyel olarak istenmeyen istekler (ör. botlar) gönderen IP adresleriyle ilgili istemci verilerinin dizisi. Rapor, her müşteri için şunları içerir:

    Müşteri Özelliği Açıklama
    ipAddress İstemcinin IP adresi.
    botDetectedLast Müşteriden gelen en son isteğin zaman damgası.
    ipIsp İstek gönderen istemcinin İSS'si.
    ipCountry İstemciden gelen isteklerin kaynağı olan ü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 Analiz menüsünü ve ardından Algıla'yı tıklayın.
  3. Ayarlar menüsünü tıklayın.
  4. Ayarlar sayfasında bildirimleri yapılandırmak için değerler 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 gelen raporlar bu URI'ye gönderilir.
    API Anahtarının Adı İsteğe bağlı. Apigee Sense'in sisteminizle kimlik doğrulaması yaparken kullanması gereken 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 kullanması gereken anahtar değeri. 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-300). Apigee Sense, IP adreslerini şüpheli istek sayısına göre, en çok istekten en az isteğe doğru sıralayarak buraya belirttiğiniz IP sayısına kadar ekler.