Mendapatkan notifikasi dari Sense

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Anda dapat mengonfigurasi Apigee Sense untuk memberi tahu Anda dengan daftar permintaan API yang terdeteksi yang mungkin tidak diinginkan. Setelah Anda menyiapkan notifikasi, Apigee Sense akan mengirimkan laporan setiap 5 menit ke URI webhook yang Anda tentukan.

Dengan menggunakan URI webhook, Apigee Sense akan mengirim string dalam bentuk JSON (Anda memerlukan kode yang mengurai string menjadi JSON). Contoh singkat laporan berikut telah diformat dari string menjadi JSON agar mudah dibaca:

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

Laporan ini menangkap informasi berikut tentang kemungkinan serangan yang tidak diinginkan terhadap API Anda:

  • Organisasi dan lingkungan Apigee tempat permintaan yang dilaporkan dikumpulkan.
  • Stempel waktu laporan.
  • ID pesan laporan.
  • Jumlah alamat IP yang membuat permintaan yang mungkin tidak diinginkan.

  • Array data klien untuk alamat IP yang membuat permintaan yang berpotensi tidak diinginkan (seperti bot). Untuk setiap klien, laporan menyertakan:

    Karakteristik Klien Deskripsi
    ipAddress Alamat IP klien.
    botDetectedLast Stempel waktu permintaan terbaru dari klien.
    ipIsp ISP klien yang membuat permintaan.
    ipCountry Negara tempat asal permintaan dari klien.
    botReason Aturan deteksi Apigee Sense yang sesuai dengan permintaan dari alamat IP ini.
    callCount Jumlah permintaan dari alamat IP ini.
    topUrl URL paling umum yang diminta oleh IP klien. Ini adalah API yang diminta oleh klien.
    ipCity Kota tempat permintaan diterima.

Untuk menyiapkan notifikasi

  1. Buka Pengalaman Edge baru.
  2. Di versi Edge Baru, klik menu Analisis, lalu klik Sensor.
  3. Klik menu Setelan.

  4. Di halaman Setelan, masukkan nilai untuk mengonfigurasi notifikasi:

    Setelan Deskripsi
    Notifikasi Klik untuk mengaktifkan atau menonaktifkan notifikasi ini.
    URI URI yang ingin Anda gunakan oleh Apigee Sense saat mengirim notifikasi. Ini biasanya adalah sistem pemantauan yang menerima webhook masuk. Laporan dari Apigee Sense akan dikirim ke URI ini.
    Nama Kunci API Opsional. Nama kunci yang harus digunakan Apigee Sense saat mengautentikasi dengan sistem Anda. Gunakan kunci API untuk meningkatkan keamanan.
    Nilai Kunci API Opsional. Nilai kunci yang harus digunakan Apigee Sense saat mengautentikasi dengan sistem Anda. Gunakan kunci API untuk meningkatkan keamanan.
    Jumlah maksimum IP Jumlah maksimum (dari 1 hingga 300) alamat IP klien yang akan disertakan dalam laporan. Apigee Sense akan menyertakan alamat IP berdasarkan jumlah permintaan yang dicurigai, dari jumlah permintaan terbanyak hingga jumlah permintaan terendah, hingga jumlah IP yang Anda tentukan di sini.