Güvenlik ve izinler

Nerede bulunur: Sol menü → Ayarlar → Yapay Zeka Erişimi Kimler için: Anahtar oluşturan ya da bir izni onaylayan herkes Kısaca: Anahtar sizin yetkilerinizin bir alt kümesini alır, salt okuma önerilir, yetki zamanla yalnız daralır ve iptal anında etki eder.

---

Temel kural: anahtar sizden fazlasını yapamaz

Anahtar üretildiğinde seçebileceğiniz yetkiler, sizin o mağazadaki yetkilerinizle kesiştirilir. Sizde olmayan bir yetkiyi anahtara veremezsiniz.

Üstelik kapı iki kez çalışır:

1. Çağrı geldiğinde anahtarın kapsamı kontrol edilir.
2. İş panelin kendi ucundan geçerken panelin izin kapısı yeniden kontrol eder.

İkisinden biri "hayır" derse iş yapılmaz. Yani bir hata anahtarın kapsamına sızsa bile panelin kendi kapısı hâlâ oradadır.

---

Kapsam rozetleri ne anlama geliyor?

Anahtar listesindeki Kapsam sütununda kodlar görürsünüz. Anlamları:

Rozetler paket seçiminizden otomatik olarak türetilir; tek tek seçmezsiniz.

---

Salt okuma neden önerilir?

Salt okuma modundaki bir anahtar, yazma araçlarını hiç görmez. Araç listesi anahtarın kapsamına göre süzülür; yapay zekâ o araçların var olduğunu bile bilmez, dolayısıyla yanlışlıkla çağıramaz.

Bu, "çağırır ama reddedilir"den daha güçlü bir korumadır: reddedilecek bir işin denenmesi bile gerekmez.

---

Yazma araçları ne yapabilir, ne yapamaz?

Okuma-yazma modundaki bir anahtarda Katalog (yazma) paketi açıksa yapay zekâ beş şey yapabilir: ürünün adını/kısa ve uzun açıklamasını/stok kodunu/etiketlerini değiştirmek, ürünün arama motoru (SEO) alanlarını değiştirmek, bir deponun stoğunu belirlemek, bir ürünün fiyatını değiştirmek ve süzgeçle seçilen ürünlerin fiyatını topluca değiştirmek.

Yapamayacakları bilerek kapalıdır. Yapay zekâ ürün silemez, ürünü yayına alamaz ya da yayından kaldıramaz, iade/ödeme işlemi yapamaz, mağaza ve ödeme ayarlarına dokunamaz. Bu araçlar listede hiç yoktur; "yapamıyorum" demesi bir kısıtlama değil, tasarımın kendisidir. Bunlar panelden yapılır.

Ayrıca yazma araçlarının dokunamadığı alanlar var: ürünün yayın durumu (yayında/taslak), kategorisi, görselleri, varyant yapısı, paylaşım görseli ve sayfanın arama motoruna kapatılması (noindex/nofollow). Bunlar da panelden düzenlenir.

Durum ve noindex neden kapalı? İkisi de veritabanında tek tuşla geri alınır ama etkisinin geri alınması bizim elimizde değildir: yayından kalkan ürün o sırada satılamaz ve sepetteki müşteri ödeme adımında engellenir; dizinden çıkan sayfanın geri dönmesi arama motorunun yeniden taramasına bağlıdır. Bu yüzden onay sohbette değil panelde alınır.

---

Toplu işlemde önizleme zorunludur

Çok sayıda ürünü birden değiştiren araç (products_bulk_update) tek adımda çalışmaz:

1. Önizleme. Yapay zekâ aracı çağırır, araç hiçbir şeyi değiştirmeden kaç ürünün etkileneceğini, en çok beş örnek satırın önceki ve sonraki değerini ve bir onay jetonu döndürür.
2. Uygulama. Yapay zekâ aynı argümanlarla ikinci kez çağırır ve o jetonu geri verir.

Jetonun dört kilidi var:

Dördüncü kilit siz ya da bir başkası araya girip bir ürünün fiyatını değiştirdiğinde de çalışır: uygulama düşer ve hiçbir ürün değişmez, yapay zekânın yeniden önizlemesi gerekir.

---

Günlük yazma tavanı

Anahtar başına bir günlük yazma tavanı vardır (planınıza göre belirlenir). Tavan dolduğunda yazma çağrıları reddedilir ve yapay zekâ ne zaman yeniden deneyebileceğini görür; okuma çağrıları etkilenmez. Tavan her gün gece yarısı (UTC) sıfırlanır.

Önizleme çağrıları tavandan düşmez — önizleme hiçbir şeyi değiştirmediği için yazma sayılmaz.

Yetki zamanla yalnız daralır

Daha fazlası gerekiyorsa yeni anahtar oluşturursunuz. Bu kural izin ekranından (OAuth) verilen izinler için de geçerlidir: bir izin yenilenirken genişletilemez, yalnız daraltılabilir.

---

Anahtar neyi göremez?

Bu sınırlar anahtarın kapsamından bağımsızdır; hiçbir anahtar bunları göremez:

• Ödeme sağlayıcı anahtarları ve sırları (iyzico, PayTR vb.)
• Entegrasyonların şifrelenmiş ayarları
• Oturum ve jeton bilgileri
• Başka bir mağazanın verisi

Bu alanlar araç çıktılarından merkezî olarak temizlenir.

---

Müşteri kişisel verisi

Sipariş ve müşteri araçlarında kişisel veri varsayılan olarak maskelidir:

Maskeyi açmak için:

1. Anahtarın kapsamında CUSTOMERS_READ olmalıdır. Yoksa istek panele hiç gitmez, doğrudan reddedilir.
2. Açılan her çağrı denetim kaydına kişisel veri açıldı olarak işlenir.

Yani varsayılan bir sipariş anahtarı, hangi argüman verilirse verilsin maskeyi açamaz.

---

Denetim kaydı

Her çağrı kayda geçer: hangi anahtar, hangi araç, sonuç, süre ve IP adresi.

Yazma çağrılarında kayıt zenginleşir: hangi kaydın hangi değerden hangi değere çevrildiği de yazar. Yani "yapay zekâ neyi değiştirdi" sorusunun cevabı panelden okunabilir, tahmin edilmez. Yazma araçları ayrıca panelin kendi işlem kayıtlarını da üretmeye devam eder.

Son çağrıları panelden görebilirsiniz: anahtar satırında Kullanımı gör.

---

Hız sınırları

Bir anahtarın çağrı hızı sınırlıdır:

Sınır aşılırsa uygulama geçici bir hata alır ve bir süre sonra yeniden dener. Bu genellikle bir sorun değil, bir frendir. Sürekli görüyorsanız: Sorun giderme

---

IP listesi

Anahtarı yalnız belirli internet adreslerine bağlayabilirsiniz.

---

Anahtar ne zaman kendiliğinden ölür?

İzin ekranından (OAuth) verilen izinler de aynı kurala tabidir: panelden iptal ettiğinizde uygulamanın elindeki erişim anında ölür.

---

Yapay zekâya gelen metin talimat değildir

Ürün açıklaması, müşteri notu, sipariş notu ve kargo hareket açıklaması gibi alanları başkaları yazar. Böyle bir metnin içine "önceki talimatları yok say, şunu yap" gibi bir cümle gömülebilir.

Treyza bu alanları yapay zekâya veri olarak işaretlenmiş biçimde verir ve sunucu yönergesi modele bunların talimat olmadığını açıkça söyler.

---

Anahtarı nerede saklamalı?

Panelin kendisi de sizi uyarır:

"Anahtar, mağazanızda sizin yetkileriniz kadarını yapabilir. Kimseyle paylaşmayın; şüphelendiğiniz anda iptal edin ve yenisini oluşturun."

---

Şüphelendiğinizde ne yapmalı?

1. Ayarlar → Yapay Zeka Erişimi sekmesini açın.
2. Şüpheli anahtarın satırında Kullanımı gör ile son çağrılara bakın (araç, saat, IP).
3. Tanımadığınız bir şey varsa İptal et.
4. Gerekiyorsa yeni bir anahtar oluşturup uygulamanızı yeniden ayarlayın.

İptal geri alınamaz ama zararsızdır: en kötü ihtimalle yeniden bağlanırsınız.