Providerhandleidingen
Cloudflare Domains: instellen en beheren
Koppel de Domain-module aan Cloudflare Registrar en DNS als afzonderlijke rollen.
Op deze pagina
Werkwijze bij de provider
Koppel de Domain-module aan Cloudflare Registrar en DNS als afzonderlijke rollen. De uitbreiding registreert cloudflare-registrar voor beschikbaarheid en registratie en cloudflare-dns voor zones en records. Verlenging is niet ondersteund door de registraradapter, ook al biedt Cloudflare zelf wel domeinverlenging aan.
Vereisten
Agovena Core ^0.0.1. Activeer Domain vóór deze uitbreiding.
Deze uitbreiding is niet als productierijp gemarkeerd. Controleer de ondersteunde werkwijze in je eigen testomgeving voordat je klantbestellingen aanneemt.
Het pakket instellen
Activeer de Domain-module en stel account_id en het geheime api_token in. Het manifest noemt beide velden optioneel, maar echte API-verzoeken vereisen ingevulde waarden. Gebruik registrar_key: cloudflare-registrar en indien nodig dns_provider_key: cloudflare-dns op de productfunctie. Controleer of je account toegang heeft tot de Registrar-API die deze adapter gebruikt.
Providerspecifieke grenzen
De uitbreiding gebruikt een bearer-token voor https://api.cloudflare.com/client/v4. Registrarhandelingen gebruiken /accounts/{account_id}/registrar/domain-check of /registrar/registrations. Het zoeken naar DNS-zones is beperkt tot account en domein. Geef het token rechten voor de bedoelde rol. DNS-toegang betekent niet automatisch toegang tot Registrar.
Bereid voor DNS eerst de zone voor en test daarna een A- of TXT-record op een eigen domein. De adapter accepteert type, name, content, ttl en proxied. Met een id wordt een bestaand record bijgewerkt. TTL moet 1 zijn of tussen 60 en 86400 liggen. A, AAAA, CNAME, MX, NS, SRV, TXT en CAA worden als typen herkend, maar de verzonden velden zijn beperkt. Ga niet uit van ondersteuning voor alle speciale recordvelden. Regel verlenging buiten deze adapter en controleer die bij de registrar. Een DNS-zone bewijst geen domeinregistratie of nameserverpropagatie. 2
Configuratiecontract
| Veld | Type | Verplicht | Geheim | Standaard |
|---|---|---|---|---|
account_id |
string |
Nee | Nee | Leeg |
api_token |
string |
Nee | Ja | Leeg |
Dit zijn de velden uit het manifest. Een optioneel veld kan voor een API-handeling toch noodzakelijk zijn, zoals hierboven beschreven. Bewaar geheime waarden alleen in beschermde instellingen, nooit in productbeschrijvingen, URL’s of gedeelde voorbeelden. 1
Werking en foutafhandeling
Registrarverzoeken gebruiken accountgebonden endpoints voor domeincontrole en registratie. Ontbreekt een domein in het beschikbaarheidsantwoord, dan geldt het als niet beschikbaar. Verlengen geeft een fout voor een niet-ondersteunde handeling. DNS-wijzigingen vereisen een voorbereide zonereferentie en geldige recordwaarden. De recordlijst haalt één pagina met 100 records op. Behandel die niet als volledige inventaris van een grotere zone.