Notifikasi keamanan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Pratinjau — Notifikasi Advanced API Security

Fitur ini tercakup dalam Persyaratan Penawaran Pra-GA dari Persyaratan Layanan Google Cloud. Fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dukungan untuk peluncuran Pratinjau Pemberitahuan Advanced API Security tersedia melalui forum Apigee - Komunitas Google Cloud.

Notifikasi Advanced API Security memungkinkan Anda membuat notifikasi untuk peristiwa yang terkait dengan keamanan API, seperti perubahan pada skor keamanan atau insiden penyalahgunaan API yang terdeteksi. Anda membuat pemberitahuan menggunakan Cloud Monitoring. Anda dapat mengonfigurasi pemberitahuan untuk mengirim notifikasi kepada Anda melalui teks, email, atau saluran lainnya, saat pemberitahuan dipicu. Lihat Membuat kebijakan pemberitahuan batas metrik untuk mengetahui informasi selengkapnya tentang cara membuat pemberitahuan.

Peran yang diperlukan

Untuk menyiapkan pemberitahuan dan saluran notifikasi di Cloud Monitoring, Anda harus diberi peran berikut:

• roles/monitoring.alertPolicyEditor
• roles/monitoring.notificationChannelEditor

Batasan

Untuk pemberitahuan, batasan berikut berlaku:

• Jumlah maksimum kebijakan pemberitahuan adalah 500 untuk semua tingkat langganan Apigee.
• Data metrik disimpan selama 6 minggu.
• Jangka waktu maksimum yang dievaluasi oleh kondisi nilai minimum metrik adalah 23 jam 30 menit.
• Mungkin ada penundaan hingga 4 menit sejak peristiwa yang memicu notifikasi terjadi hingga saat notifikasi dibuat dan dikirim.

Lihat Batasan untuk pemberitahuan untuk mengetahui daftar lengkap batasan untuk pemberitahuan.

Bagian berikut menyajikan contoh yang menunjukkan cara membuat pemberitahuan.

Contoh: Membuat pemberitahuan untuk penurunan skor keamanan proxy

Contoh ini membuat pemberitahuan saat skor keamanan proxy berada di bawah nilai minimum yang ditentukan. Untuk membuat pemberitahuan, lakukan langkah-langkah berikut:

1. Buka halaman Create alerting policy di konsol Google Cloud.

2. Klik Select a Metric.
3. Batalkan pilihan Hanya tampilkan resource & metrik aktif.

   Catatan: Jika tidak ada data traffic API terbaru di organisasi Anda, metrik di langkah berikutnya tidak akan ditampilkan kecuali jika opsi ini tidak dipilih.

4. Pilih metrik sebagai berikut:
   1. Pilih Apigee API Security Profile Environment Association.
   2. Di panel yang terbuka di sebelah kanan, pilih Keamanan
   3. Di panel berikutnya di sebelah kanan, pilih Skor keamanan proxy API Apigee.
   4. Klik Terapkan
   Catatan: Atau, Anda dapat memilih salah satu metrik berikut:

   • Skor keamanan sumber Apigee: Lihat Penilaian sumber.
   • Skor keamanan server target Apigee: Lihat Penilaian target.
   • Skor keamanan lingkungan Apigee: Total skor keamanan di lingkungan.

   Lihat Metrik untuk pemberitahuan keamanan.

5. (Opsional) Untuk membatasi data pemberitahuan, misalnya ke lingkungan tertentu, Anda dapat membuat filter sebagai berikut:
   1. Di bagian Tambahkan filter > Filter baru, klik di kolom Filter, lalu pilih label resource yang akan difilter, seperti env.
   2. Di kolom Comparator, pilih pembanding, seperti =.
   3. Di kolom Value, pilih nilai untuk label resource, seperti nama lingkungan.

   Dengan filter ini, pemberitahuan hanya akan dipicu oleh data yang lulus kondisi filter. Lihat Filter untuk mengetahui daftar filter yang tersedia.

6. Di bagian Transform data, di kolom Rolling window function, pilih sum.
7. Klik Berikutnya.
8. Di panel Configure alert trigger, tetapkan hal berikut:
   • Di bagian Jenis Kondisi, pilih Batas.
   • Di bagian Pemicu pemberitahuan, pilih Deret waktu mana pun melanggar.
   • Di bagian Threshold position, pilih Below threshold.
   • Di kolom Nilai minimum, masukkan nilai minimum yang memicu pemberitahuan, seperti 600.
9. Klik Berikutnya.
10. Di kolom Configure notifications, klik kolom Notification Channels dan pilih saluran, seperti pesan teks atau email, untuk notifikasi. Jika Anda belum mengonfigurasi saluran apa pun, klik Kelola Saluran Notifikasi dan tambahkan saluran.
11. Klik Oke.
12. Di kolom Documentation, masukkan teks yang ingin Anda kirimkan dengan notifikasi, seperti deskripsi tentang apa yang memicu pemberitahuan. Misalnya, Anda dapat memasukkan "Skor keamanan telah turun di bawah 600".
13. Di bagian Name the alert policy, masukkan nama untuk kebijakan pemberitahuan.
14. Klik Berikutnya dan tinjau detail kebijakan pemberitahuan.
15. Jika semuanya sudah benar, klik Create Policy untuk membuat kebijakan pemberitahuan.

Contoh: Membuat pemberitahuan untuk peningkatan traffic penyalahgunaan yang terdeteksi untuk aturan deteksi

Contoh ini menunjukkan cara membuat pemberitahuan saat jumlah permintaan dengan traffic penyalahgunaan yang terdeteksi melebihi nilai minimum yang ditentukan untuk satu aturan deteksi. Untuk membuat pemberitahuan, lakukan langkah-langkah berikut:

1. Buka halaman Create alerting policy di konsol Google Cloud.

   

2. Klik Select a Metric.
3. Batalkan pilihan Hanya tampilkan resource & metrik aktif.

   Catatan: Jika tidak ada data traffic API terbaru di organisasi Anda, metrik di langkah berikutnya tidak akan ditampilkan kecuali jika opsi ini tidak dipilih.

4. Pilih metrik sebagai berikut:
   1. Pilih Apigee API Security Detection Rule.
   2. Di panel yang terbuka di sebelah kanan, pilih Keamanan
   3. Di panel berikutnya di sebelah kanan, pilih Apigee API Security detected request count by rule.
   4. Klik Terapkan
   Catatan: Atau, Anda dapat memilih metrik Apigee Environment > Security > Apigee API Security detected request count. Dalam hal ini, pemberitahuan akan dipicu saat total jumlah permintaan yang terdeteksi melebihi nilai minimum yang ditentukan (bukan jumlah untuk satu aturan).

   Lihat Metrik untuk pemberitahuan keamanan.

5. (Opsional) Untuk membatasi data pemberitahuan, misalnya ke lingkungan tertentu, Anda dapat membuat filter sebagai berikut:
   1. Di bagian Tambahkan filter > Filter baru, klik di kolom Filter, lalu pilih label resource yang akan difilter, seperti env.
   2. Di kolom Comparator, pilih pembanding, seperti =.
   3. Di kolom Value, pilih nilai untuk label resource, seperti nama lingkungan.

   Dengan filter ini, pemberitahuan hanya akan dipicu oleh data yang lulus kondisi filter, seperti data di lingkungan. Lihat Filter untuk mengetahui daftar filter yang tersedia.

6. Di bagian Transform data, di kolom Rolling window function, pilih sum.
7. Klik Berikutnya.
8. Di panel Configure alert trigger, tetapkan hal berikut:
   • Di bagian Jenis Kondisi, pilih Batas.
   • Di bagian Pemicu pemberitahuan, pilih Deret waktu mana pun melanggar.
   • Di bagian Posisi nilai minimum, pilih Di atas nilai minimum.
   • Di kolom Nilai minimum, masukkan nilai minimum yang memicu pemberitahuan, seperti 100.
9. Klik Berikutnya.
10. Di kolom Configure notifications, klik kolom Notification Channels dan pilih saluran, seperti pesan teks atau email, untuk notifikasi. Jika Anda belum mengonfigurasi saluran apa pun, klik Kelola Saluran Notifikasi dan tambahkan saluran.
11. Klik Oke.
12. Di kolom Documentation, masukkan teks yang ingin Anda kirimkan dengan notifikasi, seperti deskripsi tentang apa yang memicu pemberitahuan. Misalnya, Anda dapat memasukkan "Traffic penyalahgunaan terdeteksi melebihi 100 untuk $(resource.label.env)." Ini menggunakan label $(resource.label.env), yang menampilkan lingkungan yang datanya memicu pemberitahuan.
13. Di bagian Name the alert policy, masukkan nama untuk kebijakan pemberitahuan.
14. Klik Berikutnya dan tinjau detail kebijakan pemberitahuan.
15. Jika semuanya sudah benar, klik Create Policy untuk membuat kebijakan pemberitahuan.

Metrik untuk notifikasi keamanan

Tabel di bawah menjelaskan metrik yang tersedia untuk membuat pemberitahuan keamanan:

Resource	Metrik	Deskripsi	Filter yang didukung
Lingkungan Apigee	Jumlah permintaan Apigee API Security: apigee.googleapis.com/security/request_count	Jumlah permintaan API yang diproses oleh Advanced API Security, sejak sampel terakhir.	location, org, env, proxy
Lingkungan Apigee	Apigee API Security mendeteksi jumlah permintaan: apigee.googleapis.com/security/detected_request_count	Jumlah permintaan API yang terdeteksi oleh deteksi penyalahgunaan Advanced API Security, sejak sampel terakhir.	location, org, env, proxy
Aturan Deteksi Keamanan Apigee API	Apigee API Security mendeteksi jumlah permintaan berdasarkan aturan: apigee.googleapis.com/security/detected_request_count_by_rule	Jumlah permintaan API yang terdeteksi oleh deteksi penyalahgunaan Advanced API Security dan dikelompokkan menurut aturan deteksi sejak sampel terakhir.	location, org, env, proxy, detection_rule
Insiden Keamanan API Apigee	Jumlah permintaan insiden Apigee API Security: apigee.googleapis.com/security/incident_request_count	Jumlah permintaan API yang terdeteksi sebagai bagian dari insiden Keamanan API. Nilai ini diukur sekali setiap jam.	location, org, env, proxy
Insiden Keamanan API Apigee	Jumlah permintaan insiden Apigee API Security menurut aturan deteksi: apigee.googleapis.com/security/incident_request_count_by_rule	Jumlah permintaan API yang terdeteksi sebagai bagian dari insiden Keamanan API yang dikelompokkan menurut aturan deteksi. Nilai ini diukur sekali setiap jam.	location, org, env, incident_id, detection_rule
Asosiasi Lingkungan Profil Keamanan Apigee API	Skor keamanan sumber Apigee API: apigee.googleapis.com/security/source_score	Skor keamanan saat ini dari proxy API Apigee berdasarkan penilaian sumber Advanced API Security. Nilai ini diukur setidaknya sekali setiap 3 jam.	location, org, env, profile
Asosiasi Lingkungan Profil Keamanan Apigee API	Skor keamanan proxy API Apigee: apigee.googleapis.com/security/proxy_score	Skor keamanan saat ini dari proxy API Apigee berdasarkan penilaian proxy Advanced API Security. Nilai ini diukur setidaknya sekali setiap 3 jam.	location, org, env, profile, proxy
Asosiasi Lingkungan Profil Keamanan Apigee API	Skor keamanan target Apigee API: apigee.googleapis.com/security/target_score	Skor keamanan saat ini dari proxy API Apigee berdasarkan penilaian target Advanced API Security. Nilai ini diukur setidaknya sekali setiap 3 jam.	location, org, env, profile, target_server
Asosiasi Lingkungan Profil Keamanan Apigee API	Skor keamanan lingkungan Apigee: apigee.googleapis.com/security/environment_score	Skor keamanan total saat ini untuk lingkungan Apigee berdasarkan penilaian Advanced API Security terhadap sumber, proxy, dan target. Nilai ini diukur setidaknya sekali setiap 3 jam.	location, org, env, profile

Filter

Label Filter	Deskripsi
location	Lokasi resource: selalu global.
diagram	Nama organisasi Apigee
env	Nama lingkungan Apigee
profil	Nama profil Keamanan Apigee API
proxy	Nama proxy API Apigee
target_server	Nama server target Apigee
detection_rule	Nama aturan deteksi keamanan Apigee API