Menambahkan kebijakan Spike Arrest ke API

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

Yang akan Anda pelajari

Melalui tutorial ini, Anda akan mempelajari cara:

• Menambahkan kebijakan yang memengaruhi permintaan dan respons.
• Lihat pengaruh kebijakan.

Yang Anda butuhkan

• Setidaknya satu kebijakan di proxy Anda (juga merupakan bagian dari tutorial Memulai).
• curl diinstal di komputer Anda untuk melakukan panggilan API dari command line.

Tambahkan kebijakan Spike Arrest

Dalam tutorial ini, Anda akan menambahkan dan mengonfigurasi kebijakan SpikeArrest untuk melindungi layanan target dari lonjakan traffic mendadak yang dapat disebabkan oleh peningkatan penggunaan, klien yang bermasalah, atau serangan berbahaya. Jika jumlah permintaan melebihi batas kecepatan, API akan menampilkan error HTTP 500 untuk permintaan.

Menambahkan kebijakan Spike Arrest ke proxy API:

1. Login ke apigee.com/edge.
2. Pilih Develop > API Proxies di menu navigasi kiri.
3. Pilih proxy API yang ingin Anda tambahi kebijakan Spike Arrest.

   Jika Anda mengikuti tutorial Memulai, Anda dapat menambahkannya ke proxy "getstarted" yang Anda buat di Membuat proxy API.

4. Di editor untuk proxy API baru, klik tab Develop:

   

   Editor Proxy API memungkinkan Anda melihat struktur proxy API dan mengonfigurasi alurnya. Editor menampilkan representasi visual alur pesan permintaan dan respons proxy Anda serta tampilan XML pokok yang menentukan proxy yang dapat diedit.

5. Di panel Navigator kiri, klik PreFlow di bagian Proxy Endpoints > default. (Tutorial lain akan membahas konsep alur.)
6. Klik tombol +Step teratas, yang sesuai dengan Request PreFlow. Tindakan ini menampilkan daftar semua kebijakan yang dapat Anda buat, yang dikategorikan.

   

7. Pilih Spike Arrest di kategori Traffic Management. Dialog New Policy akan muncul:

   

8. Biarkan nama default, lalu klik Tambahkan. Kebijakan baru dilampirkan ke alur PreFlow permintaan.
9. Di Navigator, pastikan PreFlow di bagian Proxy Endpoints > default masih dipilih dan perhatikan hal berikut di Editor API Proxy:
   • Kebijakan Spike Arrest-1 baru ditambahkan di bagian Policies di Navigator di sisi kiri Editor Proxy API.
   • Ikon Spike Arrest-1 ditambahkan ke Designer view di tengah atas Editor API Proxy, yang merupakan representasi visual dari alur pesan proxy Anda.
   • XML untuk kebijakan ditampilkan di Tampilan kode di bagian tengah bawah Editor Proxy API.

   

10. Di Navigator, pilih Spike Arrest-1 di bagian Policies dan perhatikan hal berikut di API Proxy Editor:
    • Detail kebijakan ditampilkan dalam tampilan Designer di bagian tengah atas Editor Proxy API.
    • XML untuk kebijakan ditampilkan di Tampilan kode di bagian tengah bawah Editor Proxy API.
    • Nilai atribut dan elemen XML untuk kebijakan ditampilkan di Property Inspector di sisi kanan API Proxy Editor.

    

11. Dalam XML untuk kebijakan, ubah nilai elemen <Rate> menjadi 13.00 (yang diterjemahkan menjadi sekitar 2 permintaan yang diizinkan setiap 60 detik di cloud).

    Anda dapat menentukan kecepatan sebagai nilai bilangan bulat per menit (pm) atau per detik (ps). Ini adalah batas yang sangat rendah dan hanya digunakan untuk tutorial ini guna mendemonstrasikan kebijakan. Biasanya, Anda menetapkannya ke batas yang jauh lebih tinggi.

    Perhatikan bahwa nilai Rate di Pemeriksa Properti juga berubah menjadi "13.00". Atau, Anda dapat mengubah nilai Rate di Pemeriksa Properti dan nilai tersebut akan ditampilkan dalam tampilan XML.

12. Klik Simpan untuk menyimpan revisi saat ini dengan perubahan Anda.

13. Panggil API menggunakan curl, dengan mengganti nama organisasi Apigee Anda dengan org_name:

    curl "http://org_name-test.apigee.net/getstarted"

    Contoh:

    curl "http://ahamilton-eval-test.apigee.net/getstarted" | python -m json.tool

    Pastikan permintaan berhasil dan Anda melihat respons XML yang sama seperti sebelumnya. (Anda juga dapat memasukkan URL saja di browser web.)

14. Jalankan perintah curl (atau muat ulang jendela browser) dua atau tiga kali lagi dalam satu menit, dan perhatikan bahwa Anda akan mendapatkan pesan berikut karena Anda melampaui batas kecepatan kebijakan:

    {
    "fault": {
      "faultstring":"Spike arrest violation. Allowed rate : 1pm",
      "detail": {
        "errorcode":"policies.ratelimit.SpikeArrestViolation"}
      }
    }

    Jika Anda mencoba melakukan lebih banyak panggilan dalam satu menit, Anda akan terus mendapatkan pesan error.

15. Edit kebijakan Anda untuk menetapkan batas <Rate> ke 15pm (yang diterjemahkan menjadi sekitar 2 panggilan yang diizinkan setiap 4 detik di cloud), lalu simpan proxy API.
16. Jalankan perintah curl atau muat ulang browser berulang kali (curl lebih cepat). Perhatikan bahwa jika Anda melakukan satu atau dua panggilan dalam interval 4 detik, panggilan Anda akan berhasil. Jika Anda melakukan panggilan dengan cepat, lebih dari dua dalam waktu 4 detik, Anda akan mendapatkan kesalahan. Namun, setelah setiap interval 4 detik, Anda dapat terus melakukan panggilan, alih-alih diblokir selama satu menit penuh (dengan setelan pukul 13.00).