Skip to main content

Investigasi kebocoran kunci API

Alur investigasi setelah kunci API diduga bocor: temukan dan tangani kunci yang bocor untuk membatasi kerugian, periksa penggunaan dan biaya untuk mengunci periode anomali, periksa log audit dan log inferensi untuk mengonfirmasi perilaku pemanggilan, verifikasi operasi manajemen melalui ActionTrail, lalu selesaikan penilaian kerugian, pengumpulan bukti, serta rotasi dan pemulihan.

Pendekatan investigasi

Jika kebocoran telah dikonfirmasi, buka halaman manajemen kunci API terlebih dahulu dan atur ulang atau hapus kunci yang bocor untuk segera membatasi kerugian, lalu ikuti langkah-langkah di halaman ini untuk menilai dampaknya; jika kebocoran belum pasti, mulailah dari pemeriksaan penggunaan pada langkah kedua. Investigasi kebocoran harus menjawab lima pertanyaan, dan setiap pertanyaan dipetakan ke satu sumber informasi konsol:

Pertanyaan yang harus dijawab

Tempat mencari

Apa yang Anda dapatkan

Kunci mana yang bocor? Siapa yang membuatnya? Bagaimana statusnya sekarang?

Halaman manajemen kunci API

ID kunci, kunci tersamar, deskripsi, akun pemilik, waktu pembuatan; aksi atur ulang, edit, hapus, dan lihat biaya

Seberapa banyak kunci ini dipanggil, dan berapa biayanya?

Penggunaan model, ikhtisar biaya, dan tagihan

Jumlah pemanggilan, penggunaan token, kurva penggunaan per hari, dan jumlah yang dikelompokkan berdasarkan kunci API

Dari mana pemanggilan berasal, model apa yang dipanggil, dan apakah berhasil?

Log audit

Request ID, waktu, model, penggunaan token, latensi, kode status, dan kode kesalahan; dapat difilter berdasarkan kunci API

Apa input dan output pemanggilan tersebut?

Log inferensi (harus diaktifkan terlebih dahulu)

Prompt dan respons lengkap (hingga 128K)

Operasi manajemen apa saja yang telah dialami kunci ini?

ActionTrail

Catatan peristiwa operasi di tingkat konsol dan OpenAPI

Lanjutkan dalam urutan berikut:
Suspected leak
  ├─ Step 1: locate the key and immediately reset or delete it (containment)
  ├─ Step 2: identify anomalous periods from usage and cost curves
  ├─ Step 3: confirm call sources and behavior in audit logs (input and output available if inference logs were enabled)
  ├─ Step 4: review management operations such as key creation and deletion
  └─ Step 5: summarize the damage, rotate credentials, and fix the leak source

Langkah 1: Temukan dan tangani kunci yang bocor

Buka halaman Kunci API Alibaba Cloud Model Studio dan pilih wilayah di pojok kanan atas: kunci bersifat independen per wilayah dan tidak dapat digunakan lintas wilayah. Saat kebocoran dikonfirmasi, utamakan mengatur ulang atau menghapus kunci tersebut untuk segera membatasi kerugian; mengedit untuk mempersempit izin hanya cocok untuk situasi ketika kebocoran belum dapat dikonfirmasi dan Anda memerlukan masa observasi. Temukan kunci target dalam daftar kunci API dan gunakan aksi di kolom operasinya:
  • Atur ulang: menerbitkan nilai baru untuk kunci, dan nilai lama langsung berhenti berlaku.
  • Edit: mempersempit izin (whitelist IP, cakupan model); lihat Praktik terbaik pencegahan kebocoran kunci API.
  • Hapus: berlaku seketika dan tidak dapat dipulihkan.
  • Lihat biaya: melompat ke tampilan biaya dan penggunaan kunci tersebut.
Halaman ini menampilkan informasi identitas kunci: ID kunci, kunci API tersamar (misalnya sk-ws-H.YHXL****PgonKozeC4RM-Nm), deskripsi, akun pemilik, dan waktu pembuatan. Deskripsi dan akun pemilik adalah petunjuk pertama untuk mengetahui aplikasi atau penanggung jawab kunci; teks biasa lengkap umumnya tidak dapat dilihat: kunci versi baru hanya ditampilkan lengkap satu kali saat pembuatan, sementara sebagian kunci versi lama masih dapat disalin langsung dari daftar, bergantung pada kemampuan yang benar-benar disediakan daftar tersebut. Untuk identifikasi, gunakan nilai tersamar, ID, dan deskripsi.
Menghapus kunci tidak membatalkan tugas asinkron yang sudah terkait: tugas asinkron yang belum selesai akan terus berjalan dan menimbulkan biaya, serta harus dihentikan secara terpisah; lihat Penagihan tunggakan untuk tugas asinkron. Selama investigasi, Anda juga dapat mengaktifkan "hentikan segera saat anggaran tercapai" pada anggaran kunci tersebut sebagai pembatasan kerugian kedua; lihat Manajemen anggaran.
Dua kesalahan umum yang harus dihindari saat menangani insiden ini:
  1. Sekadar membuat kunci baru tidak otomatis membatalkan kunci lama; kunci lama harus ditangani secara terpisah.
  2. Jangan menempatkan kunci baru kembali ke lingkungan yang mencurigakan dan belum selesai diinvestigasi, atau Anda menyerahkan kembali kredensial baru tersebut.

Langkah 2: Periksa penggunaan dan biaya untuk mengunci periode anomali

Sinyal kebocoran yang paling langsung adalah pemanggilan atau biaya yang seharusnya tidak ada. Di konsol Model Studio, buka Biaya dan Penggunaan > Penggunaan Model, tetapkan dimensi pengelompokan ke Kunci API, lalu bandingkan penggunaan setiap kunci untuk langsung melihat kunci mana yang anomali:
  • Granularitas waktu: menit (hingga 1 hari), jam (hingga 7 hari), hari (hingga 31 hari), dan bulan (hingga 12 bulan); gunakan granularitas jam untuk menemukan pemanggilan mendadak berbiaya tinggi.
  • Penundaan data: jumlah pemanggilan tertunda kurang dari 1 menit, penggunaan token dan biaya sekitar 10 menit; penyalahgunaan yang baru terjadi mungkin baru muncul nanti, jangan singkirkan kecurigaan hanya karena data belum tampil.
  • Baris detail menawarkan Lihat biaya untuk jumlah terkait; untuk ikhtisar biaya dan akuntansi tagihan, lihat Lihat ikhtisar penagihan dan Kueri tagihan.
Untuk definisi metrik dan detail operasi, lihat Lihat penggunaan model. Singkirkan dulu fluktuasi bisnis normal: bandingkan waktu, model, dan volume pemanggilan yang anomali dengan rilis, pekerjaan batch, uji beban, dan tugas terjadwal bisnis, serta periksa apakah wilayah deployment layanan, IP egress, atau alat pihak ketiga yang menggunakan kunci tersebut berubah. IP luar negeri, IP baru, dan lonjakan penggunaan adalah sinyal yang perlu diverifikasi, bukan bukti final kebocoran. Sesuaikan besaran respons dengan tingkat kecurigaan: untuk sekadar notifikasi peringatan atau anomali ringan, periksa sumber pemanggilan di log audit terlebih dahulu; setelah kurva penggunaan mengonfirmasi pemanggilan dari sumber asing, segera atur ulang atau hapus kunci tersebut lalu lanjutkan pengumpulan bukti. Dengan waktu konfirmasi kebocoran sebagai titik akhir, lihat mundur 7 hari (granularitas jam) dan 31 hari (granularitas hari) untuk membandingkan garis dasar historis kunci; rentang waktu anomali yang terkunci menentukan cakupan investigasi log berikutnya.

Langkah 3: Periksa log pemanggilan untuk mengonfirmasi perilaku pemanggilan

Log pemanggilan Model Studio terbagi menjadi dua kategori, log audit dan log inferensi, dengan batasan kemampuan yang berbeda; bedakan keduanya saat investigasi.

Log audit

Log audit aktif secara default dan tersimpan di sisi platform tanpa konfigurasi, menjadikannya alat investigasi utama; lihat di halaman pemantauan model:
  • Field yang dicatat: Request ID, waktu, model, penggunaan token, latensi, status, dan kode kesalahan, tanpa konten input dan output.
  • Filter dan pencarian: filter berdasarkan waktu (hingga 30 hari), model, ID kunci API, status, dan tipe inferensi, atau cari berdasarkan Request ID.
  • Kegunaan: mengonfirmasi apakah pemanggilan kunci dalam rentang kebocoran berasal dari perilaku yang diharapkan, misalnya volume besar 4xx/5xx, ritme pemanggilan yang tidak wajar, atau catatan pemanggilan model yang tidak dikenal.
Untuk cara penggunaan, lihat Logging.

Log inferensi

Log inferensi memuat prompt dan respons lengkap beserta langkah antara (hingga 128K), harus diaktifkan terlebih dahulu di pengiriman data dan dikirim ke layanan log milik Anda sendiri (SLS; pengaktifan melibatkan otorisasi produk cloud dan biaya layanan log), serta hanya berlaku untuk data mendatang: pemanggilan historis sebelum pengaktifan tidak dapat ditelusuri, dan log yang dihasilkan selama pengiriman mati tidak diisi kembali. Untuk cara mengaktifkan dan ketersediaan wilayah, lihat Aktifkan log inferensi. Tanpa log inferensi, pemanggilan sebelumnya hanya dapat diinvestigasi melalui informasi tingkat field di log audit.

Batasan penelusuran

Platform dapat membantu memverifikasi perilaku anomali berdasarkan log pemanggilan, tetapi informasi IP, model, dan waktu pemanggilan umumnya tidak cukup untuk mengonfirmasi langsung pengguna sebenarnya atau kanal kebocoran awal; penelusuran lebih lanjut memerlukan bukti dari repositori kode, server, terminal, dan layanan pihak ketiga di sisi Anda. Hasil investigasi adalah rantai bukti dan penilaian dampak, bukan kesimpulan penentuan tanggung jawab; untuk aktivitas ilegal, simpan bukti sesuai hukum dan tangani melalui kanal yang tepat.

Langkah 4: Periksa riwayat operasi manajemen

Operasi siklus hidup kunci API seperti pembuatan dan penghapusan dihimpun di Alibaba Cloud ActionTrail. Buka halaman kueri peristiwa di konsol ActionTrail dan filter berdasarkan layanan (Model Studio) dan rentang waktu:
  • Cari peristiwa pembuatan kunci untuk mengonfirmasi siapa yang membuat kunci ini dan kapan, guna memverifikasi kepemilikan dan tanggung jawab.
  • Cari peristiwa penghapusan kunci untuk mengonfirmasi apakah ada yang menghapus kunci di sekitar rentang kebocoran, misalnya penyerang atau orang dalam yang mencoba menghapus jejak.
Konfirmasikan status dan riwayat operasi kunci melalui ActionTrail terlebih dahulu, lalu investigasi perilaku spesifik dengan log pemanggilan.

Langkah 5: Penilaian kerugian, pengumpulan bukti, dan pemulihan

  1. Ringkas kerugian: gabungkan rentang waktu anomali (kurva penggunaan), sumber dan status pemanggilan (log audit), serta jumlah (tagihan) menjadi kesimpulan dampak.
  2. Tentukan cakupan dampak: nilai berdasarkan cakupan otorisasi kunci. Memegang kunci API Model Studio tidak setara dengan memegang kata sandi akun atau izin penuh atas resource cloud; dampak nyata terbatas pada cakupan pemanggilan yang diotorisasi kunci tersebut. Perhatikan bahwa kunci API Model Studio dan Alibaba Cloud AccessKey (AK) adalah kredensial yang berbeda: jika yang bocor adalah AK, ikuti proses penanganan AK di RAM.
  3. Simpan bukti tersamar: saat menyimpan tangkapan layar dan daftar Request ID, samarkan nilai kunci dan ID akun, dan berhenti menyebarkan kunci lengkap di kanal mana pun.
  4. Tinjau tugas asinkron: menghapus kunci tidak membatalkan tugas asinkron yang telah dikirim; hentikan tugas yang dapat dibatalkan dan lacak biaya tugas yang tidak dapat dibatalkan.
  5. Tentukan cakupan rotasi: batalkan dan ganti kunci yang dipastikan bocor sesegera mungkin; untuk kunci lainnya, nilai berdasarkan cakupan paparan, dan rotasi sekaligus kunci yang tersimpan di lingkungan yang sama yang telah terekspos, lalu perbaiki lingkungannya.
  6. Urutan pemulihan: perbaiki sumber kebocoran dengan daftar lokasi berisiko tinggi, lalu buat kunci baru di lingkungan tepercaya dengan izin dan anggaran yang dikonfigurasi ulang, perbarui referensi kredensial di layanan, tugas, dan integrasi pihak ketiga, pastikan kunci baru berfungsi, dan terakhir verifikasi bahwa kunci lama tidak valid.
Sebelum biaya anomali sepenuhnya diinvestigasi, jangan sekadar menaikkan anggaran atau memulihkan pemanggilan setelah mematikan konfigurasi pembatasan kerugian; selesaikan investigasi di atas terlebih dahulu untuk memastikan sumber kebocoran telah diperbaiki.

FAQ

Deteksi dan notifikasi melibatkan selisih waktu, dan waktu notifikasi saja tidak dapat menentukan apakah anomali masih berlanjut; peristiwa historis juga mungkin baru ditemukan dan diberitahukan saat peninjauan berikutnya. Menerima notifikasi tidak berarti kunci lama masih dapat memanggil dengan sukses: jika kunci lama telah ditangani dan penggunaan terkini normal, verifikasi waktu pemanggilan dan pengenal kunci pada notifikasi tersebut lalu abaikan.
Pengulangan saja tidak mengonfirmasi kebocoran. Periksa waktu pemanggilan, pengenal kunci, dan detail anomali dari setiap peringatan untuk membedakan pemanggilan yang baru terjadi, notifikasi berulang dari peristiwa yang sama, dan catatan historis.
Deteksi dan peringatan risiko platform adalah kemampuan yang secara proaktif disediakan platform, tidak termasuk dalam cakupan layanan yang disepakati dalam SLA, dan karena keterbatasan kompleksitas skenario risiko cakupan peringatan yang absolut tidak dijanjikan; keamanan penyimpanan serta kepatuhan penggunaan kredensial merupakan tanggung jawab Anda. Tidak menerima peringatan bukan berarti tidak ada risiko kebocoran; selesaikan dulu investigasi dan penanganan kunci yang diduga bocor mengikuti langkah-langkah dalam artikel ini, lalu verifikasi penyebab peringatan tidak terkirim dengan mengombinasikan waktu anomali dan catatan notifikasi.
Tidak. Kunci versi baru hanya ditampilkan lengkap satu kali saat pembuatan dan tidak dapat dilihat atau disalin lagi setelahnya (sebagian kunci versi lama masih dapat disalin langsung dari daftar, bergantung pada kemampuan yang benar-benar disediakan daftar tersebut).
Log inferensi hanya berlaku untuk data mendatang; data historis tidak dapat ditelusuri kembali. Pemanggilan sebelumnya hanya dapat diinvestigasi melalui informasi tingkat field di log audit.
Penggunaan token dan biaya tertunda sekitar 10 menit; halaman penggunaan juga hanya menghitung pemanggilan bayar sesuai pakai berbasis token, tidak termasuk pelatihan model dan throughput yang telah disediakan sebelumnya (PTU). Jumlah kegagalan, kesalahan pembatasan laju, dan metrik lainnya dilihat di halaman pemantauan model.
Keduanya mengembalikan 429. Pesan kesalahan anggaran yang habis berbunyi "Anggaran yang Anda tetapkan di Manajemen Anggaran telah habis..."; lihat Kode kesalahan. 429 pembatasan laju dipicu oleh pembatasan laju atau batas kuota; bedakan keduanya dengan metrik jumlah kesalahan pembatasan laju di pemantauan model.
Untuk analisis Anda sendiri, kirimkan log ke penyimpanan log SLS milik Anda dan telusuri atau ekspor dari sana; lihat Pengiriman data.
Keduanya adalah kredensial yang berbeda: kunci API Model Studio hanya mengakses layanan model dalam cakupan otorisasinya; Alibaba Cloud AccessKey mengautentikasi pemanggilan API cloud dengan izin yang ditentukan oleh akun dan konfigurasi otorisasi. Konfirmasikan dulu tipe kredensial yang bocor, lalu masuk ke titik manajemen produk yang sesuai; jangan mencampur prosesnya.