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 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 mengambil 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 ini 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 yang paling umum diminta oleh IP klien. Ini adalah API yang diminta oleh klien.
  ipCity	Kota tempat permintaan diterima.

Untuk menyiapkan notifikasi

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

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

   Setelan	Deskripsi
   Notifikasi	Klik untuk mengaktifkan atau menonaktifkan notifikasi ini.
   URI	URI yang ingin Anda gunakan 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 melakukan autentikasi 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, mulai dari jumlah permintaan terbanyak hingga yang paling sedikit, hingga jumlah IP yang Anda tentukan di sini.