Sense'ten bildirim alma

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri.
bilgi

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 dizeden JSON'ye 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"
            }
        ]
    }
}

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 istekler gönderen IP adreslerinin sayısı.
  • İstenmeyen olabilecek istekler (ör. bot'lar) gönderen IP adreslerine ait istemci verilerinin dizisi. Her müşteri için raporda şunlar bulunur:

    Müşterinin Özellikleri Açıklama
    ipAddress İstemcinin IP adresi.
    botDetectedLast İstemciden gelen en son isteğin zaman damgası.
    ipIsp İstekte bulunan istemcinin İSS'si.
    ipCountry İstemciden gelen isteklerin geldiği ülke.
    botReason Apigee Sense algılama, bu IP adresinden gelen isteklerin uygun olduğu kuralları belirler.
    callCount Bu IP adresinden gelen isteklerin sayısı.
    topUrl İstemci IP'si tarafından en çok istenen 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 et menüsünü, ardından Sense'i tıklayın.
  3. Ayarlar menüsünü tıklayın.
  4. Ayarlar sayfasında, bildirimleri yapılandırmak için değerler 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 sisteminizde 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 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.