Mendapatkan notifikasi dari Sense

Anda 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 Anda menyiapkan notifikasi, Apigee Sense akan mengirimkan laporan setiap 5 menit ke URI webhook yang Anda tentukan.

Dengan menggunakan URI webhook, Apigee Sense akan mengirimkan string dalam bentuk JSON (Anda akan 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 mencatat informasi berikut tentang kemungkinan serangan yang tidak diinginkan ke 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 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 dipatuhi oleh 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 New Edge.
2. Di pengalaman New Edge, klik menu Analyze, lalu klik Sense.
3. Klik menu Settings.

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

   Setelan	Deskripsi
   Notifikasi	Klik untuk mengaktifkan atau menonaktifkan notifikasi ini.
   URI	URI yang Anda inginkan untuk digunakan Apigee Sense saat mengirim notifikasi. Biasanya, ini 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. Gunakan kunci API untuk meningkatkan keamanan.
   Nilai Kunci API	Opsional. Nilai kunci yang harus digunakan Apigee Sense saat melakukan autentikasi 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 dalam urutan jumlah permintaan yang mencurigakan, dari jumlah permintaan terbanyak hingga paling sedikit, hingga jumlah IP yang Anda tentukan di sini.