Cegah kebocoran kunci API melalui tiga lapisan: memperpendek waktu paparan kredensial, mempersempit cakupan izin, dan mengonfigurasi peringatan serta pembatasan kerugian; mencakup kunci API temporary, rotasi berkala, whitelist IP, koneksi jaringan pribadi, peringatan anggaran, dan peringatan pemantauan model.
Ringkasan
Kunci API adalah kredensial yang digunakan untuk memanggil layanan model Alibaba Cloud Model Studio. Setelah bocor, siapa pun yang memperolehnya dapat memanggil model dalam cakupan otorisasi kunci tersebut dan menghabiskan kuota Anda. Dampak kebocoran dapat diuraikan menjadi empat faktor: probabilitas kebocoran, waktu paparan, cakupan izin per pemanggilan, dan durasi anomali berlangsung. Probabilitas kebocoran ditekan oleh praktik dasar yang menembus seluruh halaman ini, dan tiga faktor lainnya masing-masing ditekan oleh tiga lapisan berikut:
Lapisan | Faktor yang ditekan | Tindakan utama |
|---|---|---|
Perpendek waktu paparan | Waktu paparan | Kunci API temporary untuk klien, tampilan sekali dengan penyimpanan terkendali, rotasi berkala dan pencabutan saat meninggalkan organisasi |
Persempit cakupan izin | Cakupan izin per pemanggilan | Satu kunci per bisnis, isolasi ruang kerja, whitelist IP dan cakupan model, koneksi jaringan pribadi |
Peringatan dan pembatasan kerugian | Durasi anomali berlangsung | Peringatan anggaran dengan penghentian saat anggaran tercapai, peringatan pemantauan model, deteksi risiko platform |
- Aplikasi membaca kredensial dari variabel lingkungan atau layanan manajemen kunci, bukan di-hard-code dalam kode; konfigurasikan pemindaian informasi sensitif di CI/CD (dapat menggunakan alat pemindai kredensial seperti gitleaks), mencakup pola kunci API.
- Pelihara buku register kunci: mulai dari tabel dasar yang mencatat ID kunci, kegunaan, penanggung jawab, dan waktu rotasi terakhir, lalu lengkapi secara bertahap dengan kolom wilayah, ruang kerja, cakupan izin, anggaran, dan lainnya; buku register tidak menyimpan kunci lengkap.
- Batasi izin manajemen kunci (membuat, melihat, mengedit, menghapus) hanya pada administrator yang diperlukan.
Perpendek waktu paparan kredensial
Simpan kunci API jangka panjang dengan aman
Kunci API yang baru dibuat hanya ditampilkan lengkap satu kali saat pembuatan; setelah dialog ditutup, teks biasa lengkap tidak dapat dilihat atau disalin lagi. Jika Anda tidak menyimpannya, satu-satunya cara adalah mengatur ulang atau membuat ulang kunci tersebut; lihat Buat kunci API.
Setelah berhasil dibuat, simpan kunci lengkap langsung ke penyimpanan kredensial terkendali (layanan manajemen kunci atau manajemen Secret platform deployment), jangan dialihkan melalui tangkapan layar, email, alat obrolan, atau dokumen biasa; nilai tersamar dalam daftar hanya untuk identifikasi dan perbandingan.
Jangan menempatkan kunci API jangka panjang di lokasi berikut:
- Skrip browser, artefak build frontend, dan paket instalasi aplikasi seluler
- Repositori kode publik atau bersama (sekadar menambahkan .gitignore tidak menghapus kredensial dari commit historis)
- Output notebook dan kode contoh
- Tangkapan layar dan perekaman layar
- Tiket, obrolan grup, dan dokumen daring
- Prompt, basis pengetahuan, dan konteks agen
- URL permintaan dan parameter kueri
- Log akses dan stack trace pengecualian
- Plugin pihak ketiga dan layanan perantara model
- Lingkungan bersama serta file konfigurasi, image, dan cadangan yang terekspos ke publik
Gunakan kunci API temporary dalam skenario sisi klien
Browser, aplikasi seluler, mini program, dan lingkungan serupa tidak dapat menjaga kerahasiaan kredensial secara andal. Untuk skenario ini, minta backend yang telah diautentikasi menerbitkan kunci API temporary agar frontend dapat memanggil secara langsung:
- Simpan kunci API jangka panjang hanya di server Anda sendiri dan jangan pernah mengirimkannya ke klien mana pun.
- Saat frontend perlu memanggil model, minta kunci temporary dari backend Anda terlebih dahulu.
- Backend memanggil API pembuatan kunci API temporary dan mengembalikan kunci st- berumur pendek ke frontend.
- Frontend memanggil Model Studio secara langsung dengan kunci st-.
Rotasi berkala dan pencabutan saat meninggalkan organisasi
Kunci berumur panjang yang dikonfigurasi dalam kode atau agen mengakumulasi permukaan paparan seiring waktu dan harus dirotasi secara berkala:
- Buat kunci baru dan konfigurasikan ulang izin serta anggarannya sesuai kebutuhan saat ini.
- Perbarui referensi kredensial di sisi bisnis.
- Verifikasi bahwa kunci baru berfungsi.
- Hapus kunci lama dan pastikan kunci lama tidak dapat memulai pemanggilan baru.
- Perbarui buku register kunci.
Persempit cakupan izin kredensial
Satu kunci per bisnis dan isolasi ruang kerja
Tetapkan kunci API independen untuk aplikasi dan lingkungan yang berbeda (produksi, pengujian, dan debugging pribadi): ini memperkecil dampak kebocoran satu kunci sekaligus mempermudah pelacakan masalah dan rotasi per kunci. Saat Anda membutuhkan isolasi izin, kontrol akses model yang detail halus, atau akuntansi biaya independen, tetapkan ruang kerja non-default untuk bisnis tersebut (ruang kerja adalah wadah di Model Studio yang mengisolasi izin dan biaya; setiap akun secara default telah memiliki ruang kerja default); cakupan pemanggilan dasar kunci dibatasi oleh ruang kerja tempat kunci berada; lihat Pengelolaan izin.
Batasi juga izin manajemen kunci hanya pada administrator yang diperlukan; akun yang dapat masuk ke konsol untuk mengelola kredensial harus mengikuti prinsip hak akses minimum dan mengaktifkan autentikasi multifaktor sesuai kebijakan organisasi.
Konfigurasikan whitelist IP dan cakupan model
Setelah mengatur izin kunci API menjadi Kustom di panel pembuatan atau pengeditan kunci, Anda dapat mempersempit cakupan pemanggilannya lebih lanjut:
- Whitelist IP: izinkan hanya IP atau blok CIDR egress publik yang benar-benar digunakan bisnis, hingga 20 entri (gunakan cara seperti curl ifconfig.me untuk mengetahui egress publik Anda). Semua alamat IPv4 diizinkan secara default; sekadar membuat kunci bukan berarti pembatasan sumber telah aktif. Saat memanggil melalui NAT, proxy, atau gateway, masukkan alamat egress publik yang benar-benar dilihat oleh Model Studio, bukan alamat intranet server.
- Cakupan model: setelah diaktifkan, kunci hanya dapat memanggil model yang dipilih (hingga 30, dibatasi oleh model yang diotorisasi di ruang kerja), mencegah kunci yang bocor digunakan untuk model berbiaya tinggi.
Panggil melalui koneksi jaringan pribadi
Untuk skenario dengan persyaratan keamanan jaringan yang tinggi, Anda dapat membangun koneksi jaringan pribadi (PrivateLink) antara VPC dan Model Studio: pemanggilan tidak melewati jaringan publik, sehingga penyerang eksternal yang jalur jaringannya tidak terhubung tidak dapat memanggil layanan meskipun kunci bocor. Untuk konfigurasi, lihat Akses API Model Studio melalui jaringan pribadi.
Konfigurasikan peringatan dan pembatasan kerugian
Peringatan anggaran dan penghentian saat anggaran tercapai
Tetapkan anggaran bulanan dan ambang batas peringatan untuk akun, ruang kerja, atau satu kunci API; prioritaskan anggaran independen untuk kunci berisiko tinggi seperti pengembangan, pengujian, demo, dan integrasi pihak ketiga. Saat pengeluaran mencapai ambang batas dan saat anggaran habis, notifikasi dikirim melalui pesan dalam situs, SMS, email, atau bot; setelah mengaktifkan "hentikan segera saat anggaran tercapai", anggaran yang habis akan membatasi pemanggilan pay-as-you-go pada dimensi tersebut dan mengembalikan 429. Untuk konfigurasi, lihat Manajemen anggaran.
Peringatan pemantauan model
Pemantauan model mengagregasi jumlah pemanggilan, penggunaan token, jumlah kegagalan, tingkat kegagalan, dan metrik lain per ruang kerja, mendukung pemfilteran berdasarkan kunci API, serta memungkinkan pembuatan aturan peringatan dari templat peringatan preset atau kustom yang memberi tahu kontak atau grup kontak. Konfigurasikan peringatan lonjakan volume atau jumlah pemanggilan untuk kunci berisiko tinggi: anomali terlihat dalam hitungan menit setelah pemanggilan terjadi, dan pemicuan di luar jam kerja menuntut intervensi manual. Konfigurasi peringatan pertama kali memerlukan otorisasi peran layanan Cloud Monitor di pengiriman data; untuk konfigurasi, lihat Peringatan.
Deteksi risiko platform
Platform secara berkala memindai lingkungan publik seperti repositori kode publik untuk mengidentifikasi kunci API yang bocor dan memberi tahu Anda secara proaktif; kanal aktual bergantung pada yang diaktifkan (mungkin mencakup SMS, email, dan pesan dalam situs). Platform juga mengidentifikasi perilaku anomali seperti login dari IP yang tidak biasa, lonjakan traffic di malam hari, dan kenaikan biaya yang tidak wajar.
Deteksi dan peringatan risiko platform adalah kemampuan deteksi anomali serta peringatan dini yang secara proaktif disediakan platform untuk meningkatkan pengalaman penggunaan, tidak termasuk dalam cakupan layanan yang disepakati dalam SLA; karena keterbatasan kompleksitas skenario risiko, cakupan peringatan yang absolut tidak dijanjikan, dan identifikasi serta pengiriman peringatan juga mungkin mengalami penundaan. Keamanan penyimpanan serta kepatuhan penggunaan kredensial seperti kunci API merupakan tanggung jawab Anda; jadikan peringatan anggaran, peringatan pemantauan model, dan rotasi berkala yang Anda konfigurasi sendiri sebagai pertahanan utama; tidak menerima peringatan platform bukan berarti tidak ada risiko kebocoran. Setelah menemukan kebocoran yang diduga atau menerima peringatan, lacak dan tangani mengikuti Investigasi kebocoran kunci API.
Daftar periksa sebelum peluncuran
Pengembang perorangan atau tim kecil dapat memulai dengan minimum: tetapkan anggaran dengan notifikasi peringatan untuk kunci, simpan kredensial hanya di variabel lingkungan, dan rotasi secara berkala. Daftar periksa lengkapnya sebagai berikut:
- Produksi, pengujian, dan integrasi pihak ketiga tidak berbagi kunci API yang sama; penanggung jawab dan kegunaan kunci jelas.
- Wilayah, ruang kerja, cakupan model, dan IP egress permintaan telah diverifikasi, dengan izin hanya mencakup cakupan yang diperlukan.
- Kunci jangka panjang hanya tersimpan di backend terkendali dan tidak pernah masuk ke klien, kode sumber, prompt, dokumen bersama, atau log.
- Kunci tidak dikirim ke layanan perantara pihak ketiga yang tidak tepercaya atau lingkungan plugin; jika pernah dikirim, pengiriman telah dihentikan dan kunci telah dirotasi.
- Kredensial diinjeksi melalui variabel lingkungan atau Secret; file sensitif dan artefak build tidak mengandung teks biasa.
- Skenario koneksi langsung dari klien menggunakan kunci berumur pendek yang diterbitkan backend yang telah diautentikasi, dan kunci jangka panjang penerbit telah dipersempit izinnya.
- Kunci versi baru tersimpan secara terkendali; kunci versi lama, kunci menganggur, dan kunci terkait personel yang telah pergi telah ditinjau.
- Anggaran dan peringatan tingkat akun, ruang kerja, dan kunci telah dikonfigurasi, dengan kanal notifikasi dan penanggung jawab yang jelas.
- Dampak ketersediaan dan penundaan efektif "hentikan segera saat anggaran tercapai" telah dievaluasi.
- Prosedur rotasi dan penanganan kebocoran telah ditetapkan; langkah investigasi dijelaskan dalam Investigasi kebocoran kunci API.
FAQ
Apakah kunci API temporary memiliki izin lebih sedikit daripada kunci API jangka panjang?
Apakah kunci API temporary memiliki izin lebih sedikit daripada kunci API jangka panjang?
Dengan whitelist IP dikonfigurasi, apakah saya masih perlu khawatir tentang kebocoran kunci?
Dengan whitelist IP dikonfigurasi, apakah saya masih perlu khawatir tentang kebocoran kunci?
Apa yang harus dilakukan jika saya pernah memberikan kunci ke layanan perantara pihak ketiga?
Apa yang harus dilakukan jika saya pernah memberikan kunci ke layanan perantara pihak ketiga?