Güvenlik modeli
Peki, müşterilerinizle konuşan, sistemlerinizi çağıran ve kendi başına işlem yapan yapay zekâ agent'ları çalıştırır. Bu sayfa her parçanın nasıl korunduğunu ve neleri sizin kontrol ettiğinizi, bir müşterinin ya da güvenlik değerlendirmesi yapan birinin ihtiyaç duyacağı düzeyde anlatır.
İlkeler
| İlke | Sizin için anlamı |
|---|---|
| Çalışma alanınız sizindir | Bir çalışma alanındaki hiçbir şey başka bir çalışma alanından görülemez ya da değiştirilemez. |
| En az yetki | Her kişi ve her anahtar yalnızca ihtiyaç duyduğu rolü alır; rol her istekte kontrol edilir. |
| Anahtarlar gizli kalır | Anahtarlar şifrelenir, bir daha asla tam gösterilmez, yapay zekâ tarafından görülmez ve yalnızca izin verdiğiniz sitelere gönderilir. |
| Müşteri verisi modelin dışında kalır | Kişisel veriler, bir yapay zekâ modeli görmeden önce yer tutucularla değiştirilir. |
| Veri veridir | Web sayfaları, tool sonuçları, dosyalar ve webhook gövdeleri agent için bilgidir, asla ona verilmiş talimat değildir. |
| Gerçek etkiler bir insan gerektirir | Yayınlama, sürüm geri yükleme, widget değişiklikleri ve otomasyonların ya da Copilot testlerinin yaptığı yazmalar onayınızı bekler. |
| Önemli olan her şey kaydedilir | Değişiklikler, kimin yaptığıyla birlikte bir denetim kaydına yazılır. |
Çalışma alanı izolasyonu
- Her veri tam olarak bir çalışma alanına aittir ve her istek bir çalışma alanının içinde çalışır.
- Kişiler için Peki, her istekte çalışma alanının etkin bir üyesi olup olmadığınızı ve rolünüzün işleme izin verip vermediğini kontrol eder. Çıkarılan bir üye ya da değişen bir rol, bir sonraki girişte değil, bir sonraki tıklamada geçerli olur.
- Bir API anahtarı tek bir çalışma alanına aittir ve başka birine yönlendirilemez.
- Başka bir çalışma alanına ait bir kimlik, var olmayan bir kimlik gibi davranır:
404. Var olduğunu bile öğrenemezsiniz. - Agent'lar da çalışma alanı içinde birbirinden ayrıdır: gizli anahtarlar, Copilot ve otomasyonlar tek bir agent üzerinde çalışır, asla onun ötesine geçmez.
Roller ve erişim
İzleyici'den Sahip'e beş rol, her üyenin neler yapabileceğini belirler. Tam tablo için bkz. Üyeler ve roller.
- Üyeleri, API anahtarlarını ve çalışma alanı ayarlarını yalnızca yöneticiler yönetir. Diğer sahipleri yönetmek ve çalışma alanını silmek yalnızca sahiplere aittir.
- Bir çalışma alanında her zaman en az bir sahip kalır.
- Copilot, onu kullanan kişinin rolünün ötesinde asla işlem yapmaz.
Giriş
Kişiler Google ile ya da tek kullanımlık bir e-posta bağlantısıyla giriş yapar. Sızabilecek bir parola yoktur. Tarayıcıdaki oturum, sayfa betiklerinin okuyamadığı bir çerezde tutulur.
API anahtarı hijyeni
- Anahtarlar oluşturulduğunda bir kez gösterilir. Peki yalnızca bir parmak izini saklar; bu yüzden çalınan bir veritabanı kopyası bile onları ortaya çıkarmaz.
- Her anahtarın bir erişim düzeyi vardır: Yalnızca okuma izleyici, Okuma ve yazma düzenleyici gibi davranır. Hiçbir anahtar asla yönetici ya da sahip gibi davranamaz ve yalnızca kişilere açık uç noktalar (üyeler, anahtarlar, onaylar, Copilot) her anahtarı reddeder.
- Liste her anahtarın ilk ve son karakterlerini ve en son ne zaman kullanıldığını gösterir; böylece kullanılmayan anahtarları bulup kaldırabilirsiniz.
- İptal et bir sonraki istekte geçerli olur.
- Anahtar oluşturma ve iptal etme denetim kaydına yazılır; bir anahtarın yaptığı değişiklikler o anahtar tarafından yapılmış olarak kaydedilir.
Anahtarları nasıl saklayıp yenileyeceğiniz için bkz. API anahtarları.
Gizli anahtarlar
Gizli anahtarlar, agent'larınızın tool'larının sistemlerinizi (örneğin mağazanızın sipariş API'sini) çağırmak için kullandığı anahtarlardır.
- Kayıtlıyken şifreli. Kaydettikten sonra herkese yalnızca son dört karakter gösterilir.
- Yapay zekâ asla görmez. Model, bir gizli anahtarın yalnızca adını ve son dört karakterini bilir. Peki model neyi çağıracağına karar verdikten sonra anahtarı isteğe kendi tarafında ekler.
- Anahtar başına tek agent. Bir anahtar tek bir agent'a aittir ve yalnızca o agent'ın tool'ları kullanabilir.
- Sitelere bağlı. Her anahtarın İzin verilen siteler listesi vardır ve yalnızca oraya gönderilir. Anahtarı başka bir yere göndermeye çalışan bir tool açık bir mesajla başarısız olur. Bir anahtarın sitelerini yalnızca yöneticiler değiştirebilir; çünkü bir anahtarı başka bir siteye yönlendirmek, onu okumanın yoludur.
- Webhook'lar için imzalama anahtarları yalnızca imzaları kontrol etmek için kullanılır ve hiçbir yere gönderilmez.
- Yapıştırılan anahtarlar yakalanır. Biri Copilot sohbetine bir anahtar yapıştırırsa, model görmeden önce kaldırılır. Anahtarları Copilot'un API anahtarı kartından ya da Ayarlar → Gizli anahtarlar bölümünden ekleyin.
- Gizli anahtar ekleme, atama, kaldırma ve yeniden yönlendirme denetim kaydına yazılır.
Kişisel veriler
TC kimlik numaraları, kart numaraları, IBAN'lar, telefon numaraları, e-posta adresleri ve isteğe bağlı olarak müşterilerin adları, bir yapay zekâ modeli görmeden önce [TCKN_1] gibi yer tutucularla değiştirilir. Gerçek değerler konuşma başına şifreli tutulur ve yalnızca izin verdiğiniz yerlerde tool'larınıza ulaşır. Her model çağrısı yalnızca verilerinizi saklamayan sağlayıcılara gider. Bkz. Veri ve gizlilik.
Fonksiyon sanal alanı
Fonksiyonlar, agent'ın tool olarak çağırabildiği ve çoğu zaman Copilot'un yazdığı küçük kod parçalarıdır. Kodları bir modelden gelebileceği için her çalıştırma sıkı biçimde kısıtlanır:
| Koruma | Ne yapar |
|---|---|
| İzole çalıştırma | Her çalıştırma kendi yeni, kısa ömürlü sürecini alır. Çalıştırmalar ya da müşteriler arasında hiçbir şey paylaşılmaz. |
| Yerel erişim yok | Kod dosya okuyamaz ya da yazamaz, sunucunun ayarlarını okuyamaz, başka programlar başlatamaz ya da başka kod yükleyemez. |
| Ağa yalnızca bir proxy üzerinden | Kod hiçbir yere doğrudan ulaşamaz. Her istek, yalnızca Fonksiyonda listelenen sitelere (en fazla 10) izin veren Peki'nin çıkış proxy'sinden geçer. |
| Anahtarları proxy ekler | Kod gizli anahtarınızı asla tutmaz. Fonksiyonun kullanmasına izin verilen bir gizli anahtarın adını verir; proxy onu isteğe yalnızca o anahtarın kendi izinli sitelerinde ekler. |
| Süre sınırı | Çalıştırma başına 1–10 saniye (varsayılan 5), sonra çalıştırma durdurulur. |
| Bellek sınırı | 128 MB. |
| İstek sınırı | Çalıştırma başına 20 giden istek. |
| Sonuç sınırı | 16 KB. |
| Onay | Bir Fonksiyon, her çağrısı bir düzenleyici onaylayana kadar Onaylar içinde bekleyecek şekilde ayarlanabilir. |
Proxy aynı zamanda HTTP tool'larıyla aynı kuralları (aşağıda) uygular; böylece bir Fonksiyon özel ağınıza ulaşamaz.
Güvenli giden istekler
HTTP tool'ları, Fonksiyonlar, agent'ın okuduğu web sayfaları ve Peki'nin getirdiği bilgi kaynağı sayfaları aynı korumalardan geçer:
- Özel ya da yerel adres yok. localhost'a, özel ağlara, link-local adreslere (bulut metadata servisleri gibi) ve diğer ayrılmış aralıklara giden istekler reddedilir. Adres, alan adı çözüldükten sonra, bağlantı kurulduğu anda kontrol edilir; böylece bir alan adı sessizce iç bir servise yönlendirilemez.
- Yönlendirmeler asla izlenmez. Tool, yönlendirme yanıtının kendisini alır.
- Süre sınırları. Bir HTTP tool'u 1–30 saniye (varsayılan 10) bekler.
- Boyut sınırları. 1 MB'tan büyük yanıtlar reddedilir.
- Yapay zekâya yalnızca sizin seçtiğiniz ulaşır. Bir HTTP tool'u yalnızca listelediğiniz yanıt alanlarını tutabilir; yanıtlardaki kişisel veriler yer tutucularla değiştirilir.
- Veri veridir. Yanıtlar ve web sayfaları modele talimat olarak değil, bilgi olarak verilir.
Web sitesi sohbeti
Web sitesi sohbeti ziyaretçilerinizin tarayıcısında çalışır; bu yüzden tasarımı gereği herkese açıktır ve kapsamı sıkı biçimde daraltılmıştır:
- İzin verilen web siteleri. Sitelerinizi listelerseniz sohbeti yalnızca bu tam adresler kullanabilir; diğer siteler
403alır. Liste boşsa her site sohbeti gösterebilir; bu yüzden kendi sitenizi ekleyin. - Bir ziyaretçi, bir konuşma. Ziyaretçi, tarayıcısında oluşturulan rastgele bir kimlikle tanınır. Bu onun tek kimlik bilgisidir ve yalnızca kendi konuşmasına ulaşır. Peki bunun yalnızca bir parmak izini saklar.
- Dosyalar. Bir ziyaretçi yalnızca kendi yüklediklerini ve ekibinizin ona gönderdiği dosyaları açabilir. Diğer her dosya kimliği, var olsun ya da olmasın, aynı
404'ü verir. - Ziyaretçi, ağ ve sohbet başına hız sınırları taşmaları ve veri kazımayı durdurur. Bkz. Web sitesi sohbeti API'si.
- Kapatmak, sohbetin adresinin hemen yanıt vermemesini sağlar.
- Sohbet hiçbir zaman bir API anahtarı kullanmaz ya da ortaya çıkarmaz.
Gelen webhook'lar
- Her webhook URL'si, tahmin edilemeyen uzun bir rastgele gizli değer içerir. URL'yi yenile ve URL'yi iptal et eskisini hemen durdurur.
- Stripe, Shopify, GitHub ya da herhangi bir HMAC-SHA256 gönderici için imza kontrolleri, sabit sürede karşılaştırılır. 5 dakikadan eski Stripe imzaları reddedilir.
- Tekrar gönderimler yok sayılır. Aynı olay 24 saat içinde bir kez çalışır.
- İmzasız yazmalar isteğe bağlıdır. Bir şey yazan bir otomasyon, siz bunu açıkça kabul etmedikçe imzasız isteklerde çalışmaz.
- Boyut (256 KB) ve hız (URL başına dakikada 60) sınırları.
- Duraklatılmış ya da bilinmeyen bir URL aynı
404'ü verir ve her gövdenin yalnızca maskelenmiş bir önizlemesi saklanır.
Bkz. Gelen webhook'lar.
Dosyalar
- Dosya türü adından değil, içeriğinden kontrol edilir. SVG ve HTML asla kabul edilmez; böylece bir "fotoğraf" betik taşıyamaz.
- Dosyalar, tarayıcının içlerindeki herhangi bir şeyi çalıştırmasını engelleyen başlıklarla sunulur.
- Dosyalar gizli saklanır ve kişilere yalnızca Peki, müşterinin kendi sohbeti ya da API anahtarınız üzerinden ulaşır.
- Belgelerin içindeki metin talimat olarak değil bilgi olarak okunur ve mesajlarla aynı kişisel veri yer tutucularını alır.
Gerçek etkiler için onaylar
Peki dışında etkisi olan ya da bir şeyi yayına alan işlemler bir insanı bekler:
- bir sürümü yayınlamak ve eski bir sürümü geri yüklemek,
- Copilot'un web sitesi sohbetinde yaptığı değişiklikler,
- Copilot test çalıştırmaları sırasındaki yazmalar,
- bir otomasyonun yaptığı yazmalar (kaydederken onaylanır),
- onay için işaretlediğiniz tool'lar ve Fonksiyonlar; bunlar Onaylar içinde bir düzenleyiciyi bekler.
Denetim kaydı
Her önemli değişiklik çalışma alanının denetim kaydına yazılır: kimin işlem yaptığı (bir üye ya da bir API anahtarı), ne yaptığı, neyin üzerinde ve ne zaman. Bu; üyeleri ve rolleri, API anahtarlarını, gizli anahtarları, kanalları, bilgi kaynaklarını, değişkenleri, kayıt tablolarını, silinen agent'ları, reddedilen webhook imzalarını ve daha fazlasını kapsar. Gizli anahtar değerleri ve kayıt içerikleri asla kayda yazılmaz. Bkz. Veri ve gizlilik.
Sizin yapabilecekleriniz
- Herkese işini görecek en düşük rolü verin. Sahip rolünü bir ya da iki kişiyle sınırlayın.
- Her sistem için ayrı bir API anahtarı kullanın, mümkün olduğunda Yalnızca okuma seçin ve kullanılmayan anahtarları iptal edin.
- Her gizli anahtarda İzin verilen siteler, web sitesi sohbetinde İzin verilen web siteleri ayarlayın.
- Göndericisi destekleyen her webhook için imza kontrolünü açın.
- Kişisel verileri koru ayarını açık bırakın.
- Ayrılan üyeleri ayrıldıkları gün çıkarın.