Zet een app op je eigen domein

Elke gepubliceerde app heeft een eigen adres op kvyk.app. Je kunt hem ook openen op een domein van jezelf, zoals shop.example.com. De app werkt daar hetzelfde: hij toont zijn Live-versie, aan dezelfde mensen, en die melden zich aan op dat domein.

Alleen Builders en Administrators voegen domeinen toe. Een app kan er tot vijf hebben.

Wat je nodig hebt

• Een domein van je organisatie, en toegang tot de DNS-instellingen ervan, meestal bij het bedrijf waar je het registreerde.
• Een app die gepubliceerd is. Je kunt het domein eerder toevoegen, maar het toont de app pas zodra Live een versie heeft.

Voeg het domein toe

1. Open de pagina van de app via Apps in de zijbalk.
2. Typ onder Your own domain het domein, zoals shop.example.com, en kies Add domain.
3. kvyk.ai vraagt je te bevestigen, omdat de app daar opent zodra de records staan. Kies Add it.

Het domein verschijnt in de tabel als Waiting for its records, met daaronder de twee records die je toevoegt.

Voeg de twee DNS-records toe

Voeg bij het bedrijf waar je de DNS van het domein beheert beide records toe, precies zoals de pagina van de app ze toont:

Type	Naam	Waarde
CNAME	shop.example.com	het eigen adres van de app, zoals shop.bakkerij.kvyk.app
TXT	_kvyk.shop.example.com	kvyk-verify= gevolgd door de code van het domein

• De CNAME stuurt bezoekers van je domein naar de app.
• Het TXT-record toont dat het domein van jou is. Alleen wie de DNS van het domein kan wijzigen, kan het toevoegen, dus niemand anders kan jouw domein op zijn app zetten.

Sommige providers willen alleen het eerste deel van de naam (shop en _kvyk.shop) en vullen het domein zelf aan.

Een domein zonder www

DNS staat geen CNAME toe op een domein zelf, zoals example.com. Voor zo’n domein vraagt de pagina in de plaats een ALIAS- of ANAME-record, bij sommige providers een flattened CNAME, met dezelfde waarde. Heeft je provider dat niet, gebruik dan www.example.com voor de app en laat je provider example.com daarheen sturen.

Verifieer het

kvyk.ai zoekt de records om de paar minuten op en verifieert het domein zodra het ze allebei vindt. Wil je nu kijken, kies dan Verify naast het domein. Zolang ze niet allebei gevonden zijn, zegt de pagina wat er nog ontbreekt, bijvoorbeeld Er is geen TXT-record gevonden op _kvyk.shop.example.com. Nieuwe records kunnen een paar minuten tot een paar uur nodig hebben voor ze overal zichtbaar zijn.

Zodra het domein Verified is, linkt zijn naam in de tabel naar de app. Het eerste bezoek kan een paar seconden langer duren: kvyk.ai haalt dan een eigen certificaat voor het domein, zodat het via https opent.

Aanmelden op je domein

Mensen openen de app op je domein en melden zich daar aan, zoals op het eigen adres van de app: leden met Aanmelden met kvyk, klanten van een openbare app met de code of de link uit hun mail, en ze blijven op je domein. Wie zich op het ene adres aanmeldt, is dat niet op het andere: ze melden zich op elk adres één keer aan.

Als een domein niet meer werkt

kvyk.ai bekijkt de records van een geverifieerd domein om de paar uur opnieuw. Is er een weg of gewijzigd, dan toont het domein No longer set up met de reden, en opent de app daar niet meer. Zet de records terug en kies Verify, of wacht op de volgende controle.

kvyk.ai kijkt ook na of het domein nog een geldig certificaat heeft. Kon het er geen krijgen, of het niet op tijd vernieuwen, dan toont het domein Certificate failing met de reden. De app opent er nog, maar browsers waarschuwen bezoekers tot het certificaat weer in orde is. Meestal komt dat door een CAA-record op het domein dat alleen andere certificaatautoriteiten toelaat. Verwijder het, of voeg er een naast toe met de waarde 0 issue "letsencrypt.org", en kijk na of de twee records van het domein er nog staan. kvyk.ai blijft het zelf proberen.

Je krijgt een mail

Werkt een geverifieerd domein niet meer, door de records of door het certificaat, dan krijgen de Administrators van de organisatie en wie het domein toevoegde één mail. Die zegt wat er mis is en geeft precies de records die je terugzet. Werkt het domein weer, dan krijgen ze nog één mail. Intussen blijft de app bereikbaar op zijn eigen adres op kvyk.app.

Een domein is voor één app tegelijk geverifieerd. Om het naar een andere app te verhuizen, verwijder je het hier en voeg je het daar toe. Heeft de app van een andere organisatie op kvyk.ai het domein, dan gaat het naar jouw app zodra de records van die app niet meer kloppen en de jouwe staan.

Verwijder een domein

Kies Remove naast het domein en bevestig. De app opent daar meteen niet meer. Daarna kun je de twee records bij je DNS-provider verwijderen.

Een domein toevoegen, verifiëren en verwijderen, en een domein of zijn certificaat dat niet meer en weer werkt, staat allemaal in het gebeurtenissenlogboek.