- Ana sayfa
- Dokümantasyon
- Politika kuralları referansı
Politika kuralları referansı
Son güncelleme
Yapay zekâ oturumları için çalışma alanı politika kuralları yazın: yedi eylem; allow, ask ve deny; kaynak glob'ları, güven ayarları, log-only modu ve işlenmiş bir örnek.
Bir çalışma alanı politikası, yapay zekâ oturumlarının neleri kendi başına yapabileceğine, nelerin bir insanın onayını gerektirdiğine ve neleri asla yapamayacaklarına karar verir. Bu sayfa kural yazmak için referanstır. Bir kural onay istediğinde onayların nasıl işlediği için bkz. Onaylar ve politikalar.
Politikalar yalnızca oturumları yönetir. Bir insanın neler yapabileceğini rolü belirler.
Politikayı açın
Secure → Policies sayfasını açın. Sayfa şunları gösterir:
- Enforcement: Enforced veya Log only.
- Rules in effect, Trust posture ve Version.
- Rules: her kuralın kimliği, eylemi, kaynağı ve kararı.
- What changed between versions: kaydedilmiş iki sürüm arasında eklenen, kaldırılan ve değiştirilen kurallar.
- How rules apply: eylemler ve her birinin neyle eşleştiği.
- Recent decisions: en son retler, bekletmeler ve log-only sonuçları; yanlarında View session.
Sayfa, policy-manage iznine sahip rollere gösterilir: varsayılan olarak Owner, Admin ve Security Admin.
Kural biçimi
Kuralları, kural başına bir kart olacak şekilde bir formda veya Advanced (JSON) sekmesinde bir JSON dizisi olarak düzenlersiniz. Her kuralın şu alanları vardır:
| Alan | Zorunlu | Nedir |
|---|---|---|
id | Evet | 1–64 karakter: harfler, rakamlar, ., _, : veya -. Benzersiz. |
action | Evet | Aşağıdaki eylemlerden biri veya her eylem için *. |
decision | Evet | allow, ask (onay gerektirir) veya deny. |
resource | Hayır | Eylemin dokunduğu şeyle eşleştirilen bir glob. Belirtilmezse tümü. |
description | Hayır | En fazla 500 karakter; kuralın kimliğinin altında gösterilir. |
enabled | Hayır | false, kuralı tutar ama uygulanmasını durdurur. |
Formda bunlar Rule ID, Action, Decision, Resource, Description ve On onay kutusudur. Bir politika en fazla 200 kural içerebilir.
Eylemler
| Eylem | Etiket | Eşleştiği kaynak | Ne zaman kontrol edilir | Kararlar |
|---|---|---|---|---|
workflow.dispatch | Start a session | iş akışı kimliği | Bir oturum başlarken | allow, ask, deny |
agent.dispatch | Run an agent step | ajan kimliği; örn. builder | Bir oturum başlarken, çalıştıracağı her ajan için | allow, ask, deny |
mcp.invoke | Call an MCP tool | server/tool | Bir oturum başlarken, bağlı her MCP aracı için | allow, deny |
shell.command | Run the test command | komut | Oturum testlerinizi çalıştırmadan önce | allow, deny |
diff.apply | Change a file | dosya yolu; örn. infra/** | Pull request açılırken, her dosya için | allow, ask, deny |
github.push | Open a pull request | owner/repo | Pull request açılırken | allow, ask, deny |
release.deploy | Deploy automatically | ortam adı | Bir merge işleminden sonraki otomatik dağıtımdan önce | allow, deny |
Bazı eylemler bir insanı bekleyemez; bu yüzden ask kullanamazlar. Düzenleyici bunlarda ask kararını reddeder. Bunlardan birinde saklanmış bir ask, deny olarak uygulanır.
Her kararın ne yaptığı:
- Oturum başlatma (
workflow.dispatch,agent.dispatch):denyoturumu reddeder.ask, biri Review & Gate → Approvals altında onaylayana kadar oturumu bekletir; reddetmek veya süresinin dolmasına izin vermek onu iptal eder. - MCP araçları: izin verilmeyen bir araç ajanlara asla sunulmaz.
- Pull request (
github.push,diff.apply):denypull request'i reddeder.ask, değişikliğin onaylanmış bir incelemesini gerektirir. Oturum yine çalışır ve değişikliğini önerir; değişikliğin ulaşıp ulaşamayacağına kural karar verir. - Otomatik dağıtım:
allowdışındaki her şey dağıtımı durdurur. Dışarı çıkmadığını görebilmeniz için engellenmiş bir dağıtım olarak kaydedilir.
Kurallar nasıl değerlendirilir
actionalanı eşleşen (veya*olan) veresourcealanı eşleşen her etkin kural değerlendirilir.- En katı karar kazanır:
deny,askkararını;askdaallowkararını yener. Kural sırası önemli değildir. - Hiçbir kural eşleşmezse güven ayarı karar verir.
Kaynak glob'ları
**,/dahil her şeyle eşleşir.*, herhangi bir karakter dizisiyle eşleşir. Dosya yolları,server/toolveowner/repoiçin/karakterinde durur.?tek bir karakterle eşleşir.resourceyoksa ya da*veya**ise her şeyle eşleşir.
Dolayısıyla src/*.ts, src/app.ts ile eşleşir ama src/lib/app.ts ile eşleşmez; klasörün tamamı için src/** kullanın.
Güven ayarı
Ayar, hiçbir kural eşleşmediğinde uygulanır.
| Ayar | Varsayılan kararlar |
|---|---|
trusted | Her şeye izin verilir. |
limited (varsayılan) | Trusted gibi, ancak pull request açmak ask olur. |
none | İzin verilmedikçe MCP araçları, test komutu, dosya değişiklikleri, pull request'ler ve otomatik dağıtımlar için deny. |
Kodu değiştiren her oturum ayrıca Review & Gate → Approvals altında bir inceleme talebi alır. Ayar buna ekleme yapar; onu kaldırmaz.
Örnek
Bu politika bağımlılık yükseltmelerini onay için bekletir, altyapı dosyalarındaki her değişiklik için inceleme ister, production ortamına otomatik dağıtımları engeller ve bir MCP aracını ajanlardan uzak tutar. Advanced (JSON) sekmesinde göreceğiniz JSON olarak gösterilmiştir:
[
{
"id": "approve-dependency-refresh",
"action": "workflow.dispatch",
"resource": "dependency-refresh",
"decision": "ask",
"description": "A person approves before a dependency upgrade session starts"
},
{ "id": "review-infra-changes", "action": "diff.apply", "resource": "infra/**", "decision": "ask" },
{ "id": "no-production-deploys", "action": "release.deploy", "resource": "production", "decision": "deny" },
{ "id": "no-repo-deletes", "action": "mcp.invoke", "resource": "github/delete_*", "decision": "deny" }
]
Politikayı düzenleyin
- Secure → Policies sayfasını açın ve Edit rules düğmesini seçin.
- Bir Trust posture seçin.
- Form sekmesinde bir kuralın alanlarını değiştirin, yeni bir kural için Add rule düğmesini ya da birini silmek için Remove düğmesini seçin. Bir kuralı uygulamadan tutmak için On onay kutusunun işaretini kaldırın. Kuralların sırası önemli değildir.
- Save (version → N) düğmesini seçin.
Kuralları metin olarak düzenlemek için Advanced (JSON) sekmesini açın. İki sekme de aynı kuralları düzenler; dolayısıyla birinde yapılan değişiklik diğerine geçtiğinizde oradadır. JSON okunamıyorsa veya formda alanı olmayan bir şey içeriyorsa sayfa Advanced sekmesinde kalır ve neyin düzeltileceğini söyler.
Bir kuralda sorun varsa hiçbir şey kaydedilmez ve her sorun kuralı ve alanıyla birlikte listelenir; örneğin Rule 2 (no-repo-deletes), Decision: "Call an MCP tool" (mcp.invoke) can't wait for an approval, so it can't use ask. Choose allow or deny. Formda her mesaj ayrıca kendi alanının altında da görünür. Siz düzenlerken başka biri kaydettiyse "Policy conflict" mesajını görürsünüz ve değişiklikleriniz kaydedilmez. Düzenlemeleriniz, kopyalayabilmeniz için düzenleyicide kalır; onların sürümünü yüklemek için Cancel düğmesini seçin, ardından değişikliğinizi yeniden yapın.
Her kayıt yeni bir sürüm ve denetim günlüğünde bir policy.updated kaydı oluşturur.
Sürümleri karşılaştırın
What changed between versions bölümü, politikanın kaydedilmiş iki sürümü arasındaki farkı gösterir. Önceki sürümü güncel sürümle karşılaştırarak açılır; From ve To altında başka herhangi iki sürümü seçin. Şunları görürsünüz:
- Added, Removed veya Changed olan kurallar; değişen her alanın öncesi ve sonrasıyla;
- değiştiyse Trust posture.
Kurallar kimliğe göre eşleştirilir ve sıraları yok sayılır. Sürümler, bu karşılaştırma eklendikten sonra yapılan ilk kayıttan itibaren saklanır. Bundan önce son kez kaydedilmiş bir politikanın, yeniden kaydedilene kadar gösterilecek tek bir sürümü vardır.
Log-only modu
Kuralları silmeden uygulamayı durdurmak için Switch to log only düğmesini seçin. Her karar yine hesaplanır ve kaydedilir, Recent decisions altında "logged" olarak gösterilir, ancak hiçbir şey engellenmez veya bekletilmez. Yeniden açmak için Enforce düğmesini seçin. Log-only modunu yeni bir politikayı ayarlarken kullanın.
Yalnızca düz bir allow dışındaki kararlar kaydedilir.
Sonraki adımlar
Sık sorulan sorular
Kurallarımın sırası önemli mi?
Hayır. Eşleşen her kural değerlendirilir ve en katı karar kazanır; dolayısıyla bir kural eklemek öncekini asla gevşetemez.
Politikalar insanların neler yapabileceğini sınırlar mı?
Hayır. Politikalar yapay zekâ oturumlarının neler yapabileceğini yönetir. Bir insanın neler yapabileceğini rolü belirler.
Bir politikayı kimseyi engellemeden test edebilir miyim?
Evet. Switch to log only düğmesini seçin. Kurallar yine değerlendirilir ve her karar kaydedilir, ancak hiçbir şey engellenmez veya bekletilmez.