Skip to main content

Praktik terbaik pencegahan kebocoran kunci API

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

Praktik dasar yang menembus ketiga lapisan:
  • 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
Untuk debugging lokal, tetapkan variabel lingkungan melalui input tersembunyi agar teks biasa tidak masuk ke riwayat perintah:
read -r -s -p "Enter API key: " DASHSCOPE_API_KEY
printf '\n'
export DASHSCOPE_API_KEY
Contoh ini berlaku untuk lingkungan Linux/macOS.
Variabel lingkungan menghindari hard-coding tetapi bukan penyimpanan terenkripsi: kredensial tetap dapat bocor melalui diagnostik proses, konfigurasi kontainer, crash dump, atau ekspor operasional; saat debugging, hindari opsi seperti set -x yang mencetak variabel sensitif. Untuk produksi, gunakan layanan manajemen kunci atau injeksi Secret dari platform deployment Anda.
Jika Anda pernah memberikan kunci API ke layanan perantara model yang tidak tepercaya atau plugin pihak ketiga, hentikan pengiriman kunci baru ke sana, beralihlah ke API resmi atau integrasi sisi server tepercaya, dan rotasi kunci yang telah dikirim.

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:
  1. Simpan kunci API jangka panjang hanya di server Anda sendiri dan jangan pernah mengirimkannya ke klien mana pun.
  2. Saat frontend perlu memanggil model, minta kunci temporary dari backend Anda terlebih dahulu.
  3. Backend memanggil API pembuatan kunci API temporary dan mengembalikan kunci st- berumur pendek ke frontend.
  4. Frontend memanggil Model Studio secara langsung dengan kunci st-.
Kunci API temporary berlaku 60 detik secara default; Anda dapat menetapkan 1 hingga 1.800 detik melalui expire_in_seconds (tetapkan durasi terpendek yang dibutuhkan tugas, dan jangan gunakan nilai maksimum tanpa syarat). Kunci kedaluwarsa otomatis dan tidak dapat dihapus lebih awal; kunci ini mewarisi semua izin dari kunci API jangka panjang yang menerbitkannya, jadi persempit dulu kunci jangka panjang penerbit ketika izin yang lebih kecil dibutuhkan. API penerbitan dipanggil melalui OpenAPI dengan kunci jangka panjang; validasi izin pemanggil dan batasi frekuensi penerbitan agar tidak menjadi pintu pembagian kredensial publik. Untuk detail API, lihat Hasilkan kunci API temporary.

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:
  1. Buat kunci baru dan konfigurasikan ulang izin serta anggarannya sesuai kebutuhan saat ini.
  2. Perbarui referensi kredensial di sisi bisnis.
  3. Verifikasi bahwa kunci baru berfungsi.
  4. Hapus kunci lama dan pastikan kunci lama tidak dapat memulai pemanggilan baru.
  5. Perbarui buku register kunci.
Kunci baru tidak otomatis mewarisi izin dan konfigurasi anggaran kunci lama; atur ulang. Saat personel meninggalkan organisasi atau bisnis dihentikan, kunci atas nama mereka wajib diinventarisasi dan dihapus atau dirotasi secara terpisah: kunci API yang dibuat pada atau setelah 25 Maret 2026 tidak ikut terhapus saat Pengguna RAM pemiliknya dihapus dan tetap dapat digunakan (aturan ini hanya relevan saat kunci dimiliki oleh sub-akun RAM), sehingga Pengguna RAM yang telah dihapus bukan berarti kredensial telah dicabut; lihat Validitas Kunci API. Jika beberapa kunci tersimpan di server yang sama yang diduga telah dikompromikan, konfigurasi publik, repositori kode, atau lingkungan pihak ketiga, rotasi semua kredensial yang berpotensi terdampak dan perbaiki lingkungannya: jangan mengganti semua kunci secara membabi buta, dan jangan pula hanya menangani satu kunci sambil mengabaikan lingkungan yang terekspos bersama. Praktik lanjutan: simpan teks biasa kunci di layanan manajemen kunci (KMS), biarkan aplikasi mengambilnya berdasarkan nama kredensial, dan manfaatkan kemampuan rotasi kunci KMS untuk memperbaruinya secara berkala.

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.
Setelah konfigurasi, verifikasi bahwa pembatasannya efektif: hanya jaringan dan model yang diizinkan dapat dipanggil dan yang tidak diotorisasi tidak dapat; jangan mencetak kunci lengkap saat verifikasi. Untuk titik masuk operasi dan aturan lengkap, lihat izin Kunci API.
Whitelist IP tidak dapat menggantikan kerahasiaan kredensial: orang atau host yang telah dikompromikan yang dapat memanggil dari jaringan egress yang sama masih dapat menyalahgunakan kunci yang bocor.

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.
"Hentikan segera saat anggaran tercapai" berlaku dengan penundaan, dan biaya yang timbul selama penundaan tetap ditagihkan; pemanggilan dari luapan throughput yang telah disediakan sebelumnya (PTU) dan aplikasi belum didukung untuk penghentian otomatis. Untuk bisnis penting produksi, jangan aktifkan penghentian otomatis; utamakan peringatan plus penanganan terkendali.

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

Tidak. Kunci API temporary mewarisi semua izin dari kunci API jangka panjang yang menerbitkannya; hanya masa berlakunya yang lebih pendek. Untuk izin yang lebih kecil, persempit dulu kunci API jangka panjang penerbitnya.
Ya. Whitelist IP hanya membatasi jaringan sumber pemanggilan; kunci yang bocor ke dalam jaringan egress yang sama tetap dapat disalahgunakan. Gunakan bersama hak akses minimum, peringatan anggaran, dan rotasi berkala.
Hentikan pengiriman kunci baru ke layanan tersebut, rotasi kunci yang telah dikirim, dan beralihlah ke API resmi atau integrasi sisi server tepercaya. Untuk langkah penanganan kunci yang telah bocor, lihat Investigasi kebocoran kunci API.