BroadRouter
Mulai

Kunci API (API key)

Diperbarui

Kunci API adalah string rahasia yang mengidentifikasi dan mengotorisasi client yang memanggil API. API LLM biasanya mengharapkannya di header Authorization: Bearer, dan siapa pun yang memegang kunci itu bisa membuat permintaan yang ditagihkan ke akun pemiliknya.

Disebut juga: kunci API, API key, API token, secret key, kunci rahasia, bearer token, kunci inferensi, inference key

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-ID sebagai gantinya.

Pertanyaan umum

Bolehkah kunci API LLM ditaruh di aplikasi browser atau mobile?

Tidak. Apa pun yang dikirim ke client bisa diekstrak. Simpan kunci di server, lalu biarkan aplikasi Anda memanggil server Anda, yang kemudian memanggil API LLM.

Apa yang harus saya lakukan jika kunci bocor?

Segera cabut, buat kunci baru, dan periksa pemakaian selama kunci itu terekspos. Lalu cari tahu bagaimana kunci bocor, misalnya lewat commit, baris log, atau tangkapan layar.

Berapa banyak kunci yang bisa saya punya di BroadNet Inference?

Hingga sepuluh kunci bayar sesuai pemakaian yang aktif per akun. Setiap kunci berlaku satu tahun sejak dibuat. Kunci paket terpisah.

Baca sebagai MarkdownTanya ChatGPTTanya ClaudeTanya Perplexity