Domaine personnalisé et validation
Domaine personnalisé et validation
Configurer, valider et dépanner un domaine pour la vitrine publique
Apprenez pas-à-pas comment ajouter un domaine personnalisé, configurer les enregistrements DNS requis, comprendre la validation automatique et corriger les erreurs les plus courantes.
Introduction Ce guide couvre tout ce dont vous avez besoin pour connecter un nom de domaine à la vitrine publique de votre projet : procédure d’ajout, exigences DNS (CNAME / A / TXT), validation et règles d’unicité (un domaine ne peut être utilisé que par un seul projet). Vous trouverez aussi des workflows complets pour éditer le branding, scrapper un site pour récupérer la charte graphique et intégrer le messenger public pour la gestion des tickets. Enfin, une section détaillée explique comment résoudre les erreurs fréquentes lors de la validation.
Ajouter et lancer la validation d'un domaine personnalisé
1. Aller aux paramètres du site
Ouvrez Paramètres > Site (ou Site public & Branding) depuis le tableau de bord de votre projet.
2. Trouver la section 'Domaine personnalisé'
Dans la section Domaine personnalisé, cliquez sur “Ajouter le domaine” ou saisissez le nom de domaine souhaité (ex. www.example.com ou example.com).
3. Choisir le type de domaine (sous-domaine vs domaine racine)
- Pour un sous-domaine (ex. www.example.com) : préférez un enregistrement CNAME.
- Pour un domaine racine/apex (ex. example.com) : votre fournisseur DNS doit supporter ALIAS/ANAME ou fournir des enregistrements A vers les adresses indiquées par l’interface.
4. Soumettre et récupérer les instructions DNS
Après l’ajout, l’interface affiche les enregistrements DNS exacts que vous devez créer chez votre registrar (ex. CNAME, TXT pour vérification, éventuellement A). Copiez-les précisément.
5. Ajouter les enregistrements chez votre fournisseur DNS
Connectez-vous chez votre registrar/fournisseur DNS et créez les enregistrements indiqués (type, nom/host, valeur/target, TTL recommandé). Sauvegardez les modifications.
6. Lancer la vérification automatique
Retournez dans l’interface du projet et cliquez sur “Actualiser” ou “Vérifier” pour démarrer la validation. Le système vérifie automatiquement les enregistrements DNS et la présence des jetons de validation.
7. Attendre la propagation et le statut 'Actif'
Patientez jusqu’à obtention du statut “Actif”. La propagation DNS peut prendre de quelques minutes à 48 heures selon le TTL et le fournisseur.
Ne laissez pas Cloudflare en mode proxy pendant la validation
Si vous utilisez Cloudflare, mettez l’enregistrement en mode DNS only (nuage gris) avant la validation. Le mode proxy (nuage orange) masque les valeurs réelles et empêche la vérification.
Configuration DNS requise (détails pratiques)
CNAME (sous-domaine)
Nom/Host : www (ou le sous-domaine choisi)
Type : CNAME
Valeur/Target : la cible fournie dans l’interface (copier-coller)
TTL : 300–3600s recommandé
Note : assurez-vous qu’aucun autre enregistrement A/AAAA n’existe pour ce même nom.
A / ALIAS / ANAME (domaine racine/apex)
Si vous voulez l’apex (example.com) :
- Préférez ALIAS/ANAME si votre fournisseur le propose.
- Sinon, créez les enregistrements A fournis (les IP indiquées) chez votre registrar.
TTL : 300–3600s recommandé.
Enregistrement TXT pour la vérification de propriété
Type : TXT
Nom : souvent une valeur fournie (ex. _deployit-verif.example.com) ou @ selon instructions
Valeur : jeton unique affiché dans l’interface
But : prouver que vous contrôlez le domaine. La vérification ne fonctionnera pas si le jeton est incorrect ou absent.
Enregistrement TXT pour validation SSL (si demandé)
Parfois, un TXT additionnel est demandé pour la validation SSL : suivez strictement la clé et le nom fournis par l’interface.
Que fait la validation automatique et combien de temps cela prend ?
Détection
Le système interroge publiquement le DNS pour vérifier la présence des enregistrements CNAME/A et des TXT de validation.
SSL / HTTPS
Si tout est correct, un certificat SSL est demandé et la validation SSL complète peut nécessiter quelques minutes supplémentaires.
Statut final
Statuts courants : En attente (Pending), Actif (Active), Erreur (Errors). Une fois Actif, la vitrine répondra sur le domaine configuré.
Sous-domaine (ex. www.example.com)
- Recommandé pour la simplicité.
- Insérer un CNAME vers la cible indiquée + TXT de vérification.
- Watchout : supprimez tout enregistrement A pour le même sous-domaine avant d’ajouter un CNAME.
Domaine racine / apex (ex. example.com)
- Nécessite ALIAS/ANAME ou enregistrements A fournis.
- La validation SSL prend parfois plus de temps.
- Si votre fournisseur ne propose pas ALIAS, utilisez les A fournis ou redirigez l’apex vers www côté registrar si possible.
Utilisation de CDN/proxy (Cloudflare, etc.)
- Désactivez le proxy (DNS only) pendant la validation.
- Une fois Actif, vous pouvez réactiver le proxy si nécessaire, mais vérifiez le comportement HTTPS/redirects.
Avant validation (Statut : En attente)
- Le domaine peut ne pas répondre.
- Le certificat SSL n’est pas encore émis.
- Certaines fonctions dépendantes du domaine sont désactivées.
Après validation (Statut : Actif)
- Le domaine dessert la vitrine publiquement.
- Certificat SSL valide et HTTPS activé.
- Le messenger intégré et les redirections fonctionnent normalement.
Résolution des erreurs fréquentes lors de la validation
Erreur : Enregistrements introuvables
Vérifications : TTL trop long, enregistrements ajoutés mais non publiés. Attendre la propagation et vérifier avec un outil DNS public. Confirmez que vous avez ajouté le bon type (CNAME vs A) et la bonne cible.
Erreur : Jeton TXT non trouvé / mismatch
Vérifiez que la valeur TXT est exacte (pas d’espaces en début/fin) et que le nom du record correspond aux instructions (parfois _deployit… ou @). Supprimez les anciennes valeurs en conflit.
Erreur : Domaine déjà utilisé
Message indiquant que le domaine est déjà lié à un autre projet : vous devez d’abord supprimer le domaine du projet actuel qui l’utilise, puis l’ajouter à ce projet. Un même domaine ne peut être attribué qu’à une seule vitrine de projet.
Erreur : Validation bloquée par le proxy CDN
Si vous utilisez un CDN/proxy (Cloudflare, etc.), mettez l’enregistrement en mode DNS only (desactivez le proxy) durant la validation. Réactivez le proxy seulement une fois la validation terminée et testée.
Erreur : SSL non émis
Attendre quelques minutes et réessayer la vérification. Assurez-vous que les enregistrements TXT requis existent et que le domaine répond correctement sur HTTP/HTTPS. Si le problème persiste, rafraîchissez la configuration côté DNS (suppressions/ajouts) puis relancez la vérification.
Dernier recours : supprimer et ré-ajouter
Si la validation reste bloquée, supprimez le domaine depuis l’interface, supprimez les enregistrements DNS erronés chez le registrar, attendez la propagation, puis recommencez l’ajout en suivant scrupuleusement les instructions.
Règles d'unicité et gestion des conflits de domaines
La règle d'unicité
Un domaine personnalisé ne peut être utilisé que par un seul projet à la fois. Si vous tentez d’ajouter un domaine déjà pris, l’interface affichera une erreur et empêchera la validation.
Transférer un domaine entre projets
- Supprimez d’abord le domaine du projet qui le détient.
- Attendez la propagation de la suppression (quelques minutes à quelques heures selon le TTL).
- Ajoutez ensuite le domaine au nouveau projet et suivez la procédure de validation.
Cas particulier : domaines partagés ou wildcard
Les domaines wildcard ou partagés peuvent nécessiter des étapes spécifiques et doivent être validés individuellement selon les contraintes du fournisseur DNS. Contactez le support si vous utilisez des configurations avancées.
Éditer le branding du site (titre, couleurs, footer_links) — workflow rapide
1. Ouvrir Paramètres > Site
Accédez aux paramètres du site dans votre projet.
2. Modifier les champs clefs
Éditez le nom du site, les couleurs (primaire, accent, arrière-plan, texte) et les liens du pied de page (footer_links). Chaque champ offre un aperçu en temps réel.
3. Sauvegarder
Cliquez sur “Enregistrer” ou “Save”. Un message de confirmation s’affiche (ex. “Enregistré !”). Les modifications s’appliquent à la vitrine publique une fois sauvegardées.
Scraper le branding depuis une URL (détection automatique)
1. Ouvrir l'outil de détection automatique
Dans Paramètres > Site, section “Détection automatique depuis le site web”, saisissez l’URL publique à analyser.
2. Lancer le scraping
Cliquez sur “Détecter” (ou “Scrape”). L’opération est asynchrone : elle peut prendre quelques instants et n’est pas garantie de réussir selon le site cible.
3. Revue et intégration
Quand le résultat est prêt, l’interface propose les couleurs, logo, polices et autres éléments extraits. Vous pouvez intégrer automatiquement ces valeurs dans le formulaire ou les copier manuellement.
4. Ajuster et sauvegarder
Ajustez les valeurs importées si nécessaire (contrastes, noms, liens) puis sauvegardez le branding.
Gérer les tickets publics et intégrer le messenger sur un site externe
1. Configurer les contacts de réception
Dans les paramètres du projet, définissez les adresses email ou contacts qui doivent recevoir les tickets envoyés depuis le formulaire public.
2. Intégrer le snippet du messenger
L’interface fournit un petit snippet HTML/JS à coller juste avant la balise