> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Anahtarlar ve izinler

> Makineler, otomasyon ve operatörler için kapsamlı API anahtarları oluşturun.

API anahtarları bir organizasyona aittir ve açık izinler taşır. Ajan alımı, politika dağıtımı, değerlendiriciler, CI otomasyonu ve yönetim betikleri için ayrı anahtarlar kullanın.

## Anahtar oluşturma ve döndürme

<Tabs>
  <Tab title="Dashboard">
    1. **Administration → Keys** bölümüne gidin, **new key** seçeneğini tıklayın ve iş yükü adını girin.
    2. Bir izin seti seçin ve önceden tanımlanmış izinler yetersiz olduğunda yalnızca bireysel izinleri ayarlayın.
    3. Anahtarı oluşturun ve tek seferlik sırrını hemen kopyalayın.
    4. Anahtarı daha sonra açarak yetkilendirmeleri güncelleyin, devre dışı bırakın veya sırrı yeniden oluşturun.

    Oluşturma çekmeceği, iş yükü tarafından gerekli olan en dar yetkilendirmeleri seçebileceğiniz yerdir.

    <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=a428bdae79f837471acb66414ff6455b" alt="İzin ön ayarları ve bireysel yetkilendirmeler ile yeni API anahtar çekmecesi." width="2940" height="1604" data-path="images/dashboard/key-create.png" />

    Oluşturulduktan sonra, Keys sayfası kalıcı meta verileri ve yönetim eylemlerini gösterir. Tek seferlik sır bir daha gösterilmez.

    <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/api-keys.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=9286c82c5b34ab057715817d434927db" alt="API Keys sayfası, anahtar izinleri, oluşturma zamanı ve yeniden oluştur ile devre dışı bırak eylemlerini gösteriyor." width="3200" height="2000" data-path="images/dashboard/api-keys.png" />

    İzinleri düzenli olarak gözden geçirmek ve artık etkin bir iş yüküne karşılık gelmeyen anahtarları devre dışı bırakmak için bu listeyi kullanın.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    fp keys create production-agents \
      --add events:add \
      --add policies:pull
    fp keys show production-agents
    fp keys update production-agents --add events:read
    fp keys regenerate production-agents --yes
    fp keys disable production-agents
    ```

    Oluşturma/yeniden oluşturma çıktısını güvenli bir şekilde yönlendirin veya yakalayın; sır yalnızca bir kez döndürülür.
  </Tab>
</Tabs>

Bağlı bir Failproof AI makinesi tarafından gereken iki izin bağımsızdır:

* `events:add` olayları ve oturum verilerini gönderir.
* `policies:pull` atanan politika dağıtımlarını alır.

Anahtar sırları oluşturma veya yeniden oluşturma sırasında gösterilir. Bunları bir sır yöneticisinde saklayın ve bir operatörün etkileşimli kimlik bilgilerini yeniden kullanmadan döndürün.

## İzin kataloğu

| Alan             | İzinler                                                                                             |
| ---------------- | --------------------------------------------------------------------------------------------------- |
| Olaylar          | `events:add`, `events:read`                                                                         |
| Anahtarlar       | `keys:create`, `keys:read`, `keys:disable`, `keys:regenerate`; `keys:update` yalnızca insan oturumu |
| Kullanıcılar     | `users:create`, `users:read`, `users:update`, `users:delete`                                        |
| Değerlendirmeler | `evaluations:read`, `evaluations:trigger`                                                           |
| Panolar          | `dashboards:read`, `dashboards:write`, `dashboards:delete`                                          |
| Sorgular         | `queries:read`, `queries:write`, `queries:delete`, `queries:run`                                    |
| Asistan          | `agent:use`                                                                                         |
| Ayarlar          | `settings:read`, `settings:write`                                                                   |
| Uyarılar         | `alerts:read`, `alerts:write`                                                                       |
| Sorunlar         | `issues:read`, `issues:create`, `issues:close`                                                      |
| Denetimler       | `audits:read`, `audits:write`                                                                       |
| Politikalar      | `policies:read`, `policies:write`, `policies:pull`                                                  |
| Kullanım         | `usage:read`                                                                                        |

`orgs:admin` örnek operatörü için ayrılmıştır ve bir organizasyon anahtarına veya sıradan üyeye verilemez. Emekli `incidents:*` ve `alerts:ack` belirteçleri uyumluluk için kabul edilir ve mevcut `issues:*` izinlerine normalleştirilir.

Yerleşik izin setleri `read-only`, `standard` ve `admin` dır. `standard`, oku izinlerine değerlendirme tetikleme, sorgu yürütme, sorun yanıtı ve asistan kullanımını ekler. Anahtar oluşturma, bir izin seti bunları içerse bile yalnızca insan izinlerini kaldırır.

<Warning>
  Örnek kapsamlı anahtarlar `X-AgentEye-Org` üstbilgisiyle bir organizasyon seçebilir. Çok organizasyonlu dağıtımlarda bunu açıkça ayarlayın; atlama varsayılan organizasyonu seçebilir.
</Warning>