Providerhandleidingen
Cloudflare Domains: instellen en beheren
Controleer beschikbaarheid, registreer domeinen via Cloudflare Registrar en beheer DNS-zones en records via de Cloudflare API.
Op deze pagina
Status en werkwijze
De Cloudflare Domains-extension koppelt de Domains Module in twee rollen aan Cloudflare. cloudflare-registrar controleert beschikbaarheid en registreert domeinen via de Cloudflare Registrar API. cloudflare-dns bereidt zones voor en beheert DNS-records via de Cloudflare DNS API. Beide rollen gebruiken hetzelfde account-ID en dezelfde API-token, en elke call gaat naar https://api.cloudflare.com/client/v4.
Production-ready voor de gedocumenteerde scope. Elke bewerking onder Ondersteunde bewerkingen is gebouwd op de Cloudflare Registrar-, DNS- en Zones-API en geverifieerd met geautomatiseerde tests die de provider vervangen door gesimuleerde HTTP-antwoorden, zonder netwerkcalls. Live acceptatie op je eigen Cloudflare-account blijft de verantwoordelijkheid van de beheerder: registreer één goedkoop domein en wijzig één DNS-record op je eigen Cloudflare-account voordat je domeinen verkoopt. Bewerkingen onder Niet ondersteund worden niet aangeboden.
Vereisten
- Agovena Core
^0.0.1. - De Domains Module, geactiveerd vóór deze extension.
- Een Cloudflare-account met een billing profile en geldige standaardbetaalmethode, plus een standaard registrant-adres met geaccepteerde overeenkomst. Registratie gebruikt express mode en verstuurt geen contactgegevens.
- Een API-token met Registrar-rechten voor registratie en
Zone EditofDNS Editvoor zones en records.
Het pakket instellen
- Activeer de Domains Module, open daarna Admin > Extensies en activeer Cloudflare Domains.
- Kopieer in het Cloudflare-dashboard het account-ID en maak een API-token met de rechten hierboven.
- Rond in het Cloudflare-dashboard het billing profile en het standaard registrant-adres af. Agovena kan die niet voor je instellen.
- Sla
account_idenapi_tokenop. De token wordt als secret bewaard en nooit opnieuw getoond. - Gebruik in de Domains Module
cloudflare-registrarvoor registratie encloudflare-dnsvoor DNS.
Ondersteunde bewerkingen
| Bewerking | Gedrag |
|---|---|
| Beschikbaarheid | POST /accounts/{account_id}/registrar/domain-check. Een domein is alleen beschikbaar als Cloudflare registrable: true meldt en de tier niet premium is. De prijs komt uit pricing.registration_cost. |
| Registratie | Leest de bestaande registratieworkflow, voert een realtime beschikbaarheidscontrole uit en stuurt daarna POST /accounts/{account_id}/registrar/registrations met domain_name en auto_renew. |
| Statusverversing | De Domains Module draait elke vijf minuten agovena:refresh-domain-registrations. Die leest alleen registration-status en dient nooit een tweede registratie in. |
| Zone voorbereiden | Hergebruikt een zone in het account alleen bij een exacte naam, en maakt anders een full zone aan. |
| DNS-records | A-, AAAA-, CNAME-, MX-, NS- en TXT-records tonen, aanmaken, wijzigen en verwijderen. Namen worden binnen de zone volledig uitgeschreven, MX vraagt een prioriteit van 0 tot 65535 en proxied wordt alleen voor A, AAAA en CNAME meegestuurd. |
De workflowstatussen pending, in_progress, blocked en action_required houden de registratie op registering. succeeded wordt active met de vervaldatum van Cloudflare en bereidt de DNS-zone voor. failed wordt failed, met de foutcode en melding van Cloudflare in de registratie-meta. Bij action_required bewaart de meta context.action, zodat je die stap in het Cloudflare-dashboard kunt afronden.
auto_renew: true geeft Cloudflare toestemming om verlengingen tot 30 dagen voor de vervaldatum af te schrijven van de standaardbetaalmethode van het account. Die afschrijving valt buiten de facturatie van Agovena.
Niet ondersteund
- Verlengen. De Registrar API heeft geen verlengingsendpoint, dus
renewalwordt niet aangeboden en een verlengverzoek faalt met een expliciete foutmelding. - Transfers, nameserverwijzigingen, contactwijzigingen, premium registraties en meerjarige looptijden.
- SRV, CAA en andere recordtypen met gestructureerde data.
- Een health check callback.
Foutafhandeling en eigendom
- Cloudflare staat één registratie per domein toe. Een bestaande workflow met
pending,in_progress,blocked,action_requiredofsucceededwordt ongewijzigd teruggegeven. Opnieuw registreren werkt daardoor als statusverversing en verstuurt nooit een tweede betaald verzoek.action_requiredwordt nooit opnieuw ingediend. - Niet-beschikbare en premium domeinen worden geweigerd voordat er een betaald verzoek vertrekt.
- Faalt het registratieverzoek door een timeout, transportfout of weigering, dan wordt de workflowstatus één keer gelezen. Een net gestarte workflow wordt dan gemeld in plaats van de fout. Anders wordt het record
failed, en een latere poging leest eerst de workflow, zodat die verdergaat in plaats van twee keer te betalen. - Antwoorden zonder gedocumenteerde
state, met een inconsistentecompleted-vlag of voor een ander domein worden geweigerd. Een mislukte statuscontrole laat de registratie ongewijzigd voor de volgende run. - DNS-records die Cloudflare weigert, geven een formulierfout in plaats van een mislukt verzoek.
- In de
demo-omgeving worden alle HTTP-calls geweigerd, redirects worden nooit gevolgd en foutmeldingen bevatten nooit de API-token.
Configuratiecontract
| Veld | Type | Verplicht | Geheim | Standaard |
|---|---|---|---|---|
account_id |
string |
Nee | Nee | Leeg |
api_token |
string |
Nee | Ja | Leeg |
Beide velden zijn optioneel in het manifest, maar registratie en DNS-wijzigingen hebben ze allebei nodig. De token moet de rechten uit Vereisten hebben. Bewaar geheime waarden alleen in de beschermde extension-instellingen, nooit in productbeschrijvingen, URL's, screenshots of gedeelde voorbeelden.