Bir politika yazın

Bir politika yazmanın iki yolu vardır: Failproof AI’nın bir denetim bulgusundan taslak hazırlamasını sağlamak veya kaynağı kendiniz yazmak. Yayınlamayı veya dağıtmayı seçene kadar hiçbir şey yayınlanmaz veya dağıtılmaz.

Denetimden bir politika yazın

Denetim bir hatayı bulur; politika bunun yeniden olmasını engeller. Failproof AI, politikayı bulguyu oluşturan kanıtlardan taslaklaştırır.

1. Denetim çalıştırın

Hatanın meydana geldiği oturumlar üzerinde denetim çalıştırın. Her bulgu kanıt oturumları, kök neden ve önerilen önleme yolunu içerir. Tekrarlanabilir bir işlem deseni taşıyan bir bulguden başlayın — bir politika yalnızca hook olayında tanıyabileceği şeyi durdurabilir.

2. Taslağı oluşturun

Dashboard
CLI

Analyze → issues altında bulgunun sorununu açın ve alıntı yapılan oturumları, kök nedeni ve tavsiyesini kontrol edin.
generate policy seçeneğini seçin. Failproof AI önce bir politikanın sorunu hiç ifade edip edemeyeceğini söyler. no policy sonucu, düzeltmenin bir uyarı, iş akışı değişikliği veya bir kişi olduğu anlamına gelir — politika değil.
write this policy seçeneğini seçin. Sorun başlığı, bulgu, kök neden, tavsiye ve önerilen yaptırım amacı Admin → policy editor içinde bir taslak haline gelir. Aday değerlendirme kontrolüne katılmadığınızda open the editor anyway kullanın.

Kanıtları okuyun, ardından asistan ile taslak oluşturun. compose kaynağı gözden geçirmeniz için yazdırır ve hiçbir şey yayınlamaz:

fp issues show <issue-id>
fp audits finding <finding-id>
fp policies compose "Block git push --force on release branches"

compose imzalanmış bir oturuma ihtiyaç duyar (fp login) ki rolü policies:write yetkisine sahip olsun; API anahtarlarını reddeder.

3. Taslağı gözden geçirin

Taslak bir başlangıç noktasıdır, bir karar değil. Yayınlamadan önce şunları kontrol edin:

Başarısızlık modunu operasyonel dilde adlandırır.
Yalnızca karar almak için yeterli kanıt taşıyan hook olayları ve araçlarıyla eşleşir.
Güvenli olmayan işlemi yakalayan en dar koşulu kullanır.
Ajanı ne yapması gerektiğini söyleyen bir neden döndürür.
Ajanın güvenli bir şekilde düzeltebileceği yerde instruct kullanır ve işlemin yapılmasına izin vermek kabul edilemez veya tersine döndürülemez olduğu yerde yalnızca deny kullanır.

Editörde kaynağı doğrulayın ve bildirilen her hatayı düzeltin.

4. Test edin, ardından yayınlayın

Yayınlamadan önce kaynak altında backtest çalıştırın: taslağı donanımınızın zaten yaptığı çağrılara karşı yeniden oynatır ve kesintiye uğratacağı çalışan çağrıları sayar. Bir politikayı test edin bunu ve diğer kontrolleri kapsar. Davrandığında, politika kimliğini girin ve publish version seçeneğini seçin. Yayınlama değişmez bir sürümü oluşturur ve hiçbir şey dağıtmaz: dağıtıncaya kadar kullanılmamış kalır. Bir terminalden:

fp policies publish checkout-guard ./checkout.policy.mjs --description "Block force-push"

publish kaynağı göndermeden önce ayrıştırma denetimi yapar, bu nedenle söz dizimi hatası bir makinede yaptırım süresi yerine burada ortaya çıkar.

Kendiniz yazın

Bir politika failproofai API’ye karşı JavaScript veya TypeScript’tir:

import { customPolicies, allow, deny } from "failproofai";

customPolicies.add({
  name: "protect-production-paths",
  description: "Block writes to production configuration",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolName !== "Write" && ctx.toolName !== "Edit") return allow();
    const path = String(ctx.toolInput?.file_path ?? "").replaceAll("\\", "/");
    if (path.split("/").includes("production")) {
      return deny("Writes to production configuration require approval.");
    }
    return allow();
  },
});

Bu production/config.yml, /srv/production/config.yml, /srv/production ve C:\\production\\config.yml için Write ve Edit öğelerini eşleştirir, ancak production-backup öğesini eşleştirmez: production tam bir yol segmenti olmalıdır. Bağlam ayrıca olay türü, normalleştirilmiş yük, oturum meta verileri, parametreler ve kullanılabilir olduğunda kaynak CLI’yi içerir — politika SDK sayfasına bakın. Bunu bir sürüm olarak yayınlamak için kaynağı Admin → policy editor içindeki compose girişine yapıştırın ve yukarıdaki 3 ve 4. adımları izleyin veya dosyayı terminalden fp policies publish ile yayınlayın. Cloud olmadan bir makinede çalıştırmak için .failproofai/policies/ altında policies.js, policies.mjs veya policies.ts ile biten bir adla kaydedin — bunlar proje ve kullanıcı kapsamında otomatik olarak yüklenirler — veya yola göre yükleyin:

failproofai policies --install --custom ./security.policies.ts --scope project

Her politikaya, kural, özel, paket ve Cloud tarafından yönetilen politikalar arasında benzersiz olan bir ad verin.

Prevent repeat failures

Get a policy

Ship a policy

Denetimden bir politika yazın

1. Denetim çalıştırın

2. Taslağı oluşturun

3. Taslağı gözden geçirin

4. Test edin, ardından yayınlayın

Kendiniz yazın

​Denetimden bir politika yazın

​1. Denetim çalıştırın

​2. Taslağı oluşturun

​3. Taslağı gözden geçirin

​4. Test edin, ardından yayınlayın

​Kendiniz yazın

Denetimden bir politika yazın

1. Denetim çalıştırın

2. Taslağı oluşturun

3. Taslağı gözden geçirin

4. Test edin, ardından yayınlayın

Kendiniz yazın