Tools voor eigen domeinen

Verbind een domein met het project en controleer de DNS-inrichting.

Op deze pagina

Verbind een domein, controleer het DNS en kies het hoofddomein. Je stelt de DNS-records zelf in bij je aanbieder.

Informatie

De verbinding geldt voor de Space. Je bent daar lid en de Space is niet geblokkeerd. Een Space is een gedeelde werkruimte in de app.

Voor alle vier tools heb je de rol Eigenaar, Beheerder of Gebruiker nodig. De rol Alleen-lezen is niet voldoende.

hosting_add_domain Add domain

wijzigt gegevens

Voegt een eigen domein toe aan een project. Het domein wacht daarna: het levert de website pas uit als het DNS is ingesteld, hosting_check_domain dit als correct heeft beoordeeld en het certificaat aanwezig is.

Het antwoord noemt de vereiste DNS-records. Als deze door een openstaande overdracht ontbreken, roep je hosting_check_domain aan.

  • De hostnaam is maximaal 253 tekens, is geen IP-adres en bevat geen https:// of pad. Hostnamen in de zones teisenda.com, teisendapages.com en teisendahosting.com weigert TEISENDA.
  • Een project heeft maximaal 19 eigen domeinen.
  • Het abonnement beperkt de eigen domeinen per Space: een Space mag er evenveel hebben als het toegestane aantal projecten, dus 1 bij Free en 10 bij Max. Bij een afgesloten Max-abonnement zijn pakketten met elk 5 extra projecten en daarmee 5 extra eigen domeinen beschikbaar; zie Extra pakketten kopen en afbestellen. Als het aantal is bereikt, weigert TEISENDA de aanroep en wijzigt niets.
Welke DNS-records noemt het antwoord en waarvoor zijn ze?

De lijst bevat alleen een AAAA-record als het hostingknooppunt er een noemt. Het TXT-record met de naam _teisenda-hosting.<Domain> en de waarde teisenda-hosting=<Nachweis> bewijst dat het domein van jou is.

Parameters van hosting_add_domain
ParameterTypeVereisteBeschrijving
spaceGeheel getalverplichtDe tiencijferige Space-ID.
projectGeheel getalverplichtHet projectnummer zoals getoond door hosting_list_projects.
hostnameTekstverplichtEen hostnaam zonder https:// of pad, bijvoorbeeld www.example.com.

hosting_check_domain Check domain

wijzigt gegevens

Controleert het DNS en activeert het domein als de records kloppen. Het certificaat wordt daarna op de achtergrond uitgegeven.

Roep de tool opnieuw aan om de huidige toestand te controleren. Na een mislukt certificaat begint deze een nieuwe poging.

Bij onjuist DNS noemt het antwoord de problemen en Stel het CNAME-record of het A-record in, plus het TXT-record als bewijs van eigendom..

Parameters van hosting_check_domain
ParameterTypeVereisteBeschrijving
spaceGeheel getalverplichtDe tiencijferige Space-ID.
projectGeheel getalverplichtHet projectnummer zoals getoond door hosting_list_projects.
hostnameTekstverplichtEen hostnaam zonder https:// of pad, bijvoorbeeld www.example.com.

hosting_set_primary_domain Set primary domain

wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud

Stelt het hoofddomein in: het adres waarnaar alle andere adressen van het project doorverwijzen. Dit is een actief eigen domein of, als hostname ontbreekt, het TEISENDA-adres van het project.

Het hoofddomein wordt bij de eerste aanroep gewijzigd. Een eigen domein moet actief zijn; bezoekers zien de wijziging zodra deze is overgedragen.

Parameters van hosting_set_primary_domain
ParameterTypeVereisteBeschrijving
spaceGeheel getalverplichtDe tiencijferige Space-ID.
projectGeheel getalverplichtHet projectnummer zoals getoond door hosting_list_projects.
hostnameTekstoptioneelHet eigen domein dat hoofddomein wordt: een hostnaam zonder https:// of pad, bijvoorbeeld www.example.com. Als dit ontbreekt, wordt het TEISENDA-adres het hoofddomein.

hosting_remove_domain Remove domain

wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoudtwee stappen

Verwijdert het domein en certificaat. Als het domein het hoofddomein was, geldt weer het TEISENDA-adres.

Roep de tool eerst zonder confirm aan. Pas de tweede aanroep met de teruggegeven bevestigingszin verwijdert het domein; de toepassing moet eerst je toestemming vragen.

Parameters van hosting_remove_domain
ParameterTypeVereisteBeschrijving
spaceGeheel getalverplichtDe tiencijferige Space-ID.
projectGeheel getalverplichtHet projectnummer zoals getoond door hosting_list_projects.
hostnameTekstverplichtEen hostnaam zonder https:// of pad, bijvoorbeeld www.example.com.
confirmTekstoptioneelBij de eerste aanroep moet de toepassing dit weglaten; het antwoord noemt dan een bevestigingszin. De toepassing mag precies die zin pas verzenden nadat je toestemming hebt gegeven.

Als iets niet lukt

Als een oplossing een tool noemt, vraag je de toepassing deze aan te roepen. De melding over het abonnement eindigt met een verwijzing naar de Space-instellingen en Pakketten; in de instellingen heet het onderdeel Facturatie.

Dit is geen geldige hostnaam. Voer hem in zonder https:// en zonder pad.

De hostnaam is ongeldig. Deze is maximaal 253 tekens, is geen IP-adres en bevat geen https:// of pad. Geef alleen de hostnaam op, bijvoorbeeld www.example.com.

Dit domein is geblokkeerd.

De hostnaam ligt in een zone die geen enkel project mag gebruiken: teisenda.com of teisendapages.com. Gebruik een eigen domein.

Adressen in deze zone kent TEISENDA zelf toe.

De hostnaam ligt in de zone teisendahosting.com, waarin TEISENDA zelf de TEISENDA-adressen uitgeeft. Gebruik een eigen domein.

Dit domein leidt al naar een project.

Het domein leidt al naar een project: dit project, een ander project van de Space of een project van een andere Space. Dezelfde melding verschijnt als het hostingknooppunt het domein bij een project kent. Een hostnaam kan over alle Spaces samen maar bij één project horen. Verwijder deze eerst van het andere project met hosting_remove_domain of gebruik een andere hostnaam.

De limiet voor eigen domeinen is bereikt.

Het project heeft al 19 eigen domeinen. Verwijder eerst een domein.

Het pakket van deze Space staat geen extra eigen domeinen toe: … van … zijn toegevoegd. Er is niets gewijzigd. Het pakket van deze Space staat in TEISENDA onder Instellingen › Pakketten.

Het abonnement van de Space staat geen extra eigen domein toe: een Space mag er evenveel hebben als het toegestane aantal projecten. TEISENDA heeft niets gewijzigd. Verwijder een domein. Max en de bijbehorende pakketten staan meer projecten en daarmee meer eigen domeinen toe; zie Free en Max en Extra pakketten kopen en afbestellen.

Het domein … hoort niet bij dit project.

Het domein hoort niet bij dit project. Bekijk de domeinen van het project met hosting_project_status.

Pas mogelijk als het domein actief is.

hosting_set_primary_domain is aangeroepen voor een domein dat nog niet actief is. Rond de DNS-inrichting af en roep hosting_check_domain aan totdat het domein actief is.

De DNS van … klopt nog niet:

Geen weigering: hosting_check_domain heeft vastgesteld dat het DNS van het domein nog niet klopt. Na de zin volgt per probleem een regel; de regels staan in het volgende onderdeel. Stel de DNS-records in bij je DNS-aanbieder en roep hosting_check_domain opnieuw aan.

Deze problemen meldt hosting_check_domain

Geen van deze regels is een weigering. De eerste negen staan in het resultaat van hosting_check_domain zolang het DNS niet klopt. De laatste drie zijn het probleem dat bij het domein is opgeslagen; hosting_project_status en hosting_check_domain tonen dit als probleem van het domein.

Voor het domein bestaat geen DNS-record.

De domeinnaam leidt nergens naartoe: aan het einde van de CNAME-keten vindt het hostingknooppunt geen A-record en geen AAAA-record. Stel het CNAME-record of A-record in dat het resultaat noemt.

Het A-record ontbreekt.

Het domein heeft een AAAA-record maar geen A-record. Stel het A-record in met de waarde uit het resultaat of gebruik in plaats daarvan het CNAME-record.

Er is nog een A-record dat ergens anders naartoe wijst.

Naast het A-record dat naar het hostingknooppunt wijst, heeft het domein nog een A-record dat ergens anders naartoe wijst. Verwijder het andere A-record bij je DNS-aanbieder.

Het domein wijst naar een andere server.

Het domein heeft A-records en geen ervan bevat het adres van het hostingknooppunt: het wijst naar een andere server. Vervang het bestaande CNAME-record of A-record door dat uit het resultaat.

Er is een AAAA-record dat ergens anders naartoe wijst.

Het domein heeft een AAAA-record dat niet het IPv6-adres van het hostingknooppunt is. De certificaatautoriteit geeft de voorkeur aan IPv6 en loopt vast op zo'n record. Verwijder dit AAAA-record of stel de waarde uit het resultaat in als dit er een noemt.

Een CAA-record verbiedt het uitgeven van het certificaat.

Een CAA-record van het domein of van een bovenliggende naam staat alleen certificaten toe van andere certificaatautoriteiten dan Let's Encrypt, die het hostingknooppunt gebruikt. Wijzig of verwijder het CAA-record bij je DNS-aanbieder zodat het letsencrypt.org toestaat.

Het bewijs van eigendom ontbreekt: het TXT-record is niet ingesteld.

Het eigendomsbewijs ontbreekt: het domein wijst niet via CNAME naar een adres van hetzelfde project onder teisendahosting.com en het TXT-record _teisenda-hosting.<Domain> bevat niet de verwachte waarde. Alleen een A-record bewijst niets. Stel het TXT-record in met de naam en waarde uit het resultaat.

De DNS van het domein reageert niet.

De resolvers die het hostingknooppunt raadpleegt, hebben voor dit domein niet geantwoord. Het DNS kon daarom niet worden gecontroleerd. Controleer bij je DNS-aanbieder of het domein wordt opgelost en roep hosting_check_domain opnieuw aan.

De records zijn nog niet overal aangekomen. Probeer het over een paar minuten opnieuw.

Een van de twee openbare resolvers die het hostingknooppunt raadpleegt, ziet de records al als correct, de andere nog niet. In dat geval verschijnt alleen deze regel. Wacht enkele minuten en roep hosting_check_domain opnieuw aan.

De DNS klopt nog niet.

Bij een poging om het domein te activeren, klopte het DNS op dat moment niet. Daarom is er geen certificaat aangevraagd. Corrigeer het DNS en roep hosting_check_domain opnieuw aan.

Het certificaat is geweigerd.

Het uitgeven van het certificaat is mislukt, ongeacht de oorzaak. Het domein heeft dan de status failed. Controleer de DNS-records, vooral een CAA-record, en roep hosting_check_domain opnieuw aan; dit begint een nieuwe poging zodra het DNS klopt. Neem als dit blijft gebeuren contact op met Support.

Het hostingknooppunt meldt een probleem met dit domein.

Het hostingknooppunt meldt iets waarvoor TEISENDA geen eigen zin heeft, bijvoorbeeld dat een herstart van het knooppunt het uitgeven van het certificaat heeft onderbroken. Roep hosting_check_domain opnieuw aan.

Meldingen over de Space en het projectnummer staan bij de tools voor Spaces en projecten. Alle andere die bij elke tool kunnen voorkomen, staan onder Problemen met de Connector oplossen.

Verder