Mettre une application sur votre propre domaine
Ouvrez une application publiée sur un domaine à vous, comme shop.example.com, avec deux enregistrements DNS et un certificat que kvyk.ai obtient pour vous.
Chaque application publiée a sa propre adresse sur kvyk.app. Vous pouvez aussi l’ouvrir sur un domaine à vous, comme shop.example.com. L’application y fonctionne de la même façon : elle montre sa version Live, aux mêmes personnes, qui se connectent sur ce domaine.
Seuls les Builders et les Administrators ajoutent des domaines. Une application peut en avoir jusqu’à cinq.
Ce qu’il vous faut
Section titled “Ce qu’il vous faut”- Un domaine de votre organisation, et l’accès à ses réglages DNS, en général chez la société où vous l’avez enregistré.
- Une application publiée. Vous pouvez ajouter le domaine avant, mais il ne montre l’application qu’une fois que Live en a une version.
Ajouter le domaine
Section titled “Ajouter le domaine”- Ouvrez la page de l’application depuis Apps dans la barre latérale.
- Sous Your own domain, tapez le domaine, comme
shop.example.com, et choisissez Add domain. - kvyk.ai vous demande de confirmer, car l’application s’y ouvre dès que ses enregistrements sont en place. Choisissez Add it.
Le domaine apparaît dans le tableau comme Waiting for its records, avec en dessous les deux enregistrements à ajouter.
Ajouter les deux enregistrements DNS
Section titled “Ajouter les deux enregistrements DNS”Chez la société où vous gérez le DNS du domaine, ajoutez les deux enregistrements exactement comme la page de l’application les montre :
| Type | Nom | Valeur |
|---|---|---|
| CNAME | shop.example.com | l’adresse propre de l’application, comme shop.boulangerie.kvyk.app |
| TXT | _kvyk.shop.example.com | kvyk-verify= suivi du code du domaine |
- Le CNAME envoie les visiteurs de votre domaine vers l’application.
- L’enregistrement TXT montre que le domaine est à vous. Seul quelqu’un qui peut modifier le DNS du domaine peut l’ajouter : personne d’autre ne peut donc mettre votre domaine sur son application.
Certains fournisseurs ne veulent que la première partie du nom (shop et _kvyk.shop) et ajoutent le domaine eux-mêmes.
Un domaine sans www
Section titled “Un domaine sans www”Le DNS n’accepte pas de CNAME sur un domaine lui-même, comme example.com. Pour un tel domaine, la page demande à la place un enregistrement ALIAS ou ANAME, que certains fournisseurs appellent un CNAME aplati, avec la même valeur. Si votre fournisseur n’en propose pas, utilisez www.example.com pour l’application et faites envoyer example.com vers cette adresse par votre fournisseur.
Le vérifier
Section titled “Le vérifier”kvyk.ai consulte les enregistrements toutes les quelques minutes et vérifie le domaine dès qu’il trouve les deux. Pour regarder tout de suite, choisissez Verify à côté du domaine. Tant que les deux ne sont pas trouvés, la page indique ce qui manque encore, par exemple Aucun enregistrement TXT n’a été trouvé à _kvyk.shop.example.com. De nouveaux enregistrements peuvent mettre de quelques minutes à quelques heures pour être visibles partout.
Une fois le domaine Verified, son nom dans le tableau mène à l’application. La première visite peut prendre quelques secondes de plus : kvyk.ai obtient alors un certificat propre au domaine, pour qu’il s’ouvre en https.
Se connecter sur votre domaine
Section titled “Se connecter sur votre domaine”Les personnes ouvrent l’application sur votre domaine et s’y connectent, comme à l’adresse propre de l’application : les membres avec Se connecter avec kvyk, les clients d’une application publique avec le code ou le lien de leur e-mail, et ils restent sur votre domaine. Se connecter à une adresse ne connecte pas à l’autre : on se connecte une fois à chacune.
Quand un domaine ne fonctionne plus
Section titled “Quand un domaine ne fonctionne plus”kvyk.ai consulte à nouveau les enregistrements d’un domaine vérifié toutes les quelques heures. Si l’un d’eux a disparu ou changé, le domaine affiche No longer set up avec la raison, et l’application ne s’y ouvre plus. Remettez les enregistrements et choisissez Verify, ou attendez la prochaine vérification.
kvyk.ai vérifie aussi que le domaine a toujours un certificat valide. S’il n’a pas pu en obtenir un, ou le renouveler à temps, le domaine affiche Certificate failing avec la raison. L’application s’y ouvre encore, mais les navigateurs mettent les visiteurs en garde jusqu’à ce que le certificat soit de nouveau en ordre. Le plus souvent, cela vient d’un enregistrement CAA sur le domaine qui n’autorise que d’autres autorités de certification. Supprimez-le, ou ajoutez-en un à côté avec la valeur 0 issue "letsencrypt.org", et vérifiez que les deux enregistrements du domaine sont toujours en place. kvyk.ai continue d’essayer de lui-même.
Vous recevez un e-mail
Section titled “Vous recevez un e-mail”Quand un domaine vérifié ne fonctionne plus, à cause de ses enregistrements ou de son certificat, les Administrators de l’organisation et la personne qui a ajouté le domaine reçoivent un seul e-mail. Il indique ce qui ne va pas et donne exactement les enregistrements à remettre. Dès que le domaine fonctionne de nouveau, ils reçoivent un dernier e-mail. En attendant, l’application reste accessible à sa propre adresse sur kvyk.app.
Un domaine est vérifié pour une seule application à la fois. Pour le déplacer vers une autre application, retirez-le ici et ajoutez-le là. Si l’application d’une autre organisation sur kvyk.ai a le domaine, il passe à la vôtre dès que les enregistrements de cette application ne tiennent plus et que les vôtres sont en place.
Retirer un domaine
Section titled “Retirer un domaine”Choisissez Remove à côté du domaine et confirmez. L’application ne s’y ouvre plus, aussitôt. Vous pouvez ensuite supprimer ses deux enregistrements chez votre fournisseur DNS.
L’ajout, la vérification et le retrait d’un domaine, ainsi qu’un domaine ou son certificat qui ne fonctionne plus puis de nouveau, figurent tous dans le journal des événements.