Yayına almak13 dk okuma
Güvenlik
collage'ın request forgery'ye, open redirect'lere, path hilelerine, cache sızıntılarına ve aşırı büyük body'lere karşı yaptıkları ve size bıraktıkları.
Bir framework'teki bug, onunla kurulan her sitedeki bir bug'dır. Bu yüzden collage, her sitenin aksi hâlde hatırlaması gerekecek güvenlik işlerini kendisi yapar.
Bu sayfa, collage'ın sizin için yaptıklarını tek bir yerde toplar ve her birinin anlatıldığı yere link verir. Yapmadıkları ise sonda yer alır.
Her request collage'ın kontrolleriyle hep aynı sırayla karşılaşır ve her kontrol, kendisinden sonra gelen çalışmadan önce cevap verebilir:
Form'lar sahte olarak gönderilemez
Unsafe bir method'a sahip her action, handler'ı çalışmadan önce imzalı bir token'ı kontrol eder. {{csrfToken}} içeren bir page yine de cache'lenir: her okuyucuya kendi token'ı gönderilir.
Token tek başına kontrol edilmez. Tarayıcının başka bir origin'den geldiğini işaretlediği bir gönderim (Sec-Fetch-Site ile ya da Host'a karşı Origin ile) ne taşırsa taşısın reddedilir. Kardeş subdomain'ler de buna dahildir, bu yüzden yerleştirilmiş bir cookie içeri girmenin yolu değildir. Buraya post etmesi amaçlanan bir origin Security.CSRFTrustedOrigins'te belirtilir. Ayrıntılar için Form'lar ve action'lar sayfasına bakın.
Deploy etmeden önce Security.CSRFKey'i ayarlayın: üretilen bir key her process'te farklıdır; bu yüzden bir restart'tan sonra ya da bir load balancer'ın arkasındaki başka bir instance'ta, okuyucunun ekranında zaten açık olan her form reddedilir.
Bir token, üretildiği zamanı imzalı olarak taşır ve Security.CSRFTokenTTL'den daha eski olduğunda reddedilir. Varsayılan on iki saattir, böylece sızan bir token sonsuza kadar tekrar kullanılamaz.
Uzun süredir açık bir form'u olan bir okuyucu reddedilmek yerine yeni bir token alır. Bir token'ı imzası geçerli olduğu sürece geçerli tutmak için CSRFTokenTTL'i negatif yapın.
Bir form'daki token her response'ta yeniden maskelenir: her seferinde yeni, rastgele bir pad ile XOR'lanır ve başına ~ konur. Request'in gönderdiğini yansıtan sıkıştırılmış bir response, yansıyan metin token'ın bir kısmıyla eşleştiğinde daha kısa olur. Bir okuyucunun tarayıcısına request gönderttirebilen bir saldırgan da token'ı bu uzunluklardan okuyabilirdi (BREACH). Maskelenmiş token her seferinde farklı byte'lardır. Kontrol maskeyi hem form'dan hem header'dan gelen değerden kaldırır ve maskelenmemiş bir token'ı da kabul eder.
Üretilemeyen bir token, page'i form'unda token'ın placeholder'ıyla sunmak yerine response'u 500 ile başarısız kılar.
GET ve HEAD tasarım gereği token taşımaz; bu yüzden yalnızca bunlara cevap veren bir action, herhangi bir sitenin bir okuyucunun tarayıcısına bir link ya da bir <img> ile tetikletebileceği bir değişikliktir. Böyle bir action'ı register etmek development'ta bir uyarı log'lar ve HEAD bir GET action'ına düşmez: action onu bildirmedikçe 405'tir. Bkz. Form'lar ve action'lar.
Redirect'ler sitede kalır
collage'ın yazdığı hiçbir redirect, okuyucuyu başka bir siteye gönderemez:
/a/./bya da/a//b'yi temiz yazımına gönderen redirect, path'i escape ederek yazar. Böylece/./%5Cevil.com,/\evil.com'a değil/%5Cevil.com'a gider. Tarayıcı/\evil.com'u//evil.comolarak okur.- Locale ve trailing slash redirect'leri hiçbir zaman
//ile başlamaz. //hostya da/\host'a giden register edilmiş bir redirect, register sırasında reddedilir. Yakaladığı bir değer de düştüğü yere göre escape edilir: path'te ya da tek bir query değeri olarak. Böylece/login?next={slug}'a ikinci birnextverilemez.
Bir action'ın Location'ı ve bir guard'ınki sizindir: collage onları sizin ayarladığınız gibi yazar. Bu yüzden request'ten, kontrol etmeden bir Location oluşturmayın. Bazıları siteden çıkmak zorundadır (bir giriş sağlayıcısının sayfası), collage'ın onları kontrol etmemesinin sebebi budur.
URL'den alınan bir next için collage kendi kontrolünü sunar:
loc := collage.SafeRedirect(rc.Request.URL.Query().Get("next"), "/")
SafeRedirect, next bu sitede bir path ise onu döndürür: / ile başlar, // ile başlamaz, ters bölü ve kontrol karakteri içermez, temizlendikten sonra da tek bir / ile başlar. Değilse fallback'i döndürür (fallback da path değilse /).
Temizleme önemlidir çünkü http.Redirect köklü bir path'i temizler: /./\evil.example, /\evil.example olarak çıkar ve tarayıcı bunu //evil.example diye okur. Mutlak bir URL, bu sitenin kendi origin'indeki bile olsa hiçbir zaman kabul edilmez.
Bir path tek bir anlama gelir
Middleware decode edilmiş r.URL.Path'i okur, router ise escape edilmiş olanı. İkisi arasında bir fark çıkabilecek her yerde request hiçbir yere ulaşmaz:
- Dot segment'ler ya da çift slash içeren bir path, middleware çalışmadan önce temiz yazımına redirect edilir. Böylece
/admin/üzerindeki bir kontrol/x/../adminile hiç karşılaşmaz. - Encode edilmiş bir slash (
%2F) içeren bir path 404 döner.%2Fbir ayırıcı değildir, ama middleware decode edilmiş path'i okur ve orada/public%2Fsecret,/public/secret'tir: middleware için iki segment, router için tek segment. - Bozuk bir escape 500 değil 400 döner.
- Bir action'ın ya da document'ın sondaki slash'li diğer yazımı, tek yazımına redirect edilir (action için 308, document için 301; page'de olduğu gibi) ve hiçbir zaman sunulmaz. Redirect middleware'inizden sonra gelir; middleware path'i geldiği gibi görür. Bu yüzden tam bir path üzerindeki kontrolde canonical path'i karşılaştırın (ya da slash'i kesin), yoksa
POST /admin/delete/yazmadığınız bir path olarak değerlendirilir./admin/gibi bir prefix'te böyle bir açık yoktur. Bkz. Middleware ve kendi API'niz.
Bu retler görünmez değildir. Tarayıcı bot'unun path'i yerine sınırlı bir etiket altında, diğer her request gibi süreleri ölçülür, trace edilir ve sayılır: collage.RouteInfo tür olarak "rejected", ad olarak "normalise" bildirir; Metrics.HTTPResponse ve request span'i path almaz. Bir dashboard ya da bir ban plugin'i, yoklama başına bir time series oluşmadan yoklamayı görür.
Ayrıntılar için Path'ler önce temizlenir bölümüne bakın.
Private page'ler private kalır
Bir guard, page'in render'ları, URL'sindeki action'lar ve fragment path'leri için cache okunmadan önce çalışır.
Guard'lı bir page private, no-cache ile, bir guard'ın kendi cevabı ise no-store ile gider. Böylece bir CDN, bir okuyucunun page'ini ya da aldığı reddi hiçbir zaman sonrakine vermez. Static export guard'lı page'leri hiç yazmaz.
Bir plugin'in bir stream üzerinden gönderdiği fragment da aynı kurala tabidir: fragment'in kendi URL'sine gelen bir request olarak render edilir. Bu request o path için sizin ve plugin'lerin middleware'inden, ardından o URL'nin parametrelerini (stream'inkileri asla) okuyan guard'lardan geçer. /admin/ üzerindeki bir basicauth, /admin/stats'ı bir live stream'in dışında tutar; middleware'in ya da bir guard'ın artık reddettiği bir okuyucuya hiçbir şey gönderilmez.
Plugin'ler HTTP'nin ulaştığı yere ulaşır
Bir plugin güvenilen koddur, ama Host'u dokümantasyonunun verdiği sözleri tutar:
- Gönderilen bir fragment bir request'tir.
RenderFragmentmiddleware'i, guard'ları ve herPersonaliseHook'u (bir CSP nonce'u, bir honeypot marker'ı) çalıştırır ve çağıranın context değerlerinden hiçbirini taşımaz.Sharedbir render her değişiklikte bir kez yapılır ve yalnızca middleware'i ve guard'ları kabul eden okuyuculara verilir. - Yapılandırma
Configureile biter. Saklanan birConfigHostsonradan template fonksiyonu eklemez ve mount wrap etmez (ErrConfigureClosed); geç gelen bir render fonksiyonu process'i çökertirdi. - Bir plugin template dilinin bir adını alamaz.
html,js,urlquery,eqve diğerleri reddedilir; böylece hiçbir plugin'inhtml'i html/template'in escaping'inin yerine geçmez. UygulamanınConfig.Template.Funcs'ı da her plugin'in fonksiyonuna karşı kazanır. - Bir host yalnızca kendi plugin'inin config'ini taşır,
Host.Pagesde bir page'in tuttuğu her container'ın kopyasını verir. Böylece bir plugin başka birinin bölümünü okuyamaz ya da kopyası üzerinden cache key'ini değiştiremez. - Bir plugin'in
Host.Handlebody'si, bir page'inki gibi, middleware'den önceServer.MaxBodyBytesile sınırlanır. - Her
OnCacheInvalidateçalışır, böylece başarısız olan tek bir plugin bir CDN purge'ünü engellemez.PersonaliseEvent.Personalkalıcıdır: bir hook onu bir kez ayarladıysa nonce'lu bir body hiçbir zaman public olarak ya da bir 304 ile cevaplanmaz. - Komut adları tek bir shell kelimesidir ve hiçbiri dispatcher'ın ya da bir plugin için
collagebinary'sinin kendi adı değildir.
Ayrıntılar için Plugin yazmak sayfasına bakın.
Cache'lenmiş bir page kimseye özel değildir
Cache'te saklanan bir render, request'i aynı key'e sahip her okuyucuya sunulur. Bu yüzden render'a yalnızca key'in içerdikleri verilir:
- path ve host;
- key'deki query parametreleri;
collage.Varyile bildirilen header'lar.
Bir okuyucunun cookie'leri, credential'ları ya da adresi hiçbir zaman verilmez. Host key'de yer aldığı için başka bir host adı veren bir request, diğer herkesin aldığı kopyayı zehirleyemez. Host normalleştirilir (küçük harf, port yok, sondaki nokta yok); böylece EXAMPLE.com:8080 ve example.com tek bir entry'yi paylaşır ve Host'un yazımını değiştiren bir client, herkesin okuduğu page'leri sınırlı bir cache'ten dışarı itemez. Cacheable bir page mutlak URL'leri artık görmediği r.Host'taki porttan değil, collage.BaseURL(rc)'den kurar.
Degraded bir render, bir error page ve development'taki bir page hiçbir zaman public olarak cache'lenemez. Cache header'ları yazıldığında bir Set-Cookie taşıyan response de öyledir (bir middleware'in koyduğu bir session yenilemesi gibi): Cache-Control: private, no-store ile gider, böylece bir CDN bir okuyucunun cookie'sini sonrakine oynatamaz. Page yine de sunucuda cache'lenir. Aynı URL için TLS üzerinden gelen request ile düz request ayrı entry'lerdir. Ayrıntılar için Paylaşılan bir render neyi görür bölümüne bakın.
Body'ler sınırlıdır
Bir request body'si, middleware'iniz çalışmadan önce, yönlendirildiği action'ın limitiyle sınırlanır. Aksini söylemediğiniz sürece bu limit 4 MiB'tır. Middleware yokken de böyledir, yani bir page'in ya da action'ın guard'ı body'yi sınırlı olarak okur. Daha büyük olduğunu söyleyen bir body, handler çalışmadan önce reddedilir. net/http'nin kendi 10 MB'ını aşan urlencoded bir form, limit ne kadar yüksek olursa olsun 403 değil 413 döner.
Diske taşan multipart dosyalar, form'u kim parse etmiş olursa olsun request cevaplandığında silinir. Forgery kontrolünün hiç imzalamadığı bir cookie ise body daha hiç okunmadan reddedilir. Ayrıntılar için Request body'leri sınırlıdır bölümüne bakın.
Bir dosya, uzantısının söylediği şeydir
Bir asset mount, bir dosyanın tipini uzantısına göre belirler. Adı bir tip belirtmeyen dosyanın tipi içeriğinden çıkarılır; böylece uzantısız yüklenen bir görsel yine görsel olarak gider.
Ama hiçbir zaman çalıştırılabilen bir tipe dönüşmez: HTML ya da XML'e benzeyen bir dosya text/plain olur ve nosniff sayesinde tarayıcı buna uyar. Böylece markup içeren uzantısız bir upload bir page olarak sunulmaz.
Uzantısı olan bir dosya ise bilerek uzantısının söylediği gibi sunulur: static bir sitenin .html ve .svg dosyaları page ve görseldir. Bu yüzden ziyaretçilerinizin yüklediği dosyaların klasörünü hiçbir zaman düz bir Mount ile mount etmeyin: oradaki bir .html ya da .svg, script'ini sizin siteniz olarak çalıştırır. Onu collage.WithAttachments() ile mount edin: .html, .xhtml, .svg ve .xml dosyaları o zaman Content-Disposition: attachment ile gönderilir, tarayıcı da onları çalıştırmak yerine kaydeder. Ya da sakladığınız uzantıları kendiniz denetleyin. elagoht/uploads her dosyayı içeriğine göre kontrol eder ve bunu yapamayacağı şekilde sunar.
Mount hiçbir zaman bir dizini listelemez; .well-known dışında bir dotfile'ı (.env, .git/) hiçbir zaman sunmaz ya da export etmez. collage serve de aynısını yapar.
Hatalar production'da hiçbir şey söylemez
Production'da collage'ın kendi error page'i status'tan başka bir şey göstermez: hata metni yok, stack yok, path yok.
Development overlay'i ve reload kanalı yalnızca development'ta vardır. collage dev de yalnızca bu makineyi adlandıran bir Host'a cevap verir. Bu yüzden başka bir sitedeki bir page, DNS rebinding yoluyla onları okuyamaz.
Bir log satırındaki request path'i kontrol karakteri içerdiğinde tırnak içine alınır. Böylece sahte bir satır oluşturamaz ya da terminalinizi yeniden yazamaz.
Security header'ları
Her response varsayılan olarak X-Content-Type-Options: nosniff ve X-Frame-Options: SAMEORIGIN taşır. Böylece bir site, hiçbir şey eklemeden form'larında MIME-sniff ve clickjacking korumasına sahip olur.
Security.FrameOptions değeri belirler: "-" hiçbirini göndermez, başka her şey olduğu gibi gönderilir. Security.DisableNoSniff ise nosniff'i kapatır.
Tam bir Content-Security-Policy, HSTS ve geri kalanını elagoht/secure plugin'i ekler ve onun header'ları bunların yerine geçer. Production'daki bir page hiçbir framework script'i taşımadığı için sıkı bir policy nonce gerektirmez.
Size kalanlar
Güvenlik düzeltmelerini içeren bir Go toolchain'i. Bir program, derlendiği standart kütüphaneyi içinde taşır. collage Go 1.26.11 ister. Böylece varsayılan
GOTOOLCHAIN=autoile go komutu, daha eski bir Go ile yapılacak bir derleme için bu sürümü kendisi indirir. Bir binary'yigo version -mile kontrol edin. Go 1.26.11,http.MaxBytesReader'daki, bir HTTP/1 sunucusunu çökertebilen ve collage'ın body limitinin üzerine kurulu olduğu bir race'i düzeltir (GO-2026-6859); Go 1.26.10 ele geçirilmiş eMudhra ara sertifikalarını reddetti (CVE-2026-111943).TLS,
X-Forwarded-Proto'yu ve tarayıcınınHost'unu ileten bir proxy'de. Ayrıntılar için Deployment sayfasına bakın.Server.TrustedProxies'i ayarlayın: o olmadanX-Forwarded-Protoherkesten kabul edilir ve sunucuya doğrudan ulaşan bir client sahip olmadığı TLS bağlantısını iddia edebilir.Kendi redirect'lerinizin nereye gittiği. Bir action'ın ya da bir guard'ın
Location'ı sizin ayarladığınız gibi yazılır; URL'den gelen birnext'icollage.SafeRedirectile kontrol edin.Neyi mount ettiğiniz. Düz bir
Mount,.htmlve.svgdosyalarını oldukları gibi sunar; güvenilmeyen upload'ları ondan uzak tutun (bkz. yukarısı).Rate limit'ler: elagoht/ratelimit. O ve elagoht/fail2ban varsayılan olarak bir IPv6 istemcisini
/64'ü olarak sayar; bir/48sahibinin bunlardan 65536 tane vardır. Karşınızdaki böyle istemcilerseipv6Prefix'i48yapın.Girişten önceki giriş durumu.elagoht/oauth bekleyen bir girişi kendine ait kısa ömürlü
collage_oauthcookie'sinde tutar ve session'ı yalnızca başarılı bir callback'te başlatır; böylece login route'una anonim bir ziyaret page cache'i kapatan bir session dağıtmaz.app.Handleile mount edilmiş bir handler tamamen sizindir: forgery kontrolü, body limiti ve cache yoktur, middleware de yoktur.collage.WithMiddleware()ile mount edilmedikçe hiçbir plugin'in authentication'ı, rate limit'i, ban'ı ya da access log'u onu kapsamaz. Ayrıntılar için İstemedikçe middleware yok bölümüne bakın.Bir data handler'ın okudukları. Cache'lenebilir bir page'de, middleware'in request context'ine koyduğu bir değer paylaşılan render'dan gizlenir, böylece bir okuyucunun değeri başka bir okuyucunun page'ine ulaşamaz. Bu değeri
collage.Varyile bildirin vecollage.Variedile okuyun.Layout'taki
{{hoist}}area adları.{{hoist "head"}}harf, rakam,_ve-içeren bir ad alır, başka her şeyi reddeder; böylece{{hoist .Area}}markup'a çevrilemez. Yine de area'yı literal olarak yazın.
Düzeltmeler ve bildirim
pkg/collage ve pkg/collagetest v1.0.0'dan itibaren semantic versioning izler. Bir güvenlik düzeltmesi, en son v1 minor'ının patch release'i olarak çıkar ve CHANGELOG kaydı, Security başlığı altında, nelerin etkilendiğini söyler. Eski bir minor'a backport yapılmaz; bu yüzden düzeltmeyi almanın yolu, hiçbir uygulamayı bozmayan en son v1 release'ine yükseltmektir.
Bir güvenlik açığını bildirmek için GitHub'ın private reporting özelliğini kullanın: collage repository'sininSecurity sekmesindeki Report a vulnerability düğmesi. Public bir issue, pull request ya da discussion açmayın. Hangi sürümü test ettiğinizi, bir saldırganın ne yapabildiğini ve bunu gösteren en küçük request'i ya da programı yazın. app.Handle ile mount edilmiş bir handler sizindir; bu yüzden onun yaptığı bir collage açığı sayılmaz. Bir request'in ona ulaşmaması gerekirken ulaşabilmesi ise sayılır.
Örnek: bir ekibin iş listesi, yayına girmeden önce
Middleware ve kendi API'niz ile Form'lar ve action'lar sayfalarındaki ekip iş listesi yayına girmek üzere:
- her üye giriş yapar ve bir rolü vardır: bir admin ekibin her görevini, bir üye ise yalnızca kendisine atanmış görevleri değiştirebilir;
- ekibin listesi
/teams/{team}/tasks'teki bir page'dir ve bir "görev ekle" form'u taşır; - ekibin komut satırı aracı için bir JSON API
app.Handleile,WithMiddleware()kullanılarak mount edilmiştir.
Aşağıdaki her riski ya collage, ya uygulamanın eklediği bir plugin ya da uygulamanın kendisi karşılar:
| Risk | collage, built-in | Plugin | Hâlâ uygulamanın işi |
|---|---|---|---|
| Başka bir site "görev ekle" form'unu post eder | Unsafe method'lu her action'da önce origin, sonra token | — | Form'da {{csrfToken}}; ayarlanmış bir Security.CSRFKey |
| Kimin giriş yaptığı | — | elagoht/session: imzalı, HttpOnly, SameSite=Lax bir cookie; Encrypt ile şifreli | Giriş action'ı; okuyucu giriş yaptığında Regenerate |
| Giriş yapmamış bir okuyucu listede | Guard'lar cache'ten önce çalışır: page, action'ları ve fragment path'leri için | Guard olarak session.RequireUser("/login") | Guard'lı layout'u her private page'e koymak |
| Bir üyenin başka bir üyenin ya da başka bir ekibin görevini değiştirmesi | — | — | Rol ve ekip kontrolü, verinin olduğu yerde: requireRole gibi bir guard, ayrıca action ve API |
Girişten sonraki next okuyucuyu siteden çıkarır | collage.SafeRedirect | RequireUser, next'i URL'ye koyar | next'i SafeRedirect'ten geçirmek |
/x/../admin'in bir path kontrolünü atlatması | Path middleware'den önce temizlenir | — | — |
| Bir üyenin page'inin başka birine sunulması | Guard'lı bir page private, no-cache'tir; cache key'i cookie içermez | elagoht/session: session'ı olan bir request taze render edilir, private, no-store | — |
| Çok büyük bir upload | Varsayılan olarak action başına 4 MiB; WithMaxBodyBytes | — | API'nin kendi sınırı: http.MaxBytesReader |
/login'de şifre tahmini | — | elagoht/ratelimit: bir /login kuralı | Bir proxy arkasında Server.TrustedProxies; bucket'lar process başınadır |
| Bir form'u dolduran bot'lar | — | elagoht/honeypot: {{honeypot}}, forgery kontrolünden sonra, handler'dan önce kontrol edilir | elagoht/ratelimit ile birlikte kullanmak |
| Enjekte edilen script'ler, framing, düz HTTP | nosniff; X-Frame-Options: SAMEORIGIN | elagoht/secure: nonce'lu bir CSP, HSTS | Policy'nin kendisi; proxy'de TLS |
| Bir veritabanı adresini gösteren bir hata | Production error page'i yalnızca status'u gösterir | — | API'nin kendi yazdığı hata metni |
| Çalınmış bir session cookie'si | — | elagoht/session: bir session iptal edilemez, cookie'de yaşar | Kısa bir maxAge ya da idleTimeout |
Plugin'ler Config.Plugins'e girer: elagoht/secure ve elagoht/honeypot template fonksiyonları ekler ({{cspNonce}}, {{honeypot}}). Bir plugin'in key'i hiçbir zaman plugins-config.json'dan değil, bir ortam değişkeninden okunur: SESSION_KEY, SECURE_KEY, HONEYPOT_KEY ya da KeyEnv'inin adını verdiği başka bir değişken:
app, err := collage.New(&collage.Config{
Server: collage.ServerConfig{
// The proxy that ends TLS, so ClientIP and IsHTTPS believe it.
TrustedProxies: []string{"10.0.1.10"},
},
Security: collage.SecurityConfig{
CSRFKey: []byte(os.Getenv("COLLAGE_CSRF_KEY")),
},
Plugins: []collage.Plugin{
session.New(session.Options{Encrypt: true}),
secure.New(secure.Options{
CSP: "default-src 'self'; script-src 'self' 'nonce-{nonce}'",
}),
ratelimit.New(ratelimit.Options{Rules: []ratelimit.Rule{
{PathPrefix: "/login", Rate: 0.1, Burst: 5},
{Rate: 0.5, Burst: 10},
}}),
honeypot.New(honeypot.Options{}),
},
})
İkinci kuralın ne path'i ne de method'u vardır. Bu yüzden kendi skip listesi dışındaki her yerde GET, HEAD ve OPTIONS dışındaki her method'u sayar. API'nin PATCH'i de buna dahildir, çünkü API WithMiddleware() ile mount edilmiştir. Düz bir app.Handle mount'unda hiçbir middleware çalışmaz. Bu yüzden ne bu rate limit ne de başka bir plugin'in middleware'i onu kapsardı.
Roller uygulamanın işi olarak kalır. Yalnızca admin'leri geçiren guard, Örnek: private bir bölümü olan bir blog bölümündeki requireRole'dür. API ise ekibi ve atanan kişiyi kendisi kontrol eder; Olduğu gibi mount edilen API bölümü bunu gösterir. collage kimin neyi değiştirebileceği hakkında hiçbir şey söylemez.