Ne zaman yenilemeli?
Etsy düzenli bir takvim zorunlu tutmaz ama üç durumda yenilemeyi önerir (Etsy: Rotating Your Shared Secret):
- Secret açığa çıkmış olabilir: kod deposuna girmiş, yanlışlıkla paylaşılmış ya da bir kayıt dosyasına düşmüştür.
- Erişimi olan bir çalışan ya da yüklenici ayrılmıştır.
- Genel güvenlik alışkanlığı olarak; eski yedeklerde kalan kopyaların ömrünü kısaltmak için.
Birincil ve ikincil secret
| Etiket | Nedir | Ne zaman vardır |
|---|---|---|
| Primary | Bugün kullandığınız asıl secret | Her zaman; her uygulamada bir tane bulunur |
| Secondary | Rotasyon için üretilen yeni secret | Yalnız geçiş penceresinde |
İkisi aynı anda geçerlidir. Böylece birden fazla sunucu, zamanlanmış iş ya da test ortamı kullanıyorsanız her birini sırayla güncelleyebilirsiniz. Aynı anda yalnız bir ikincil secret olabilir.
Adım adım rotasyon
| Adım | Portalda | Sonuç |
|---|---|---|
| 1 | Rotate shared secret, ardından Generate a new secret | Yeni secret ikincil olarak oluşur; eskisi çalışmaya devam eder |
| 2 | Yeni değeri tüm sistemlere dağıtın | Sunucular, işler, test ortamı ve bağlı yazılımlar |
| 3 | Her ortamı ayrı ayrı sınayın | Yeni secret'lı istekler başarılı olmalı |
| 4 | I've completed the rotation | Eski secret kalıcı olarak silinir, yenisi birincil olur |
Dördüncü adım geri alınamaz. Eski değeri kullanan bir sistem kalırsa o sistem hemen hata almaya başlar. Yeni secret'ı ilk adımda kopyalayıp bir gizli bilgi yöneticisine kaydedin; ortam değişkenleri ve sürekli entegrasyon ayarları da güncellenecekler listesindedir.
İptal ve otomatik tamamlanma
Bir sorun çıkarsa tamamlamadan önce "Cancel, keep original secret" ile iptal edebilirsiniz. Bu yalnız yeni secret'ı siler; eskisi çalışmaya devam eder. Yeni değere geçirdiğiniz sistemleri eski değere döndürmeyi unutmayın. Daha sonra yeni bir rotasyon başlatıp taze bir secret alabilirsiniz.
Rotasyonu başlatıp ne tamamlar ne de iptal ederseniz Etsy bir süre sonra işlemi kendisi tamamlar: eski secret silinir, yenisi birincil olur. Etsy bunu, başlatılmış rotasyonu eski secret'ın tehlikede olabileceği işareti saydığı için yapar. Süre değişebildiği için belgede yazmaz; panelde görünür. Etsy otomatik tamamlanmadan iki gün önce bir hatırlatma gönderir.
Sık sorulanlar
Etsy keystring değiştirilebilir mi?
Hayır. Etsy'ye göre keystring kalıcıdır. Yenilenebilen parça yalnız shared secret'tır.
Secret yenilerken uygulamam durur mu?
Adımlara uyarsanız durmaz. Rotasyon tamamlanana kadar eski ve yeni secret birlikte kabul edilir.
Rotasyonu tamamlamayı unutursam ne olur?
Etsy bir süre sonra rotasyonu kendisi tamamlar ve eski secret'ı siler. Yeni değeri her yere dağıttıysanız bir şey değişmez; dağıtmadıysanız eski değeri kullanan sistemler hata alır.
Eski secret'ı yenisini üretmeden silebilir miyim?
Hayır. Her uygulamanın bir birincil secret'ı olmalıdır. Eski değer yalnız rotasyon tamamlanırken silinir.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı