- Ana sayfa
- Dokümantasyon
- Kanıt paketleri
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 (approvedByverejectedBy) ve her oy (votes). - Her oy:
votesalanında, kullanıldıkları sırayla oy başına bir kayıt bulunur: oy verenin hesabı (accountID), çalışma alanı rolü (role), oy (approveveyareject), zaman (decidedAt) ve not.roleAsOfalanı 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ğernullolur.selfApprovalalanı, oy veren kendi başlattığı bir değişikliği onayladığında true olur veselfApprovalAllowedByalanı buna neden izin verildiğini söyler.gateOverridealanı, 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. Hamdecisionslistesi 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 paketinauditbölümündeapproval.decidedkayı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.