---
title: "API anahtarı güvenliği: ortam değişkeni, rotasyon, IP"
description: "LLM API anahtarlarını koddan ve loglardan uzak tutun: iş yükü başına anahtar, düzenli rotasyon, sunucu IP'sine kilit ve sızıntıyı saniyeler içinde iptal."
url: https://broadrouter.com/tr/blog/llm-api-key-security/
lang: tr
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/blog/llm-api-key-security/) (güncelleme: 2026-11-15).

# LLM API anahtarı güvenliği: saklama, rotasyon ve IP izin listeleri

BroadNet Inference ekibi · 6 dk okuma · Yayımlandı 2026-11-14 · Güncellendi 2026-11-15

LLM API anahtarlarını kodda veya tarayıcıda değil, bir gizli bilgi yöneticisinde (secret manager) saklayın. Her uygulama veya ajana ayrı anahtar verin, anahtarları düzenli olarak yenileyin ve IP izin listesiyle sunucularınıza kilitleyin. BroadNet Inference'a göre izin listeleri 32 kayıt alır, iptal yeni istekleri beş saniye içinde durdurur ve anahtarlar bir yıl geçerlidir.

## Öne çıkanlar

-   Anahtarı asla bir tarayıcıya veya mobil uygulamaya koymayın; LLM'i kendi sunucunuzdan çağırın.
-   Her iş yüküne bir anahtar: BroadNet hesabı başına en fazla 10 etkin anahtar, sızıntıları kolayca izole etmenizi sağlar.
-   IP izin listeleri, çalınan bir anahtarın başka bir yerde çalışmasını engeller. BroadNet en fazla 32 IPv4, IPv6 veya CIDR kaydı kabul eder.
-   BroadNet Inference'ta iptal ve izin listesi değişiklikleri beş saniye içinde geçerli olur.
-   Anahtarların süresi oluşturulduktan bir yıl sonra dolar; bu yüzden rotasyon acil durum değil, rutin bir iş olmalıdır.

**Bu sayfada**

1.  LLM API anahtarı nerede saklanmalı?
2.  API anahtarı tarayıcıya veya mobil uygulamaya konabilir mi?
3.  Her iş yüküne neden ayrı anahtar verilmeli?
4.  IP izin listeleri bir anahtarı nasıl korur?
5.  Çıkarım anahtarları neden yönetici kimlik bilgilerinden ayrı tutulmalı?
6.  API anahtarları ne sıklıkla yenilenmeli?
7.  Bir anahtar sızdığında ne yapılmalı?
8.  Anahtarlar loglar üzerinden nasıl sızar?
9.  Henüz fark etmediğiniz bir sızıntının zararı nasıl sınırlanır?
10.  BroadNet Inference hangi anahtar kontrollerini sunuyor?

Bir LLM API anahtarını güvende tutmak için onu bir gizli bilgi yöneticisinde saklayın ve modeli tarayıcıdan veya uygulamadan değil, yalnızca sunucunuzdan çağırın. Her iş yüküne ayrı bir anahtar verin, anahtarları belirli aralıklarla yenileyin (rotasyon), izin listesiyle sunucu IP’lerinize kilitleyin ve sızan bir anahtarı önce iptal edin, sonra araştırın.

Bu yazı anahtarları güvende tutan alışkanlıkları, BroadNet Inference’ın sunduğu somut kontrollerle birlikte anlatıyor. Portalda adım adım yapılacaklar için [API anahtarları ve IP izin listeleri rehberine](https://broadrouter.com/tr/guides/api-keys-ip-allow-lists/), bütçeler ve kontrolden çıkan döngülere karşı koruma için [LLM API harcama kontrolü](https://broadrouter.com/tr/blog/llm-api-spend-control/) yazısına bakın.

## LLM API anahtarı nerede saklanmalı?

Anahtarları kodda değil, bir gizli bilgi yöneticisinde veya platformunuzun şifreli gizli bilgilerinde saklayın. [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html) seçenekleri ayrıntılı anlatıyor. Uyarısına dikkat edin: ortam değişkenleri “are generally accessible to all processes and may be included in logs or system dumps” (BroadRouter çevirisi: “genellikle tüm süreçler tarafından erişilebilir ve loglara veya sistem dökümlerine dahil olabilir”); bu yüzden OWASP, seçme imkânınız olduğunda bağlanmış (mount edilmiş) gizli dosyaları veya gizli bilgileri bir gizli bilgi deposundan çekmeyi tercih ediyor. Başlangıçta bir gizli bilgi yöneticisinden doldurulan ortam değişkeni, yaygın orta yoldur.

```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
)
```

Sabit kodlanmış bir yedek değerle `os.getenv(...)` değil, `os.environ[...]` kullanın; anahtarlar Git’e genellikle böyle yedek değerler yüzünden düşer. Yerel geliştirmede `.env` dosyası, ilk commit’ten itibaren `.gitignore` içindeyse sorun değildir. Git barındırma hizmetinizin gizli bilgi taramasını ve push korumasını açın. GitHub’da [push protection](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection), bilinen gizli bilgi biçimlerini içeren push’ları depoya ulaşmadan engeller. Kullanıcılar için push protection varsayılan olarak açıktır; ancak depo düzeyindeki push protection varsayılan olarak kapalıdır ve bir depo yöneticisi veya kuruluş sahibi tarafından etkinleştirilmesi gerekir.

## API anahtarı tarayıcıya veya mobil uygulamaya konabilir mi?

Hayır. İstemciye gönderilen her şey dışarı çıkarılabilir. Ön yüz kodu ve uygulama paketleri, ne kadar küçültülmüş (minify) veya karıştırılmış (obfuscate) olursa olsun herkese açıktır. LLM’i sunucunuzdan çağırın, kendi kullanıcılarınızın kimliğini orada doğrulayın ve isteği iletmeden önce kullanıcı başına kendi sınırlarınızı uygulayın.

Başkalarına verdiğiniz masaüstü araçları için de aynısı geçerli. Bir ekip arkadaşınızın bir kodlama ajanına erişmesi gerekiyorsa tek bir anahtarı paylaşmak yerine ona kendi hesabında kendi anahtarını verin.

## Her iş yüküne neden ayrı anahtar verilmeli?

BroadNet Inference’ta bir hesapta **en fazla on etkin anahtar** olabilir. Bunları kullanın:

| Anahtar etiketi | Kullanan |
| --- | --- |
| `prod-api` | Üretim arka ucu |
| `prod-worker` | Toplu işler |
| `staging` | Staging ortamı |
| `agent-ci` | CI’daki kodlama ajanı |
| `dev-laptop-<name>` | Yerel geliştirme |

Biri sızarsa yalnızca o anahtarı iptal edersiniz, diğerleri çalışmaya devam eder. Etiketler kullanımı da okunur kılar: hangi iş yükünün ne kadar harcadığını görebilirsiniz. Anahtarlara onları kimin oluşturduğuna göre değil, neyin kullandığına göre ad verin.

## IP izin listeleri bir anahtarı nasıl korur?

Bir [IP izin listesi](https://broadrouter.com/tr/glossary/ip-allow-list/), çalınan bir anahtarın kendi altyapınız dışında hiçbir yerde çalışmaması demektir. BroadNet Inference’ta:

-   Hesap izin listesi **en fazla 32 kayıt** alır; her satıra bir IPv4 veya IPv6 adresi ya da CIDR aralığı.
-   Boş liste, kısıtlama olmadığı anlamına gelir.
-   Yeni anahtarlar hesap listesini devralır; ancak kendi `allowed_ips` değeriyle oluşturulan bir anahtarda bu liste, o anahtar için devralınan listenin yerine geçer.
-   Listenin dışındaki bir adresten gelen istek 403 ile reddedilir (“refused by model, route or IP policy”; BroadRouter çevirisi: “model, rota veya IP politikası tarafından reddedildi”).

Portal API’si üzerinden kendi listesi olan bir anahtar oluşturun:

```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"]}'
```

Yanıt, ham anahtarı yalnızca bir kez içerir. Hemen gizli bilgi yöneticinize kaydedin; sonradan tekrar okunamaz. Tüm adımlar [IP izin listesi rehberinde](https://broadrouter.com/tr/guides/api-keys-ip-allow-lists/).

İzin listeleri, çıkış (egress) IP’si sabit olan sunuculara uyar: bir VPS, bir NAT ağ geçidi, sabit bir ofis IP’si. Ağı sürekli değişen dizüstü bilgisayarlar için listesi olmayan ayrı bir anahtar kullanın ve o anahtarın risk altındaki bakiyesini küçük tutun.

## Çıkarım anahtarları neden yönetici kimlik bilgilerinden ayrı tutulmalı?

BroadNet iki tür kimlik bilgisi kullanır:

| Kimlik bilgisi | Neler yapabilir | Nerede saklanır |
| --- | --- | --- |
| Çıkarım anahtarı | `/v1/*` adresine model istekleri | Uygulamanın çalıştığı her yerde |
| Portal kimlik bilgisi | Anahtar oluşturma ve iptal etme, izinli IP’leri değiştirme, satın alma | Yalnızca otomasyon veya yönetim araçlarınızda |

Belgeler, her portal kimlik bilgisini hesap üzerinde tam yetki olarak görmenizi söylüyor. Portal kimlik bilgisini asla uygulamanızın yanına dağıtmayın. Uygulama sunucunuz ele geçirilirse saldırganın eline hesabın kontrolü değil, tek bir çıkarım anahtarı geçmelidir.

## API anahtarları ne sıklıkla yenilenmeli?

OWASP, düzenli rotasyonu “so that any stolen credentials will only work for a short time” (BroadRouter çevirisi: “çalınan kimlik bilgileri yalnızca kısa bir süre işe yarasın diye”) öneriyor. BroadNet anahtarları oluşturulduktan sonra **bir yıl** geçerlidir; yani her anahtarın zaten bir gün değiştirilmesi gerekecek. Rotasyonu rutin hâle getirin:

1.  Aynı etiket düzeni ve izin listesiyle yeni bir anahtar oluşturun.
2.  Eskisinin yanına dağıtın ya da gizli bilgiyi değiştirip yeniden başlatın.
3.  Trafiğin yeni anahtara geçtiğini izleyin.
4.  Eski anahtarı `DELETE /portal/keys/{alias}` ile iptal edin.

Bir hesapta en fazla on etkin anahtar olabildiği için eski ve yeni anahtarı birkaç dakika birlikte çalıştırıp kesinti yaşamadan geçiş yapabilirsiniz. Ekipten ayrılan birinin erişimi olan anahtarları daha erken yenileyin.

## Bir anahtar sızdığında ne yapılmalı?

Bir anahtar sızdığında önce iptal edin, sonra araştırın. BroadNet Inference’ta iptal veya izin listesi değişikliğinden sonra yeni istekler **beş saniye içinde** durur; belgeler, yetkilendirme kararlarının bu sınırlı süre boyunca çoğaltılmış bir önbellekte kalabileceğini açıklıyor.

İptalden sonra:

-   anahtarın kullanımını hesap sayfasından veya `GET /portal/usage` ile kontrol edin;
-   nasıl sızdığını bulun (commit geçmişi, CI logları, paylaşılmış bir ekran görüntüsü);
-   aynı yerde saklanan diğer gizli bilgileri de yenileyin.

İptal edilmiş veya engellenmiş bir anahtar 401 ya da 403 döndürür; izleme sisteminizin bunları geçici hata saymaması için [hatalar rehberine](https://broadrouter.com/tr/guides/errors-and-retries/) bakın.

## Anahtarlar loglar üzerinden nasıl sızar?

Loglar gözden kaçması kolay bir sızıntı kaynağıdır. HTTP hata ayıklama loglarında, hata raporlayıcılarda ve proxy erişim loglarında `Authorization` başlığını maskeleyin. Destek ekibiyle iletişime geçtiğinizde anahtarın kendisini asla göndermeyin; `X-Request-ID`, zaman damgası, rota, durum ve anahtar **takma adını** (alias) gönderin. BroadNet’in belgelerine göre portal her anahtarın yalnızca hash değerini saklar; bu yüzden kaybettiğiniz bir anahtarı size gösteremez.

## Henüz fark etmediğiniz bir sızıntının zararı nasıl sınırlanır?

Yukarıdaki tüm alışkanlıklara rağmen bir anahtarın bir gün sızabileceğini varsayın. Etki alanını küçültün:

-   Kullandıkça öde bakiyesini kaybetmeyi göze alabileceğiniz bir düzeyde tutun ve gerektikçe bakiye yükleyin.
-   Yoğun çalışan ajanlar için sabit fiyatlı bir plan kullanın: plan oturumunun fiyatı sabittir, bu yüzden çalınan bir plan anahtarı token başına fatura biriktiremez. Bkz. [sınırsız aslında ne demek](https://broadrouter.com/tr/blog/what-unlimited-llm-api-really-means/).
-   Anahtar başına olağan dışı harcama veya istek hızları için uyarı kurun; [LLM API maliyet hesaplayıcısı](https://broadrouter.com/tools/llm-api-cost-calculator/), uyarıyı karşılaştıracağınız normal aylık rakamı verir. [LLM API harcama kontrolü](https://broadrouter.com/tr/blog/llm-api-spend-control/) yazımız bütçeleri ve uyarıları anlatıyor.

## BroadNet Inference hangi anahtar kontrollerini sunuyor?

| Kontrol | BroadNet Inference |
| --- | --- |
| Anahtar bir kez gösterilir, hash olarak saklanır | Evet |
| Hesap başına etkin anahtar | En fazla 10 |
| Anahtar ömrü | Bir yıl |
| IP izin listesi | En fazla 32 IPv4, IPv6 veya CIDR kaydı |
| Anahtar başına izin listesi | Evet, oluştururken `allowed_ips` |
| İptalin geçerli olması | Beş saniye içinde |
| Ayrı yönetici kimlik bilgisi | Portal kimlik bilgisi |

Anahtarlar hesabınızı korur; [sıfır veri saklama](https://broadrouter.com/tr/privacy/) ise hesap üzerinden gönderdiklerinizi. Yayına almadan önce ikisini de okuyun.

Bu konu için ücretsiz araçlar (İngilizce)

-   [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.

[Ücretsiz araçlar (İngilizce)](https://broadrouter.com/tools/)

## Bu yazıdaki terimler

[API anahtarı (API key)](https://broadrouter.com/tr/glossary/api-key/)

API anahtarı, bir API'yi çağıran istemciyi tanımlayan ve yetkilendiren gizli bir dizedir. LLM API'leri genellikle anahtarı Authorization: Bearer başlığında bekler; anahtarı elinde tutan herkes, sahibi olan hesaba faturalandırılan istekler yapabilir.

[IP izin listesi (IP allow list)](https://broadrouter.com/tr/glossary/ip-allow-list/)

IP izin listesi, yalnızca listelenen IP adreslerinden veya CIDR aralıklarından gelen istekleri kabul edip diğer tümünü reddeden bir güvenlik denetimidir. Bir API'de sızdırılmış bir anahtarın vereceği zararı sınırlar, çünkü anahtar listede olmayan ağlardan çalışmaz.

[Araç çağırma (tool calling)](https://broadrouter.com/tr/glossary/tool-calling/)

Araç çağırma (tool calling), fonksiyon çağırma (function calling) olarak da bilinir; modelin, geliştiricinin tanımladığı bir fonksiyonu çalıştırmak için JSON argümanlı yapılandırılmış bir istek döndürdüğü bir LLM API özelliğidir. Fonksiyonu uygulama çalıştırır ve sonucu geri gönderir; model hiçbir zaman kodu kendisi çalıştırmaz.

[Kullandıkça öde (pay-as-you-go)](https://broadrouter.com/tr/glossary/pay-as-you-go/)

Kullandıkça öde, abonelik veya asgari taahhüt olmadan yalnızca kullandığınız kadar ödediğiniz, token, istek veya ses dakikası gibi birimler üzerinden ölçülen bir fiyatlandırma modelidir. LLM API'lerinin çoğu bu şekilde, ön ödemeli bir bakiyeden veya dönemsel faturayla ücretlendirir.

[Sıfır veri saklama (ZDR)](https://broadrouter.com/tr/glossary/zero-data-retention/)

Sıfır veri saklama (ZDR), bir yapay zeka sağlayıcısının istemleri ve çıktıları yalnızca isteği karşılamak için işlediği ve bu içeriği sonrasında loglarda, önbelleklerde veya eğitim verilerinde saklamadığı bir veri işleme politikasıdır. Token sayıları ve süreler gibi içerik barındırmayan kayıtlar genellikle yine tutulur.

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

Token, bir dil modelinin okuduğu ve yazdığı metin birimidir: modelin tokenizer'ının ürettiği bir kelime, kelime parçası, noktalama işareti veya bayt dizisi. LLM API'leri kullanımı token cinsinden sayar, sınırlar ve genellikle faturalandırır.

[Yapay zekâ kodlama ajanı (AI coding agent)](https://broadrouter.com/tr/glossary/coding-agent/)

Yapay zekâ kodlama ajanı, bir dil modelinin bir kod tabanı üzerinde döngü içinde çalıştığı bir yazılım aracıdır: dosyaları okur, düzenler, testler gibi komutları çalıştırır, çıktıyı okur ve görev bitene ya da bir sınıra ulaşılana kadar bir sonraki adıma karar verir.

[Zaman damgaları (konuşmadan metne)](https://broadrouter.com/tr/glossary/timestamps-asr/)

Konuşmadan metnede zaman damgaları, transkriptin parçalarına eklenen saniye cinsinden başlangıç ve bitiş zamanlarıdır. Segment zaman damgaları bir ifadeyi veya cümleyi, kelime zaman damgaları her kelimeyi kapsar. Altyazılar, kayıt içinde arama ve metni konuşmacılarla hizalamak için gereklidir.

## Sık sorulan sorular

### LLM API anahtarını nerede saklamalıyım?

Bir gizli bilgi yöneticisinde veya platformunuzun şifreli gizli bilgilerinde saklayın ve sürece BROADNET\_API\_KEY gibi bir ortam değişkeni olarak aktarın. Kaynak kodda, commit'lenmiş bir .env dosyasında ve hiçbir zaman ön yüz (front-end) kodunda tutmayın.

### BroadNet Inference anahtarını ne kadar hızlı iptal edebilirim?

BroadNet'in belgelerine göre iptal veya izin listesi değişikliğinden sonra yeni istekler beş saniye içinde durur; çünkü yetkilendirme kararları bu sınırlı süre boyunca çoğaltılmış (replicated) bir önbellekte kalabilir.

### BroadNet Inference anahtarı ne kadar süre geçerli?

Kullandıkça öde anahtarı oluşturulduğu andan itibaren bir yıl geçerlidir. Bir hesapta en fazla on etkin anahtar olabilir; böylece eskisinin süresi dolmadan yenisini oluşturabilirsiniz.

### Anahtarımı kaybedersem BroadNet onu bana tekrar gösterebilir mi?

Hayır. BroadNet'in belgelerine göre ham anahtar yalnızca bir kez gösterilir ve portal yalnızca hash değerini saklar. Yeni bir anahtar oluşturup eskisini iptal edin.

### OpenAI uyumlu API anahtarım sızarsa ne yapmalıyım?

Önce iptal edin, sonra araştırın. Anahtarın kullanımında bilinmeyen trafik olup olmadığına bakın, nereden sızdığını bulun (commit geçmişi, CI logları, ekran görüntüleri), aynı yerde saklanan diğer gizli bilgileri de yenileyin ve IP izin listesi olan yeni bir anahtar oluşturun.

## Okumaya devam edin

-   [LLM API harcama kontrolü: bütçe, anahtar sınırı, döngü koruması](https://broadrouter.com/tr/blog/llm-api-spend-control/)
-   [LLM API'ye hassas veri göndermek: maskeleyin, azaltın, az kaydedin](https://broadrouter.com/tr/blog/llm-api-sensitive-data/)
-   [LLM API 429 hatası nasıl çözülür: geri çekilme, jitter, sınırlayıcılar](https://broadrouter.com/tr/blog/handle-llm-api-429-rate-limits/)
-   [GDPR ve LLM API'leri: sağlayıcınıza sormanız gereken 15 soru](https://broadrouter.com/tr/blog/gdpr-llm-api-checklist/)
-   [BroadNet'in GPU donanımı ve sunum yaklaşımı, BroadNet'in anlatımıyla](https://broadrouter.com/tr/blog/broadnet-gpu-fleet-and-serving/)
-   [LLM API yanıtlarını önbelleğe alıp maliyeti düşürün: Python örneği](https://broadrouter.com/tr/blog/cache-llm-responses-cut-cost/)
-   [Rehber: API anahtarlarını IP izin listeleriyle sunucularınıza kilitleyin](https://broadrouter.com/tr/guides/api-keys-ip-allow-lists/)
-   [Rehber: BroadNet Inference hata kodları ve ne zaman yeniden denenmeli](https://broadrouter.com/tr/guides/errors-and-retries/)
-   [Rehber: OpenAI Python SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/openai-python-sdk/)

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-llm-api-key-security&utm_content=page-cta) ·

**Kaynaklar**

-   [BroadNet Inference API referansı, sınırlar: anahtar ömrü, etkin anahtarlar (2026-11-14 tarihinde erişildi) (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-llm-api-key-security&utm_content=sources#limits)
-   [BroadNet Inference API referansı, IP izin listeleri ve portal anahtarları (2026-11-14 tarihinde erişildi) (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-blog-llm-api-key-security&utm_content=sources#ip-allow-lists)
-   [OWASP Secrets Management Cheat Sheet (2026-11-14 tarihinde erişildi)](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [GitHub Docs, gizli bilgi taraması (secret scanning) (2026-11-14 tarihinde erişildi)](https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning)
-   [GitHub Docs, push protection hakkında (2026-11-14 tarihinde erişildi)](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection)
