Anahtarlar ve gizli bilgiler

Anahtarlar kullanmadan önce, projeyi Atoms Bulutu'na bağlayın. Bağlı değilse, Agent'tan Atoms Bulutu'nu bağlamasını isteyin veya Atoms Bulutu bağlantısını izleyin.

Atoms Bulutu'nda bir anahtar kullanın

Başlamadan önce

Bir anahtar eklemeden önce şunlardan emin olun:

• Atoms'u masaüstü web'de kullanıyorsunuz.
• Proje Atoms Bulutu'na bağlı.
• Bir çalışma alanı sahibisiniz. Yalnızca çalışma alanı sahipleri yeni anahtar ekleyebilir.

Anahtarlar veya Yeni Anahtar kullanılamıyorsa, amaçlanan projeyi açtığınızı ve projenin Atoms Bulutu'na bağlı olduğunu doğrulayın. Yeni Anahtar hâlâ kullanılamıyorsa, bir çalışma alanı sahibi olduğunuzu doğrulayın. Atoms bir plan veya kullanım uygunluğu mesajı gösteriyorsa, ekrandaki uygunluk ya da yükseltme yolunu izleyin, ardından tekrar deneyin.

Bir Test anahtarı ekleyin

1. Projeyi bir masaüstü cihazda açın.
2. Uygulama Görüntüleyici'nin bulunduğu aynı çalışma alanı araç çubuğunda Atoms Bulutu'nu seçin.
3. Atoms Bulutu kenar çubuğunda Anahtarlar'ı seçin.
4. Test Anahtarları'nı açın, ardından Bu Projede'yi seçin.
5. Yeni Anahtar'ı seçin.
6. Gerekli alanları doldurun:
   • Ad: RESEND_API_KEY gibi açık bir referans adı girin. Harfler, sayılar ve alt çizgi kullanın; bir harf veya alt çizgi ile başlayın.
   • Değer: Kimlik bilgisini sağlayıcı tarafından verildiği şekliyle tam olarak girin.
   • Açıklama: Anahtarın ne için olduğunu açıklayın; örneğin Hesap e-postaları göndermek için kullanılır. Kimlik bilgisinin değerini eklemeyin.
7. Anahtarı diğer projelerde yeniden kullanmak istiyorsanız, Kitaplığa Kaydet'i seçin.
8. Ekle'yi seçin. Anahtar kaydedildiğinde Atoms Anahtar başarıyla eklendi gösterir.

Bir Test anahtarı ekleyin

Yalnızca çalışma alanı sahipleri yeni anahtar ekleyebilir. Bir anahtar eklenmesine ihtiyacınız varsa, bir çalışma alanı sahibine danışın.

Chat'te kaydedilmiş bir anahtarı kullanın

Mesaja değerini girmek yerine kaydedilmiş anahtara başvurun.

1. Atoms'un masaüstü sürümünde proje Chat'ini açın ve # yazın.
2. Anahtarlar'ı seçin.
3. Kaydedilmiş anahtarı arayın, ardından adını seçin.
4. Agent'a anahtarın ne için olduğunu ve entegrasyonun ne yapmasını istediğinizi söyleyin.

# menüsü, değeri mesajınıza eklemeden kaydedilmiş anahtara bir referans ekler.

Chat'te kaydedilmiş bir anahtara referans verin

Kaydedilmiş bir anahtarı test edin

1. Uygulama Görüntüleyici içinde, anahtarı kullanan basit bir işlem gerçekleştirin.
2. Test e-postası göndermek veya test verileri döndürmek gibi beklenen sonucu verdiğini doğrulayın.
3. Görünen hataları veya günlükleri inceleyin ve bunların anahtarın değerini açığa çıkarmadığından emin olun.

Hizmet size ayrı test ve canlı anahtarlar veriyorsa, uygulamanızı geliştirirken test anahtarını kullanın. Canlı anahtarı yalnızca uygulamanız yayımlandıktan sonra kullanın. Test başarısız olursa, anahtarın etkin olduğunu ve istenen işlemi gerçekleştirme iznine sahip olduğunu doğrulamak için sağlayıcının kontrol panelini kontrol edin. Sorun giderirken anahtarın değerini asla Chat'e yapıştırmayın.

Anahtarlar'ın nasıl çalıştığını anlayın

Anahtar eklemeden önce, Atoms'un ne sakladığını ve kimlik bilgilerinizi nasıl koruyacağınızı anlamak faydalıdır.

Atoms'un sakladıkları

Atoms Bulutu → Anahtarlar, uygulamanızın API anahtarları ve erişim jetonları gibi harici hizmetlere bağlanmak için kullandığı kimlik bilgilerini saklar.

Kaydedilen her anahtarın bir adı, açıklaması ve özel değeri vardır. Ad ve açıklama, Agent'ın anahtarı ne zaman kullanacağını anlamasına yardımcı olurken özel değer Chat'ten gizli kalır.

Bir anahtar nereden alınır

Atoms, harici hizmetler için kimlik bilgileri oluşturmaz veya sağlamaz. Bunları ilgili hizmet sağlayıcıdan edinmeniz gerekir. İzinleri seçerken, anahtarı test ederken ve süresinin dolup dolmadığını kontrol ederken sağlayıcının talimatlarını izleyin.

Özel kimlik bilgilerini gizli tutun

Özel bir kimlik bilgisini asla Chat'e, kaynak koda, tarayıcıda çalışan koda, ekran görüntülerine, günlüklere veya destek mesajlarına yapıştırmayın. Bunu Anahtarlar içinde kaydedin, ardından kaydedilmiş girdiye adıyla başvurun.

Özel bir değer zaten açığa çıktıysa, bunu tehlikeye girmiş kabul edin ve sağlayıcı üzerinden iptal edin veya değiştirin.

Özel ve tarayıcı için güvenli kimlik bilgileri

Anahtarlar, kaydedilmiş değerleri Public veya Private olarak etiketlemez. Bir değeri Anahtarlar içinde kaydetmek, onu tarayıcıya dönük kodda kullanmayı otomatik olarak güvenli hâle getirmez. Uygulamanız değeri tarayıcıda kullanıyorsa, ziyaretçiler onu inceleyebilir.

Bir kimlik bilgisini nerede kullanacağınıza karar vermeden önce sağlayıcının belgelerini kontrol edin:

• Bir değeri tarayıcıya dönük kodda yalnızca sağlayıcı bunun açığa çıkarılmasının güvenli olduğunu açıkça belirttiğinde kullanın.
• Özel kimlik bilgilerini, uygulama ziyaretçilerine açığa çıkmadıkları sunucu tarafı veya backend mantığında tutun.

Anahtarın ortamını ve depolamasını seçin

Bir anahtar eklerken iki ayrı karar vermeniz gerekir:

• Anahtarı hangi ortamın kullanacağı.
• Anahtarın bu projede mi kalacağı yoksa diğer projelerde de kullanılabilir mi olacağı.

Bir ortam seçin

Seçenek	Ne zaman kullanılır
Test Anahtarları	Uygulamanızı Uygulama Görüntüleyici içinde geliştirirken ve test ederken kullanılır. Ayrı bir Production değeri eklemezseniz, yayımlanan uygulama da Test değerini kullanır.
Production Anahtarları	Yayımlanan uygulama ayrı bir canlı kimlik bilgisi gerektirdiğinde kullanılır. Production değerleri yayımlama sürecinde eklenir ve Test değerlerinden ayrı yönetilir.

Anahtarın nereye kaydedileceğini seçin

Seçenek	Ne zaman kullanılmalı
Bu Projede	Yalnızca mevcut proje tarafından kullanılması gereken bir anahtar için bunu seçin.
Anahtar Kitaplığı	Bir anahtarı birden fazla projede bilerek yeniden kullanmak istediğinizde bunu seçin. Bir Test anahtarı eklerken veya güncellerken, kitaplıkta kullanılabilir hâle getirmek için Kitaplığa Kaydet'i seçin.

Ortam ve depolama konumu birbirinden bağımsızdır. Bir Test anahtarını Anahtar Kitaplığı'na kaydetmek onu yeniden kullanılabilir yapar, ancak onu Production değerine dönüştürmez.

Varsayılan olarak Bu Projede'yi kullanın. Bir anahtarı yalnızca projeler arasında paylaşılması gerektiğinden eminseniz kitaplığa kaydedin.

Ayrı bir Production değeri kullanın

Kaydedilmiş bir anahtar kullanan bir projeyi yayımladığınızda, yayımlama akışı sizden Production Anahtarları yapılandırmanızı isteyebilir. Varsayılan olarak yayımlanan uygulama Test değerini kullanır. Farklı bir kimlik bilgisi kullanmak için Production'ı seçin ve anahtar için ayrı bir değer kaydedin.

Ayrı bir Production değeri şu durumlarda kullanın:

• Sağlayıcı farklı test ve canlı kimlik bilgileri sağlıyorsa.
• Geliştirme sırasında kullanılan kimlik bilgisinin yayımlanan uygulama tarafından kullanılmasını istemiyorsanız.

Production değerleri yayımlama akışı üzerinden oluşturulur. Production Anahtarları sekmesinden Yeni Anahtar'ı seçerek bir tane oluşturamazsınız. Yayımlanmış bir uygulama için bir Production değeri yapılandırıldıktan sonra, bunu Atoms Bulutu → Anahtarlar → Production Anahtarları altında görüntüleyebilirsiniz.

Uygulamayı yayımladıktan veya güncelledikten sonra, Production anahtarının doğru çalıştığını doğrulamak için ilgili kullanıcı yolculuğunu yayımlanmış web sitesinde tekrarlayın. Tam dağıtım süreci için Yayımla ve dağıt bölümüne bakın.

Bir kimlik bilgisini güncelleyin veya değiştirin

Kaydedilmiş bir Test değerini güncelleyin

1. Atoms Bulutu → Anahtarlar → Test Anahtarları'nı açın.
2. Girdinin nereye kaydedildiğine bağlı olarak Bu Projede veya Anahtar Kitaplığı'nı açın.
3. Anahtarın Değer veya Açıklama alanını seçin, güncellenmiş bilgileri girin, ardından Güncelle'yi seçin.
4. Kaydetme başarılı mesajını bekleyin, ardından etkilenen akışı tekrar test edin.

Planlı anahtar değişimi

Mevcut kimlik bilgisi hâlâ güvenliyken ve uygulamanızı kesintiye uğratmadan değiştirmek istediğinizde şu adımları izleyin:

1. Hizmet sağlayıcı üzerinden bir yedek kimlik bilgisi oluşturun.
2. Atoms'taki Test değerini değiştirin, ardından etkilenen özelliği Uygulama Görüntüleyici içinde test edin.
3. Yayımlanan uygulama ayrı bir Production değeri kullanıyorsa, onu değiştirin ve güncellemeyi yayımlayın.
4. Aynı özelliği yayımlanmış web sitesinde test edin.
5. Yedeğin doğru çalıştığını doğruladıktan sonra, eski kimlik bilgisini sağlayıcı üzerinden iptal edin.

Bir kimlik bilgisi açığa çıkmış olabilir ise

Kimlik bilgisini tehlikeye girmiş kabul edin ve hemen harekete geçin:

1. Hizmet sağlayıcı üzerinden bunu iptal edin veya devre dışı bırakın.
2. Yeni bir kimlik bilgisi oluşturun.
3. Atoms'taki ilgili Test ve Production değerlerini güncelleyin.
4. Etkilenen özellikleri hem Uygulama Görüntüleyici'nde hem de yayımlanan uygulamada tekrar test edin.
5. Mümkünse kaynak kod, Chat, ekran görüntüleri ve günlüklerdeki açığa çıkmış kopyaları kaldırın.

Bir anahtarı silmek veya değerini Atoms'tan kaldırmak, özgün kimlik bilgisini iptal etmez. Bunu hizmet sağlayıcı üzerinden iptal etmeniz gerekir.

Bir kimlik bilgisini kaldırın

Kaydedilmiş bir anahtarı silmeden önce, uygulamanızın artık ona bağlı olmadığından emin olun:

1. Anahtarı kullanan özelliği kaldırın veya referanslarını başka bir kaydedilmiş anahtarla değiştirin.
2. Artık kullanılamaması için özgün kimlik bilgisini hizmet sağlayıcı üzerinden iptal edin.
3. Atoms Bulutu → Anahtarlar'ı açın, etkin olmayan girdiyi bulun, Sil'i seçin ve onaylayın.

Bir anahtarın silinmesi geri alınamaz. Ayrıca hâlâ ona referans veren önizlemeleri veya eski kontrol noktalarını bozabilir. Sil kullanılamıyorsa, anahtar hâlâ etkin olarak işaretlenmiştir. Tekrar denemeden önce ona yapılan her referansı kaldırın veya değiştirin.

SSS

Test anahtarım App Viewer'da çalışıyor ama yayımladıktan sonra çalışmıyor. Neden?

Test anahtarınız App Viewer'da çalışıyor ancak yayımlanan uygulama bir anahtar eksik veya boş olduğu için başarısız oluyorsa:

1. İlgili Test veya Production değerinin son yayımlamadan önce mi sonra mı kaydedildiğini kontrol edin. Sonra kaydedildiyse, değişikliğin etkili olması için yeniden yayımlayın.
2. Kaydedilmiş anahtarın doğru Test veya Production değerine sahip olduğunu doğrulayın. Ayrı bir Production değeri yapılandırılmadıkça yayımlanan uygulama Test değerini kullanır.
3. İpuçları için aşağı akış hizmeti hatalarını inceleyin. “Unauthorized” genellikle o ortam için boş veya yanlış bir anahtarı gösterir.

Sorun devam ederse, Destek ile iletişime geçin ve şunları ekleyin:

• Proje bağlantısı veya canlı URL
• Etkilenen anahtar adı ve sorunun Test mi yoksa Production değerinde mi olduğu
• Aşağı akış hizmetinden gelen tam hata
• Yapılandırma sayfasının gizli bilgiler temizlenmiş bir ekran görüntüsü
• Anahtar yapılandırmasının yayımlamadan önce mi sonra mı kaydedildiği

Önemli: Yalnızca anahtar adlarını paylaşın. Gizli değerler, parolalar veya jetonlar göndermeyin.