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, Beveiliging, 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 Vanaf nul beginnen. Ingebouwde sjablonen zijn onder meer:

    • HTTPS afdwingen — alle HTTP-verzoeken automatisch omleiden naar HTTPS
    • Redirect-URL — bezoekers naar een andere URL sturen
    • Blokkeren op land — verkeer uit specifieke landen blokkeren of omleiden
    • Cachetijd overschrijven — een aangepaste cachetijd instellen voor overeenkomende verzoeken
    • Antwoordheader instellen — een aangepaste HTTP-header toevoegen aan overeenkomende responses
    • IP / bereik blokkeren — verzoeken van een IP-adres of CIDR-bereik blokkeren
    • Onderhoudsmodus (503) — een 503 retourneren voor alle verzoeken

  3. Stel de voorwaarden in (de "When"). In de kaart Wanneer (triggers) kiest elke voorwaarde iets om op te matchen — bijvoorbeeld URL komt overeen met, land is, IP is of bestandsextensie is — en een of meer Waarde-invoeren om mee te vergelijken.

    • Voorwaarden die matchen op een request header, een antwoordheader of een cookie vragen daarnaast om een Headernaam of een Cookienaam.
    • Klik op + Waarde toevoegen om in één voorwaarde meerdere waarden te matchen (maximaal 5 waarden per voorwaarde).
    • Elke voorwaarde heeft zijn eigen matchtype Een / Alle / Geen, dat bepaalt hoe de waarden van die voorwaarde worden gecombineerd.
    • Klik op + Voorwaarde toevoegen om meer voorwaarden toe te voegen, tot maximaal 5 per regel. Zowel + Waarde toevoegen als + Voorwaarde toevoegen wordt grijs zodra je de bijbehorende limiet bereikt.
    • Het Type overeenkomst op het hoogste niveau van de kaart (Een / Alle / Geen) bepaalt hoe de afzonderlijke voorwaarden worden gecombineerd: Een voert de regel uit als ten minste één voorwaarde overeenkomt, Alle vereist elke voorwaarde, en Geen voert de regel alleen uit wanneer geen enkele voorwaarde overeenkomt.

  4. Stel de actie in (de "Then"). Kies in de kaart Dan (actie) een Actie en vul de eventueel benodigde parameters in. De actie omleiden naar vraagt bijvoorbeeld om een bestemmings-URL en een HTTP-statuscode (301 permanent of 302 tijdelijk); cachetijd overschrijven naar vraagt om een cachetijd in seconden.

    • Je kunt extra acties aaneenschakelen met + Actie toevoegen.
    • De lijst Actie is gegroepeerd per categorie — Beveiliging, Redirect, Caching, Headers, Origin, Compressie, Prestaties en Overig. Een paar van de actietypen die de CDN zelf ondersteunt, worden niet in de editor aangeboden, omdat ze diensten aansturen die CloudPress niet doorverkoopt. Gebruikt een regel die je bewerkt er al een, dan blijft die voor die regel selecteerbaar.

  5. Bekijk de live samenvatting. Terwijl je de regel opbouwt, wordt een samenvatting in gewone taal bijgewerkt die beschrijft wat deze gaat doen (bijv. "Als URL komt overeen met …, dan omleiden naar …"). Gebruik deze om de regel te controleren voordat je opslaat.

  6. Voeg details toe (optioneel). Stel een Beschrijving in om de regel te labelen, en een Volgorde-nummer om te bepalen wanneer deze wordt uitgevoerd ten opzichte van andere regels — regels worden uitgevoerd in oplopende volgorde. Laat de schakelaar Ingeschakeld 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. Wordt het opslaan geweigerd, dan blijft het formulier precies zoals je het had opgebouwd — elke voorwaarde- en actierij blijft behouden — en verschijnt de reden in een banner boven aan het formulier.

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, en vraagt je bij het opslaan nog één keer om bevestiging. 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 Ingeschakeld 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 $CLOUDPRESS_TOKEN" -H "X-Auth-Account: $ACCOUNT_ID" \
  https://my.cloudpress.com/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