Deteksi penyalahgunaan

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Deteksi penyalahgunaan Advanced API Security memungkinkan Anda melihat insiden keamanan yang melibatkan API. Insiden keamanan adalah serangkaian 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 Advanced API Security 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 itu.

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

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

Membantu meningkatkan kualitas model machine learning Anda untuk mendeteksi penyalahgunaan

Apigee meminta bantuan Anda dalam meningkatkan kualitas model machine learning untuk deteksi penyalahgunaan di organisasi Anda, dengan mengizinkan kami melatih model berdasarkan data Anda. Melatih model pada data Anda akan membantu meningkatkan akurasinya dalam mendeteksi insiden keamanan. Pelatihan ini 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 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 detail selengkapnya. Jika Anda adalah pelanggan Bayar sesuai penggunaan, Anda dapat mengaktifkan add-on di lingkungan yang memenuhi syarat. Untuk 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 Keamanan API tingkat lanjut > Deteksi penyalahgunaan.
  • Jika Anda menggunakan UI Apigee klasik: Pilih Analyze > API Security > Abuse detection.

Tindakan ini akan menampilkan halaman Deteksi penyalahgunaan utama:

Halaman utama deteksi penyalahgunaan.

Mengubah izin untuk mengizinkan Apigee meningkatkan kualitas model machine learning Anda

Anda dapat mengubah izin untuk mengizinkan Apigee meningkatkan kualitas 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 Deteksi penyalahgunaan utama

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

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

Setiap baris tabel juga menampilkan hal berikut:

  • Lingkungan: Lingkungan tempat penyalahgunaan terjadi.
  • Total insiden: Total jumlah insiden di lingkungan selama interval waktu yang dipilih. Lihat Batasan 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: parah, sedang, dan rendah. Tingkat risiko didasarkan pada karakteristik insiden yang berbeda, seperti jumlah aturan yang terdeteksi, jenisnya, dan ukuran relatif insiden dibandingkan dengan traffic yang sah. Tingkat risiko dimaksudkan untuk membantu Anda memprioritaskan insiden mana yang harus diselidiki, sehingga Anda dapat berfokus pada insiden yang paling penting.

    Tingkat risiko dapat berupa salah satu dari hal berikut:

    • Berat: Insiden parah memiliki risiko tinggi. Sebaiknya Anda memprioritaskan menyelidiki masalah tersebut.
    • Sedang: Insiden sedang menimbulkan beberapa risiko, tetapi lebih kecil daripada insiden dengan risiko parah, dan sebaiknya Anda memprioritaskannya daripada insiden berisiko rendah.
    • Rendah: Insiden berisiko rendah dapat diselidiki terakhir, setelah Anda menyelidiki insiden berisiko yang lebih tinggi.

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

Detail lingkungan

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

Tampilan insiden.

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

Tampilan Environment details memiliki dua tab:

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

Insiden

Tab Incidents pada tampilan Environment details, yang ditunjukkan di atas, menampilkan opsi berikut:

  • Lingkungan: Mengubah lingkungan tempat melihat insiden.
  • Proxy: Anda dapat memilih All untuk menampilkan insiden untuk semua proxy, atau proxy individual untuk hanya menampilkan insiden untuk proxy yang dipilih.
  • Sertakan insiden yang diarsipkan: Jika dipilih, daftar insiden akan menampilkan insiden yang diarsipkan. Insiden yang diarsipkan ditampilkan dengan ikon di sampingnya: Ikon yang diarsipkan.

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

Tampilan Incidents juga menampilkan hal berikut:

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

  • Aturan deteksi: Daftar aturan deteksi 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 terakhir.
  • UUID: ID unik universal untuk insiden.

Detail insiden

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

Tampilan detail insiden.

Seperti dalam tampilan Environment details, Anda dapat mengklik Create Security Action di bagian atas halaman untuk membuat security action sebagai respons terhadap insiden.

Tampilan Insiden details memiliki dua tab, Overview dan Attributes. 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 Overview dan Attributes dijelaskan di bawah ini.

Insiden arsip

Untuk membantu membedakan insiden yang telah diselidiki dan yang belum, Anda dapat mengarsipkan insiden yang tidak lagi memerlukan perhatian Anda. Mengarsipkan insiden akan menyembunyikannya dari daftar Environment details > Incidents (disediakan bahwa Include arsip insiden tidak dipilih). Pengarsipan tidak menghapus insiden: Anda selalu dapat membatalkan pengarsipannya jika berubah pikiran.

Untuk mengarsipkan insiden, pilih Archive di bagian atas tampilan Incident details. Setelah Anda melakukannya, label tombol Arsip akan berubah menjadi Unarchive. Tombol Batalkan pengarsipan.

Batalkan pengarsipan insiden

Untuk membatalkan pengarsipan insiden yang diarsipkan:

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

Atau, jika Anda berada dalam tampilan Insiden details untuk insiden, klik Unarchive.

Tab Overview dan Attributes

Ringkasan

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

  • Insiden name: 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 terakhir.
  • Insight: Detail insiden deteksi penyalahgunaan dapat mencakup insight AI generatif yang dibuat menggunakan model bahasa besar (LLM) AI generatif Google Cloud. LLM merangkum traffic yang terdeteksi per insiden untuk membantu Anda lebih memahami insiden keamanan, memberikan konteks dan informasi tambahan tentang insiden tersebut, link ke dokumentasi pendukung, serta merekomendasikan langkah selanjutnya. Berikan masukan Anda dengan mengklik ikon suka atau tidak suka dan memberikan penjelasan opsional.

    Rekomendasi dan ringkasan insight didasarkan pada data 14 hari terakhir, meskipun insiden dimulai lebih dari 14 hari yang lalu.
    Insight AI generatif ini otomatis disertakan dalam deteksi penyalahgunaan jika project dan akun pengguna Anda disiapkan untuk menggunakan Cloud AI Companion API. Lihat Mengaktifkan Cloud AI Companion API dalam 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 di 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 di sekitar waktu tersebut. Jika Anda mengarahkan kursor ke titik dalam grafik, jumlah peristiwa dalam jangka waktu terakhir ditampilkan di bawah Nilai. Anda dapat melihat nilai yang jangka waktu berubah dengan menggerakkan kursor ke kiri atau kanan, lalu mengamati di mana nilai berubah.

    Panel Events juga menampilkan informasi berikut tentang peristiwa:

    • Peristiwa pertama terdeteksi: Tanggal dan waktu peristiwa pertama dalam insiden terdeteksi.
    • Peristiwa terakhir terdeteksi: Tanggal dan waktu peristiwa terakhir dalam insiden terdeteksi.
    • Total traffic insiden: Total jumlah peristiwa yang terkait dengan insiden.

    Untuk melihat alamat IP yang terkait dengan insiden, klik Lihat Semua Alamat IP.

    Catatan: Tindakan ini akan menampilkan alamat IP yang unik, meskipun lebih dari satu insiden sesuai dengan alamat IP yang sama.
  • Aturan teratas yang terdeteksi: Menampilkan hingga lima grup aturan teratas yang terdeteksi, termasuk informasi berikut:
    • Aturan dominan: Aturan deteksi paling signifikan yang dipicu oleh insiden.
    • Peristiwa Dominant rules API: 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 menampilkan negara yang menjadi sumber peristiwa dalam insiden tersebut. Di bawah peta terdapat diagram yang menampilkan hingga lima negara tersebut dan persentase total traffic yang berasal dari negara-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.

Atribut

Tampilan Attributes memungkinkan Anda melihat perincian detail insiden. 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 Attributes, pilih Attributes di bagian atas tampilan Incident details.

Panel atribut dengan produk API dipilih.

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 Attributes dengan API Products dipilih. Panel API Products menampilkan grafik persentase panggilan API yang dilakukan untuk setiap produk API. Lihat Apa artinya jika suatu atribut memiliki nilai (not set) untuk informasi tentang nilai (not set).

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

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

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

Untuk beberapa atribut, tabel memiliki kolom tambahan.

Anda dapat memilih dari atribut berikut di panel sebelah kiri:

  • Produk API: Lihat detail insiden berdasarkan produk API.
  • Kunci aplikasi: Melihat detail insiden berdasarkan kunci aplikasi—juga dikenal sebagai kunci API atau kunci konsumen—ID untuk klien.
  • Negara/Wilayah: Melihat detail insiden menurut negara dan wilayah tempat peristiwa dalam insiden berasal.
  • Developer: Lihat detail insiden menurut developer— orang-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: Lihat detail insiden berdasarkan aplikasi.

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

  • Alamat IP: Lihat detail insiden menurut alamat IP yang merupakan sumber peristiwa dalam insiden. Klik Lihat Semua Alamat IP untuk melihat alamat IP. Catatan: Panel Alamat IP menampilkan alamat IP yang unik, meskipun lebih dari satu insiden sesuai dengan alamat IP yang sama.

    Alamat IP menampilkan kolom berikut:

    • Alamat IP: Alamat IP untuk insiden.
    • Lokasi: Lokasi alamat IP.
    • Traffic yang terdeteksi: Jumlah total permintaan dari alamat IP.
    • % of call: Persentase permintaan dari alamat IP dari semua panggilan di lingkungan.
    • Peristiwa pertama terdeteksi: Saat pertama kali peristiwa terdeteksi dalam insiden.
    • Peristiwa terakhir terdeteksi: Terakhir kali peristiwa terdeteksi dalam insiden.
  • Proxy: Melihat detail insiden menurut proxy.
  • Kode respons: Melihat detail insiden berdasarkan kode respons.
  • Aturan: Lihat detail insiden berdasarkan aturan deteksi.
  • Agen pengguna: Melihat detail insiden berdasarkan 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. Salah satunya, 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 mengetahui informasi selengkapnya.

Traffic yang terdeteksi

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

Untuk membuka tampilan Detected Traffic, pilih Detected Traffic di tampilan Environment details, seperti yang ditunjukkan di bawah ini:

Tampilan penyalahgunaan.

Tampilan Traffic Terdeteksi menampilkan data untuk:

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

Tampilan Detected Traffic juga menampilkan tabel yang mencantumkan detail setiap alamat IP yang terkait dengan penyalahgunaan yang terdeteksi. Perlu diperhatikan bahwa secara default, alamat IP tidak ditampilkan karena alasan privasi. Untuk melihatnya, pilih Display all IP addresses 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 teratas: 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 terdeteksi: Saat pertama kali peristiwa terdeteksi dalam permintaan dari alamat IP selama rentang waktu yang dipilih di bagian atas halaman Skor Keamanan untuk pertama kalinya.
  • Peristiwa terakhir terdeteksi: Terakhir kali peristiwa terdeteksi dalam permintaan dari alamat IP selama rentang waktu yang dipilih di bagian atas halaman Skor Keamanan.

Pembatasan deteksi penyalahgunaan

Deteksi penyalahgunaan memiliki batasan berikut.

  • Insiden yang Peristiwa terakhir terdeteksi lebih dari 14 hari sebelumnya tidak ditampilkan di UI Deteksi penyalahgunaan. Lihat Batasan 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 ke dalam insiden. Setelah itu, akan ada penundaan secara berkala.
  • Halaman atribut Detail insiden dapat memerlukan waktu singkat untuk dimuat bagi organisasi dengan jumlah traffic yang besar.