Domaine personnalisé

Par défaut, votre application est servie sur un sous-domaine *.onkavio.fr. Vous pouvez y brancher votre propre nom de domaine.

1. Ajoutez le domaine

Dans la section Domaine personnalisé, saisissez votre domaine (par exemple api.mon-entreprise.com). Elle se trouve :

• sur la page de votre projet, pour un dépôt importé ;
• dans « Paramètres du site » → Mise en ligne, pour un site Magikio. Le réglage n'y apparaît qu'une fois le site publié au moins une fois : brancher un domaine sur un site qui n'est pas encore en ligne activerait une adresse que rien ne sert.

2. Configurez le DNS

Chez votre fournisseur de domaine, créez un enregistrement CNAME qui pointe votre domaine vers :

cname.kavio.fr

Cas du domaine racine

Un CNAME ne peut pas être posé sur un domaine racine (mon-entreprise.fr sans rien devant) : la plupart des fournisseurs le refusent, et la norme DNS l'interdit à côté des enregistrements du domaine.

Pointez donc www.mon-entreprise.fr avec le CNAME ci-dessus, puis ajoutez chez votre fournisseur une redirection du domaine racine vers www. C'est une option courante, proposée notamment par OVH et Gandi. Déclarez ensuite www.mon-entreprise.fr dans Kavio.

3. Vérifiez

De retour sur Kavio, cliquez sur Vérifier. Kavio contrôle que le CNAME pointe bien vers cname.kavio.fr.

Tant que le domaine n'est pas vérifié, votre application reste servie sur son sous-domaine *.onkavio.fr : la bascule ne se fait qu'une fois la preuve DNS établie.

Certificat TLS

Une fois le domaine vérifié, le certificat HTTPS est émis automatiquement — aucune action de votre part.

La propagation DNS peut prendre de quelques minutes à quelques heures selon votre fournisseur. Si la vérification échoue, patientez puis réessayez.