Deteksi penyalahgunaan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Pratinjau — Advanced API Security Abuse Detection

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 Advanced API Security Abuse Detection tersedia melalui forum Apigee - Google Cloud Community.

Deteksi penyalahgunaan Advanced API Security memungkinkan Anda melihat insiden keamanan yang melibatkan API Anda. Insiden keamanan adalah sekelompok peristiwa dengan pola serupa yang dapat mewakili ancaman keamanan. Advanced API Security menggunakan model machine learning untuk mendeteksi pola yang merupakan tanda aktivitas berbahaya, termasuk scraping dan anomali API, serta mengelompokkan peristiwa berdasarkan pola yang serupa.

Saat mendeteksi insiden keamanan, Advanced API Security akan melaporkan hal berikut:

• Tingkat risiko dan durasi insiden
• Proxy yang terpengaruh oleh insiden
• Alamat IP peristiwa insiden
• Aturan deteksi yang dipicu oleh insiden
• Negara asal insiden

dan informasi terkait lainnya tentang insiden tersebut.

Anda dapat mengakses deteksi penyalahgunaan melalui UI Apigee, seperti yang dijelaskan di bawah, atau melalui Incidents API atau Security stats API

Lihat Peran yang diperlukan untuk deteksi penyalahgunaan untuk mengetahui peran yang diperlukan untuk melakukan tugas deteksi penyalahgunaan.

Membantu meningkatkan kualitas model machine learning Anda untuk deteksi penyalahgunaan

Apigee meminta bantuan Anda dalam meningkatkan model machine learning untuk deteksi penyalahgunaan di organisasi Anda, dengan mengizinkan kami melatih model tersebut menggunakan data Anda. Melatih model pada data Anda akan membantu meningkatkan akurasinya untuk mendeteksi insiden keamanan. Pelatihan hanya akan berlaku untuk model Anda, dan tidak akan dibagikan kepada pelanggan Google Cloud lainnya.

Saat pertama kali membuka halaman Deteksi penyalahgunaan di UI Apigee, Anda akan melihat banner yang meminta izin Anda untuk melatih model keamanan organisasi Anda pada data Anda.

Untuk menggunakan fitur ini, Anda harus mengaktifkan add-on. Jika Anda adalah pelanggan Langganan, Anda dapat mengaktifkan add-on untuk organisasi Anda. Lihat Mengelola Keamanan API Lanjutan untuk organisasi Langganan untuk mengetahui detail selengkapnya. Jika Anda adalah pelanggan Bayar sesuai penggunaan, Anda dapat mengaktifkan add-on di lingkungan yang memenuhi syarat. Untuk mengetahui informasi selengkapnya, lihat Mengelola add-on Advanced API Security.

Buka halaman Deteksi penyalahgunaan

Untuk membuka halaman Deteksi penyalahgunaan:

• Jika Anda menggunakan UI Apigee di Cloud Console: Pilih Advanced API security > Abuse detection.
• Jika Anda menggunakan UI Apigee klasik: Pilih Analyze > API Security > Abuse detection.

Tindakan ini akan menampilkan halaman utama Deteksi penyalahgunaan:

Catatan: Saat pertama kali membuka halaman Deteksi penyalahgunaan, Anda akan melihat banner yang meminta izin untuk melatih model keamanan organisasi Anda pada data Anda. Jika Anda setuju, klik Aktifkan peningkatan model Advanced API Security organisasi Apigee saya di bawah banner.

Mengubah izin untuk mengizinkan Apigee meningkatkan kualitas model machine learning Anda

Anda dapat mengubah izin untuk mengizinkan Apigee meningkatkan model machine learning Anda kapan saja, dengan mengklik Setelan di kanan atas halaman Deteksi penyalahgunaan dan memilih opsi untuk mengaktifkan atau menonaktifkan fitur ini.

Halaman utama Deteksi penyalahgunaan

Di bagian atas halaman, Anda dapat memilih salah satu jangka waktu terbaru berikut untuk melihat insiden: 12 jam, 1 hari, 1 minggu, atau 2 minggu.

Tabel di halaman menampilkan lingkungan di organisasi Anda yang terpengaruh oleh insiden keamanan selama interval waktu yang dipilih.

Catatan: Jika tidak ada lingkungan yang ditampilkan, artinya tidak ada insiden yang terdeteksi di lingkungan mana pun dalam interval waktu yang dipilih. Dalam hal ini, Anda dapat mencoba memilih interval waktu yang lebih lama, yang dapat mencakup hingga 14 hari yang lalu.

Setiap baris tabel juga menampilkan hal berikut:

• Lingkungan: Lingkungan tempat penyalahgunaan terjadi.
• Total insiden: Jumlah total insiden di lingkungan selama interval waktu yang dipilih. Lihat Batasan pada insiden dan data yang ditampilkan untuk mengetahui informasi selengkapnya tentang insiden dan data yang ditampilkan di UI.

• Tingkat risiko: Menampilkan jumlah insiden pada tiga tingkat risiko: berat, sedang, dan rendah. Tingkat risiko didasarkan pada berbagai karakteristik insiden, seperti jumlah aturan yang terdeteksi, jenisnya, dan ukuran insiden yang relatif dibandingkan dengan traffic yang sah. Tingkat risiko dimaksudkan untuk membantu Anda memprioritaskan insiden yang akan diselidiki, sehingga Anda dapat berfokus pada insiden yang paling penting.

  Tingkat risiko dapat berupa salah satu dari berikut:

  • Serius: Insiden serius menimbulkan risiko tinggi. Sebaiknya Anda memprioritaskan penyelidikannya.
  • Sedang: Insiden sedang menimbulkan beberapa risiko, tetapi lebih rendah daripada insiden dengan risiko berat, dan sebaiknya Anda memprioritaskannya daripada insiden dengan risiko rendah.
  • Rendah: Insiden berisiko rendah dapat diselidiki terakhir, setelah Anda menyelidiki insiden berisiko lebih tinggi.

  Angka di samping setiap tingkat risiko menunjukkan jumlah insiden pada tingkat risiko tersebut.

Detail lingkungan

Untuk melihat insiden di lingkungan untuk rentang waktu yang dipilih, pilih lingkungan dalam tabel yang ditampilkan di atas. Tindakan ini akan membuka tampilan Detail lingkungan:

Jika Anda melihat insiden atau traffic yang terdeteksi, dan ingin membuat tindakan keamanan untuk memblokir atau menandai permintaan yang terkait dengan insiden atau traffic yang terdeteksi, klik Buat Tindakan Keamanan di bagian atas halaman. Tindakan ini akan membuka halaman Tindakan keamanan.

Batasan pada insiden dan data yang ditampilkan:

• UI Deteksi penyalahgunaan tidak menampilkan insiden yang Peristiwa terakhir terdeteksi terjadi lebih dari 14 hari yang lalu.
• UI hanya menampilkan data insiden yang diterima setelah 14 hari sebelumnya.

Untuk mendapatkan informasi tambahan tentang insiden ini, Anda dapat melakukan salah satu hal berikut:

1. Panggil Incidents API untuk mendapatkan daftar insiden di luar rentang 14 hari.
2. Panggil Security reports API untuk mengumpulkan detail selengkapnya tentang insiden tersebut.

Tampilan Detail lingkungan memiliki dua tab:

• Insiden: Menampilkan daftar insiden di lingkungan dan informasi tentang insiden tersebut.
• Traffic terdeteksi: Menampilkan detail traffic penyalahgunaan yang terdeteksi dan terkait dengan insiden.

Insiden

Tab Insiden pada tampilan Detail lingkungan, yang ditampilkan di atas, menampilkan opsi berikut:

• Lingkungan: Ubah lingkungan tempat melihat insiden.
• Proxy: Anda dapat menggunakan Pilih semua untuk menampilkan insiden untuk semua proxy, atau memilih satu atau beberapa proxy untuk menampilkan insiden hanya untuk proxy yang dipilih.
• Sertakan insiden yang diarsipkan: Jika opsi ini dipilih, daftar insiden akan menampilkan insiden yang diarsipkan. Insiden yang diarsipkan ditampilkan dengan ikon di sampingnya:

  Untuk menyembunyikan insiden yang diarsipkan dari daftar, batalkan pilihan Sertakan insiden yang diarsipkan. Anda mungkin ingin menyembunyikan insiden yang diarsipkan jika ada banyak insiden yang ditampilkan dan Anda tidak ingin melihat semuanya, atau jika Anda ingin menyembunyikan insiden yang telah Anda selidiki.

Tampilan Insiden juga menampilkan hal berikut:

• Nama insiden: Nama yang dibuat untuk meringkas insiden.
• Tingkat risiko: Tingkat risiko insiden.

• Aturan deteksi teratas: Daftar aturan deteksi teratas yang dipicu oleh insiden.

• Traffic insiden: Jumlah total peristiwa: Panggilan API yang diberi tag oleh salah satu aturan deteksi yang terkait dengan insiden.
• Peristiwa pertama terdeteksi: Tanggal dan waktu peristiwa pertama dalam insiden terdeteksi.
• Peristiwa terakhir terdeteksi: Tanggal dan waktu peristiwa terakhir dalam insiden terdeteksi.
• Durasi: Durasi insiden, dari peristiwa pertama hingga peristiwa terakhir.
• UUID: ID unik universal insiden.

Detail insiden

Untuk melihat detail insiden, klik namanya dalam tabel. Tindakan ini akan menampilkan panel Ringkasan dari tampilan Detail insiden, seperti yang ditunjukkan di bawah:

Seperti pada tampilan Detail lingkungan, Anda dapat mengklik Buat Tindakan Keamanan di bagian atas halaman untuk membuat tindakan keamanan sebagai respons terhadap insiden.

Tampilan Detail insiden memiliki dua tab, Ringkasan dan Atribut. Atribut—juga dikenal sebagai dimensi—adalah pengelompokan data yang memungkinkan Anda melihat insiden dengan cara yang berbeda. Misalnya, atribut produk API memungkinkan Anda melihat data insiden menurut produk API.

Tab Ringkasan dan Atribut dijelaskan di bawah.

Mengarsipkan insiden

Untuk membantu Anda membedakan antara insiden yang telah diselidiki dengan insiden yang belum, Anda dapat mengarsipkan insiden yang tidak lagi memerlukan perhatian Anda. Mengarsipkan insiden akan menyembunyikannya dari daftar Detail lingkungan > Insiden (asalkan Sertakan insiden yang diarsipkan tidak dipilih). Mengarsipkan tidak akan menghapus insiden: Anda dapat membatalkan pengarsipan kapan saja jika berubah pikiran.

Untuk mengarsipkan insiden, pilih Arsipkan di bagian atas tampilan Detail insiden. Setelah Anda melakukannya, label tombol Arsipkan akan berubah menjadi Batalkan arsip.

Membatalkan pengarsipan insiden

Untuk membatalkan pengarsipan insiden yang diarsipkan:

1. Pada tampilan Environment details > Incidents, klik ikon di samping insiden yang ingin Anda batalkan pengarsipannya:
2. Di bagian atas daftar insiden, klik Batalkan pengarsipan.

Atau, jika Anda berada di tampilan Detail insiden untuk insiden tersebut, klik Batalkan pengarsipan.

Tab Ringkasan dan Atribut

Ringkasan

Panel Ringkasan menampilkan informasi dasar tentang insiden, termasuk hal berikut:

• Nama insiden: Nama insiden.
• Tingkat risiko: Tingkat risiko insiden.
• Proxy yang terpengaruh: Jumlah proxy yang terpengaruh oleh insiden. Klik Lihat proxy untuk melihat proxy yang terpengaruh.
• Durasi: Durasi insiden, dari peristiwa pertama hingga peristiwa terakhir. Tabel ini juga menampilkan tanggal dan waktu saat peristiwa pertama kali terdeteksi.
• Alamat IP: Jumlah alamat IP unik yang terdeteksi untuk insiden ini. Klik Lihat alamat IP untuk melihat informasi selengkapnya tentang alamat IP.
• Insight: Detail insiden deteksi penyalahgunaan mungkin mencakup insight AI generatif yang dibuat menggunakan model bahasa besar (LLM) AI generatif Google Cloud. LLM meringkas traffic yang terdeteksi per insiden untuk membantu Anda lebih memahami insiden keamanan, memberikan konteks dan informasi tambahan tentang insiden, link ke dokumentasi pendukung, dan merekomendasikan langkah berikutnya. Berikan masukan Anda dengan mengklik ikon suka atau tidak suka dan memberikan penjelasan opsional.
  
  Ringkasan dan rekomendasi insight didasarkan pada data 14 hari terakhir, meskipun insiden dimulai lebih dari 14 hari yang lalu.
  
  Perhatian: Gunakan Insight dengan hati-hati. Insight mungkin tidak akurat atau lengkap.
  Insight AI generatif ini disertakan secara otomatis dalam deteksi penyalahgunaan jika project dan akun pengguna Anda disiapkan untuk menggunakan Cloud AI Companion API. Lihat Mengaktifkan Cloud AI Companion API di project Google Cloud dan Memberikan peran IAM di project Google Cloud.
  
  Untuk menonaktifkan insight AI generatif, nonaktifkan Cloud AI Companion API untuk project ini dengan mengikuti petunjuk dalam artikel Menonaktifkan layanan.
• Peristiwa: Menampilkan grafik deret waktu peristiwa dalam insiden. Untuk setiap titik waktu dalam grafik, nilai y yang sesuai adalah jumlah total peristiwa dalam jangka waktu singkat sekitar waktu tersebut. Jika Anda mengarahkan kursor ke titik dalam grafik, jumlah peristiwa dalam jangka waktu terbaru akan ditampilkan di bawah Nilai. Anda dapat melihat nilai saat jangka waktu berubah dengan memindahkan kursor ke kiri atau kanan dan mengamati tempat nilai berubah.

  Panel Peristiwa juga menampilkan total jumlah traffic lingkungan dan insiden.

• Aturan teratas yang terdeteksi: Menampilkan hingga lima grup aturan teratas yang terdeteksi, termasuk informasi berikut:
  • Aturan dominan: Aturan deteksi yang paling signifikan yang dipicu oleh insiden.
  • Peristiwa API aturan dominan: Jumlah peristiwa API yang diberi tag oleh aturan dominan.
  • Total aturan yang terdeteksi: Jumlah aturan deteksi yang dipicu oleh insiden.

  Untuk melihat semua aturan, klik Lihat Semua Aturan di bagian bawah kartu.

• Negara teratas yang terdeteksi: Peta yang menunjukkan negara yang menjadi sumber peristiwa dalam insiden. Di bawah peta terdapat diagram yang menampilkan hingga lima negara tersebut dan persentase total traffic yang berasal dari negara tersebut.

  Catatan: Jika negara asal peristiwa tidak dapat ditentukan, peta akan menampilkan not set.

  Untuk melihat semua negara, klik Lihat Semua Negara di bagian bawah kartu.

• Alamat IP: Melihat detail insiden berdasarkan alamat IP sumber untuk peristiwa dalam insiden. Pilih Tampilkan semua alamat IP untuk melihat semua alamat IP dalam daftar. Untuk mendownload file CSV yang berisi alamat IP traffic yang terdeteksi, klik Download File CSV. Catatan: Panel Alamat IP menampilkan alamat IP unik, meskipun lebih dari satu insiden sesuai dengan alamat IP yang sama.

  Alamat IP menampilkan kolom berikut:

  • Alamat IP: Alamat IP untuk insiden. Klik Lihat jika alamat IP tidak terlihat. Setelah alamat IP ditampilkan, klik alamat tersebut untuk melihat aturan yang terdeteksi, tanggal deteksi pertama dan terakhir, traffic, serta atribut untuk insiden yang terlihat dengan alamat IP tersebut.
  • Lokasi: Lokasi alamat IP.
  • Traffic yang terdeteksi: Total jumlah permintaan dari alamat IP.
  • % panggilan: Persentase permintaan dari alamat IP dari semua panggilan di lingkungan.
  • Peristiwa pertama yang terdeteksi: Pertama kali peristiwa terdeteksi dalam insiden.
  • Peristiwa terakhir yang terdeteksi: Waktu terakhir peristiwa terdeteksi dalam insiden.

Atribut

Tampilan Atribut memungkinkan Anda melihat perincian insiden secara mendetail. Atribut—juga dikenal sebagai dimensi— adalah pengelompokan data yang memungkinkan Anda melihat insiden dengan cara yang berbeda. Misalnya, atribut produk API memungkinkan Anda melihat data insiden menurut produk API.

Untuk melihat Atribut, pilih Atribut di bagian atas tampilan Detail insiden.

Panel kiri menampilkan semua atribut dan jumlah nilai yang berbeda untuk setiap atribut. Anda dapat memilih atribut untuk melihat detail insidennya.

Gambar di atas menunjukkan tampilan Atribut dengan Negara/Wilayah dipilih. Panel Negara/Wilayah menampilkan grafik persentase panggilan API yang dilakukan untuk setiap wilayah.

Lihat Arti jika atribut memiliki nilai (not set) jika Anda melihat (not set) untuk nilai apa pun.

Kolom Filter memungkinkan Anda memfilter data yang ditampilkan di panel untuk atribut menurut berbagai properti.

Secara umum, panel untuk atribut menampilkan tabel yang menunjukkan data insiden berdasarkan nilai atribut. Kolom tabel mencakup:

• Total panggilan yang dilakukan: Jumlah total panggilan API.
• % panggilan: Persentase semua panggilan untuk setiap nilai atribut.
• Waktu deteksi terakhir: Waktu terakhir peristiwa yang terkait dengan insiden terdeteksi.

Untuk beberapa atribut, tabel memiliki kolom tambahan.

Anda dapat memilih dari atribut berikut di panel kiri:

• Produk API: Lihat detail insiden menurut produk API.
• Kunci aplikasi: Melihat detail insiden menurut kunci aplikasi—juga dikenal sebagai kunci API atau kunci konsumen—yang merupakan ID untuk klien.
• Negara/Wilayah: Melihat detail insiden berdasarkan negara dan wilayah tempat peristiwa dalam insiden berasal.
• Developer: Melihat detail insiden menurut developer—orang yang menggunakan API Anda untuk mengembangkan aplikasi. Selain tiga kolom yang dijelaskan di atas, Developer juga memiliki kolom berlabel Aplikasi, yang memberikan jumlah aplikasi untuk setiap developer.
• Aplikasi developer: Melihat detail insiden menurut aplikasi.

  Selain tiga kolom yang dijelaskan di atas, Aplikasi developer juga memiliki kolom Developer, yaitu orang yang membuat aplikasi.

• Proxy: Melihat detail insiden menurut proxy.
• Kode respons: Melihat detail insiden menurut kode respons.
• Aturan: Melihat detail insiden menurut aturan deteksi.
• Agen pengguna: Melihat detail insiden menurut agen pengguna—agen software yang melakukan panggilan API.

Apa artinya jika atribut memiliki nilai (not set)?

Terkadang, atribut memiliki nilai (not set). Ada beberapa alasan mengapa hal ini dapat terjadi. Pertama, Apigee mungkin tidak memiliki cukup informasi untuk menentukan nilai atribut—misalnya, negara asal panggilan API. Atau, atribut mungkin tidak berlaku dalam kasus tertentu. Lihat Apa yang dimaksud dengan nilai entitas analisis "(not set)"? untuk informasi selengkapnya.

Traffic terdeteksi

Tampilan Traffic yang Terdeteksi menampilkan informasi tentang insiden yang Peristiwa terakhir yang terdeteksi terjadi dalam 14 hari terakhir. Lihat Batasan pada insiden dan data yang ditampilkan untuk mengetahui informasi selengkapnya tentang rentang waktu data yang ditampilkan di UI.

Untuk membuka tampilan Traffic yang Terdeteksi, pilih Traffic yang Terdeteksi di tampilan Detail lingkungan, seperti yang ditunjukkan di bawah:

Tampilan Traffic yang Terdeteksi menampilkan data untuk:

• Total traffic: Jumlah total permintaan.
• Traffic terdeteksi: Jumlah permintaan dari alamat IP penyalahgunaan yang terdeteksi.
• % traffic terdeteksi: Persentase traffic terdeteksi dari total traffic.
• Jumlah alamat IP yang terdeteksi: Jumlah alamat IP berbeda yang sesuai dengan penyalahgunaan yang terdeteksi. Beberapa permintaan dari alamat IP yang sama hanya dihitung sekali.

Tampilan Traffic yang Terdeteksi juga menampilkan tabel yang mencantumkan detail setiap alamat IP yang sesuai dengan penyalahgunaan yang terdeteksi. Perhatikan bahwa secara default, alamat IP tidak ditampilkan karena alasan privasi. Untuk melihatnya, pilih Tampilkan semua alamat IP di bagian atas tabel.

Setiap baris tabel alamat IP menampilkan:

• Alamat IP: Alamat IP penyalahgunaan yang terdeteksi. Klik Lihat untuk melihat alamat.
• Lokasi: Lokasi alamat IP.
• Kunci aplikasi teratas: Kunci aplikasi yang paling sering digunakan dalam permintaan dari alamat IP. Catatan: kunci aplikasi adalah istilah lain untuk kunci API.
• Aturan deteksi: Daftar semua aturan deteksi yang dipicu oleh penyalahgunaan.
• URL Terbaik: URL yang menerima permintaan terbanyak dari alamat IP.
• Traffic yang terdeteksi: Jumlah permintaan dari alamat IP.
• % traffic yang terdeteksi: Persentase permintaan dari alamat IP dari semua permintaan di lingkungan.
• Peristiwa pertama yang terdeteksi: Pertama kali peristiwa terdeteksi dalam permintaan dari alamat IP selama rentang waktu yang dipilih di bagian atas halaman Skor Keamanan.
• Peristiwa terakhir yang terdeteksi: Waktu terakhir peristiwa terdeteksi dalam permintaan dari alamat IP selama rentang waktu yang dipilih di bagian atas halaman Skor Keamanan.

Batasan pada deteksi penyalahgunaan

Deteksi penyalahgunaan memiliki batasan berikut.

• Insiden yang Peristiwa terakhir terdeteksi-nya lebih dari 14 hari yang lalu tidak akan ditampilkan di UI Deteksi penyalahgunaan. Lihat Batasan pada insiden dan data yang ditampilkan untuk mengetahui informasi selengkapnya tentang insiden dan data yang ditampilkan di UI.
• Saat Anda pertama kali mengaktifkan Advanced API untuk organisasi, atau mengaktifkannya kembali, akan ada penundaan saat peristiwa dikelompokkan menjadi insiden. Setelah itu, akan ada penundaan berkala.
• Halaman atribut Detail insiden dapat memerlukan waktu singkat untuk dimuat bagi organisasi dengan traffic dalam jumlah besar.