AI CodeOps

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.

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

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

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

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.

Bu sayfa yardımcı oldu mu?