> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Anahtarları

> Living Security Public API'ye yapılan istekleri doğrulayan kimlik bilgilerini oluşturun, döndürün ve iptal edin.

API anahtarları, `/v1` Public API'ye yapılan istekleri doğrular. Her anahtar bir [hizmet hesabına](/tr/developers/developer-hub/service-accounts) aittir ve
o hesabın ayrıntı sayfasından, [Developer Hub](/tr/developers/developer-hub/overview) üzerinden
oluşturulur.

Bir gizli anahtarın güvenli biçimde saklanması ve döndürülmesi gereksinimlerinizi karşılıyorsa, özel bir arka uç entegrasyonu için kapsamı sınırlandırılmış bir API anahtarı kullanın. OAuth istemcisi veya belirteç
değişimi gerekmez. Kuruluşunuz bunun yerine kısa ömürlü OAuth erişim belirteçleri gerektiriyorsa [Kimlik Doğrulama](/tr/developers/v1/authentication) bölümüne bakın.

## Anahtarın yapısı

* **Tanımlayıcı** — `ak_` ile başlar. Destek kayıtlarında, günlüklerde ve yapılandırmada
  güvenle referans verilebilir; tek başına hiçbir yetki sağlamaz.
* **Gizli anahtar** — `lsk_live_` ile başlar. Entegrasyonunuzun sunduğu kimlik bilgisi budur. Oluşturma veya döndürme sırasında yalnızca **bir kez** gösterilir ve
  sonradan alınamaz. Anahtar listesinde yalnızca son dört
  karakter (örneğin `lsk_live_…xQc4`) gösterilir; böylece bir satırı, çağıranın elindeki
  kimlik bilgisiyle eşleştirebilirsiniz.
* **İzinleri** — anahtarın sahibi olan hizmet hesabının izinlerinin, oluşturma sırasında seçilen bir alt kümesi. Bir anahtar, hesabın izin verdiğinden fazlasını asla yapamaz.
* **Son kullanma tarihi** — zorunludur. Her anahtarın bir son kullanma tarihi vardır.

<Warning>
  Gizli anahtarları gösterildikleri anda bir gizli anahtar yöneticisinde saklayın. Bunları asla sürüm kontrolüne eklemeyin, istemci tarafı koduna gömmeyin veya sohbette paylaşmayın. Gizli anahtara sahip olan herkes, anahtarın izinleriyle işlem yapabilir.
</Warning>

## Anahtar oluşturma

Hizmet hesabının ayrıntı sayfasında dört adımda anahtar oluşturursunuz:
anahtara ad verin, bu belirli anahtarın ihtiyaç duyduğu izinleri seçin, bir son kullanma süresi belirleyin
— 30, 90 veya 365 gün ya da bir yıla kadar özel bir süre — ve gözden geçirin. Gizli anahtar
tamamlandığında yalnızca bir kez görüntülenir.

Hesap daha fazlasına izin verse bile her anahtarın kapsamını, çağıranın ihtiyaç duyduğu en dar izin kümesiyle sınırlandırın.
Bir anahtar sızarsa, etki alanı o anahtarın izinleriyle sınırlı kalır.

## Kesinti olmadan döndürme

Döndürme, yeni bir gizli anahtar üretir ve 1 saat, 24 saat veya 7 gün süren bir çakışma penceresi başlatır; bu süre boyunca **eski gizli anahtar çalışmaya devam eder**. Böylece yeni gizli anahtarı dağıtımlarınıza kendi hızınızda uygulayabilirsiniz:

<Steps>
  <Step title="Anahtarı döndürün">
    En yavaş dağıtım yolunuzu kapsayacak bir çakışma penceresi seçin. Yeni
    gizli anahtar yalnızca bir kez gösterilir; hemen saklayın.
  </Step>

  <Step title="Entegrasyonlarınızı güncelleyin">
    Eski gizli anahtarı yapılandırıldığı her yerde değiştirin. Anahtarın durumu,
    pencere sona erene kadar çakışma durumunda olarak görünür.
  </Step>

  <Step title="Pencere kapanmadan önce doğrulayın">
    Trafiğin yeni gizli anahtara geçtiğini doğrulamak için [istek günlüklerini](/tr/developers/developer-hub/request-logs) kullanın. Çakışma sona erdiğinde eski gizli anahtar
    artık kimlik doğrulamaz.
  </Step>
</Steps>

Anahtarları son kullanma tarihinden önce de döndürün: son kullanma tarihine yaklaşan anahtarlar, anahtar listesinde süresi dolmak üzere olarak işaretlenir. Süresi dolmuş bir anahtar kimlik doğrulamayı durdurur;
bu anahtarla yapılan istekler, [`credential_expired`](/tr/developers/v1/errors/credential_expired) koduyla bir `401` döndürür.

## Anında iptal

İptal işlemi hemen geçerli olur ve kalıcıdır; çakışma penceresi yoktur ve geri alınamaz. Gizli anahtarının açığa çıktığından şüphelendiğiniz anda anahtarı iptal edin; sağlıklı bir kimlik bilgisini değiştiriyorsanız bunun yerine döndürme işlemini kullanın.

İptal edilmiş bir anahtarla yapılan istekler, [`credential_revoked`](/tr/developers/v1/errors/credential_revoked) koduyla bir `401` döndürür. Bir entegrasyonun sahip olduğu tüm anahtarları
aynı anda durdurmanız gerekiyorsa, bunun yerine hizmet hesabını devre dışı bırakın.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.