AI CodeOps

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:

AlanZorunluNedir
idEvet1–64 karakter: harfler, rakamlar, ., _, : veya -. Benzersiz.
actionEvetAşağıdaki eylemlerden biri veya her eylem için *.
decisionEvetallow, ask (onay gerektirir) veya deny.
resourceHayırEylemin dokunduğu şeyle eşleştirilen bir glob. Belirtilmezse tümü.
descriptionHayırEn fazla 500 karakter; kuralın kimliğinin altında gösterilir.
enabledHayırfalse, 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

EylemEtiketEşleştiği kaynakNe zaman kontrol edilirKararlar
workflow.dispatchStart a sessioniş akışı kimliğiBir oturum başlarkenallow, ask, deny
agent.dispatchRun an agent stepajan kimliği; örn. builderBir oturum başlarken, çalıştıracağı her ajan içinallow, ask, deny
mcp.invokeCall an MCP toolserver/toolBir oturum başlarken, bağlı her MCP aracı içinallow, deny
shell.commandRun the test commandkomutOturum testlerinizi çalıştırmadan önceallow, deny
diff.applyChange a filedosya yolu; örn. infra/**Pull request açılırken, her dosya içinallow, ask, deny
github.pushOpen a pull requestowner/repoPull request açılırkenallow, ask, deny
release.deployDeploy automaticallyortam adıBir merge işleminden sonraki otomatik dağıtımdan önceallow, 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): deny oturumu 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): deny pull 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: allow dışı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

  1. action alanı eşleşen (veya * olan) ve resource alanı eşleşen her etkin kural değerlendirilir.
  2. En katı karar kazanır: deny, ask kararını; ask da allow kararını yener. Kural sırası önemli değildir.
  3. 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/tool ve owner/repo için / karakterinde durur.
  • ? tek bir karakterle eşleşir.
  • resource yoksa 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.

AyarVarsayılan kararlar
trustedHer ş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

  1. Secure → Policies sayfasını açın ve Edit rules düğmesini seçin.
  2. Bir Trust posture seçin.
  3. 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.
  4. 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.

Bu sayfa yardımcı oldu mu?