Kunci API berfungsi seperti kata sandi untuk program. Kunci itu juga merupakan wewenang belanja: siapa pun yang memegangnya bisa memakai saldo Anda.
Cara kerjanya
API LLM memperlakukan kunci sebagai bearer token. Client mengirimkannya di setiap permintaan:
curl https://inference.broadnet.ai/v1/models \
-H "Authorization: Bearer $BROADNET_API_KEY"
RFC 6750 mendefinisikan bearer token sebagai token yang bisa dipakai oleh “any party in possession of the token” (terjemahan: pihak mana pun yang memegang token tersebut). Tidak ada faktor kedua. Karena itulah RFC yang sama menyebutkan bahwa client harus selalu mengirim bearer token lewat TLS (https://).
Penyedia mencari kunci tersebut, menemukan akunnya, memeriksa batas dan kebijakan, lalu melayani atau menolak permintaan. Kunci yang tidak ada atau salah biasanya menghasilkan 401; kunci yang ditolak oleh kebijakan, seperti daftar IP yang diizinkan, biasanya menghasilkan 403.
Kenapa ini penting
Kunci yang bocor adalah salah satu penyebab paling umum tagihan API membengkak, karena bot memindai kode publik untuk mencari rahasia. Kunci juga bisa membuka data jika mampu mengakses endpoint yang mengembalikan detail akun. Praktik yang baik, sejalan dengan panduan pengelolaan rahasia OWASP:
- Muat kunci dari environment variable atau secrets manager. Jangan pernah meng-commit-nya atau menanamkannya di image container.
- Beri setiap aplikasi atau agen kuncinya sendiri, agar Anda bisa mencabut satu tanpa menghentikan semuanya.
- Rotasi kunci secara terjadwal dan segera setelah ada dugaan kebocoran.
- Batasi tempat kunci bisa dipakai, misalnya dengan daftar IP server yang diizinkan.
Di BroadNet Inference
BroadNet memisahkan dua kredensial. Kunci inferensi memanggil model di /v1/*. Kredensial portal mengotomatiskan akun: kunci, IP yang diizinkan, dan pembelian. Perlakukan yang kedua sebagai wewenang penuh atas akun.
Keduanya hanya ditampilkan sekali. BroadNet hanya menyimpan hash SHA-256, sehingga tidak bisa menampilkan kunci itu lagi. Kunci bayar sesuai pemakaian berlaku satu tahun, dan satu akun bisa memiliki hingga sepuluh kunci aktif. Setiap kunci bisa membawa daftar IP yang diizinkan sendiri. Setelah pencabutan atau perubahan daftar IP, permintaan baru berhenti dalam lima detik.
Kunci paket untuk paket harga tetap terpisah dan tidak pernah memotong saldo Anda. Langkah penyiapannya ada di kunci API dan daftar IP yang diizinkan, dan kode statusnya di error dan percobaan ulang.
Kesalahan umum
- Mencatat seluruh header permintaan ke log. Itu menulis kunci ke log Anda.
- Memakai satu kunci bersama satu tim. Anda kehilangan kemampuan mencabut akses satu orang saja.
- Mengirim kunci ke tim dukungan. Kirim nilai header
X-Request-IDsebagai gantinya.