Aangepaste verzoekheaders
Leer hoe u aangepaste HTTP-headers kunt toevoegen aan cside-verzoeken om ze te identificeren en te filteren op uw origin-server.
Overzicht
Met aangepaste verzoekheaders kunt u uw eigen HTTP-headers toevoegen aan elk verzoek dat cside naar uw origin-server stuurt. Dit maakt het eenvoudig om cside-verkeer op uw backend te identificeren, authenticeren of filteren.
Wanneer cside uw scripts ophaalt, worden de aangepaste headers die u configureert automatisch opgenomen in het uitgaande HTTP-verzoek naar uw origin.
Gebruiksscenario’s
- cside-verkeer identificeren: Voeg een header toe zoals
X-Request-Source: csidezodat uw backend cside-verzoeken kan onderscheiden van regulier gebruikersverkeer - Authenticatie: Voeg een autorisatietoken toe zodat uw origin kan verifieren dat het verzoek van cside afkomstig is
- Filteren en logging: Tag verzoeken met een aangepaste identifier voor eenvoudiger logfiltering en analytics
- WAF / firewallregels: Sta cside-verzoeken toe door te matchen op een bekende headerwaarde
Aangepaste headers configureren
Navigeer naar uw domeininstellingen in het cside-dashboard en scroll naar de sectie Custom Request Headers.
Een header toevoegen
- Voer de headernaam in het veld Header name in (bijv.
X-Request-Id) - Voer de headerwaarde in het veld Value in (bijv.
my-value) - Om extra headers toe te voegen, klik op + Add header
- Klik op Save request headers om uw wijzigingen toe te passen
Wijzigingen aan aangepaste headers worden binnen enkele minuten van kracht naarmate de configuratie wordt bijgewerkt in alle edge-regio’s.
Een header verwijderen
Om een header te verwijderen, klik op de verwijderknop naast de headerrij die u wilt verwijderen en klik vervolgens op Save request headers.
Hoe het werkt
Wanneer cside een verzoek doet naar uw origin-server om scriptinhoud op te halen, worden alle aangepaste headers die u hebt geconfigureerd geinjecteerd in het uitgaande HTTP-verzoek. Uw origin-server ontvangt deze headers naast de standaard verzoekheaders.
Voorbeeld: Als u een header X-Cside-Token configureert met waarde abc123, ontvangt uw origin verzoeken zoals:
GET /your-script.js HTTP/1.1
Host: yourdomain.com
X-Cside-Token: abc123
U kunt deze header vervolgens gebruiken in uw serverconfiguratie om cside-verzoeken te identificeren of autoriseren. Bijvoorbeeld in NGINX:
location /scripts/ {
if ($http_x_cside_token = "abc123") {
# Verzoek is van cside
}
}
Machtigingen
Het beheren van aangepaste verzoekheaders vereist de machtiging Manage Domains op uw team. Neem contact op met uw teambeheerder als u geen toegang hebt tot deze instelling.