# Kanıt paketleri

> Tek bir değişikliğin nasıl yapıldığının imzalı kaydını (görev, modeller, onaylar, bulgular, testler, teslim) indirin ve tarayıcıda veya çevrimdışı doğrulayın.

Kaynak: https://aicodeops.dev/tr/docs/evidence-packs

Kanıt paketi, AI CodeOps'ta tek bir değişikliğin nasıl yapıldığının imzalı kaydıdır. Yapay zekânın yazdığı kodun canlı ortama nasıl ulaştığını göstermesi gereken denetçiler, uyumluluk incelemeleri ve müşteriler içindir.

## Bir paket neleri içerir

Tek bir değişiklik için (**Develop → Changes**, ardından bir değişiklik):

- **Görev:** yapay zekâya verilen prompt, model, sağlayıcı ve kademe ile bağlam dosyaları.
- **Çalıştırmalar:** oturum ve her takip çalıştırması; durum, zamanlamalar, token'lar ve maliyetle, ayrıca her ajan adımının sağlayıcısı ve modeliyle birlikte.
- **Sonuç:** özet, değişen dosyalar ve diff'in SHA-256 özeti. Kodun kendisi dahil değildir; özet, onu pull request ile eşleştirmenizi sağlar.
- **Onaylar:** her onay talebi, kimin istediği (bir oturumun kendi onayı için, oturumu başlatan üye), kimin onaylayabildiği (`eligibleApprovers`: adını andığı onaylayıcılar ve karar vermesine izin verilen roller), kimin onayladığı veya reddettiği (`approvedBy` ve `rejectedBy`) ve her oy (`votes`).
- **Her oy:** `votes` alanında, kullanıldıkları sırayla oy başına bir kayıt bulunur: oy verenin hesabı (`accountID`), çalışma alanı rolü (`role`), oy (`approve` veya `reject`), zaman (`decidedAt`) ve not. `roleAsOf` alanı rolün hangi tarihe ait olduğunu söyler: `vote`, oy kullanıldığında kaydedilen roldür; `export`, paket oluşturulduğunda sahip olunan roldür ve roller kaydedilmeye başlanmadan önce kullanılan oylar için kullanılır; oy veren o zamandan beri çalışma alanından ayrıldıysa değer `null` olur. `selfApproval` alanı, oy veren kendi başlattığı bir değişikliği onayladığında true olur ve `selfApprovalAllowedBy` alanı buna neden izin verildiğini söyler. `gateOverride` alanı, oy veren yayın kontrolü başarısız olan bir değişikliği onayladığında verdiği gerekçeyi ve yayın kontrolünün ne dediğini taşır. Ham `decisions` listesi değişmeden yerinde durur. İkisi de yalnızca geçerli turu tutar: bir onay yeniden açıldığında, örneğin onaylanmış bir değişiklik düzenlendikten sonra, ikisi de temizlenir ve önceki oylar paketin `audit` bölümünde `approval.decided` kayıtları olarak kalır.
- **Politika kararları:** çalışma alanının politikalarının değişiklik sırasında verdiği her allow, deny veya ask kararı.
- **Bulgular ve testler:** triyajlarıyla birlikte inceleme bulguları ve test sonuçları (geçen, başarısız olan, atlanan, kapsam).
- **Teslim:** pull request, dağıtım ve değişikliğe bağlı varsa olay.
- **Denetim izi:** yukarıdakilerin herhangi biriyle ilgili denetim günlüğü kayıtları.
- **Kişiler:** paketteki her hesap kimliğinin arkasındaki e-posta adresi.

## Bir paketi indirin

**Changes** sayfasını açın, bir değişiklik seçin ve **Download evidence pack** düğmesini seçin. Çalışma alanında denetim erişimine ihtiyacınız vardır: Owner, Admin ve Security Admin rollerinde bu erişim bulunur. Her indirme çalışma alanının denetim günlüğüne kaydedilir.

## Bir paketi tarayıcıda doğrulayın

[/evidence/verify](https://aicodeops.dev/evidence/verify) adresini açın ve dosyayı seçin. Hesap gerekmez. Sayfa imzanın eşleşip eşleşmediğini ve onu hangi anahtarın imzaladığını söyler.

## Bir paketi çevrimdışı doğrulayın

Doğrulayıcımıza güvenmek zorunda değilsiniz. Paketin `signature` alanı, `payload` alanının kanonik JSON'u üzerinde Ed25519 imzasıdır: nesne anahtarları her düzeyde sıralanır, boşluk yoktur. Platformun açık anahtarları `/api/evidence?action=keys` adresindedir. Node.js 20 veya sonrası ile:

```js
// verify-evidence.mjs <pack.json> <keys.json>
import { readFileSync } from "node:fs"
import { createPublicKey, verify } from "node:crypto"

const canonical = (v) =>
  v === null || typeof v !== "object"
    ? JSON.stringify(v)
    : Array.isArray(v)
      ? `[${v.map(canonical).join(",")}]`
      : `{${Object.keys(v)
          .sort()
          .map((k) => `${JSON.stringify(k)}:${canonical(v[k])}`)
          .join(",")}}`

const pack = JSON.parse(readFileSync(process.argv[2], "utf8"))
const { keys } = JSON.parse(readFileSync(process.argv[3], "utf8"))
const key = keys.find((k) => k.kid === pack.signature.kid)
if (!key) throw new Error(`unknown key ${pack.signature.kid}`)
const ok = verify(
  null,
  Buffer.from(canonical(pack.payload)),
  createPublicKey(key.publicKey),
  Buffer.from(pack.signature.value, "base64url"),
)
console.log(ok ? "VERIFIED" : "NOT VERIFIED: the pack was altered")
```

Anahtarları bir kez kaydedin, ardından script'i çalıştırın:

```bash
curl -o keys.json "https://console.aicodeops.dev/api/evidence?action=keys"
node verify-evidence.mjs evidence-chg_....json keys.json
```

## Anahtarlar ve yenileme

Anahtarlar asla silinmez. Bir anahtar kullanımdan kaldırıldığında yeni paketleri imzalamayı bırakır; imzaladığı paketler ise yine doğrulanır. Platforma ulaşmaya bağlı olmayan bir doğrulama istiyorsanız `keys.json` dosyasının bir kopyasını denetim kayıtlarınızla birlikte saklayın.

## Sonraki adımlar

- [Onaylar ve politikalar](https://aicodeops.dev/tr/docs/approvals-and-policies)
- [Kalite kapıları](https://aicodeops.dev/tr/docs/quality-gates)
- [API](https://aicodeops.dev/tr/docs/api)

## Sık sorulan sorular

### Paket kaynak kodumuzu içerir mi?

Hayır. Değişen dosyaları ve diff'in SHA-256 özetini listeler; böylece kod reponuzdan çıkmadan onu pull request ile eşleştirebilirsiniz.

### Bir anahtar kullanımdan kaldırıldıktan sonra eski paketler yine doğrulanır mı?

Evet. Anahtarlar asla silinmez. Kullanımdan kaldırılan bir anahtar yeni paketleri imzalamayı bırakır; imzaladığı paketler ise yine doğrulanır.
