Sırlar Yönetimi

Güvenli Kimlik Bilgisi Depolama

Uygulamanızın SendGrid aracılığıyla e-posta göndermek, Stripe ile ödemeleri işlemek veya yapay zekâ özellikleri için OpenAI kullanmak gibi harici hizmetlere bağlanması gerektiğinde, API anahtarlarını ve kimlik bilgilerini güvenli bir şekilde saklamanız gerekir. Kliv'in sır yönetim sistemi bunu otomatik olarak yönetir.

Sırları güvenli kılan şeyler:

  • Veritabanında şifreli depolama
  • Siz kaydettikten sonra hiçbir zaman tam olarak görüntülenmez
  • Gerektiğinde edge function'lara otomatik olarak enjekte edilir
  • Hesap genelinde yani her anahtarı yalnızca bir kez saklarsınız
  • Denetim kayıtları, sırların ne zaman oluşturulduğunu veya güncellendiğini takip eder

Sırlar Nasıl Çalışır?

Yapay zekâya harici bir hizmetle entegrasyon yapmak istediğinizi söylediğinizde gerekli kimlik bilgilerini isteyecektir. Bir API anahtarı sağladığınızda, yapay zekâ bunu açıklayıcı bir adla (örneğin OPENAI_API_KEY veya STRIPE_SECRET_KEY) güvenli bir şekilde saklar. O andan itibaren, bu kimlik bilgilerine ihtiyaç duyan herhangi bir edge function buna otomatik olarak erişebilir.

Maskeli ekran: Bir sırrı kaydettikten sonra yönetici arayüzünde yalnızca kısmen maskelenmiş bir sürümü görürsünüz. Örneğin, sk-proj-abc123xyz789, sk-p****9789 olarak görünür. Bu, tam değeri açığa çıkarmadan hangi anahtarın hangisi olduğunu doğrulamanıza olanak tanır.

Otomatik enjeksiyon: Bir edge function çalıştığında, başvurduğu sırlar yalnızca o çalışma için güvenli bir şekilde enjekte edilir. Yapay zekâ, işlevi bunları platformun sır arayüzü üzerinden okuyacak şekilde yazar ve platform, çalışma zamanında gerçek değeri sağlar; böylece değiştirilen bir anahtar, işlevin bir sonraki çalışmasında geçerli olur.

Sırları Yönetmek

Yönetici arayüzünden şunları yapabilirsiniz:

  • Tüm sırlarınızı görüntüleyin (maskelenmiş değerlerle)
  • Yeni sırlar ekleyin veya mevcut sırları güncelleyin
  • Artık ihtiyacınız olmayan sırları silin
  • Her sırrın ne zaman oluşturulduğunu veya en son güncellendiğini görün

Yapay zekâ, oluşturmak istediğiniz entegrasyonları açıkladığınızda sizin için sırlar oluşturabilir ve güncelleyebilir.

Sırların yaygın kullanımları

  • E-posta hizmetleri: SendGrid, Mailgun veya SMTP kimlik bilgileri
  • Ödeme işleme: Stripe, PayPal veya diğer ödeme API anahtarları
  • Yapay zekâ hizmetleri: OpenAI, Anthropic veya Google API anahtarları
  • SMS/arama: Twilio kimlik doğrulama token'ları
  • Harici API'ler: Uygulamanızın entegre olduğu herhangi bir üçüncü taraf hizmeti
  • Webhook'lar: Gelen webhook'ları doğrulamak için imzalama sırları
  • Veritabanı bağlantıları: Harici veritabanları için bağlantı dizeleri

En İyi Uygulamalar

✅ Açıklayıcı adlar kullanın - Sırlara key1 veya secret yerine SENDGRID_API_KEY gibi açık adlar verin.

✅ Düzenli olarak değiştirin - Özellikle kritik hizmetler için sırları düzenli aralıklarla güncelleyin.

✅ Bittiğinde sil - Artık kullanmadığınız hizmetlere ait sırları kaldırın.

❌ Sırları paylaşmayın - Her ortam (test, üretim) farklı API anahtarlarını kullanmalıdır.

❌ Koda commit etmeyin - Sırlar, bir nedenden dolayı kodunuzdan ayrı olarak saklanır. API anahtarlarını asla doğrudan kaynak dosyalarınıza koymayın.


İlgili Belgeler: