---
title: "Keselamatan kunci API LLM: env var, putaran, senarai IP"
description: "Jauhkan kunci API LLM daripada kod dan log, beri setiap beban kerja kunci sendiri, putar ikut jadual, kunci pada IP pelayan, batalkan kebocoran dalam beberapa saat."
url: https://broadrouter.com/ms/blog/llm-api-key-security/
lang: ms
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/blog/llm-api-key-security/) (dikemas kini 2026-11-15).

# Keselamatan kunci API LLM: penyimpanan, putaran dan senarai IP

Oleh pasukan BroadNet Inference · 6 minit bacaan · Diterbitkan 2026-11-14 · Dikemas kini 2026-11-15

Simpan kunci API LLM dalam pengurus rahsia, jangan sekali-kali dalam kod atau pelayar. Beri setiap aplikasi atau ejen kuncinya sendiri, putar mengikut jadual, dan kunci kunci itu pada pelayan anda dengan senarai IP dibenarkan. BroadNet Inference menyatakan senarai dibenarkannya menerima 32 entri, pembatalan menghentikan permintaan baharu dalam masa lima saat, dan kunci bertahan selama setahun.

## Perkara utama

-   Jangan sekali-kali menghantar kunci ke pelayar atau aplikasi mudah alih; panggil LLM dari pelayan anda.
-   Satu kunci bagi setiap beban kerja: sehingga 10 kunci aktif bagi setiap akaun BroadNet memudahkan kebocoran diasingkan.
-   Senarai IP dibenarkan menghalang kunci yang dicuri daripada berfungsi di tempat lain. BroadNet menerima sehingga 32 entri IPv4, IPv6 atau CIDR.
-   Pembatalan dan perubahan senarai dibenarkan berkuat kuasa dalam lima saat di BroadNet Inference.
-   Kunci tamat tempoh setahun selepas dicipta, jadi putaran mesti menjadi rutin, bukan kecemasan.

**Dalam halaman ini**

1.  Di manakah kunci API LLM patut disimpan?
2.  Bolehkah kunci API diletakkan dalam pelayar atau aplikasi mudah alih?
3.  Mengapakah setiap beban kerja perlu kunci sendiri?
4.  Bagaimanakah senarai IP dibenarkan melindungi kunci?
5.  Mengapakah kunci inferens perlu diasingkan daripada kelayakan pentadbir?
6.  Berapa kerapkah kunci API perlu diputar?
7.  Apakah yang perlu dilakukan apabila kunci bocor?
8.  Bagaimanakah kunci bocor melalui log?
9.  Bagaimanakah anda mengehadkan kerosakan daripada kebocoran yang belum ditemui?
10.  Apakah kawalan kunci yang disediakan oleh BroadNet Inference?

Untuk melindungi kunci API LLM, simpan kunci dalam pengurus rahsia dan panggil model hanya dari pelayan anda, jangan sekali-kali dari pelayar atau aplikasi. Beri setiap beban kerja kuncinya sendiri, putar kunci mengikut jadual, kunci pada IP pelayan anda dengan senarai dibenarkan (allow-list), dan apabila kunci bocor, batalkan (revoke) dahulu, siasat kemudian.

Catatan ini merangkumi tabiat yang memastikan kunci selamat, bersama kawalan khusus yang disediakan oleh BroadNet Inference. Untuk langkah demi langkah di portal, lihat [panduan kunci API dan senarai IP dibenarkan](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/); untuk bajet dan perlindungan daripada gelung tanpa kawalan, lihat [kawalan perbelanjaan API LLM](https://broadrouter.com/ms/blog/llm-api-spend-control/).

## Di manakah kunci API LLM patut disimpan?

Simpan kunci dalam pengurus rahsia atau rahsia tersulit platform anda, jangan sekali-kali dalam kod. [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html) membincangkan pilihan secara mendalam. Ambil perhatian amarannya: pembolehubah persekitaran “are generally accessible to all processes and may be included in logs or system dumps” (Terjemahan: lazimnya boleh diakses oleh semua proses dan mungkin termasuk dalam log atau longgokan sistem), jadi OWASP lebih suka fail rahsia yang dilekapkan atau mengambil rahsia dari stor rahsia jika anda ada pilihan. Pembolehubah persekitaran yang diisi daripada pengurus rahsia semasa permulaan ialah jalan tengah yang biasa.

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],  # fails loudly if missing
)
```

Gunakan `os.environ[...]`, bukan `os.getenv(...)` dengan nilai sandaran yang dikod keras; nilai sandaran itulah cara kunci berakhir dalam Git. Untuk pembangunan setempat, fail `.env` tidak mengapa jika ia berada dalam `.gitignore` sejak commit pertama. Hidupkan secret scanning dan push protection pada hos Git anda. Di GitHub, [push protection](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection) menyekat push yang mengandungi format rahsia yang dikenali sebelum ia sampai ke repositori; push protection untuk pengguna dihidupkan secara lalai, tetapi push protection peringkat repositori dimatikan secara lalai dan mesti didayakan oleh pentadbir repositori atau pemilik organisasi.

## Bolehkah kunci API diletakkan dalam pelayar atau aplikasi mudah alih?

Tidak. Apa sahaja yang dihantar kepada klien boleh diekstrak. Kod bahagian hadapan dan berkas aplikasi adalah awam, walau bagaimana ia dimampatkan atau dikaburkan. Panggil LLM dari pelayan anda, sahkan pengguna anda sendiri di sana, dan kenakan had setiap pengguna anda sendiri sebelum memajukan permintaan.

Begitu juga dengan alat desktop yang anda berikan kepada orang lain. Jika rakan sepasukan memerlukan akses kepada ejen pengekodan, berikan mereka kunci sendiri pada akaun sendiri dan bukannya berkongsi satu kunci.

## Mengapakah setiap beban kerja perlu kunci sendiri?

Di BroadNet Inference, satu akaun boleh memegang **sehingga sepuluh kunci aktif**. Gunakannya:

| Label kunci | Digunakan oleh |
| --- | --- |
| `prod-api` | Backend pengeluaran |
| `prod-worker` | Kerja batch |
| `staging` | Persekitaran staging |
| `agent-ci` | Ejen pengekodan dalam CI |
| `dev-laptop-<name>` | Pembangunan setempat |

Apabila satu kunci bocor, anda hanya membatalkan kunci itu dan yang lain terus berfungsi. Label juga menjadikan penggunaan mudah dibaca: anda boleh melihat beban kerja mana yang membelanjakan berapa. Namakan kunci mengikut penggunanya, bukan mengikut siapa yang menciptanya.

## Bagaimanakah senarai IP dibenarkan melindungi kunci?

Dengan [senarai IP dibenarkan](https://broadrouter.com/ms/glossary/ip-allow-list/), kunci yang dicuri gagal di mana-mana kecuali infrastruktur anda sendiri. Di BroadNet Inference:

-   Senarai dibenarkan akaun menerima **sehingga 32 entri**, satu alamat IPv4 atau IPv6 atau julat CIDR bagi setiap baris.
-   Senarai kosong bermaksud tiada sekatan.
-   Kunci baharu mewarisi senarai akaun, kecuali anda mencipta kunci dengan `allowed_ips` sendiri, yang menggantikan senarai warisan bagi kunci itu.
-   Permintaan dari alamat di luar senarai ditolak dengan 403 (“refused by model, route or IP policy”; Terjemahan: ditolak oleh dasar model, laluan atau IP).

Cipta kunci dengan senarai sendiri melalui API portal:

```bash
curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"prod-worker","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

Respons mengandungi kunci mentah sekali sahaja. Simpan segera dalam pengurus rahsia anda; ia tidak boleh dibaca semula. Langkah penuh ada dalam [panduan senarai IP dibenarkan](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/).

Senarai dibenarkan sesuai untuk pelayan dengan IP keluar yang stabil: VPS, gerbang NAT, IP pejabat yang tetap. Untuk komputer riba pada rangkaian yang berubah-ubah, gunakan kunci berasingan tanpa senarai dan pastikan baki yang terdedah kepadanya kecil.

## Mengapakah kunci inferens perlu diasingkan daripada kelayakan pentadbir?

BroadNet menggunakan dua jenis kelayakan:

| Kelayakan | Boleh buat | Simpan di |
| --- | --- | --- |
| Kunci inferens | Permintaan model ke `/v1/*` | Di mana aplikasi berjalan |
| Kelayakan portal | Cipta dan batalkan kunci, tukar IP dibenarkan, buat pembelian | Hanya dalam automasi atau alat pentadbir anda |

Dokumentasi menyatakan setiap kelayakan portal perlu dianggap sebagai kuasa penuh ke atas akaun. Jangan sekali-kali menempatkan kelayakan portal bersebelahan aplikasi anda. Jika pelayan aplikasi anda dikompromi, penyerang sepatutnya hanya mendapat satu kunci inferens, bukan kawalan ke atas akaun.

## Berapa kerapkah kunci API perlu diputar?

OWASP mengesyorkan putaran berkala “so that any stolen credentials will only work for a short time.” (Terjemahan: supaya mana-mana kelayakan yang dicuri hanya berfungsi untuk masa yang singkat.) Kunci BroadNet bertahan **setahun** dari tarikh dicipta, jadi setiap kunci tetap perlu diganti. Jadikan putaran satu rutin:

1.  Cipta kunci baharu dengan corak label dan senarai dibenarkan yang sama.
2.  Gunakannya bersama kunci lama, atau tukar rahsia dan mulakan semula.
3.  Perhatikan trafik beralih ke kunci baharu.
4.  Batalkan kunci lama dengan `DELETE /portal/keys/{alias}`.

Oleh sebab satu akaun boleh memegang sehingga sepuluh kunci aktif, kunci lama dan baharu boleh bertindih selama beberapa minit tanpa gangguan perkhidmatan. Putar lebih awal bagi kunci yang pernah diakses oleh ahli pasukan yang akan berhenti.

## Apakah yang perlu dilakukan apabila kunci bocor?

Apabila kunci bocor, batalkan dahulu dan siasat kemudian. Di BroadNet Inference, permintaan baharu berhenti **dalam lima saat** selepas pembatalan atau perubahan senarai dibenarkan; dokumentasi menerangkan bahawa keputusan kebenaran mungkin kekal dalam cache yang direplikasi bagi tempoh terhad itu.

Selepas membatalkan:

-   semak penggunaan kunci itu di halaman akaun atau `GET /portal/usage`;
-   cari bagaimana ia bocor (sejarah commit, log CI, tangkapan skrin yang dikongsi);
-   putar rahsia lain yang disimpan di tempat yang sama.

Kunci yang dibatalkan atau disekat memulangkan 401 atau 403; lihat [panduan ralat](https://broadrouter.com/ms/guides/errors-and-retries/) supaya pemantauan anda tidak menganggapnya sebagai ralat sementara.

## Bagaimanakah kunci bocor melalui log?

Kebocoran melalui log mudah terlepas pandang. Sunting keluar pengepala `Authorization` dalam log nyahpepijat HTTP, pelapor ralat dan log akses proksi. Apabila menghubungi sokongan, hantar `X-Request-ID`, cap masa, laluan, status dan **alias** kunci, jangan sekali-kali kunci itu sendiri. Dokumentasi BroadNet menyatakan portal hanya menyimpan hash bagi setiap kunci, jadi ia juga tidak dapat menunjukkan kunci yang hilang kepada anda.

## Bagaimanakah anda mengehadkan kerosakan daripada kebocoran yang belum ditemui?

Walaupun dengan semua tabiat di atas, anggaplah sesuatu kunci mungkin bocor suatu hari nanti. Kecilkan kesannya:

-   Kekalkan baki bayar ikut guna pada tahap yang anda sanggup kehilangan, dan tambah nilai mengikut keperluan.
-   Gunakan pelan kadar tetap untuk ejen yang berat: sesi pelan mempunyai harga tetap, jadi kunci pelan yang dicuri tidak boleh menaikkan bil setiap token. Lihat [maksud sebenar tanpa had](https://broadrouter.com/ms/blog/what-unlimited-llm-api-really-means/).
-   Pasang amaran untuk perbelanjaan atau kadar permintaan luar biasa bagi setiap kunci; [kalkulator kos API LLM](https://broadrouter.com/tools/llm-api-cost-calculator/) memberi angka bulanan biasa sebagai asas amaran. Catatan kami tentang [kawalan perbelanjaan API LLM](https://broadrouter.com/ms/blog/llm-api-spend-control/) merangkumi bajet dan amaran.

## Apakah kawalan kunci yang disediakan oleh BroadNet Inference?

| Kawalan | BroadNet Inference |
| --- | --- |
| Kunci ditunjukkan sekali, disimpan dalam bentuk hash | Ya |
| Kunci aktif setiap akaun | Sehingga 10 |
| Hayat kunci | Setahun |
| Senarai IP dibenarkan | Sehingga 32 entri IPv4, IPv6 atau CIDR |
| Senarai dibenarkan setiap kunci | Ya, `allowed_ips` semasa dicipta |
| Pembatalan berkuat kuasa | Dalam lima saat |
| Kelayakan pentadbir berasingan | Kelayakan portal |

Kunci melindungi akaun anda; [pengekalan data sifar](https://broadrouter.com/ms/privacy/) melindungi apa yang anda hantar melaluinya. Baca kedua-duanya sebelum anda melancarkan.

Alat percuma untuk topik ini (Bahasa Inggeris)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Alatan percuma (Bahasa Inggeris)](https://broadrouter.com/tools/)

## Istilah dalam artikel ini

[Kunci API (API key)](https://broadrouter.com/ms/glossary/api-key/)

Kunci API ialah rentetan rahsia yang mengenal pasti dan membenarkan klien yang memanggil sesuatu API. API LLM biasanya menjangkakannya dalam pengepala Authorization: Bearer, dan sesiapa yang memegang kunci itu boleh membuat permintaan yang dibilkan kepada akaun pemiliknya.

[Ejen pengekodan AI (AI coding agent)](https://broadrouter.com/ms/glossary/coding-agent/)

Ejen pengekodan AI ialah alat perisian di mana model bahasa bekerja pada codebase dalam satu gelung: ia membaca fail, menyuntingnya, menjalankan arahan seperti ujian, membaca output dan menentukan langkah seterusnya sehingga tugas selesai atau had dicapai.

[Baris Arab (tashkeel, Arabic diacritics)](https://broadrouter.com/ms/glossary/arabic-diacritics/)

Baris Arab, atau tashkeel, ialah tanda kecil yang ditulis di atas atau di bawah huruf untuk menunjukkan vokal pendek, konsonan berganda dan ketiadaan vokal. Ia pilihan: kebanyakan teks Arab, termasuk berita, meninggalkannya, jadi pembaca dan perisian meneka vokal daripada konteks.

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

[Kredit prabayar (prepaid credit)](https://broadrouter.com/ms/glossary/prepaid-credit/)

Kredit prabayar ialah wang yang ditambah ke akaun API sebelum digunakan. Setiap permintaan menolak kosnya daripada baki, dan apabila baki habis, permintaan bermeter berhenti sehingga anda menambah nilai. Ia mengehadkan perbelanjaan kepada jumlah yang telah anda bayar.

[Token](https://broadrouter.com/ms/glossary/token/)

Token ialah unit teks yang dibaca dan ditulis oleh model bahasa: satu perkataan, sebahagian perkataan, tanda baca atau jujukan bait yang dihasilkan oleh tokenizer model itu. API LLM mengira, mengehadkan dan biasanya mengebil penggunaan dalam token.

[Tool calling (panggilan alatan)](https://broadrouter.com/ms/glossary/tool-calling/)

Tool calling, juga dipanggil function calling, ialah ciri API LLM di mana model memulangkan permintaan berstruktur untuk menjalankan fungsi yang ditakrifkan oleh pembangun, bersama argumen JSON. Aplikasi menjalankan fungsi itu dan menghantar hasilnya kembali; model sendiri tidak pernah menjalankan kod.

## Soalan lazim

### Di manakah saya patut menyimpan kunci API LLM?

Dalam pengurus rahsia atau rahsia tersulit platform anda, yang dimasukkan ke dalam proses sebagai pembolehubah persekitaran seperti BROADNET\_API\_KEY. Bukan dalam kod sumber, bukan dalam fail .env yang di-commit, dan jangan sekali-kali dalam kod bahagian hadapan.

### Berapa cepat saya boleh membatalkan kunci BroadNet Inference?

Dokumentasi BroadNet menyatakan permintaan baharu berhenti dalam masa lima saat selepas pembatalan atau perubahan senarai dibenarkan, kerana keputusan kebenaran mungkin kekal dalam cache yang direplikasi bagi tempoh terhad itu.

### Berapa lamakah kunci BroadNet Inference bertahan?

Kunci bayar ikut guna bertahan setahun dari tarikh dicipta. Satu akaun boleh memegang sehingga sepuluh kunci aktif, jadi anda boleh mencipta kunci pengganti sebelum kunci lama tamat tempoh.

### Bolehkah BroadNet menunjukkan semula kunci saya jika saya kehilangannya?

Tidak. Dokumentasi BroadNet menyatakan kunci mentah dipulangkan sekali sahaja dan portal hanya menyimpan hash-nya. Cipta kunci baharu dan batalkan kunci lama.

### Apakah yang patut saya lakukan jika kunci API serasi OpenAI saya bocor?

Batalkan dahulu, kemudian siasat. Semak penggunaan kunci itu untuk trafik yang tidak dikenali, cari punca kebocoran (sejarah commit, log CI, tangkapan skrin), putar rahsia lain yang disimpan di tempat yang sama, dan keluarkan kunci pengganti dengan senarai IP dibenarkan.

## Teruskan membaca

-   [Kawalan perbelanjaan API LLM: bajet, had kunci dan perlindungan gelung](https://broadrouter.com/ms/blog/llm-api-spend-control/)
-   [Menghantar data sensitif ke API LLM: sunting, kurangkan, kurangkan log](https://broadrouter.com/ms/blog/llm-api-sensitive-data/)
-   [Cara mengendalikan ralat 429 API LLM: backoff, jitter dan pengehad](https://broadrouter.com/ms/blog/handle-llm-api-429-rate-limits/)
-   [GDPR dan API LLM: 15 soalan untuk ditanya kepada penyedia anda](https://broadrouter.com/ms/blog/gdpr-llm-api-checklist/)
-   [Perkakasan GPU dan pendekatan penyajian BroadNet, menurut BroadNet](https://broadrouter.com/ms/blog/broadnet-gpu-fleet-and-serving/)
-   [Cache respons API LLM untuk jimat kos: cache padanan tepat Python](https://broadrouter.com/ms/blog/cache-llm-responses-cut-cost/)
-   [Panduan: Kunci API kepada pelayan anda dengan senarai IP dibenarkan](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/)
-   [Panduan: Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)
-   [Panduan: Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/)

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

[Mulakan](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-blog-llm-api-key-security&utm_content=page-cta) ·

**Sumber**

-   [Rujukan API BroadNet Inference, had: hayat kunci, kunci aktif (disemak 2026-11-14) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-blog-llm-api-key-security&utm_content=sources#limits)
-   [Rujukan API BroadNet Inference, senarai IP dibenarkan dan kunci portal (disemak 2026-11-14) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-blog-llm-api-key-security&utm_content=sources#ip-allow-lists)
-   [OWASP Secrets Management Cheat Sheet (disemak 2026-11-14)](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [GitHub Docs, secret scanning (disemak 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning)
-   [GitHub Docs, tentang push protection (disemak 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection)
