Ga naar inhoud

Edge-regels beheren

Edge-regels werken in op een verzoek aan de CDN-edge — voordat het ooit je WordPress-server bereikt. Gebruik ze om URL's om te leiden, HTTPS af te dwingen, verkeer per land of IP te blokkeren, te overschrijven hoe lang content wordt gecachet, responsheaders toe te voegen en meer. Elke regel volgt een eenvoudige When → Then-vorm: een set voorwaarden die bepalen wanneer de regel van toepassing is, en een actie die wordt uitgevoerd wanneer ze overeenkomen.

Waar edge-regels passen

Edge-regels maken deel uit van het CDN van je site. Voor het grotere geheel van hoe de edge-laag (caching, WAF en botbescherming) werkt, zie CDN & Shield.

Voordat je begint

  • Een site met CDN actief. Edge-regels vereisen een actieve CDN-pull zone — als CDN nog niet is ingeschakeld voor de site, toont de pagina Edge-regels "CDN is niet actief voor deze site" en moet je eerst CDN inschakelen.
  • Rechten om de site te beheren. Het verwijderen van een regel vereist verwijderrechten op het account.

De pagina Edge-regels openen

  1. Open je site. Open in de linkerzijbalk Mijn sites en selecteer de site die je wilt beheren.

  2. Open het CDN-gedeelte. Kies in de linkerzijbalk van de site CDN en vervolgens Edge-regels. (Binnen het CDN-gedeelte kun je schakelen tussen de tabbladen Caching en Edge-regels.)

De pagina Edge-regels toont de regels die al voor de site zijn ingesteld, in de volgorde waarin ze worden uitgevoerd, met een Samenvatting, een Categorie-badge (Redirect, Caching, Security, Headers, enzovoort) en een Ingeschakeld-schakelaar voor elke regel.

Een regel aanmaken

  1. Begin een nieuwe regel. Klik op de pagina Edge-regels op + Nieuwe edge-regel.

  2. Kies een startpunt. Je ziet een sjablonenkiezer "Kies een startpunt". Kies een sjabloon om het formulier vooraf in te vullen, of kies Begin vanaf nul. Ingebouwde sjablonen zijn onder meer:

    • Force HTTPS — alle HTTP-verzoeken automatisch omleiden naar HTTPS
    • Redirect URL — bezoekers naar een andere URL sturen
    • Block by country — verkeer uit specifieke landen blokkeren of omleiden
    • Override cache time — een aangepaste cachetijd instellen voor overeenkomende verzoeken
    • Set response header — een aangepaste HTTP-header toevoegen aan overeenkomende responses
    • Block IP / range — verzoeken van een IP-adres of CIDR-bereik blokkeren
    • Maintenance mode (503) — een 503 retourneren voor alle verzoeken

  3. Stel de voorwaarden in (de "When"). In de kaart When (triggers) kiest elke voorwaarde iets om op te matchen — bijvoorbeeld URL matches, country is, IP is of file extension is — en een of meer Value-invoeren om mee te vergelijken.

    • Klik op + Add value om in één voorwaarde meerdere waarden te matchen (maximaal 5 waarden per voorwaarde).
    • Elke voorwaarde heeft zijn eigen Any / All / None-matchtype, dat bepaalt hoe de waarden van die voorwaarde worden gecombineerd.
    • Klik op + Add condition om meer voorwaarden toe te voegen. Het Match type op het hoogste niveau van de kaart (Any / All / None) bepaalt hoe de afzonderlijke voorwaarden worden gecombineerd: Any voert de regel uit als ten minste één voorwaarde overeenkomt, All vereist elke voorwaarde, en None voert de regel alleen uit wanneer geen enkele voorwaarde overeenkomt.

  4. Stel de actie in (de "Then"). Kies in de kaart Then (action) een Action en vul de eventueel benodigde parameters in. Redirect vraagt bijvoorbeeld om een bestemmings-URL en een HTTP-statuscode (301 permanent of 302 tijdelijk); Override cache time vraagt om een cachetijd in seconden.

    • Je kunt extra acties aaneenschakelen met + Add action.

  5. Bekijk de live samenvatting. Terwijl je de regel opbouwt, wordt een samenvatting in gewone taal bijgewerkt die beschrijft wat deze gaat doen (bijv. "If URL matches … then redirect to …"). Gebruik deze om de regel te controleren voordat je opslaat.

  6. Voeg details toe (optioneel). Stel een Description in om de regel te labelen, en een Order-nummer om te bepalen wanneer deze wordt uitgevoerd ten opzichte van andere regels — regels worden uitgevoerd in oplopende volgorde. Laat de schakelaar Enabled aan staan om de regel direct actief te maken.

  7. Opslaan. Klik op Regel opslaan. Je keert terug naar de lijst met Edge-regels waar de nieuwe regel wordt getoond.

Security-acties

Sommige acties schakelen een beveiligingsfunctie uit — bijvoorbeeld acties die de WAF of andere Shield-bescherming uitschakelen voor overeenkomende verzoeken. Het formulier toont een waarschuwing wanneer je er een kiest. Gebruik deze alleen voor paden waarvan je zeker weet dat ze die nodig hebben.

Een regel bewerken, in- of uitschakelen, of verwijderen

In de lijst met Edge-regels heeft elke regel zijn eigen bedieningselementen:

  • In-/uitschakelen — zet de schakelaar Enabled op de rij van de regel om. De wijziging wordt direct toegepast; je hoeft de regel niet opnieuw te openen.
  • Bewerken — klik op Bewerken om de regel opnieuw te openen in hetzelfde When → Then-formulier. Bij het bewerken wordt de hele regel vervangen, dus het formulier laadt elk bestaand veld zodat je het kunt wijzigen. Klik op Regel opslaan wanneer je klaar bent.
  • Verwijderen — klik op Verwijderen en bevestig in het dialoogvenster. Het verwijderen van een regel kan niet ongedaan worden gemaakt.

Dezelfde regels zijn beschikbaar via de REST API onder /api/sites/:site_id/edge_rules. Hier is bijvoorbeeld hoe je de edge-regels van een site opsomt:

curl -H "Authorization: Bearer $SUPERSPACE_TOKEN" -H "X-Auth-Account: $ACCOUNT_ID" \
  https://control.superspace.nl/api/sites/$SITE_ID/edge_rules

Schrijfacties voor edge-regels zijn synchroon. Eén ding om op te letten: het aanmaken van een regel zonder een Guid is niet idempotent — een opnieuw geprobeerde aanmaak maakt een duplicaatregel. Om een bestaande regel bij te werken, stuur je de Guid ervan mee (of gebruik je PATCH). Zie de volledige parameterlijst, de actie-/triggertypenummers en de statuscodes in de CDN API-referentie.

Volgende stappen

  • Bekijk je cachingconfiguratie op het tabblad CDN → Caching
  • Lees CDN & Shield om te begrijpen hoe edge-regels samenwerken met caching en Shield-bescherming