# Politika kuralları referansı

> 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.

Kaynak: https://aicodeops.dev/tr/docs/policy-engine · Son güncelleme: 2026-11-15

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](https://aicodeops.dev/tr/docs/approvals-and-policies).

Politikalar yalnızca oturumları yönetir. Bir insanın neler yapabileceğini [rolü](https://aicodeops.dev/tr/docs/roles-and-permissions) 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`): `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.

| 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:

```json
[
  {
    "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](https://aicodeops.dev/tr/docs/audit-logs) 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

- [Onaylar ve politikalar](https://aicodeops.dev/tr/docs/approvals-and-policies)
- [Roller ve izinler](https://aicodeops.dev/tr/docs/roles-and-permissions)
- [MCP sunucuları](https://aicodeops.dev/tr/docs/mcp-servers)

## 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.
