Uygulamanızın özel kimlik bilgilerini Atoms Bulutu → Anahtarlar içinde saklayarak değerlerini Chat ve kaynak kodunun dışında tutun ve ayrı Test ve Production değerlerini yönetin.

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 kullanma

Başlamadan önce

Bir anahtar eklemeden önce şunlardan emin olun:

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

Anahtarlar veya New Key kullanılamıyorsa, amaçlanan projeyi açtığınızı ve projenin Atoms Bulutu'na bağlı olduğunu doğrulayın. New Key hâlâ kullanılamıyorsa, ç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 masaüstü bir 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 Keys'i açın, ardından In This Project'i seçin.
5. New Key'i seçin.
6. Gerekli alanları doldurun:
   • Name: RESEND_API_KEY gibi açık bir referans adı girin. Harfler, rakamlar ve alt çizgi kullanın; bir harf veya alt çizgi ile başlayın.
   • Value: Kimlik bilgisini sağlayıcı tarafından verildiği şekliyle tam olarak girin.
   • Description: Anahtarın ne için olduğunu, örneğin Used to send account emails şeklinde açıklayın. Kimlik bilgisi değerini eklemeyin.
7. Anahtarı diğer projelerde yeniden kullanmak istiyorsanız, Save to Library'yi seçin.
8. Add'i seçin. Anahtar kaydedildiğinde Atoms Key added successfully 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 sorun.

Chat'te kayıtlı bir anahtar kullanın

Bir mesaja değerini girmek yerine kayıtlı 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. Kayıtlı 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ü, kayıtlı anahtarın değerini mesajınıza eklemeden ona bir referans ekler.

Chat'te kayıtlı bir anahtara başvurun

Kayıtlı bir anahtarı test edin

1. Uygulama Görüntüleyici'de anahtarı kullanan basit bir işlem gerçekleştirin.
2. Test e-postası gönderilmesi veya test verilerinin döndürülmesi gibi beklenen sonucu verdiğini doğrulayın.
3. Görünür 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ınlandı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.

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'a kaydedin, ardından kaydedilen 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 döndürün.

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

Anahtarlar, kaydedilen değerleri Public veya Private olarak etiketlemez. Bir değeri Anahtarlar'a kaydetmek, onu tarayıcıya dönük kodda kullanmak için 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 projeler için de kullanılabilir mi olacağı.

Bir ortam seçin

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

Anahtarın nereye kaydedileceğini seçin

Seçenek	Ne zaman kullanılır
In This Project	Bunu, yalnızca mevcut proje tarafından kullanılması gereken bir anahtar için seçin.
Key Library	Bunu, bir anahtarı birden fazla projede yeniden kullanmak istediğinizde seçin. Bir Test anahtarı eklerken veya güncellerken, onu kütüphanede kullanılabilir hâle getirmek için Save to Library'yi seçin.

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

Varsayılan olarak In This Project'i kullanın. Bir anahtarı yalnızca projeler arasında paylaşılması gerektiğinden eminseniz kütüphaneye kaydedin.

Ayrı bir Production değeri kullanın

Kayıtlı bir anahtar kullanan bir projeyi yayınladığınızda, yayınlama akışı sizden Production Keys'i yapılandırmanızı isteyebilir. Varsayılan olarak yayınlanan 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 sunuyorsa.
• Geliştirme sırasında kullanılan kimlik bilgisinin yayınlanan uygulama tarafından kullanılmasını istemiyorsanız.

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

Uygulamayı yayınladıktan veya güncelledikten sonra, Production anahtarının doğru çalıştığını doğrulamak için yayınlanan web sitesinde ilgili kullanıcı yolculuğunu tekrar edin. Tam dağıtım süreci için Publish and deploy bölümüne bakın.

Bir kimlik bilgisini güncelleyin veya döndürün

Kayıtlı bir Test değerini güncelleyin

1. Atoms Bulutu → Anahtarlar → Test Keys'i açın.
2. Girdinin nereye kaydedildiğine bağlı olarak In This Project veya Key Library'yi açın.
3. Anahtarın Value veya Description alanını seçin, güncellenmiş bilgileri girin, ardından Update'i seçin.
4. Save success mesajını bekleyin, ardından etkilenen akışı tekrar test edin.

Planlı anahtar döndürme

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'de test edin.
3. Yayınlanan uygulama ayrı bir Production değeri kullanıyorsa, onu değiştirin ve güncellemeyi yayınlayın.
4. Aynı özelliği yayınlanan web sitesinde test edin.
5. Yedek kimlik bilgisinin doğru çalıştığını doğruladıktan sonra, eski kimlik bilgisini sağlayıcı üzerinden iptal edin.

Bir kimlik bilgisi açığa çıkmış olabilirse

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

1. Bunu hizmet sağlayıcı üzerinden iptal edin veya devre dışı bırakın.
2. Bir yedek kimlik bilgisi oluşturun.
3. Atoms'taki ilgili Test ve Production değerlerini güncelleyin.
4. Etkilenen özellikleri hem Uygulama Görüntüleyici'de hem de yayınlanan uygulamada tekrar test edin.
5. Mümkün olduğunda kaynak koddan, Chat'ten, ekran görüntülerinden ve günlüklerden açığa çıkmış tüm kopyaları kaldırın.

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

Bir kimlik bilgisini kaldırın

Kayıtlı 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 kayıtlı anahtarla değiştirin.
2. Artık kullanılamaması için orijinal kimlik bilgisini hizmet sağlayıcı üzerinden iptal edin.
3. Atoms Bulutu → Anahtarlar'ı açın, etkin olmayan girdiyi bulun, Delete'i seçin ve onaylayın.

Bir anahtarı silme işlemi geri alınamaz. Bu, hâlâ ona başvuran önizlemeleri veya eski kontrol noktalarını da bozabilir. Delete kullanılamıyorsa, anahtar hâlâ etkin olarak işaretlenmiştir. Tekrar denemeden önce ona yapılan tüm referansları kaldırın veya değiştirin.

SSS

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

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

1. İlgili Test veya Production değerinin son yayından önce mi sonra mı kaydedildiğini kontrol edin. Sonradan kaydedildiyse, değişikliğin etkili olması için yeniden yayınlayın.
2. Kaydedilen 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ınlanan 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 hassas bilgiler temizlenmiş ekran görüntüsü
• Anahtar yapılandırmasının yayınlamadan önce mi sonra mı kaydedildiği

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