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

23 — Yetkinlik ve outbound ağ güvenliği

Depodaki spec/23-yetkinlik-ve-outbound-guvenligi.md belgesinden Zee ile üretildi.

Normatif kaynak: RFC-0024, ADR-031. Gerçekleme kaydı: K-127.

Yetkinlik kümesi (TANIMLI)

Kararlı proje yazımları şunlardır:

YazımAçtığı sınır
dosya-okumaProje kökündeki dosyayı okuma/listeleme/SHA-256 hesaplama
dosya-yazmaProje kökündeki dosyayı atomik yazma/ekleme/taşıma/silme
ağBildirilmiş origin'e outbound HTTP(S)
yerel-ağPrivate/loopback hedef ve explicit düz HTTP
ağ-sunucusuNative loopback web sunucusu/adaptörü
donanımSensör ve ışık adaptörü
web-oturumuOturum, rol, çerez ve CSRF adaptörü
kriptografiParola/kriptografi adaptörü; K-210 eki 3 ile gizli değer şifreleme (gizli_anahtar_değişkeni ortam değişkeni, zee1: XChaCha20-Poly1305)
veritabanıBildirilmiş exact loopback PostgreSQL adaptörü

proje.dil içindeki yetkinlikler ve ağ_hedefleri yoksa boş listedir. Değerler tekil olmak ZORUNDADIR. yerel-ağ → ağ, web-oturumu → ağ-sunucusu bağı ZORUNLUDUR. ağ ancak boş olmayan ağ_hedefleri ile ve tersi birlikte bulunabilir. İhlal P015'tir.

veritabanı, bildirimsiz tek dosya geliştirici profilinde örtük açılmaz. Proje hedefi, bağlantı sırrı ve migration kökü spec/25'teki üçlü bildirime bağlıdır; outbound ağ allowlist'i yerine geçmez.

Origin ve IP kuralları (TANIMLI)

Bildirim hedefi yalnız http://host[:port] veya https://host[:port] origin'idir; yol, sorgu ve parça YASAKTIR. İstek URL'sinin yolu/sorgusu olabilir ama şema+küçük-harfli ASCII DNS/IP+etkin port exact bildirime eşleşmek ZORUNDADIR. Kullanıcı bilgisi, kontrol karakteri, ters bölü, sıfır port, ayraçsız IPv6 ve başka şema YASAKTIR. K-210 ile smtps:// (465, implicit TLS) ve smtp:// (587, STARTTLS zorunlu; düz metin yalnız loopback) şemaları aynı exact origin kuralıyla kabul edilir; bildirimsiz geliştirici ağında yalnız şifreli şemalar (https, smtps) kendiliğinden izinlidir. SMTP kimlik bilgisi bildirimde değil e_posta_bağlantı_değişkeni ortam değişkenindedir.

Public hedef HTTPS olmak ZORUNDADIR. Düz HTTP bildirimi için yerel-ağ ZORUNLUDUR. DNS çözümünden sonra bağlantıda kullanılabilecek bütün IP'ler denetlenir: public unicast kabul edilir; loopback, RFC1918, CGNAT ve IPv6 ULA yalnız yerel-ağ ile kabul edilir. Link-local/metadata ile IANA public olmayan özel-kullanım veya IPv4-geçiş önekleri her profilde YASAKTIR. Yasak ve izinli IP'yi birlikte döndüren DNS cevabı reddedilir.

Redirect izlenmez; ortam proxy'si kullanılmaz. Native istemci global ve DNS çözümünde varsayılan 30 saniye son tarih, en fazla 64 KiB response header ve 8 MiB toplam zarf içinde body uygular. HTTPS sertifika/TLS doğrulaması rustls backend'indedir. Bu sınırların ihlali runtime'da C018'e dönüşür.

K-139/ADR-036 ile aynı AgHedefi origin ayrıştırıcısı production web proxy'nin --web-proxy, Host, Forwarded host ve unsafe Origin sınırlarında da ZORUNLUDUR. Outbound ve inbound güven yüzeyleri ikinci bir DNS/IPv6/port parser'ı taşıyamaz; web'e özgü HTTPS ve loopback değişmezleri spec/12'de tanımlıdır.

Compile ve runtime uygulaması (TANIMLI)

Ana program, bütün testler ve çağrılmayan işlemler dahil her gövdenin dış dünya ihtiyacı yürütmeden önce çıkarılır. Eksik yetkinlik veya sabit outbound URL'nin allowlist dışı origin'i kesin AST ifade aralığında T054'tür. Dinamik URL runtime origin denetiminden geçmek ZORUNDADIR.

Proje çalıştırma ve denetleme manifest politikasını kullanır. --güvenli yalnız proje-kökü dosya okuma/yazmayı açar. Bildirimsiz tek dosya geriye uyumlu geliştirici profilidir; dosya ve adaptörler açık, outbound yalnız public HTTPS, yerel-ağ kapalıdır. Her runtime IO çağrısı policy sarmalayıcısından; native dosya/ağ/web adaptörü ayrıca aynı kapıdan geçer.

Proje dosya yolu göreli ve kök içinde olmalıdır. .., mutlak yol ve canonical hedef/ebeveynin sembolik bağla kök dışına çıkması reddedilir. Bu sözleşme eşzamanlı düşman yerel süreçlere karşı OS sandbox'ı değildir.

Paket yetkisi (TANIMLI)

Her paket kendi proje.dil ihtiyacını bildirir. Paket yetkinlik ve origin kümeleri ana uygulama politikasının alt kümesi olmak ZORUNDADIR; aksi P015'tir. Uygulama izni süreçteki ortak üst sınırdır. Paket başına ayrı filesystem, tenant veya süreç izolasyonu bu sürümde AÇIKTIR ve vaat edilmez.

K-220 — Native başlıklı HTTP istek profili

TANIMLI: adres yöntem başlıklar gövde süre ile HTTP isteğini dene, native HTTPS GET/POST için Metin sözlüğü Sonucu döndürür. Adres/yöntem/gövde Metin, başlıklar Metin sözlüğü (boş sözlük kabul), süre TamSayı milisaniye ve 1..30000 aralığındadır. GET gövdesi boş olmalı; başarı sözlüğü durum HTTP durum metni ve gövde UTF-8 metnidir. 3xx/4xx/5xx yanıtları başarı taşımasıdır; ağ/süre/boyut/istek hatası C018 kodlu başarısız Sonuç olur. Eski GET kalıbı değişmez; yeni çağrı eylem transaction’ında T048 ile reddedilir.

ZORUNLU: Yeni istek exact origin ve DNS sonrası IP denetimi, global bağlantı bütçesi, TLS doğrulaması, kapalı redirect ve kapalı ortam proxy’sini korur. En fazla 64 başlık/toplam 64 KiB, gövde en fazla 8 MiB - 64 KiB kabul edilir; GET gövdesi, tekrar başlık, printable ASCII dışı değer, geçersiz HTTP adı ve Host/Content-Length/Transfer-Encoding/Connection/Proxy-Connection/Proxy-Authorization/Upgrade/Expect kullanıcı başlığı reddedilir. Başlık değerleri sensitive işaretlidir; adaptör hata ayrıntısı, URL, başlık ve gövde hata mesajına girmez. İstek süresi üst deadline’ın kalanına sınırlandırılır; mevcut üst deadline C020 davranışı sürer.

TANIMLI: ad gizli ortam değerini okumayı dene yalnız ana projenin http_gizli_değişkenleri listesinde kayıtlı adları Metin Sonucu olarak okur. Liste ağ yetkinliği, en fazla 16 tekil ad, ad başına 64 A-Z/0-9/_ karakteri ve değer başına 64 KiB ister. Standalone dosya veya bağımlı proje kendiliğinden izin vermez. Yeni HTTP ve gizli ortam işlemleri IO iz kaydında yürütülmez, iz export’u kapanır; replay desteklenmeyen işlem olarak kapalı başarısızlık döndürür.

TANIMLI: metin HTTP JSON sözlüğünü okumayı dene native HTTP profilinde bir JSON nesnesini Metin sözlüğü Sonucu yapar; alan değerleri kanonik JSON metnidir (bool true true, metin true "true"). Girdi en fazla 1 MiB, en fazla 128 üst alan ve serde derinlik sınırıyla işlenir; üst düzey tekrar anahtar ve trailing veri reddedilir. İç nesnelerde serde tekrar anahtar davranışı korunur. Yeni native HTTP/ortam/JSON adaptörü WASM’da açılmaz; desteklenmeyen işlem başarısız Sonuç’tur.

HTTP kabulündeki sentetik TLS kimliği yalnız localhost test Agent’ında kullanılır. Kaynak ve scanner kopyası immutable fixture blob’u ile aynı SHA-256 değerindeyken tek pkcs12-file directory fingerprint’i verilir; bu üretim TLS güven deposu veya sır kabul politikası değildir (ADR-091/GB-054).

Ekli SMTP e-posta (TANIMLI — K-232)

alici konu duz html yanit ekler baglanti ile ekli ileti göndermeyi dene ZORUNLU imzası beş Metin, Metin listesi ve son Metin; dönüş TamSayı Sonucu'dur. Boş HTML/yanıt adresi opsiyonu, boş liste ekleri kaldırır. Boş bağlantı yalnız ana projenin mevcut e_posta_bağlantı_değişkeni ayarını seçer. Başarı 1, başarısızlık sır içermeyen C029'dur; otomatik tekrar YASAKTIR. DATA yanıtı kaybolan hata gönderilmedi kanıtı değildir. Eylemde kullanım T048 ile YASAKTIR.

ağ ve mevcut exact SMTP origin/IP sınırı ZORUNLUDUR; ekler ayrıca dosya-okuma ister, dosya-yazma istemez. Host readonly açmadan önce yol ve normal dosyayı ZORUNLU denetler; Unix writer-yok FIFO üzerinde bloklayan açma YASAKTIR. Açılışta leaf symlink/reparse-point ve değişmiş handle kimliği reddedilir. Actual read metadata uzunluğuna eş ve okuma sonrası len/mtime sabit olmak ZORUNDADIR. Düşman yerel süreçlere/NFS'e karşı tam sandbox ve atomik/coherent filesystem snapshot garantisi AÇIKTIR (GB-016 sınırı).

zee-smtp-mime-1 profili HTML için multipart/alternative, ekler için dış multipart/mixed, 76 sütun Base64/CRLF, RFC2047 Unicode başlık ve RFC2231 filename kullanır. PDF/PNG/JPEG/WebP dışında ek tipi YASAKTIR. Bu etiket whitelist'idir; içerik/antivirüs doğrulaması AÇIKTIR. Envelope ASCII tek adres, 254 bayt ve local-part 64 bayt sınırında olmak ZORUNDADIR. Header injection, boş/çok bileşenli ek basename'i ve 998 baytı aşan fiziksel SMTP satırı YASAKTIR.

Kaynak politikasının tek sahibi KaynakSinirlari.eposta() olmak ZORUNDADIR: 8 ek, tek ek 8 MiB, toplam ek 16 MiB, ayrı düz/HTML gövde 512 KiB, wire 24 MiB; konu/ad/tarih/kimlik sırasıyla 512/255/78/48 bayttır. Gerçek read upper bound sınır+1 ile ZORUNLU denetlenir; başarılı truncate YASAKTIR. SMTP global bağlantı iznini bütün sonuç yollarında ZORUNLU bırakır.

Native MIME hazırlığı/SMTP süresi 20 saniye ve varsa dış son tarihin kalanıyla ZORUNLU sınırlanır; TLS handshake/read/write aynı kalan bütçeyi kullanır. SMTPS/STARTTLS sertifika+hostname doğrulaması ZORUNLUDUR; TLS downgrade/plain fallback YASAKTIR, STARTTLS'siz plaintext yalnız loopback'te TANIMLIDIR. Sistem DNS çözümüne ve bloklayan düzenli filesystem read'ine zorla iptal ile sert wall-time garantisi AÇIKTIR; sonrasında dolan bütçeyle SMTP başlamaz.

MIME çağrısının IO iz kaydında yürütülmesi, export'u ve replay başarısı YASAKTIR; serialized sır/ek olayı eklenmez. WASM/playground unsupported başarısız Sonuç TANIMLIDIR. Canlı SMTP/M365/Gmail, özel ürün rota entegrasyonu ve staging kabulü ile P09 queue/outbox/retry/cron AÇIKTIR. Eski düz metin encoder/transport/deadline/failure davranışı K-232 kapsamında değişmez.

SMTP hata sonucu (TANIMLI — K-236)

Eski ortam ve explicit bağlantı e-posta kalıpları başarısızlıkta C029 Hata Sonucu döndürmek ZORUNDADIR. Native SMTP veya host adaptöründen gelen ham sunucu yanıtı, URL, credential ve policy ayrıntısı bu sonuçta YASAKTIR. AUTH PLAIN payload'ının ham ya da geri çözülebilir Base64 biçimi kullanıcı hata metnine taşınamaz; public native sender da aynı sabit maskeyi döndürür.

K-236 yalnız dışarı dönen hata ayrıntısını kaldırır; mevcut plain encoder, SMTP tel baytları, AUTH/TLS/deadline ve failure kontrol akışı değişmez. Otomatik tekrar YASAKTIR; DATA yanıtı kaybolan başarısız Sonuç teslim edilmedi kanıtı değildir. Genel sır taint sistemi ve SMTP yanıt okuma bütçesi bu düzeltmenin kapsamı değildir; yanıt bütçesi K-237'ye aittir.

SMTP yanıt bayt bütçesi — K-237

ZORUNLU: Düz metin ve MIME SMTP yolunun ortak yanıt okuyucusu, bütün çok satırlı yanıtı en fazla 16 KiB kabul eder; LF/EOF bekleyerek sınırsız String büyütmek YASAKTIR. Her satır okuması kalan toplam sınır + tek taşma baytıyla sınırlanır; en fazla 16385 yanıt baytı tüketildikten sonra taşma reddedilir. Tam 16 KiB terminal LF veya EOF yanıtının baytları ve cevap kodu korunur; sonraki yanıta ait BufReader tamponu tüketilmez. ZORUNLU: Ortak SMTP yanıt String tamponunun kapasitesi 16385 baytı aşmaz. Geçerli UTF-8 karakteri taşma baytında kesilse de 16 KiB sınır hatası UTF-8 hatasından önce döner; sınır içindeki bozuk UTF-8 okuma hatasıdır. Tek baytlık LF/EOF vermeyen akış, timeout'a güvenmeden aynı tüketim sınırında reddedilir; boş EOF bağlantı-kapandı hata yolunu korur.

Bu tüketim sınırı BufReaderın sabit ön okumasından ayrıdır. Varsayılan 8 KiB kapasitede alttaki okuyucudan en fazla 24 KiB alınabilir; kalan ön okuma byte'ları yanıt String'ine girmez. TLS iç buffer/socket kernel buffer veya toplam RSS için 16 KiB garantisi verilmez. K-252 düz metin yolunu da MIME ile paylaşılan mutlak son tarihe bağlar. Dış hata K-236 güvenli maskelemesini korur (ADR-099/100/110).

SMTP mutlak süre bütçesi — K-252

ZORUNLU: Native düz metin SMTP gönderimi tek mutlak süre bütçesini bağlantı, SMTP ve TLS okuma/yazmaları boyunca korur; yavaş kısmi yanıt veya yazma süreyi yenileyemez. Sıfır ve taşan süre ağdan önce reddedilir; son tarih dolunca yeni ağ işlemi başlamaz. Sistem DNS çözümlemesi iptal edilemez; sert toplam çağrı wall-time garantisi verilmez. C029 maskelemesi ve otomatik tekrar yasağı korunur.

systemd credential gizli değer kaynağı — K-339

TANIMLI: Native CLI ana projenin gizli değer bağlarını (gizli_anahtar_değişkeni, e_posta_bağlantı_değişkeni, PostgreSQL bağlantı değişkeni ve onun _TLS_CA_PEM eki, http_gizli_değişkenleri) CREDENTIALS_DIRECTORY ayarlıysa aynı adlı systemd credential dosyasından da okur; ad credential kimliğidir. Değişken ayarlı değilse davranış ortamdan okumayla birebir aynıdır. Yetki, izin listesi ve ağ hedefi denetimi kaynaktan bağımsız olarak önce uygulanır.

ZORUNLU: CREDENTIALS_DIRECTORY mutlak yol olur; ./.. bileşeni taşıyamaz ve her bileşeni sembolik bağ izlenmeden dizin olarak açılır. Son dizinin sahibi etkin kullanıcı ya da root olur, grup ve diğer kullanıcılar yazamaz. Ayarlı değişkenin dizini yoksa ya da bu koşullardan biri bozuksa gizli değer okuması açık hatayla reddedilir; ortama sessiz dönüş YASAKTIR.

YASAK: Ad [A-Za-z0-9_] ile başlayıp [A-Za-z0-9_.-] ile süren en fazla 255 baytlık tek bileşen değilse dizinde aranmaz; yol ayıracı, .., gizli dosya adı ve ASCII dışı ad dosya yolu kuramaz.

ZORUNLU: Credential dosyası nofollow ve nonblocking açılır; açılan descriptor gerçek düzenli dosya, tek hard-link, sahibi etkin kullanıcı ya da root olmalı, grupça yazılabilir veya herkesçe okunabilir olmamalıdır. Sembolik bağ, FIFO, dizin ve hard-link reddedilir.

ZORUNLU: Dosya 1 bayt ile çağrı sınırı arasında olur (gizli anahtar 4 KiB, SMTP/PostgreSQL/HTTP 64 KiB, PostgreSQL CA PEM 256 KiB); sınır ayırmadan önce ve okumada sınır+1 ile uygulanır. İçerik BOM'suz geçerli UTF-8'dir, NUL taşımaz; PEM dışındaki tek satır değerlerde CR/LF YASAKTIR. Kırpma yapılmaz.

YASAK: Aynı ad hem ortamda (boş değer dahil) hem credential dizininde varsa öncelik seçilmez; okuma reddedilir.

ZORUNLU: Ret iletisi yalnız değişken adı ve sabit neden taşır; değer, dosya yolu ve dizin adı tanıya, stderr'e veya HTTP/SMTP sonucuna girmez. HTTP ve SMTP sonuç maskeleri aynen korunur; IO iz kaydı gizli değer okumasını kaynaktan bağımsız olarak reddetmeyi sürdürür.

TANIMLI: Unix dışı platformda CREDENTIALS_DIRECTORY ayarlıysa gizli değer okuması "bu platformda desteklenmez" ile reddedilir; ayarlı değilse ortam davranışı sürer.

AÇIK: Gerçek systemd servis kurulumu ile canlı kabul, çalışan süreçte rotasyon, ACL incelemesi, aynı UID/root saldırganına karşı yalıtım ve okunan değerin süreç belleğinden garantili silinmesi bu kaynağın sözü değildir.

Kaynak: spec/23-yetkinlik-ve-outbound-guvenligi.md · Bütün belgeler