İçeriğe geç
zeev1.0.0-rc.1

`.zep` v1 conformance ve saldırı korpusu

Depodaki docs/zep-conformance.md belgesinden Zee ile üretildi.

Bu rehber, zee kaynak paketinin farklı işletim sistemlerinde aynı byte'ı üretme ve düşmanca yol girdilerini fail-closed reddetme kanıtını açıklar. Normatif sözleşme spec/18, gerekçe RFC-0020 ve ADR-028'dedir.

Kanonik üretim hattı

  1. Yalnız gerçek, sembolik bağ olmayan UTF-8 .dil dosyaları toplanır.
  2. Her dosya sistemi yol bileşeni Unicode 17.0 UAX #15 NFC'ye çevrilir.
  3. NFC sonrası aynı göreli yola inen iki girdi reddedilir.
  4. Bileşenler yalnız ASCII / ile birleştirilir ve güvenlik profili uygulanır.
  5. Yollar UTF-8 byte sırasıyla sıralanır; zaman, sahiplik, izin ve platform metadata'sı arşive girmez.
  6. Tüketici gelen yolu yeniden yazmaz: zaten NFC değilse paketi reddeder.

Bu üretici/tüketici ayrımı önemlidir. Yerel dosya sisteminin NFD sunması kanonik paketi değiştirmez; fakat ağdan gelen iki farklı byte gösterimi aynı mantıksal yol sayılmaz.

Tier-1 sabit fixture

compiler/tests/fixtures/zep-kanonik-v1.hex; kaynak/çağrı.dil içeren gerçek bir proje ağacının tam .zep byte dizisidir. tedarik_testi bu ağacı yeniden paketleyip fixture ile byte-byte karşılaştırır. Aynı test CI matrisindeki Ubuntu, macOS ve Windows üzerinde koştuğu için yalnız yerel bir “iki kez aynı çıktı” testi değildir.

Fixture yalnız bilinçli .zep wire-format değişikliğinde güncellenir. Önce RFC-0020, ADR-028 ve spec/18 revize edilir; eski/yeni paketin uyumluluk etkisi yazılır; ardından üç platformun tamamı yeşil görülür. Sırf test geçsin diye beklenen hex'i yenilemek yasaktır.

Kalıcı saldırı korpusu

compiler/tests/fixtures/zep-saldiri-korpusu/yollar-v1.tsv 92 vaka taşır:

  • üst dizin, mutlak yol, ters bölü, boş/. bileşen, NUL ve denetim karakteri;
  • NFD Türkçe yol;
  • Unicode 17.0 UTS #39 /, \\, ., : benzerleri ve tam genişlikli eşleri;
  • sıfır genişlikli ve çift yönlü metin biçim denetleyicileri (K-363: Arap harf işareti ALM U+061C dahil; Unicode'un 12 bidi biçim karakterinin tamamı);
  • K-366: Windows ayrılmış aygıt adları (CON.dil, nul.dil, aux.txt.dil, COM1.dil, LPT¹.dil, CONIN$.dil, prn/ klasörü, con .dil) ve sonu nokta/boşlukla biten bileşenler (kaynak./, kaynak /, a.dil.).

Korpus kod noktalarını hex yazar; böylece görünmez saldırı karakterleri belge incelemesini yanıltmaz. Test veri satırı sayısını da 92ye sabitler. Uzunluk, dosya sayısı, yinelenen/sırasız yol, beklenmedik son ve UTF-8 gövde saldırıları ayrı yapısal testlerde üretilir.

K-363'ten beri büyük/küçük harf katlamasından (tam büyük → tam küçük harf → NFC) sonra aynı olan, farklı yazılmış iki yol ya da klasör öneki (A.dil / a.dil, K/ / k/, ı / i) üreticide ve tüketicide reddedilir; bu kontrol artefakt_dogrulama::testler::harf_katlama_cakismasi_uretici_ve_tuketicide_reddedilir ve kurulum testindedir. Böylece büyük/küçük harf duyarsız dosya sistemi (macOS APFS, Windows NTFS) aynı arşivi Linux'tan farklı açamaz.

K-366'dan beri Windows'ta taşınamayan bileşen (ayrılmış aygıt adı, sonu nokta/boşluk) de her platformda aynı tanıyla reddedilir: artefakt_dogrulama::testler::windows_tasinamaz_adlar_uretici_ve_tuketicide_ayni_taniyla_reddedilir üretici (dosya sistemi yolu) ve tüketici (ham arşiv) metnini karşılaştırır, benzer ama ayrılmamış adları (console.dil, com10.dil) kabul eder.

Yerel doğrulama

bash
cd compiler
cargo test --locked --test tedarik_testi
cargo test --locked --lib tedarik::testler
cargo clippy --all-targets -- -D warnings
cargo rustc --release --target wasm32-unknown-unknown --lib --crate-type cdylib -- -C link-arg=-zstack-size=16777216

Yeni Unicode sürümüne geçerken unicode-normalization veri sürümü, UTS #39 reddetme kümesi, korpus ve fixture aynı değişiklikte incelenir. Bu yükseltme sıradan dependency bakımı değil, paket uyumluluk değişikliğidir.

Kaynak: docs/zep-conformance.md · Bütün belgeler