Bu bölüm K-088/K-134/K-137/K-139/K-185/K-188 ile gelen normatif oturum, yetki, CSRF, ortak oran sınırı ve HTTPS reverse-proxy sözleşmesidir. Uygulama eyleminin HTTP'den ayrılması spec/11'de tanımlıdır; bu bölüm tarayıcı isteğinin o eyleme hangi kapılardan geçerek ulaştığını tanımlar.
1. Rota önsözü
POST, PUT, PATCH ve DELETE rotalarının ilk cümlesi ZORUNLU olarak tam bir erişim politikasıdır:
herkese açık
oturum gerekli
"yönetici" yetkisi gerekliherkese açık, CSRF denetimini kapatmaz; yalnız kullanıcı oturumu aranmayacağını açıklar. Politika eksikliği T049'dur. Politika ilk ve tek politika cümlesi değilse T050'dir.
Politikadan hemen sonra sıfır veya daha çok zorunlu alan bildirilebilir:
"parola" alanı gerekli
"not" alanı gerekliAlan yoksa veya yalnızca boşluksa rota gövdesi çalışmadan 400 döner. Alan bildirimleri politika ile normal rota cümleleri arasında bulunur; başka yerde T050'dir.
GET ve HEAD için politika yazılabilir. Yazılmazsa rota herkese açıktır; spec/11'in salt-okuma kanıtı yine geçerlidir. GET/HEAD rotası açık politikayı herkese açık önbelleklenebilir 300 saniye biçiminde de yazabilir; anlamı ve sınırları K-335 bölümündedir.
2. Parola ve oturum açma
Parola doğrulama Argon2id v19 PHC veya sınırlı legacy bcrypt özeti kabul eder:
verilen parola_özeti ile doğrulanıyorsa
"Mustafa" kullanıcısını "yönetici" rolüyle oturuma alBozuk, desteklenmeyen algoritmalı veya eşleşmeyen özet yanlış sonucudur. PHC özeti dil parola-özeti ile parolayı terminalde göstermeden üretilir; otomasyon için açık --stdin seçeneği vardır.
K-210/ADR-083 ile PHC özeti dil içinde de üretilir: parolanın argon2 özeti Argon2id v19 (kitaplık varsayılan parametreleri, CSPRNG tuz) döndürür; kriptografi yetkinliği ister, web isteğinde giriş oran sınırına tabidir (aşım yanıtı §5, K-365), playground'da C028'dir. İki adımlı doğrulama yeni totp anahtarı (160 bit Base32, CSPRNG) ve kod gizli anahtarıyla doğrulanıyorsa (RFC 6238, 30 s adım, 6 hane, HMAC-SHA1, ±1 adım pencere, sabit zamanlı karşılaştırma) ile kurulur; saat adaptörden gelir; web isteğinde ayrı TOTP giriş kovasına tabidir (aşım yanıtı §5, K-368). Gizli anahtar sunucuda parola özeti gibi saklanır, istemciye yalnız kayıt anında otpauth bağlantısı olarak verilir.
Başarılı oturuma al cümlesi:
- varsa anonim veya eski oturumu iptal eder;
- işletim sistemi CSPRNG kaynağından 256 bit yeni oturum kimliği ve ayrı bir 256 bit CSRF belirteci üretir;
- depoda oturum kimliğinin yalnız SHA-256 özetini, kullanıcıyı, rolü, CSRF belirtecini ve son geçerlilik anını tutar;
- oturumu oluşturma anından başlayan mutlak 30 dakika ile sınırlar; proje bildirimi bu ömrü ve kayar yenilemeyi K-330 bölümündeki sınırlarla seçebilir.
Bu döndürme session fixation saldırısına karşı normatif davranıştır. Roller istemciden okunmaz; sunucu oturum kaydından denetlenir. Kimlik gerektiren rotaya anonim istek 401, doğru kimlik fakat yanlış rol 403 döner.
oturumu kapat sunucu kaydını iptal eder ve oturum çerezini Max-Age=0 ile sonlandırır. Eski belirteç yeniden kullanılamaz. Süresi dolan kayıt istek başında silinir. Geçerli erişim tahliye sırasını günceller ama son geçerlilik anını ileri taşımaz; proje oturum_kayar açmadıkça ömür sliding değildir.
Oturum deposu en çok 4096 toplam oturum tutar. Yalnız kimliği doğrulanmış kayıtlarla doluysa yeni giriş, var olan bir kullanıcıyı düşürmek yerine fail-closed hata olur. Deneysel web bunu süreç içi adaptörle; --web-proxy production profili proje kökündeki .zee/web-durumu-v1.json kalıcı ortak adaptörüyle uygular. Kalıcı kayıt tokenın kendisini değil yalnız SHA-256 özetini tutar. Bilinmeyen biçim sürümü, bozuk/aşırı büyük içerik, symlink, güvensiz dosya türü veya IO hatası 503'tür. Kalıcı adaptör durumu klasör yazma kilidi altında okur, günceller ve yayımlar (K-353); eşzamanlı yazar sayısı isteği reddettirmez, yalnız spec/08'in 5 sn kilit bekleme sınırı aşılırsa istek 503 olur.
Her rota gövdesinde oturum, Metin değerli bir sözlük olarak ZORUNLU bulunur. Geçerli kimlikli sunucu oturumunda tam olarak kimlik, kullanıcı, rol, oluşturulma_ms, son_erişim_ms ve son_geçerlilik_ms anahtarlarını taşır; anonim istekte boştur. kimlik, ham çerez belirteci değil depodaki 64 haneli küçük harfli SHA-256 özetidir ve yalnız iptal hedefi olarak TANIMLIDIR. Bu değerlerin tek kaynağı doğrulanmış sunucu oturum kaydıdır. İstek başlığı, form alanı veya tarayıcı çerezi oturum sözlüğünü dolduramaz; adaptör iç taşıma alanlarını istemci girdisinden ayırıp güvenilir kayıttan yeniden kurar. Ham oturum belirteci, CSRF belirteci ve başka sırlar sözlüğe konmaz. oturum yalnız rota kapsamına aittir; rota dışında kullanımı A001'dir.
GET "/panel" adresine istek geldiğinde
oturum gerekli
kullanıcı oturumun "kullanıcı" değeri olsun
rol oturumun "rol" değeri olsunKimliği doğrulanmış oturumları yönetmek için aşağıdaki iki Sonuç ifadesi TANIMLIDIR:
oturumlar kullanıcı ile web oturumlarını listelemeyi dene olsun
iptal kimlik ile web oturumunu iptal etmeyi dene olsunListeleme yalnız verilen kullanıcıya ait, süresi dolmamış kimlikli oturumları oluşturma anı ve kimliğe göre deterministik sıralı Metin sözlükleri olarak döndürmek ZORUNDADIR. Tekil iptal yalnız 64 haneli küçük harfli özet kimliği kabul etmek, bulunmayan kayıtta başarılı 0, silinen kayıtta başarılı 1 döndürmek ve ham belirteç/CSRF açmamak ZORUNDADIR. Her iki işlem web-oturumu yetkinliğine ve istek transaction'ına bağlıdır; ortak kalıcı depoda worker ve restart sınırlarını aşan iptal aynı cevabın commit/rollback semantiğini izler.
3. CSRF
Form gösteren GET rotası csrf belirteci ifadesini kullanır:
csrf csrf belirteci olsun
form "<input type=hidden name=_csrf value=\"" ile csrf ile "\">" olsunGeçerli oturum yoksa ifade oluşturma anından başlayan mutlak 10 dakikalık anonim form oturumu oluşturur. Depoda aynı anda en çok 1024 anonim oturum bulunur. Anonim veya toplam kota dolduğunda en uzun süredir kullanılmayan anonim kayıt tahliye edilir; aynı erişim anında oluşturma sırası belirleyicidir. Belirteç sunucu oturumuna bağlı synchronizer token'dır. Her POST, PUT, PATCH ve DELETE isteğinde _csrf alanı otomatik denetlenir. Oturum, alan veya eşleşme yoksa rota gövdesi çalışmadan 403 döner.
Başarılı giriş hem oturum kimliğini hem CSRF belirtecini yeniler. Giriş öncesi anonim CSRF değeri kimliği doğrulanmış oturumda geçerli değildir.
4. Çerez profili
--web-proxy profilinde yönetilen oturum çerezi:
__Host-zee-oturum=<belirteç>; Path=/; Max-Age=<sınır>;
HttpOnly; SameSite=Lax; Secure__Host- öneki nedeniyle Domain niteliği YASAK, Path / ve Secure ZORUNLUDUR. Deneysel düz-HTTP localhost kipinde tarayıcının Secure çerezi reddetmemesi için ad zee-oturumdur; bu kip production profili değildir.
Ham çerezine yaz, çerezini sil ve adresine yönlendir değerleri HTTP başlığına girmeden doğrulanır. Kontrol karakteri, CR/LF, geçersiz çerez adı/değeri ve yerel olmayan yönlendirme C022 ile reddedilir.
5. HTTPS reverse-proxy sınırı
Production profili şu komutla açılır:
dil çalıştır --web-proxy https://panel.example --web-worker-port 18091 uygulama.dilRuntime yalnız 127.0.0.1 üzerinde düz HTTP dinler. TLS'yi aynı makinedeki güvenilir reverse proxy sonlandırır. Kabul edilen socket peer'i ayrıca loopback olmak ZORUNDADIR; aksi durumda başlıklar güvenilir sayılmadan 403 döner. Runtime her istekte:
- tek
Hostbaşlığının yapılandırılan origin otoritesiyle eşleşmesini; - tam bir
Forwarded: for=<IP>;proto=https;host=<host>başlığının tek header ve tek hop olmasını; fordeğerininIpAddrile kanoniklenen yalın IPv4/IPv6 adresi olmasını;proto=httpsvehostdeğerinin yapılandırılan origin ile eşleşmesini;- durum değiştiren yöntemde tek
Origindeğerinin yapılandırılan origin ile kanonik eşleşmesini ZORUNLU tutar.
--web-proxy, Host, Forwarded host ve Origin tek AgHedefi origin ayrıştırıcısını kullanır. Production origin'i HTTPS olmalı; yol, sorgu, parça ve kullanıcı bilgisi taşımamalı; host geçerli ASCII DNS adı veya köşeli ayraçlı IPv6, port 1–65535 olmalıdır. Şema yazımı https:// olmak zorundadır; DNS adı küçük harfe çevrilir ve açık :443 varsayılan HTTPS portuyla aynı kimliktir. IP adresi standart metinsel yazımına çevrilir. Tek kapanış / yalnız origin yazımında kabul edilip kanonik çıktıda kaldırılır. Farklı portlar aynı origin değildir.
Proxy istemciden gelen Forwarded, X-Forwarded-For ve benzeri başlıkları silip doğruladığı bağlantıdan tek kanonik Forwarded başlığını kendisi kurmalıdır. Runtime X-Forwarded-Forı istemci kimliği saymaz. Eksik/tekrarlı Host, tekrarlı Forwarded, virgüllü zincir, yinelenen parametre, IP olmayan for ve host uyuşmazlığı 400; eksik Forwarded veya HTTPS olmayan proxy zinciri 426; eksik ya da yanlış unsafe Origin ve loopback dışı peer 403'tür. Dinleyicinin loopback dışına açılması bu güven sözleşmesini bozar ve YASAKTIR.
Yanıtlar no-store (tek dar istisnası aşağıdaki K-335 bölümündedir), nosniff, DENY, no-referrer, kısıtlı CSP taşır; HTTPS profilinde HSTS de eklenir. 16 KiB başlık, 64 KiB gövde, byte tabanlı yalnız-CRLF parser, tek Content-Length, origin-form hedef ve Transfer-Encoding reddi request-smuggling/yığın korkuluklarıdır. Başlık ile gövdenin tamamı bağlantı kabulünden başlayan 10 saniyelik mutlak okuma bütçesini aşarsa 408 döner; yanıt yazımı da 10 saniye socket zaman aşımı taşır. Spec/11'in 100 alan ve 30 saniye uygulama sınırı ayrıca geçerlidir.
Doğrulanmış kanonik istemci kimliğiyle varsayılan ortak kalıcı depoda (K-218 explicit bellek seçiminde süreç başına depoda, K-219 uç nokta eşiği ayarı dışında) şu pencereler ZORUNLUDUR:
| Kapı | Pencere | Eşik | Aşım |
|---|---|---|---|
| istemci + yöntem + sorgusuz path | 60 saniye | 100 | 429 |
| CSRF doğrulaması | 60 saniye | 60 | 429 |
| Argon2id/bcrypt parola doğrulaması | 300 saniye | 5 | Parola doğrulaması çalışmadan 429 |
| TOTP kod doğrulaması | 300 saniye | 5 | Kod doğrulaması çalışmadan 429 |
ZORUNLU: parolanın argon2 özeti web isteğinde parola doğrulamasıyla aynı giriş kovasını (aynı istemci ve kapsam, 300 saniye/5) artırır. Kova aşılmışsa özet üretilmez, rota o cümlede kesilir, isteğin bekleyen oturum/çerez mutation'ı ve istek transaction'ı rota hatasındaki gibi geri alınır ve yanıt parola doğrulamasıyla aynı sabit 429 çok fazla giriş denemesi gövdesidir; oran deposuna erişilemezse aynı biçimde 503 giriş oran sınırı deposuna erişilemedi döner. Bu ret kullanıcı tanısı değildir (C028 ya da 500 değildir), Zee kodu onu yakalamaz ve işçi sonraki isteği alır. Web isteği dışında (CLI dil çalıştır akışı, açılış bloğu) giriş kovası yoktur; yetkinlik kapalılığı ve adaptör üretim hatası C028 kalır (K-365).
ZORUNLU: kod gizli anahtarıyla doğrulanıyorsa web isteğinde parola kovasından ayrı TOTP giriş kovasını (aynı istemci, 300 saniye/5) artırır. Kova aşılmışsa kod denetlenmez; doğru kod da yanlış kod da aynı sabit 429 çok fazla giriş denemesi yanıtını alır, oran deposuna erişilemezse 503 giriş oran sınırı deposuna erişilemedi döner. Yanıt parola doğrulamasındaki gibi isteğin ilk yanıtıdır; rotanın sonradan gönderdiği yanıt bu durumu değiştirmez ve işçi sonraki isteği alır. Web isteği dışında TOTP kovası yoktur, doğru kod doğru kalır (K-368).
AÇIK: Parola ve TOTP doğrulaması aşımda rotaya yanlış döndürüp rotayı sürdürür; rota bu dalda kendi hesap kilidi sayacını artırabilir ve aşımı yanlış koddan ayıramaz. Aşımın Zee koduna ayrı bir değerle görünmesi ya da rotanın kesilmesi grammar/IO izi genişlemesidir, core freeze altında açık kalır.
Özet üretimine ayrı kova ya da yakalanabilir Sonuç biçimi vermek grammar/API genişlemesidir; V1 core freeze altında K-364 CalDAV/CardDAV taslağının açık sorusudur.
Sayaç artışı ile pencere sonu tek atomik transaction'dır. En çok 32768 canlı oran anahtarı tutulur. Süresi dolan anahtarlar temizlenir; tablo yalnız canlı kayıtlarla doluysa varsayılan doluluk seçiminde istek fail-closed 503 olur. K-219 explicit en-eski seçimi yalnız uç nokta kayıtlarına tahliye uygular; giriş/CSRF canlı kayıtları korunur.
Oturum/çerez mutation'ı gönderilmemiş ilk yanıtla aynı request transaction'ına aittir. Mutation socket yanıtından önce ortak depoya atomik commit edilir. Runtime hata veya 30 saniyelik deadline'da erken başarı yanıtını atar, oturum mutation'ını bırakır ve 504'ü temiz olarak gönderir. Yanıtsız rota session kaydı bırakamaz. Gerçek socket yazımı başarısızsa yalnız bu isteğin eklediği/sildiği ve hâlâ beklenen değeri taşıyan kayıtlar atomik geri alınır; başka sürecin ilgisiz değişikliği ezilmez. Yarım HTTP gövdesi bağlantı kapanışıyla geçersiz kalır.
6. Platform sınırı
Native CLI CSPRNG, Argon2id ve sınırlı legacy bcrypt doğrulama capability'sini taşır. WASM playground production oturumu veya parola özeti üretmez; parola doğrulaması başarısız olur. TLS sertifikası ve secret dağıtımı deployment katmanının sorumluluğudur.
V1 HTTP server modeli process başına tek worker/thread'dir: bir bağlantıyı okur, bir Zee isteğini yürütür ve yanıtı bitirmeden yenisini kabul etmez. Production concurrency'si aynı proje kökünü ve .zee/web-durumu-v1.json dosyasını paylaşan N ayrı süreçle kurulur: Unix'te tek komutluk resmî çok işçi profiliyle (§7, --web-isci-sayisi N) ya da her süreç kaynak portunu --web-worker-port N ile farklı loopback porta geçirerek. Thread-pool veya aynı process içinde paralel Zee request yürütümü vaat edilmez. Kalıcı adaptör aynı makine veya güvenilir kilit+atomik replace semantiği sunan ortak dosya sistemiyle sınırlıdır; çok-hostlu harici backend henüz yoktur. Sticky session ortak revoke ve oran sınırının yerine geçmez. Operasyon ayrıntıları docs/web-production-profili.md içindedir.
Normatif gerekçe: RFC-0017, ADR-034, ADR-036, ADR-037, ADR-076 ve ADR-079. Rota/eylem ayrımı: RFC-0015 ve spec/11. Ortak origin tipi: ADR-031 ve spec/23.
Legacy bcrypt ve kanonik istemci adresi (K-208/K-209)
TANIMLI: parola ozet ile doğrulanıyorsa native ortamda $2a$, $2b$ ve $2y$ önekli 60 ASCII bayt bcrypt özetini, maliyet 4–14 ve en fazla 72 UTF-8 bayt parola ile doğrular. Büyük maliyet/uzun parola/bozuk biçim crypto işinden önce yanlış olur; sessiz kırpma yapılmaz. Digest karşılaştırması sabit zamanlıdır; toplam çalışma süresinin eşitliği sözü yoktur. Yeni bcrypt üretimi YASAKTIR; Argon2id tek üretim yolu kalır.
TANIMLI: istemci adresi aktif native handler'da oran sınırıyla aynı trusted kimliğin kanonik Metin değeridir; güvenli proxy'de doğrulanmış tek-hop Forwarded, doğrudan deneysel web'de soket IP'sidir. X-Forwarded-For, form ve sorgu alanları kimlik kaynağı OLAMAZ. IPv6 parantezsizdir; request cleanup sonrası ve HTTP isteği dışındaki varsayılan adaptörde boş metindir. Ağ-sunucusu yetkinliği ve mevcut T044 eylem/web ayrımı korunur.
Ürün başarılı girişte eski biçimi SQL LIKE veya mevcut Metin prefix yüklemiyle ayırıp Argon2'ye taşır; yeni algoritma sorgu yüklemi açılmaz. IP kişisel veri olarak ele alınır; KVKK bağlamında saklama süresini uygulama kendi politikasıyla belirler. IO trace IP içerebilir, özel veridir.
K-218 — Bellek oran backend'i
TANIMLI: --web-oran-deposu bellek yalnız --web-proxy ile, tek değer ve tek kez kabul edilir; eksik, geçersiz, tekrar veya deneysel/kapalı kipte kullanım hata ile çıkar. Seçilmezse mevcut ortak dosya backend'i kullanılır.
TANIMLI: Bellek backend'i aynı süreç ve clone'ları arasında atomiktir; ayrı worker ve restart ayrı kota oluşturur. Kullanıcı ortak saldırı bütçesini trusted proxy'de sağlamalıdır. Oturum/CSRF/revoke dosya paylaşımı sürer; cookie'siz anonim istek oturum dosyasına dokunmaz, cookie'li okuma ve oturum commit'i kalıcı taze durumla fail-closed çalışır.
TANIMLI: Bellek backend’inin varsayılan Endpoint/CSRF/giriş eşikleri ve 32.768 canlı anahtar sınırı korunur; varsayılan doluluk seçiminde aktif kayıt tahliye edilmez. Dolu depoda yeni anahtar 503 ile reddedilir, mevcut anahtar kotası sürer; süre dolumu kayıt ve son-tarih indeksini birlikte temizler. İndeks canlı anahtar başına bir giriş taşır.
K-219 — Bellek oran ayarları
TANIMLI: --web-oran-siniri 1..1000000 uç nokta isteği/60 saniye, --web-oran-kapasitesi 1..32768 canlı anahtar, --web-oran-doluluk reddet veya en-eski kabul eder. Bu tekil ayarlar yalnız --web-proxy ve --web-oran-deposu bellek ile kullanılabilir; eksik, tekrar, sayı taşması veya sınır dışı değer hata ile çıkar. Varsayılanlar 100, 32768 ve reddettir; giriş 5/300 sn ve CSRF 60/60 sn değişmez.
TANIMLI: Explicit en-eski seçiminde yeni anahtar için kapasite gerektiğinde yalnız en küçük pencere sonuna sahip uç nokta kaydı (eşitlikte hash sırası) tahliye edilir; erişim pencereyi uzatmaz. Tahliye edilmiş uç nokta yeniden gelince kota sıfırlanabilir; kullanıcı ortak proxy saldırı bütçesini sağlamalıdır. Canlı giriş/CSRF kayıtları tahliye edilmez; tüm kayıtlar korunmuşsa yeni anahtar 503 alır, mevcut sayaç kotası sürer.
ZORUNLU: Bellek kayıt/süre/tahliye indeksleri aynı süreçte clone’lar arasında atomik tutulur ve seçilmiş kapasiteyi aşmaz. Süre dolumu ve tahliye ilgili tüm indeksleri temizler; mevcut anahtar artışı kapasite tahliyesi başlatmaz. Aynı IP/uç nokta seçilmiş eşiği aşınca 429 döner ve iç oran kararı kalan pencere süresini taşır; dosya backend’i ve oturum/revoke paylaşımı değişmez.
K-330 — Proje başına oturum ömrü ve kayar yenileme
TANIMLI: Ana proje.dil isteğe bağlı oturum_ömrü_saniye (sabit Sayı, 300–2592000) ve oturum_kayar (doğru/yanlış) alanlarını kabul eder; ikisi de web-oturumu yetkinliği ister. Sınır dışı ömür ve yetkinliksiz kullanım P015, yanlış tür P001 ile reddedilir. Alan yoksa kimlikli oturum ömrü 1800 sn, kayar kapalıdır. Seçilen ömür ilk oturum çerezinin Max-Age değeridir.
ZORUNLU: Kayar açıkken her kimlikli istek, istek başındaki kalıcı depo güncellemesinde son geçerliliği min(şimdi + ömür, oluşturma + 2592000 sn) yapar, var olan geçerliliği kısaltmaz ve yanıt aynı belirteçle kalan süreyi Max-Age olarak taşıyan oturum çerezini yeniden yazar. Oluşturmadan sayılan 30 günlük mutlak tavan hiçbir erişimle aşılamaz. Yeniden başlatma ve ayrı worker'lar aynı kalıcı kaydı görür.
YASAK: Kayar yenileme anonim (giriş öncesi) oturumu uzatamaz ve yeni belirteç üretemez. Aynı istekte giriş, oturumu kapat ya da kendi oturumunun kimlikle iptali varsa yenileme çerezi yazılmaz; çıkış sunucu kaydını commit ile hemen siler ve yanıt yalnız Max-Age=0 silme çerezini taşır.
ZORUNLU: dil dene bir proje klasörüyle koşulduğunda her testin hermetik web adaptörü aynı oturum_ömrü_saniye/oturum_kayar ayarını gerçek runtime ile aynı kurallarla uygular: kimlikli oturum seçilen ömürde biter, kayar kipte kimlikli istek ömrü yeniden başlatır ve aynı belirteçle yenilenmiş Max-Age çerezi yazar, mutlak kipte erişim ömrü uzatmaz. Proje bildirimi olmadan koşulan dosya ve gömme programi_dene varsayılan 1800 sn mutlak ömürde kalır.
7. Çok işçi profili ve açılış birincilliği (K-336/K-337)
TANIMLI: dil çalıştır --web-proxy <origin> --web-worker-port P --web-isci-sayisi N [--web-saglik-port S] <kaynak> (1 ≤ N ≤ 64) bir yönetici süreç açar. Yönetici 127.0.0.1:P dinleyicisini bir kez bağlar ve aynı açık dinleyiciyi N işçi sürecine devreder; bağlantıyı boştaki işçi accept ile alır. Yönetici Zee kaynağını yürütmez; her işçi kaynağı baştan yürüten §5 tek süreç çalışma zamanıdır. SO_REUSEPORT ya da proxy aktarımı kullanılmaz.
ZORUNLU: Oturum, CSRF, revoke ve varsayılan ortak oran deposu davranışı N işçide tek süreçle aynıdır: işçiler aynı proje kökünü ve .zee/web-durumu-v1.json durumunu paylaşır, bir işçide açılan oturum ve verilen CSRF belirteci ötekinde geçerli, çıkış her işçide 401, giriş deneme sınırı grup genelinde tek sayaçtır. Explicit --web-oran-deposu bellek seçimi işçi başınadır ve etkin oran sınırını N katına çıkarır; yönetici açılışta bunu uyarır.
TANIMLI: birincil süreç argümansız Mantıksal ifadedir (ağ-sunucusu yetkinliği). Tek süreçte ve sunucu yetkinliği olmayan politikada doğru; çok işçi grubunda yalnız grubun ilk açılan birincil işçisinde doğru, ikincil ve yeniden başlatılan her işçide yanlış. Değer süreç ömrü boyunca değişmez; IO izinde birincil_surec olayı 0/1 sonucuyla kaydedilir ve oynatılır.
ZORUNLU: Yönetici ikincil işçileri birincil işçi sunucu başlata ulaşmadan başlatmaz. Böylece birincil süreç doğruyken koşan açılış bloğu grubun ilk açılışında hiçbir işçi istek kabul etmeden ve yalnız bir kez koşar; yeniden başlatılan işçi ikincil olduğundan çalışan işçilerin o an yüklediği geçici dosyaları açılış taramasına kaptırmaz. Birincil sunucu başlata ulaşmadan çıkarsa grup başlatılmaz ve yönetici onun sıfır olmayan çıkış koduyla (yoksa 1) biter.
ZORUNLU: --web-worker-port ile açılan her süreç (grup işçisi ya da elle kurulan ayrı portlu süreç) birincil süreçi ilk değerlendirdiğinde dosya sınırı kökündeki .zee/birincil-acilis.kilit dışlayıcı kilidini alır, tutuluyorsa bırakılana dek bekler. Kilit altında .zee/birincil-canli.kilit üzerinde başka katılımcının paylaşımlı kilidi yoksa ve grup rolü ikincil değilse değer doğrudur; süreç ardından canlı kilidi ömrü boyunca paylaşımlı tutar. Birincil açılış kilidini sunucu başlata dek tutar, ikincil hemen bırakır. Böylece aynı kökte canlı başka katılımcı varken açılan ya da yeniden başlayan süreç yanlış görür ve birincilin açılış bloğu bitmeden başka katılımcı karar vermez. Kilit kurulamazsa (kilit yolu normal dosya değil, kök yazılamaz) süreç stderr'e yazar ve yanlış görür (K-341).
TANIMLI: Beklenmedik biçimde çıkan işçi aynı yuvada ikincil olarak 250 ms'den 5 sn'ye katlanan gecikmeyle yeniden başlatılır; 10 sn dolmadan art arda 10 kez çıkan yuva grubu durdurur (çıkış 1). SIGTERM ya da SIGINT alan yönetici işçilere SIGTERM iletir; işçi kabul ettiği isteği tamamlar ve yeni bağlantı almaz; 40 sn içinde bitmeyen işçi sonlandırılır. Yönetici kaybolursa (SIGKILL) işçiler en çok bir boşta yoklama aralığında (100 ms) yeni istek kabul etmeyi bırakıp çıkar.
ZORUNLU: Grup işçisinin dinleyicisi yönetici (ya da systemd) ve kardeş işçilerle paylaşılır; işçi SIGTERM ile kendi kopyasını kapatsa da kuyruktaki bağlantılar grupta kalır. Bu yüzden işçinin başarıyla kabul ettiği bağlantı, kabul ile kapanış denetimi arasına SIGTERM düşse de düşürülmez: istek mevcut bütçelerle yanıtlanır, sonraki kabul denetimi yeni bağlantı almayı durdurur. Dinleyicinin tek sahibi olan tek süreç (doğrudan bind) bu yarışta kabul edilen akışı dinleyiciyle birlikte kapatır (K-253; K-360).
TANIMLI: --web-saglik-port S yalnız 127.0.0.1:S üzerinde GET /saglik ve HEAD /saglik yanıtlar: birincil hazır ve N işçi süreci yaşıyorsa 200, aksi hâlde 503; gövde durum (basliyor/hazir/eksik/kapaniyor), isci, canli, yeniden_baslatma ve surecler (işçi PID'leri) alanlı JSON'dur. Başka yol 404'tür. Sağlık yanıtı uygulama hazırlığı (DB/göç) kanıtı değildir.
ZORUNLU: Yönetici sağlık bağlantısını işçilere miras bırakmaz: bağlantının kabulü ve FD_CLOEXEC işaretlenmesi işçi başlatmayla aynı anda yapılmaz. Yanıt yazıldıktan sonra bağlantı iki yönde kapatılır; istemci yanıtı her zaman EOF ile alır, başka bir süreçte kopya kalsa da bekletilmez (K-345).
TANIMLI: Proje kökündeki zee.ayar (K-234) guvenlik dalı isci-sayisi (tam sayı 1..64) ve saglik-port (tam sayı 1..65535) alanlarıyla aynı grubu kaynak öncesi --web-isci-sayisi/--web-saglik-port bayraklarına eşler. isci-sayisi aynı config'te web-modu proxy ve worker-port ister, saglik-port isci-sayisi ister; eksik bağımlılık, tür ya da sınır hatası çıkış 2'dir ve CLI'daki worker portu config'i geçerli kılamaz. Kaynak öncesi açık bayrak aynı alanın config değerini ezer. İşçi süreci config'i yeniden okusa da yönetici olmaz; işçi alanları işçide yok sayılır (K-340).
YASAK: --web-isci-sayisi --deneysel-web ile, worker portu verilmemiş proxy ile, --web-saglik-port da --web-isci-sayisi olmadan kullanılamaz; 1..64 dışı değer ve dil çalıştır dışındaki komut çıkış 2 ile reddedilir. Native listener devri (--web-listener-fd …) ve --web-metrik-fd çok işçi profiliyle birleşmez.
TANIMLI: --web-systemd-soketi (ya da zee.ayar guvenlik.systemd-soketi: true) verilen işçi grubu yöneticisi ortak dinleyiciyi bağlamaz; systemd soket etkinleştirmesiyle devralır: LISTEN_PID yöneticinin PID'i, LISTEN_FDS 1 ve soket fd 3 olmalıdır. Soket devralınan dinleyici doğrulayıcısıyla 127.0.0.1:<worker-port> üzerinde dinleyen TCP olarak sınanır; LISTEN_PID, LISTEN_FDS ve LISTEN_FDNAMES her durumda hemen silinir. Devir yoksa ya da geçersizse çıkış 2'dir ve ileti .socket düzeltme önerisi taşır; bind'e geri dönülmez. LISTEN_FDS kendiliğinden algılanmaz. Bayrak yalnız --web-isci-sayisi ile geçerlidir (K-343).
ZORUNLU: systemd soketiyle çalışan grubun yöneticisi SIGTERM ile boşaltılıp yeniden başlatılırken soket systemd'de kaldığından aralıkta gelen bağlantılar reddedilmez; soket kuyruğunda bekleyip yeni grubun işçileri tarafından yanıtlanır (K-343).
AÇIK: Windows'ta paylaşılan dinleyici devri yoktur; --web-isci-sayisi Windows'ta çıkış 2 ile reddedilir ve eşzamanlılık ayrı --web-worker-port süreçleri ile önlerindeki proxy dengelemesiyle kurulur. Bağlantıların işçilere dağılımı çekirdeğe bağlıdır (macOS'ta eşit değildir); ayrı portlu süreçlerde birincillik yalnız birincil süreçi değerlendiren süreçler arasında ve yerel dosya kilidinin (Unix flock, Windows LockFileEx) geçerli olduğu tek makinede sağlanır, ağ dosya sistemi ve çok hostlu kurulum kapsam dışıdır.
K-335 — Önbelleklenebilir herkese açık rota
TANIMLI: Rota önsözünün politika cümlesi herkese açık önbelleklenebilir N saniye biçiminde yazılabilir; N 1–86400 arası sabit TamSayıdır. Bu cümle erişim bakımından herkese açık ile aynıdır ve önsözün ilk ve tek politika cümlesi kuralına (T050) uyar. Başka sayı, birim ya da eksik parça S043'tür.
YASAK: Önbelleklenebilir politika GET ve HEAD dışındaki rotada T056 ile reddedilir. Rota gövdesi oturum ya da çerezler sözlüğünü okuyamaz; gövde ya da gövdenin (geçişli olarak) çağırdığı işlemler csrf belirteci, çerez yazma/silme, oturuma al, oturumu kapat ve web oturumu listeleme/iptal ifadelerini kullanamaz. İhlal T057'dir ve ilk dokunuşun satırını gösterir.
ZORUNLU: Çalışma zamanı önbelleklenebilir rotaya boş oturum ve çerezler sözlükleri verir. Yanıt yalnız şu koşulların hepsi sağlanınca Cache-Control: public, max-age=0, s-maxage=N taşır: istek yöntemi GET ya da HEAD, rota gövdeyle 200 yanıtı gönderdi, yanıt hiçbir Set-Cookie başlığı taşımıyor ve istek sırasında oturum yüzeyine dokunulmadı. Diğer her durumda (hata/durum yanıtı, yönlendirme, kayar oturum yenilemesi dahil herhangi bir Set-Cookie) yanıt no-store kalır. Diğer güvenlik başlıkları değişmez; max-age=0 tarayıcı önbelleğini kapalı tutar, ömür yalnız paylaşılan önbelleğe verilir.
AÇIK: Vary, ETag/koşullu istek, stale-while-revalidate ve önbellek temizleme sözü verilmez. Sorgu dizgisi önbellek anahtarının parçasıdır ve ön kapı tarafından korunmalıdır. Normatif gerekçe: RFC-0037, ADR-160.