Overzicht
Language

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: cside zodat 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

  1. Voer de headernaam in het veld Header name in (bijv. X-Request-Id)
  2. Voer de headerwaarde in het veld Value in (bijv. my-value)
  3. Om extra headers toe te voegen, klik op + Add header
  4. Klik op Save request headers om uw wijzigingen toe te passen
Opmerking

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.