Ga naar hoofdinhoud

Cloudflare-integratie

Overzicht​

Cloudflare is een toonaangevend contentdeliverynetwerk (CDN) en beveiligingsprovider die helpt websites te beschermen en te versnellen. Deze integratie maakt automatisch domeinbeheer mogelijk tussen Ultimate Multisite en Cloudflare, met name voor subdomein-multisite-installaties.

Functies​

  • Automatische aanmaak van subdomeinen in Cloudflare
  • Ondersteuning voor geproxiede subdomeinen
  • Beheer van DNS-records
  • Verbeterde weergave van DNS-records in de Ultimate Multisite admin

Vereisten​

De volgende constanten moeten worden gedefinieerd in je wp-config.php-bestand:

define('WU_CLOUDFLARE_API_KEY', 'your_api_key');
define('WU_CLOUDFLARE_ZONE_ID', 'your_zone_id');

Installatie-instructies​

1. Verkrijg je Cloudflare API Key​

  1. Log in op je Cloudflare Dashboard
  2. Ga naar "Mijn profiel" (klik op je e-mail in de rechterbovenhoek)
  3. Selecteer "API-tokens" in het menu
  4. Maak een nieuw API-token aan met de volgende rechten:
    • Zone.Zone: Lezen
    • Zone.DNS: Bewerken
  5. Kopieer je API-token

2. Verkrijg je Zone ID​

  1. Selecteer in je Cloudflare Dashboard het domein dat je wilt gebruiken
  2. De Zone ID is zichtbaar op het tabblad "Overzicht", in de rechterzijbalk onder "API"
  3. Kopieer de Zone ID

3. Voeg constanten toe aan wp-config.php​

Voeg de volgende constanten toe aan je wp-config.php-bestand:

define('WU_CLOUDFLARE_API_KEY', 'your_api_token');
define('WU_CLOUDFLARE_ZONE_ID', 'your_zone_id');

4. Schakel de integratie in​

  1. Ga in je WordPress admin naar Ultimate Multisite > Instellingen
  2. Navigeer naar het tabblad "Domeinkoppeling"
  3. Scrol omlaag naar "Hostintegraties"
  4. Schakel de Cloudflare-integratie in
  5. Klik op "Wijzigingen opslaan"

Hoe het werkt​

Subdomeinbeheer​

Wanneer een nieuwe site wordt aangemaakt in een subdomein-multisite-installatie:

  1. De integratie stuurt een verzoek naar de API van Cloudflare om een CNAME-record voor het subdomein toe te voegen
  2. Het subdomein wordt standaard geconfigureerd om via Cloudflare te worden geproxied (dit kan met filters worden gewijzigd)
  3. Wanneer een site wordt verwijderd, verwijdert de integratie het subdomein uit Cloudflare

Weergave van DNS-records​

De integratie verbetert de weergave van DNS-records in de Ultimate Multisite admin door:

  1. DNS-records rechtstreeks uit Cloudflare op te halen
  2. Weer te geven of records geproxied zijn of niet
  3. Aanvullende informatie over de DNS-records te tonen

Cloudflare Custom Hostnames​

Cloudflare Custom Hostnames (voorheen "Cloudflare for SaaS" genoemd) is een Cloudflare-functie waarmee je klanten hun eigen domeinen met SSL op je multisite-netwerk kunnen gebruiken. Dit is de aanbevolen aanpak voor domeingekoppelde multisite-installaties die Cloudflare gebruiken, omdat Cloudflare de uitgifte en verlenging van SSL-certificaten voor elk aangepast domein automatisch beheert.

Waarin dit verschilt van de standaard Cloudflare-integratie​

StandaardintegratieCloudflare Custom Hostnames
DoelMaakt automatisch DNS-records voor subdomeinen aanMaakt aangepaste (gekoppelde) domeinen mogelijk met door Cloudflare beheerde SSL
Het meest geschikt voorSubdomein-multisiteDomeingekoppelde multisite
SSLAfzonderlijk afgehandeldAutomatisch beheerd door Cloudflare

Cloudflare Custom Hostnames instellen​

  1. Open in je Cloudflare Dashboard de zone voor je hoofddomein.
  2. Ga naar SSL/TLS > Custom Hostnames.
  3. Voeg een fallback origin toe die verwijst naar het IP-adres of de hostnaam van je server.
  4. Voeg voor elk klantdomein dat in Ultimate Multisite is gekoppeld een Custom Hostname-vermelding toe in Cloudflare. Je kunt deze stap automatiseren met de Cloudflare API.
  5. Cloudflare geeft automatisch TLS-certificaten uit en verlengt deze voor elke aangepaste hostnaam zodra de DNS van de klant naar je netwerk verwijst.

Zie voor de volledige API-referentie de documentatie van Cloudflare Custom Hostnames.

Terminologie-update

Vanaf Ultimate Multisite v2.6.1 wordt deze functie in alle plugin-instellingen en labels aangeduid als Cloudflare Custom Hostnames. Eerdere versies gebruikten de naam "Cloudflare for SaaS", wat de naam is van het onderliggende Cloudflare-product.

Belangrijke opmerkingen​

Sinds de recente updates van Cloudflare is wildcard-proxying nu beschikbaar voor alle klanten. Dit betekent dat de standaard Cloudflare DNS-integratie minder essentieel is voor subdomein-multisite-installaties dan vroeger, omdat je eenvoudig een wildcard-DNS-record in Cloudflare kunt instellen.

Probleemoplossing​

Problemen met de API-verbinding​

  • Controleer of je API-token correct is en de benodigde rechten heeft
  • Controleer of je Zone ID correct is
  • Zorg ervoor dat je Cloudflare Account de benodigde rechten heeft

Subdomein niet toegevoegd​

  • Controleer de Ultimate Multisite logs op foutmeldingen
  • Controleer of het subdomein niet al aan Cloudflare is toegevoegd
  • Zorg ervoor dat je Cloudflare plan het aantal DNS-records ondersteunt dat je aanmaakt

Proxyproblemen​

  • Als je niet wilt dat subdomeinen worden geproxied, kun je het wu_cloudflare_should_proxy-filter gebruiken
  • Sommige functies werken mogelijk niet correct wanneer ze geproxied zijn (bijv. bepaalde WordPress admin-functies)
  • Overweeg Cloudflare's Page Rules te gebruiken om de cache voor admin-pagina's te omzeilen