Hızlı cevap

AI ajanında güvenli işlem onayı bir kişinin belirli bir hedefe yönelik belirli işlemi onaylaması ve yürütülen işlemin bu kararla eşleşmesidir. Ekranda bir onay düğmesinin bulunması tek başına yeterli değildir. Alıcı veya dosya değiştiğinde eski onay geçersiz olmalıdır. Yetki yürütme anında tekrar kontrol edilmeli ve belirsiz sonuçlar körlemesine yeniden denenmemelidir.

Bu rehber eposta gönderen veya kurumsal kaydı değiştiren ajanlar için tasarım ve kabul testi önerir. Kendi başına bütün bir yetkilendirme altyapısının yerini alan hazır kod sunmaz. Aşırı yetki rehberi hangi yeteneklerin sınırlandırılacağını ele alır. Buradaki odak verilen bir onayın doğru işleme bağlanmasıdır.

Kullanıcı gerçekten neyi onaylıyor?

Bir ajan müşteriye dosya göndermeyi önerdiğinde onay ekranı yalnızca devam edilsin mi sorusunu göstermemelidir. Alıcı açıkça görünmelidir. Gönderilecek dosyanın sürümü ve veri sınıfı anlaşılmalıdır. İşlemin dışarıya veri aktaracağı belirtilmelidir. Onay veren kişinin bu işlemi yapma yetkisi de bulunmalıdır.

OWASP işlem yetkilendirme rehberi önemli işlem verisinin kullanıcı tarafından görülmesini ve yetkilendirmenin sunucu tarafında uygulanmasını vurgular. İşlem değişikliğinin onayı geçersiz kılması da bu yaklaşımın parçasıdır. AI ajanına uyarlama bu rehberde önerdiğimiz bir tasarım çalışmasıdır; OWASP'ın belirli bir ajan ürününü onayladığı anlamına gelmez.

DSET tarafından önerilen işlem zarfı

Onaylanacak işlemi bir kayıt olarak düşünün. Kaydın sahibi doğrulanmış kullanıcıdır. Hedef kurum veya müşteri açık olmalıdır. Araç ve eylem adı sabitlenmelidir. İşleme giren önemli parametreler saklanmalıdır. Ek dosya varsa dosyanın sürümünü tanımlayan bilgi eklenmelidir. Yetki politikası ve son geçerlilik zamanı da kayıtla ilişkilendirilmelidir.

Bu kayıt modelin serbest metin olarak yazdığı bir özetle sınırlı kalmamalıdır. Güvenilir uygulama katmanı modelin önerisini doğrulanmış işlem alanlarına çevirmelidir. Kullanıcıya gösterilen özet de aynı alanlardan üretilmelidir. Aksi halde ekranda bir hedef görünürken arka uç başka bir hedefe işlem yapabilir.

Örnek kayıt alanları: işlem kimliği; kullanıcı; müşteri; araç sürümü; hedef; önemli parametreler; belge sürümü; politika sürümü; oluşturulma zamanı; son geçerlilik zamanı; onaylayan kimlik; yürütme durumu.

Bir içerik özeti veya hash değişikliği yakalamaya yardımcı olabilir. Fakat hash tek başına kullanıcının kimliğini veya onayın yetkili bir kaynaktan geldiğini kanıtlamaz. Kayıt bütünlüğü ve kimlik doğrulaması güvenilir sunucu mekanizmasıyla sağlanmalıdır. Sırlar doğrudan onay kaydına yazılmamalıdır.

Güvenli yaşam döngüsü nasıl görünür?

Öneri oluşturulduğunda işlem beklemededir. Kullanıcı reddederse veya süre dolarsa yürütülemez. Onaylanan kaydın önemli parametreleri değişirse yeni bir öneri gerekir. Çalıştırma öncesinde hedefin güncel durumu ve kullanıcının yetkisi yeniden değerlendirilir. Yürütme sonucu başarı veya başarısızlık olabilir. Dış servisin yanıtı kaybolduğunda ise sonuç belirsiz olarak ele alınmalıdır.

Bu son durum önemlidir. Bağlantının kopması epostanın gönderilmediğini göstermez. Aynı çağrıyı tekrar göndermek iki eposta veya iki kayıt üretebilir. Uygulama işlem kimliğiyle sonucu sorgulayabilmeli ya da bir mutabakat akışı çalıştırmalıdır. HTTP tekrarlarının anlamı için RFC 9110 idempotent yöntemler bölümü yararlı bir temeldir. Uygulama seviyesindeki işlem garantisi ayrıca tasarlanır.

Sekiz kabul testi

Aşağıdaki deneyler sentetik eposta kutuları ve deneme kayıtlarıyla uygulanabilir. Testlerin amacı kullanıcı arayüzündeki düğmeyi görmekten ziyade arka uç durumunu doğrulamaktır. Bu tablo DSET'in bu rehber için önerdiği test setidir.

No Deneme Beklenen davranış Kanıt
1 Onaydan sonra alıcı değişir Yeni onay istenir İki işlem özetinin karşılaştırması
2 Aynı dosya adı altında içerik değişir Eski onay yeni sürümü kapsamaz Belge sürümü ve işlem kaydı
3 Onayın süresi geçer İşlem yürütülmez Sunucu zamanları
4 Onaylayan kullanıcının yetkisi kaldırılır Yürütme anında erişim reddedilir Güncel politika kararı
5 Aynı işlem eşzamanlı iki kez tetiklenir Tek mantıksal etki veya kontrollü mutabakat oluşur Arka uç işlem kimlikleri
6 Dış servis sonucu dönmeden bağlantı kesilir Belirsiz durum sorgulanır Sonuç sorgusu ve mutabakat kaydı
7 Belge içinde sahte onay metni bulunur Belge metni kullanıcı onayı sayılmaz Onay kaynağı ve kimliği
8 Bir toplu işlemin kapsamı büyütülür Ek hedefler önceki onayla çalışmaz Onaylanan ve yürütülen hedef sayısı

Ajan onay güvenliği çalışma tablosunu indir.

Kurgusal örnek: teklif eki onaydan sonra değişiyor

Bir satış ajanı deneme müşterisine teklif göndermek ister. Kullanıcı fiyatı ve alıcıyı kontrol ederek onaylar. İşlem kuyrukta beklerken aynı dosya adıyla yeni bir teklif kaydedilir. Yeni sürüm farklı bir müşterinin indirim koşullarını içerir.

Dosya yoluna bağlı bir onay iki farklı içeriği aynı nesne sanabilir. Sürümü sabitlenmiş bir kayıt ise değişimi görünür kılar. Beklenen sonuç yeni dosyanın sessizce gönderilmesi değildir. Sistem işlemi durdurmalı ve kullanıcının yeni sürümü değerlendirmesini istemelidir. Bu örnek gerçek müşteri olayı veya ölçülmüş ürün sonucu değildir.

Tekrar çalıştırma güvenliği hangi katmanda sağlanır?

Bir işlem anahtarı kullanmak yararlıdır. Ancak anahtarın varlığı her dış serviste tam olarak bir kez işlem garantisi sağlamaz. Eşzamanlı isteklerin aynı anda tüketilmesi önlenmelidir. Sonuç kaydı dayanıklı tutulmalıdır. Anahtarın saklama süresi ve farklı parametreyle tekrar kullanıldığında ne olacağı tanımlanmalıdır.

Bazı API sağlayıcıları aynı anahtarla tekrarlanan isteğin önceki sonucunu döndürür. Bunun süre ve hata davranışı sağlayıcıya özgüdür. Stripe'ın idempotent istek açıklaması bu tür bir sözleşmenin somut örneğidir. Aynı davranışı belgesiz bir eposta veya dosya API'sinde varsaymayın.

Denetim kaydı faydalı ve ölçülü olmalı

İşlem kimliği üzerinden öneri ve onay ile yürütme sonucunu birleştirebilmelisiniz. Fakat her belgeyi ve bütün sırları loga kopyalamak yeni bir veri deposu riski oluşturur. İnceleme için gerekli alanları seçin. Log erişimini sınırlandırın ve saklama süresini belirleyin. OWASP günlükleme rehberi olay ilişkisi kurulmasını ve hassas verilerin korunmasını birlikte ele alır.

Başarısız testin raporu arayüz görüntüsünden fazlasını içermelidir. Hangi parametrenin değiştiği ve arka uçta ne gerçekleştiği anlaşılmalıdır. Yeniden testte meşru bir işlemin tamamlanabildiğini de gösterin. Yalnızca tüm işlemleri kapatmak yararlı otomasyonu doğrulamaz.

Sık sorulan sorular

Her ajan eylemi insan onayı gerektirir mi?

Hayır. İşlemin etkisine göre politika belirlenir. Hassas dış paylaşım ve geri dönüşü zor değişiklikler daha sıkı onay ister. Düşük etkili işlerin kapsamı önceden tanımlanabilir.

Sohbette yazılan evet yeterli midir?

Ancak hangi işlem için verildiği güvenilir biçimde belirlenebiliyorsa anlamlıdır. Belgeden gelen evet metni veya başka oturumdaki onay yetki vermez.

Güçlü bir model bu kontrolleri gereksiz kılar mı?

Hayır. Yetkilendirme kararının uygulanması modelin doğru tahminine bırakılmamalıdır. Model önerisi ile yürütme yetkisi ayrı sorumluluklardır.

Hash kullanınca işlem kaydı güvenli olur mu?

Tek başına olmaz. Hash içerik eşleştirmesine yardımcıdır. Kimlik ve izin kontrolü ile kayıt bütünlüğü ayrıca gerekir.

DSET ile doğrulanabilir kapsam

DSET siber güvenlik değerlendirmesi için en etkili üç ajan eylemini ve onay ekranlarını tanımlayın. Kimin onay verebildiğini ve hatalı işlemin iş etkisini yazın. Araç bağlantıları için MCP güvenlik testleri tamamlayıcıdır. Bu rehber KAOS dahil herhangi bir ürünün bütün bu kontrolleri uyguladığına ilişkin doğrulama beyanı değildir.

Editoryal not: İşlem zarfı ve kabul tablosu bu yazıya özgü tasarım önerileridir. Kaynaklar 11 Ekim 2026 tarihinde kontrol edilmiştir.