Biztonsági HTTP-fejlécek: CSP és HSTS bevezetése leállás nélkül
A biztonsági HTTP-fejlécek rövid utasítások, amelyeket a szerver az oldallal együtt küld a böngészőnek. Meghatározzák például, honnan tölthet be szkripteket az oldal, beágyazhatja-e egy idegen webhely keretbe, vagy hogy a webhely csak HTTPS-en keresztül nyitható-e meg. Az OWASP szerint segítenek megelőzni az olyan sebezhetőségeket, mint a cross-site scripting (XSS), a clickjacking vagy az információszivárgás (OWASP).
Ha egy biztonsági szkennelés, audit vagy ügyfélkérdőív kifogásolta a hiányukat, pótolja őket – de ne egyszerre és ne vakon. Röviden: az egyszerű fejléceket tesztelés után azonnal vezesse be, a Content-Security-Policyt (CSP) először Report-Only módban, amely a szabálysértéseket csak jelenti, a HSTS-t fokozatosan növelt érvényességgel kapcsolja be, a HSTS preload listáról pedig csak a végén döntsön, mert nehezen vonható vissza.
Mely biztonsági fejléceket érdemes beállítani
Nem minden fejléc, amelyet a szkenner említ, egyformán fontos, és néhányat már nem ajánlanak. A táblázat összefoglalja az MDN és az OWASP ajánlásait egy átlagos céges weboldalhoz vagy webáruházhoz.
| Fejléc | Mire szolgál | Ajánlás |
|---|---|---|
Content-Security-Policy |
Meghatározza, honnan tölthet be erőforrásokat az oldal, főleg JavaScriptet; elsősorban az XSS elleni védelmet szolgálja (MDN: CSP). | Fokozatosan bevezetni, először Report-Only módban. |
Strict-Transport-Security |
A böngésző meghatározott számú másodpercig megjegyzi, hogy a webhelyet csak HTTPS-en keresztül nyithatja meg (MDN: HSTS). | Az aldomainek ellenőrzése után bekapcsolni, fokozatosan növelt max-age értékkel. |
X-Content-Type-Options |
A nosniff érték megtiltja a böngészőnek, hogy kitalálja a tartalom típusát (OWASP). | Az első szakaszban beállítani, helyes Content-Type fejléccel együtt. |
Referrer-Policy |
Meghatározza, mennyi információ távozik a kiinduló oldalról a kérésekkel a Referer fejlécben (OWASP). | Kifejezetten strict-origin-when-cross-origin értékre állítani. |
frame-ancestors, X-Frame-Options |
Meghatározzák, hogy beágyazható-e az oldal keretbe, és ki ágyazhatja be, így védenek a clickjacking ellen (MDN: CSP). | Elsősorban a CSP frame-ancestors direktívája, az X-Frame-Options kiegészítésként. |
Permissions-Policy |
Meghatározza, mely böngészőfunkciókat, például kamerát, mikrofont vagy helymeghatározást használhat az oldal és a beágyazott keretek (OWASP). | Kikapcsolni azokat a funkciókat, amelyeket a webhely nem használ. |
X-XSS-Protection, Expect-CT, Public-Key-Pins |
Fejlécek, amelyeket az OWASP nem ajánl; az X-XSS-Protection bizonyos esetekben akár XSS-sebezhetőséget is létrehozhat (OWASP). | Az X-XSS-Protectiont nem beállítani vagy 0 értékkel kikapcsolni, a többit eltávolítani. |
Az OWASP az X-Powered-By fejléc eltávolítását is javasolja, mert elárulja a használt technológiákat (OWASP). A legtöbb figyelmet azonban két fejléc igényli, amelyek óvatlan bevezetés esetén működésképtelenné tehetik a webhelyet: a CSP és a HSTS.
Szemléltető példa: webáruház analitikával, csevegéssel és fizetéssel
Kitalált cég szemléltetésként: egy kisebb gyártó WordPressre és WooCommerce-re épülő webáruházon keresztül értékesít. Egy nagykereskedelmi vevő biztonsági kérdőívet küldött neki, a mellékelt szkennelés pedig hiányzó CSP-t és HSTS-t jelzett. A webhelyen analitika, külső szolgáltató csevegője, üzletkereső térkép és fizetési kapu fut. A webáruház a fő domainen működik, egyik aldomainjén pedig egy régebbi raktárkezelő felület fut, amely csak HTTP-n keresztül érhető el.
Egy útmutatóból bemásolt szigorú CSP blokkolná azokat a szkripteket, amelyekkel a szabályzat nem számol, és a csevegés vagy a mérés leállna. Az includeSubDomains direktívát tartalmazó HSTS minden aldomainre érvényes, így a webáruházat már meglátogató böngészők a raktárkezelő felületet is HTTPS-en keresztül kezdenék megnyitni, amelyet az nem támogat (MDN: HSTS). Az észszerű folyamat ezért leltárral kezdődik, nem konfigurációval.
Bevezetés lépésről lépésre
1. Leltár: mit tölt be a webhely, és hol állítják be a fejléceket
Írja össze az összes külső szolgáltatást: analitikát, marketingszkripteket, csevegést, térképeket, videókat, betűtípusokat, fizetési kaput és űrlapvédelmet. Nézze át az összes oldaltípust, beleértve a kosarat, a pénztárt, az ügyfélfiókot és az adminisztrációt; az online eszközök általában csak a megadott cím kezdőlapját tesztelik (OWASP).
Derítse ki azt is, hol állítják be ma a fejléceket: a tárhelyen, a CDN-ben, egy bővítményben vagy a sablonban. Ha valamelyikhez nincs hozzáférése, először azt szerezze meg; ebben segít a domain, a fiókok és a hozzáférések átvételéről szóló cikk.
2. Először az egyszerű fejléceket vezesse be
Kezdje az egyértelmű értékű fejlécekkel, de ezeket is tesztelje: a nosniff helyes Content-Type-ot feltételez, a Permissions-Policy pedig nem kapcsolhat ki olyan funkciót, amelyet a webhely használ, például a helymeghatározást a legközelebbi üzlet kereséséhez.
X-Content-Type-Options: nosniff
Referrer-Policy: strict-origin-when-cross-origin
Permissions-Policy: geolocation=(), camera=(), microphone=()
A modern böngészők alapértelmezés szerint a strict-origin-when-cross-origin értéket használják, az OWASP mégis azt javasolja, hogy az értéket kifejezetten állítsa be (OWASP).
3. A keretek elleni védelmet külön kényszerítse ki
A CSP részenként is bevezethető: a clickjacking elleni védelmet a szkriptek korlátozása nélkül is hozzáadhatja (MDN: CSP). Ha a webhelyet nem szabad más oldalakba beágyazni, az MDN a frame-ancestors 'none' beállítást javasolja; ha a rendszer saját oldalait keretben jeleníti meg, például előnézetként az adminisztrációban, használja a 'self' értéket. Az OWASP azt javasolja, hogy ahol lehet, a frame-ancestors élvezzen elsőbbséget, az MDN pedig az X-Frame-Options rugalmasabb helyettesítőjeként írja le (OWASP, MDN: CSP).
4. A CSP-t először Report-Only módban indítsa
A Content-Security-Policy-Report-Only fejléc a szabályzat megsértéseit és azok hatásait figyeli anélkül, hogy kikényszerítené a szabályzatot, így a hibákat az éles bevezetés előtt kijavíthatja (MDN: Report-Only). Ahhoz, hogy a jelentések eljussanak valahova, a szabályzatnak célra van szüksége: az MDN a report-to direktívát említi, amelynek címét a Reporting-Endpoints fejléc határozza meg. A régebbi report-uri direktívát elavultnak jelöli, a példájában mégis mindkettőt megadja, mert a report-to még nem rendelkezik teljes támogatással minden böngészőben.
Ha a válasz a Content-Security-Policy és a Content-Security-Policy-Report-Only fejlécet is tartalmazza, a böngésző mindkettőt figyelembe veszi: az elsőt kikényszeríti, a második csak jelent (MDN: CSP). Így a keretek elleni védelmet azonnal kikényszeríti, a szkripteket pedig egyelőre csak figyeli:
Reporting-Endpoints: csp-endpoint="https://example.com/csp-reports"
Content-Security-Policy: frame-ancestors 'self'
Content-Security-Policy-Report-Only: script-src 'nonce-{NONCE}' 'strict-dynamic'; object-src 'none'; base-uri 'none'; report-uri https://example.com/csp-reports; report-to csp-endpoint
A {NONCE} helyőrző egy véletlenszerű értéket jelöl, amelyet a szerver minden válaszhoz létrehoz. A Report-Only nem adható meg <meta> elemmel, a fejlécet a szervernek kell küldenie (MDN: Report-Only). Tárolja a jelentéseket, határozza meg, ki olvassa őket, és hagyja futni a módot, amíg le nem fedi az összes oldaltípust és a szokásos helyzeteket, például egy kampányt.
5. A jelentésekből készítse el a kikényszerített szabályzatot
Minden szabálysértésnél döntsön: a legitim szolgáltatást engedélyezze, az ismeretlen forrást vizsgálja meg, a felesleges szkriptet pedig távolítsa el. Az MDN az úgynevezett strict CSP-t javasolja, amely nonce-okon vagy hasheken alapul, mert az engedélyezett domainek listáit nehéz karbantartani, különösen az Ön által nem ellenőrzött szkriptek esetén (MDN: CSP).
A nonce-nak minden válasznál eltérőnek és kiszámíthatatlannak kell lennie, ezért a szerver nem küldhet statikus HTML-t (MDN: CSP). Ha a webhely teljes oldalas gyorsítótárat használ, ezt már a tervezéskor oldja meg, különben a tárolt oldal ugyanazt a nonce-t ismételné. Ha egy harmadik féltől származó szkript további szkripteket tölt be, a strict CSP blokkolja őket; a 'strict-dynamic' kulcsszó a nonce-szal ellátott szkriptbe vetett bizalmat átviszi az általa betöltött szkriptekre.
Kerülje az 'unsafe-inline' használatát, amely az MDN szerint a CSP értelmének nagy részét semmissé teszi (MDN: CSP). Amikor a jelentések már nem mutatnak megmagyarázatlan szabálysértést, állítsa át a szabályzatot Content-Security-Policy fejlécre, a report-to direktívát pedig hagyja meg.
6. A HSTS-t szakaszosan kapcsolja be
A HSTS-fejlécet a szervernek csak HTTPS-en keresztül szabad küldenie; ha HTTP-n érkezik, a böngészők figyelmen kívül hagyják. A HTTP-kéréseket a szervernek tartósan át kell irányítania HTTPS-re, például 301-es kóddal (MDN: HSTS). Bekapcsolás előtt ellenőrizze, hogy HTTPS-en keresztül minden aldomain működik, beleértve a nyilvánosan el nem érhető belső aldomaineket is. Ezután a hstspreload.org ajánlása szerint növelje a max-age értékét szakaszosan – 5 perc, egy hét, egy hónap (hstspreload.org):
Strict-Transport-Security: max-age=300; includeSubDomains
Strict-Transport-Security: max-age=604800; includeSubDomains
Strict-Transport-Security: max-age=2592000; includeSubDomains
Minden szakaszban figyelje a hibás oldalakat és a mutatókat, például a látogatottságot és a bevételt, javítsa ki a problémákat, és a következő lépés előtt várja ki az adott szakasz teljes max-age idejét. Ezután az érvényességet meghosszabbíthatja például egy évre (31536000 másodperc), ami egyben a preload minimuma. Hibás konfiguráció vagy tanúsítványprobléma esetén azonban előfordulhat, hogy a látogatók a HSTS érvényességének lejártáig nem érik el a webhelyet (OWASP). A tanúsítványok megbízható automatikus megújítása ezért előfeltétel; ezzel az SSL-tanúsítványok rövidebb érvényességéről szóló cikk foglalkozik.
7. Preload csak tudatos döntés után
A HSTS preload lista közvetlenül a Chrome-ba van beépítve, és a többi nagy böngésző is erre épülő listákat használ. A felvételhez érvényes tanúsítvány, ugyanazon a hoszton belüli átirányítás HTTP-ről HTTPS-re, minden aldomainen HTTPS, valamint legalább 31536000 másodperces (1 év) max-age értékkel, includeSubDomains és preload direktívával ellátott fejléc szükséges (hstspreload.org).
A felvétel nehezen vonható vissza: az eltávolítás csak hónapok múlva jut el a Chrome felhasználóihoz, más böngészőknél pedig nem garantálható. A Chrome és a Safari ráadásul a HSTS-től függetlenül automatikusan HTTPS-re váltja a HTTP-navigációkat, a preload pedig csak akkor segít, ha ezt az átváltást egy aktív támadó meghiúsítja. A hstspreload.org a preload előnyét a HSTS-hez képest minimálisnak tartja, és nem ajánlja a preloadot (hstspreload.org). Egy átlagos céges weboldalhoz elegendő a HSTS preload nélkül.
Hol állítsa be a fejléceket
Minden fejlécnek legyen egy egyértelmű helye. Az MDN szerint a CSP-t minden válasszal el kell küldeni, nem csak a fő dokumentummal (MDN: CSP).
| Hely | Mire alkalmas | Mire figyeljen |
|---|---|---|
| Webszerver (Apache, Nginx) | Rögzített értékű fejlécek: HSTS a HTTPS-válaszokhoz, nosniff, Referrer-Policy. | Az always paraméter nélkül az Nginx csak bizonyos állapotkódoknál küldi a fejlécet, a location blokkban megadott add_header pedig elveti az eggyel magasabb szinten beállított fejléceket; Apache-ban a duplikációk ellen az unset, majd az always set segít (OWASP). |
| CDN vagy fordított proxy | Egységes szabályok több szerverhez vagy webhelyhez. | A CDN és a szerver értékei nem duplikálódhatnak és nem írhatják felül egymást; ellenőrizze a végső választ a böngészőben. |
| Alkalmazás vagy bővítmény | CSP nonce-szal, amelyet minden válaszhoz létre kell hozni és be kell illeszteni a HTML-be (MDN: CSP). | A teljes oldalas gyorsítótár nem tárolhatja a nonce-t; ha a szerver is állít be fejléceket, határozza meg, melyiket ki kezeli. |
| <meta> elem a HTML-ben | CSP egyoldalas alkalmazáshoz statikus fájlokkal, szerverinfrastruktúra nélkül (MDN: CSP). | Nem támogatja a CSP összes funkcióját, és a Report-Only mód nem működik vele. |
Kompromisszumok: védelem kontra karbantartás
Az OWASP szerint a CSP-t nem egyszerű beállítani és karbantartani (OWASP). Minden új marketingeszköz, csevegő vagy beágyazott tartalom a szabályzat módosítását jelentheti. Ezért határozza meg a folyamatot: ki hagyja jóvá az új szkriptet, ki teszteli Report-Only módban, és ki módosítja a fejlécet.
A nonce dinamikusan generált oldalaknál könnyebben karbantartható, de beavatkozást igényel a sablonokba és a gyorsítótárba. A hashek statikus tartalomhoz illenek, de minden szkriptmódosítás után újra kell számolni őket. Az engedélyezett domainek listája tűnik a legegyszerűbb kezdetnek, az MDN azonban figyelmeztet, hogy az ilyen szabályzatok gyakran akaratlanul nem biztonságos domaineket is engedélyeznek (MDN: CSP).
A HSTS egyszerű fejléc, és védelmet nyújt például az ellen, hogy egy hálózati támadó átírja a HTTP-ről HTTPS-re mutató átirányítást (hstspreload.org). Ugyanakkor a webhelyet a teljes max-age időtartamra a működő HTTPS-hez köti, így egy tanúsítványprobléma súlyosabb következményekkel jár.
Gyakori hibák
- Értékek másolása útmutatóból. Az OWASP által ajánlott HSTS-érték az includeSubDomains és a preload direktívát is tartalmazza, és az OWASP arra kér, hogy használat előtt figyelmesen olvassa el, hogyan működik a fejléc (OWASP). A preload direktívát a hstspreload.org a listára való felvétel kérelmének tekinti (hstspreload.org).
'unsafe-inline'csak a zöld szkennereredmény kedvéért. A szabályzat ugyan létezik, de védelmének nagy részét elveszíti (MDN: CSP).- Report-Only jelentési cél nélkül. A report-to, valamint az azt nem támogató böngészők számára a report-uri nélkül a jelentések sehova nem jutnak el (MDN: Report-Only).
- Gyorsítótárban tárolt nonce. Ugyanaz a nonce több válaszban megsérti azt a feltételt, hogy minden alkalommal eltérőnek és kiszámíthatatlannak kell lennie.
- Fejlécek több helyen. A szerver, a CDN és a bővítmény megduplázhatja vagy felülírhatja az értékeket; Nginxben egy location blokk csendben elvetheti a biztonsági fejléceket (OWASP).
- A HSTS kikapcsolása a fejléc eltávolításával. Ha a fejléc hiányzik, az előző a lejáratáig érvényben marad; visszavonni a
max-age=0értékkel lehet (MDN: HSTS).
Ellenőrzőlista az éles bevezetés előtt
- A külső szolgáltatások leltára minden oldaltípust lefed, és van felelőse.
- Minden fejlécet egyetlen ismert helyen állítanak be, és a végső választ ellenőrizték.
- A nosniff, a Referrer-Policy, a Permissions-Policy és a frame-ancestors tesztelve van az űrlapokon, a fizetésnél, a bejelentkezésnél és az adminisztrációban.
- A CSP Report-Only módban fut report-to és Reporting-Endpoints beállítással, és valaki rendszeresen olvassa a jelentéseket.
- A kikényszerített CSP nem használ
'unsafe-inline'értéket a szkriptekhez, és minden válaszhoz új nonce készül. - Minden aldomain, a belsőket is beleértve, működik HTTPS-en, a tanúsítványok megújítása pedig automatikus és felügyelt.
- A HSTS max-age értéke szakaszosan nő, a preload pedig tudatos döntés, nem alapértelmezés.
- Minden új, harmadik féltől származó szkript jóváhagyáson és Report-Only teszten megy át.
Gyakori kérdések
Meddig maradjon a CSP Report-Only módban?
Univerzális időtartam nincs. A jelentéseknek minden oldaltípust és a szokásos helyzeteket le kell fedniük, és a kikényszerítés előtt nem lehetnek bennük megmagyarázatlan szabálysértések. A kikényszerítés után is tesztelheti a szabályzat következő változatát párhuzamosan Report-Only módban (MDN: CSP).
Szükségem van X-Frame-Optionsre, ha van frame-ancestors?
A fő védelem a frame-ancestors legyen. Az X-Frame-Options kiegészítésként megmaradhat; az OWASP a DENY értéket ajánlja, a példájában pedig a SAMEORIGIN is szerepel (OWASP). Az értékek ne mondjanak ellent egymásnak: a frame-ancestors 'self' mellé SAMEORIGIN illik, nem DENY.
Hogyan kapcsolható ki a HSTS, ha valami elromlik?
Állítsa be a max-age=0 értéket. Csak akkor lép életbe, amikor a böngésző HTTPS-en keresztül betölti a webhelyet, és megkapja ezt a fejlécet (MDN: HSTS). Ha a domain szerepel a preload listán, az eltávolítás hónapokig tart (hstspreload.org), ezért kezdjen rövid szakaszokkal.
Azt jelenti a zöld szkennereredmény, hogy a webhely biztonságos?
Nem. Az OWASP szerint a CSP egy kiegészítő biztonsági réteg, amely segít bizonyos típusú támadások észlelésében és mérséklésében (OWASP). A fejlécek nem helyettesítik a frissítéseket, a biztonságos kódot, a biztonsági mentéseket és a hozzáférések kezelését; a webhely védelmének csak egy rétegét jelentik.
Segítség a fejlécek beállításában
Ha szükségtelen leállási kockázat nélkül szeretne biztonsági fejléceket beállítani céges weboldalán vagy webáruházában, elkészítem a leltárt, beállítom a Report-Only módot, kiértékelem a jelentéseket, és előkészítem a HSTS fokozatos bevezetését. Nézze meg, hogyan dolgozom a weboldalkészítés és az egyedi webáruházak területén, vagy írjon nekem a kapcsolati oldalon.
Források
A források ellenőrzésének dátuma: 2026. november 16.