← Cloudflare Rules / rules / transform
Response Header Transform Rules
Pomocí Response Header Transform Rules můžete upravovat hlavičky HTTP odpovědí odesílaných návštěvníkům webu.
flowchart LR
accTitle: Header modifications diagram
accDescr: Header transform rules can change the headers sent to your origin server (request header modifications) or sent your your website visitors (response header modifications).
A[Visitor]
B((Cloudflare))
C[(Origin server)]
A -.-> B -. "Includes request<br> header modifications" .-> C
C -.-> B == "Includes response<br> header modifications" ==> A
style A stroke-width: 2px
style B stroke: orange,fill: orange,color: black
linkStyle 0,1,2 stroke-width: 1px
linkStyle 3 stroke-width: 3px
Chcete-li upravit HTTP hlavičky v požadavek odesílané vašemu origin serveru, viz Request Header Transform Rules.
Pomocí Response Header Transform Rules můžete:
- Nastavte hodnotu hlavičky odpovědi HTTP na doslovnou textovou hodnotu, čímž přepíšete její předchozí hodnotu nebo přidáte novou hlavičku odpovědi, pokud ještě neexistuje.
- Nastavte hodnotu hlavičky odpovědi HTTP podle výrazu, čímž přepíšete její předchozí hodnotu nebo přidáte novou hlavičku odpovědi, pokud ještě neexistuje.
- Přidejte novou hlavičku odpovědi HTTP s doslovnou textovou hodnotou, aniž byste odstranili existující hlavičky se stejným názvem.
- Přidejte novou hlavičku odpovědi HTTP podle výrazu, aniž byste odstranili existující hlavičky se stejným názvem.
- Odebere hlavičku HTTP z odpovědi.
Pravidlo pro transformaci hlavičky odpovědi můžete vytvořit v dashboardu, přes API, nebo pomocí Terraformu.
Pro složitější úpravy hlaviček odpovědi zvažte použití Snippets.
Důležité upozornění
-
Hodnoty hlaviček odpovědi se počítají z hodnot polí odpovídajícího požadavku HTTP. Například pole
ip.src.country(použité ve výrazech) vrátí zemi návštěvníka webu, nikoli zemi origin serveru, ze kterého byla odpověď odeslána. -
Nemůžete přidávat, upravovat ani odebírat hlavičky HTTP odpovědi, jejichž název začíná na
cf-nebox-cf-. -
Hodnotu některých hlaviček nelze upravit, například
server,eh-cache-tag, neboeh-cdn-cache-control. -
V současné době nelze odkazovat na seznamy IP adres ve výrazech Response Header Transform Rules.
-
Operace odstranění hlavičky HTTP odpovědi odstraní všechny hlavičky odpovědi se zadaným názvem.
-
Pokud změníte hodnotu existující HTTP hlavičky odpovědi pomocí výrazu, který se vyhodnotí jako prázdný řetězec (
"") nebo nedefinovanou hodnotu, HTTP hlavička odpovědi je odebráno. -
V současné době existuje omezený počet hlaviček HTTP odpovědí, které nelze změnit. Cloudflare může u některých z těchto hlaviček omezení zrušit, pokud se objeví platné případy použití. Vytvořte příspěvek v komunitě ↗ ke zvážení.
-
Pravidla pro transformaci hlaviček odpovědi se použijí i na výchozí chybové stránky Cloudflare a Vlastní chyby.
-
Úprava
cache-control,CDN-Cache-Control, neboCloudflare-CDN-Cache-Controlhlavičky pomocí response header transform rules nezmění způsob, jakým Cloudflare objekt ukládá do mezipaměti, protože Cloudflare vyhodnocuje chování mezipaměti ještě před úpravou hlaviček odpovědi. Pokud chcete ovlivnit chování mezipaměti Cloudflare, vytvořte cache rule. -
Chcete-li přidat
set-cookiehlavičku do odpovědi použijte jednu z Přidat statické/Přidat dynamické operace místo Nastavit staticky/Nastavit dynamické. Přidat operace přidají novou hlavičku, aniž by odstranily stávající hlavičky se stejným názvem, zatímco Nastavit operace nahradí všechny stávající hlavičky s daným názvem. Použitím Nastavit operace proset-cookieodstraní jakýkoliset-cookiehlavičky, které již v odpovědi jsou, včetně těch přidaných jinými produkty Cloudflare, jako je Bot Management. -
Pravidla pro transformaci hlaviček odpovědi se spouštějí v pořadí, přičemž pozdější pravidla mohou přepsat změny provedené předchozími pravidly.
-
Hodnoty polí požadavku a odpovědi jsou v rámci každého fáze, jako například
http_response_headers_transformfázi, kde jsou definována pravidla transformace hlaviček odpovědi. To znamená, že pozdější pravidla transformace hlaviček odpovědi při vyhodnocování svých filtračních výrazů stále používají původní hodnoty polí, nikoli hodnoty změněné předchozími pravidly. Viz Hodnoty polí při vyhodnocování pravidla s dalšími informacemi.
Řešení potíží
Při řešení problémů s Response Header Transform Rules použijte Cloudflare Trace zjistit, zda se pravidlo uplatňuje na konkrétní URL adresu.