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ı
- Yalnız gerçek, sembolik bağ olmayan UTF-8
.dildosyaları toplanır. - Her dosya sistemi yol bileşeni Unicode 17.0 UAX #15 NFC'ye çevrilir.
- NFC sonrası aynı göreli yola inen iki girdi reddedilir.
- Bileşenler yalnız ASCII
/ile birleştirilir ve güvenlik profili uygulanır. - Yollar UTF-8 byte sırasıyla sıralanır; zaman, sahiplik, izin ve platform metadata'sı arşive girmez.
- 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
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=16777216Yeni 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