Studio

Domaines personnalisés

Avec un domaine personnalisé, votre page de destination, vos pages légales, votre kit de presse, vos codes QR et vos liens profonds sont servis depuis un domaine qui vous appartient, comme get.habitly.app, avec HTTPS configuré pour vous. Les domaines personnalisés font partie du forfait Studio, qui inclut jusqu'à 25 domaines par espace de travail. Les propriétaires et les administrateurs de l'espace de travail peuvent les ajouter.

Ce que sert un domaine personnalisé

Chaque domaine est associé à une application :

URL	Sert
`https://get.habitly.app/`	La page de destination
`/go/{store}`	Une redirection avec suivi vers un store, comme `/go/google_play`
`/open/{path}`	Les liens profonds
`/privacy`, `/terms`	La politique de confidentialité et les conditions d'utilisation, avec `/{language}` en option
`/press`, `/press.zip`	Le kit de presse
`/qr.svg`, `/qr.png`	Le code QR
`/.well-known/apple-app-site-association` `/.well-known/assetlinks.json`	Les fichiers d'association pour les Universal Links et les Android App Links

La racine affiche la page de destination à tout le monde. Contrairement à mapps.one/habitly, elle ne redirige pas les téléphones vers un store. Utilisez le lien intelligent si vous voulez une détection de l'appareil, ou get.habitly.app/go/app_store si vous voulez un store précis. Les URL du lien intelligent et du code QR affichées dans le tableau de bord et dans l'API continuent d'utiliser mapps.one.

Avant de commencer

Utilisez un sous-domaine, comme get., download. ou app.. La norme DNS n'autorise pas les enregistrements CNAME sur un domaine racine comme habitly.app.
Vous devez avoir accès aux paramètres DNS du domaine, chez votre registraire ou votre fournisseur DNS.
Un domaine ne peut être connecté qu'une seule fois sur l'ensemble de mapps.one.

1. Ajouter le domaine

Dans le tableau de bord, ouvrez Domaines, choisissez Ajouter un domaine, saisissez get.habitly.app et choisissez l'application qu'il doit servir. Le tableau de bord affiche ensuite les enregistrements DNS à créer, dont un jeton de vérification propre à votre domaine.

2. Créer les enregistrements DNS

Type	Nom	Valeur	Rôle
TXT	`_mapps-verify.get.habitly.app`	`mapps-verify=your-token`	Prouve que vous contrôlez le domaine
CNAME	`get.habitly.app`	`domains.mapps.one`	Envoie le trafic vers mapps.one

Si votre fournisseur DNS ne peut pas créer d'enregistrement CNAME pour ce nom, créez à la place un enregistrement A qui pointe vers l'adresse IP affichée dans le tableau de bord.

De nombreux fournisseurs DNS ajoutent automatiquement votre domaine racine. Dans ce cas, saisissez uniquement la partie qui le précède : _mapps-verify.get pour l'enregistrement TXT et get pour l'enregistrement CNAME.

Vous utilisez Cloudflare ? Réglez l'enregistrement CNAME sur DNS uniquement (nuage gris). Si l'enregistrement passe par le proxy, le certificat ne peut pas être émis et les visiteurs voient une erreur.

3. Vérifier

Choisissez Vérifier maintenant à côté du domaine. Nous contrôlons l'enregistrement TXT et la cible vers laquelle pointe le domaine. Les domaines en attente sont aussi vérifiés automatiquement toutes les 10 minutes, vous pouvez donc fermer la page et revenir plus tard. Les modifications DNS apparaissent généralement en quelques minutes, mais certains fournisseurs mettent quelques heures.

Statut	Signification
En attente	Les enregistrements DNS ne sont pas encore visibles
Vérifié	Le domaine sert votre application
Échoué	Un enregistrement est manquant ou incorrect. Le tableau de bord en indique la raison. Corrigez l'enregistrement et lancez une nouvelle vérification.

Un webhook domain.verified est envoyé lorsque la vérification réussit.

HTTPS

Un certificat TLS est émis automatiquement la première fois qu'une personne ouvre le domaine en HTTPS après sa vérification. Cette première requête peut prendre quelques secondes, les suivantes sont rapides. Vous n'avez rien à envoyer ni à renouveler.

Dépannage

Vérifiez ce que voit le reste du monde avec dig, ou avec n'importe quel outil de recherche DNS en ligne :

dig +short TXT _mapps-verify.get.habitly.app
"mapps-verify=your-token"

dig +short CNAME get.habitly.app
domains.mapps.one.

Le nom apparaît en double, comme dans get.habitly.app.habitly.app : votre fournisseur a ajouté le domaine racine. Saisissez uniquement get.
Un autre enregistrement existe pour le même nom, comme un ancien enregistrement A. Supprimez-le, car un CNAME ne peut pas partager son nom avec d'autres enregistrements.
Un proxy ou un CDN en amont : passez l'enregistrement en DNS uniquement.
Des enregistrements CAA sur votre domaine qui n'autorisent qu'une autorité de certification précise peuvent bloquer le certificat. Supprimez-les ou complétez-les.

Retirer un domaine

Supprimez le domaine dans le tableau de bord, puis supprimez les enregistrements DNS chez votre fournisseur. Si l'espace de travail quitte le forfait Studio, ses domaines personnalisés cessent de servir des pages jusqu'à ce que vous repassiez à ce forfait. Les liens sur mapps.one continuent de fonctionner.