Domaines

Chaque service expose un domaine par défaut. Vous pouvez y attacher un ou plusieurs domaines custom.

Le domaine par défaut est de la forme <service>-<identifiant>.apps.cassiope.eu. Il est servi en HTTPS : son certificat Let’s Encrypt est émis automatiquement au premier déploiement, puis renouvelé sans action de votre part, et le HTTP redirige vers le HTTPS. Pour une stack, chaque conteneur exposé reçoit le sien : <conteneur>-<stack>-<identifiant>.apps.cassiope.eu.

Note

Pour une stack, seul le conteneur exposé (un seul par stack) peut recevoir un domaine custom — le même flux d’ajout ci-dessous s’applique, depuis l’onglet Domaines de ce conteneur.

Inclus à partir de l’offre Starter

Les domaines personnalisés ne font pas partie de l’offre free. Le formulaire d’ajout reste visible sur l’onglet Domaines, mais grisé et surmonté d’un cadenas qui mène au comparateur d’offres. Votre service reste joignable sur son domaine par défaut.

Ajouter un domaine custom

Il y a deux enregistrements DNS à créer, et ils ne servent pas à la même chose. C’est la confusion la plus fréquente : le premier prouve que le domaine est à vous, le second dirige le trafic. Aucun des deux ne remplace l’autre.

1. Ajouter le hostname (ex. app.exemple.fr) depuis l’onglet Domaines. La plateforme affiche alors l’enregistrement de validation — affiché une seule fois — et l’adresse vers laquelle faire pointer votre domaine.

2. Créer l’enregistrement de validation, tel qu’affiché à l’étape 1 :

   Nom	Type	Valeur
   _acme-challenge.app.exemple.fr	CNAME	<étiquette>.acme.cassiope.eu

   Cet enregistrement est définitif — ne le supprimez pas

   Il ne sert pas qu’à la vérification initiale. C’est lui qui permet le renouvellement automatique de votre certificat, tous les deux mois environ.

   Le retirer une fois le domaine vérifié ne casse rien tout de suite : votre site continue de fonctionner avec le certificat en cours. La panne arrive à l’expiration suivante, des semaines plus tard, sans lien visible avec le geste. C’est le mode de défaillance le plus coûteux à diagnostiquer, d’où cet avertissement.

   Pourquoi une délégation plutôt qu’un jeton à recopier : vous nous confiez un seul sous-domaine technique, celui que l’autorité de certification interroge. Accepter de le déléguer n’est possible qu’à qui administre le domaine — c’est donc en soi la preuve de contrôle. Et comme c’est nous qui publions ensuite la réponse, vous n’avez plus jamais rien à faire, ni à l’émission ni aux renouvellements.

3. Créer l’enregistrement de routage chez votre fournisseur DNS. Deux formes possibles :

   Forme	Valeur	Quand la choisir
   CNAME	le domaine par défaut de votre service	Recommandé : votre domaine suit le service même si son adresse IP change
   A	l’adresse IP affichée par la plateforme	Nécessaire à la racine d’un domaine (exemple.fr), où un CNAME est interdit

4. Vérifier. La plateforme contrôle la délégation, puis demande le certificat SSL.

L’ordre compte

Le certificat est émis par un défi HTTP-01 : l’autorité de certification appelle http://app.exemple.fr/.well-known/acme-challenge/… et cet appel doit atteindre votre service. Le certificat ne peut donc pas être émis tant que l’enregistrement de l’étape 3 n’existe pas et n’a pas propagé — même si la délégation est correcte et le domaine validé.

Si la vérification reste bloquée, c’est presque toujours ce point. Vérifiez d’abord que app.exemple.fr résout bien vers l’adresse indiquée :

dig +short app.exemple.fr

La propagation DNS peut prendre de quelques minutes à quelques heures selon le TTL configuré chez votre fournisseur.

Pour contrôler la délégation elle-même :

dig +short CNAME _acme-challenge.app.exemple.fr

Certificats génériques (*.exemple.fr)

Pas encore émis, mais la délégation ci-dessus est ce qui les rendra possibles : un certificat générique exige un défi DNS-01, que le HTTP-01 actuel ne permet pas. Aucun enregistrement supplémentaire ne vous sera demandé le jour où ils arriveront — celui que vous avez posé suffit. En attendant, déclarez chaque sous-domaine séparément.

Domaines ajoutés avant cette évolution

S’ils ont été validés avec l’ancien enregistrement TXT _cassiope-challenge.<domaine>, ils restent valides et rien n’est à refaire. La délégation ne concerne que les domaines ajoutés depuis.

Note

Le domaine par défaut ne peut pas être supprimé.

Captures d’écran à insérer.