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 terdeteksi yang mungkin tidak diinginkan. Setelah menyiapkan notifikasi, Apigee Sense 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 ke JSON). Contoh singkat laporan berikut telah diformat dari string ke 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 pengumpulan permintaan yang dilaporkan.
  • 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 mungkin tidak diinginkan (seperti bot). Untuk setiap klien, laporan ini mencakup:

    Karakteristik Klien Deskripsi
    ipAddress alamat IP klien.
    botDetectedLast Stempel waktu permintaan terbaru dari klien.
    ipIsp ISP klien yang membuat permintaan.
    ipCountry Negara tempat permintaan dari klien berasal.
    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. API ini diminta oleh klien.
    ipCity Kota tempat permintaan diterima.

Untuk menyiapkan notifikasi

  1. Buka pengalaman Edge Baru.
  2. Di pengalaman New Edge, klik menu Analyze, lalu klik Sense.
  3. Klik menu Setelan.

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

    Pembahasan Deskripsi
    Notifikasi Klik untuk mengaktifkan atau menonaktifkan notifikasi ini.
    URI URI yang Anda inginkan untuk digunakan Apigee Sense saat mengirim notifikasi. Sistem ini biasanya adalah sistem pemantauan yang menerima webhook masuk. Laporan dari Apigee Sense akan dikirim ke URI ini.
    Nama Kunci API Opsional. Nama kunci Apigee Sense yang harus digunakan saat mengautentikasi dengan sistem Anda. Menggunakan kunci API untuk meningkatkan keamanan.
    Nilai Kunci API Opsional. Nilai kunci yang harus digunakan Apigee Sense saat melakukan autentikasi dengan sistem Anda. Menggunakan kunci API untuk meningkatkan keamanan.
    Jumlah IP maksimum Jumlah maksimum (dari 1 hingga 300) alamat IP klien yang akan disertakan dalam laporan. Apigee Sense akan menyertakan alamat IP sesuai urutan jumlah permintaan yang dicurigai, dari jumlah permintaan terbanyak hingga yang paling sedikit, hingga jumlah IP yang Anda tentukan di sini.