Provisionnement de sous-domaines

Chaque site ou application hébergé sur Inklura est servi en HTTPS sur son propre nom d'hôte : un sous-domaine *.inklura.fr, ou un domaine qui vous appartient. La plateforme s'occupe du DNS des sous-domaines Inklura, des certificats et du routage ; vous n'avez aucun serveur à configurer.

Sous-domaines *.inklura.fr

À la création de votre compte Inklura, l'assistant de configuration vous demande le sous-domaine de votre espace, par exemple ma-boutique.inklura.fr, et vérifie sa disponibilité pendant la saisie. Le nom doit respecter ces règles :

  • de 3 à 63 caractères ;
  • lettres minuscules, chiffres et tirets uniquement, sans tiret au début ni à la fin ;
  • ni déjà utilisé par un autre espace, ni réservé par la plateforme (admin, api, app, auth, billing, manage, onboarding, staging, status, support, www).

Si le nom est pris, l'assistant propose quelques variantes à vérifier. La plateforme ensuite :

  • publie le site sur ce nom d'hôte, sans modification DNS de votre part (tous les sous-domaines *.inklura.fr pointent déjà vers la plateforme) ;
  • le sert en HTTPS avec un certificat qu'elle gère pour vous.

Dans la page Domaines de la console (Réglages > Domaines), le sous-domaine *.inklura.fr porte le badge « Attribué » : il est géré par la plateforme et ne peut pas y être retiré.

Un sous-domaine Inklura est aussi couvert par la politique d'affichage en iframe de la plateforme, voir Intégration iframe.

Votre propre domaine

Pour servir un site sur votre domaine (par exemple www.example.com), ouvrez la page Domaines de la console :

  1. Ajoutez le domaine. Il est rattaché au site en cours de votre espace (chaque ligne de la liste indique son site) et reste inactif tant que le DNS, le certificat HTTPS et le routage ne sont pas validés. Les noms en inklura.fr ne peuvent pas être ajoutés : ils sont gérés automatiquement.
  2. Chez votre bureau d'enregistrement, créez un enregistrement CNAME vers la cible DNS affichée sur la page (un bouton permet de la copier), ou un enregistrement A vers l'adresse IP de cette cible. Un domaine racine comme example.com ne peut en général pas porter de CNAME : utilisez alors l'enregistrement A.
  3. Cliquez sur Vérifier le DNS. La vérification réussit si le CNAME pointe vers la cible, ou si l'adresse IPv4 du domaine est celle de la cible. Le certificat et le routage sont alors préparés, puis le domaine est mis en ligne.

Pendant la préparation, la page s'actualise d'elle-même et affiche l'état du domaine :

État Signification
DNS à vérifier Le domaine est ajouté, la vérification DNS n'a pas encore réussi
En file d'attente DNS vérifié, la préparation va démarrer
HTTPS en préparation Le certificat et le routage sont en cours de mise en place
Prêt / Actif Le domaine sert votre site
À réessayer Une étape a échoué ; le bouton Réessayer relance la préparation
Intervention requise L'échec ne se résoudra pas seul ; l'étape et le message d'erreur sont affichés sous le domaine
Suppression en cours Le retrait du domaine est en cours

Le sous-domaine *.inklura.fr du site reste disponible. Pour détacher un domaine personnalisé, utilisez Retirer sur la même page (le bouton est indisponible tant qu'une préparation est en cours).

Un domaine ne peut être rattaché qu'à un seul site : s'il l'est déjà ailleurs, l'ajout est refusé avec le message « Ce domaine est déjà rattaché à un autre espace ».

Note

La propagation DNS peut prendre de quelques minutes à quelques heures selon votre bureau d'enregistrement. La vérification ne réussit, et le certificat ne peut être émis, qu'une fois la propagation terminée.

Dans votre application

Le domaine se règle dans la console, pas dans le code. Quelques points à respecter dans votre application :

  • URL de rappel. Les URL appelées par la plateforme (handlers de queue, routes du scheduler) doivent se trouver sur une adresse autorisée pour votre application. Ajouter un domaine dans la console ne modifie pas cette liste : gardez l'adresse avec laquelle vos handlers sont déjà enregistrés.
  • Cookies. Chaque nom d'hôte a ses propres cookies. Une session ouverte sur ma-boutique.inklura.fr n'est pas visible depuis www.example.com ; voir Single Sign-On.
  • Liens internes. Préférez les chemins relatifs (/panier) aux URL absolues, pour que le site fonctionne sur tous ses noms d'hôte.

Voir aussi