Aller au contenu
quest'n'click

Clever CloudGuidePour adminsS'applique de 4.2.3

Domaines et TLS

This page in EnglishCette page sur le wiki GitHub

Le Studio et son jeu ont besoin de deux origines, et ce doivent être deux sous-domaines d’un domaine à vous. Cette page les donne à l’application studio, donne son propre nom au worker, et dit pourquoi des noms en *.cleverapps.io ne suffisent pas.

Ce que vous obtenez

Trois noms en HTTPS, tous sous votre domaine : studio.exemple.fr (le Studio et son API, publicUrl) et play.exemple.fr (le jeu, playUrl), servis tous deux par l’application studio, et worker.exemple.fr (worker.url) servi par l’application worker.

Contexte et versions

  • Un Studio hébergé sur Clever Cloud, à partir de la 4.2.3.
  • Vérifié sur : non vérifié sur une installation réelle pour cette page. Deux noms sur une même application, routés par Host, ont été confirmés par le spike S le 17 octobre 2026, et le déploiement de référence du 19 octobre 2026 a tourné avec trois noms en *.cleverapps.io. Personne n’a encore déployé le Studio sur un domaine à soi en le consignant : la passe studio-hosted (« un domaine TLS ») est not-run pour la 4.4.0.

Prérequis

Où lancer les commandes

clever … : sur votre machine, dans le dépôt du moteur où les deux applications sont liées sous leur alias. Les enregistrements DNS : chez votre fournisseur DNS.

Étapes

  1. Donnez à l’application studio ses deux noms, et au worker le sien :

    # sur votre machine, dans le dépôt du moteur
clever domain add studio.example.fr --alias my-game-studio
clever domain add play.example.fr --alias my-game-studio
clever domain add worker.example.fr --alias my-game-worker
  1. Chez votre fournisseur DNS, faites pointer chaque nom vers Clever Cloud avec l’enregistrement que la console de Clever affiche sur la page des noms de domaine de l’application (pour un sous-domaine, un CNAME). Clever Cloud le sert ensuite en HTTPS avec un certificat qu’il obtient lui-même ; ce projet n’a pas mesuré combien de temps cela prend.
  1. Écrivez les mêmes noms dans la configuration : publicUrl, playUrl et worker.url (Configuration). Le serveur n’en garde que l’origine, et refuse de démarrer quand publicUrl et playUrl sont la même origine (« playUrl must be another origin than publicUrl »).

Pourquoi deux sous-domaines d’un même domaine

Le jeu tourne dans un cadre du Studio, sur playUrl, derrière son propre cookie de session (Secure; HttpOnly; SameSite=None; Partitioned). Avec deux sous-domaines de votre domaine, le Studio et le jeu sont un seul site, et le cadre garde son cookie dans tous les navigateurs.

cleverapps.io figure dans la Public Suffix List (une entrée privée, celle de Clever Cloud) : studio-x.cleverapps.io et play-x.cleverapps.io sont deux sites. Le cookie du jeu ne vit alors dans un cadre d’un autre site que parce qu’il est partitionné (CHIPS) :

Résultat attendu, et comment le vérifier

  • clever domain --alias my-game-studio liste les deux noms ; clever domain --alias my-game-worker liste celui du worker.
  • Une fois déployé (Premier déploiement), https://studio.exemple.fr/livez répond {"ok":true} avec un certificat valide, et https://play.exemple.fr/ répond 401 (« open the game from the Studio ») : l’origine du jeu refuse toute requête sans la session du jeu.
  • Dans le Studio, la vue de la pièce et l’onglet Jouer montrent le jeu.

Erreurs fréquentes

SymptômeCauseCorrection
playUrl must be another origin than publicUrl (plan §6.1) au démarrageLe même nom aux deuxDeux noms, studio. et play.
Les cadres du jeu restent vides dans un navigateurDeux sites (*.cleverapps.io), ou WebKit sous LinuxDeux sous-domaines d’un même domaine ; voir Dépannage
Une erreur de certificatL’enregistrement DNS ne pointe pas encore vers Clever CloudVérifiez l’enregistrement ; attendez la propagation

Fichiers ou données modifiés

Les listes de domaines des applications chez Clever Cloud, votre zone DNS, et ensuite les URL de la configuration.

Reprise ou retour arrière

clever domain rm <nom> --alias <application> retire un nom. Changer les noms d’un Studio en service, c’est Changer de domaine ou de fournisseur OIDC : les URI de redirection du fournisseur changent avec eux.

Références