Servir l'instance sous votre nom de domaine

Quand votre instance de Portail ZAPP est hébergée par son serveur de support, elle peut être servie sous le nom de domaine de votre organisation, par exemple support.exemple.com, au lieu de son seul nom technique. Vous saisissez ce domaine dans l'instance ; le serveur de support vérifie le DNS, émet le certificat et fait le routage.

La page Domaine personnalisé (/licensing/custom-domain, menu Administration, administrateurs) n'est proposée que si l'instance est rattachée en ligne à son serveur de support (page Licences, mode automatique) et que celui-ci propose la fonction. Sinon, la page indique pourquoi la fonction n'est pas disponible.

Ajouter un domaine

Saisissez le nom de domaine, sans https://, sans port ni chemin. Un seul domaine à la fois.
La page affiche l'enregistrement DNS exact à créer chez l'hébergeur DNS de votre domaine : son type (CNAME ou A), son nom et sa valeur.
Créez l'enregistrement, puis cliquez sur Vérifier maintenant. La propagation DNS peut prendre plusieurs heures : vous pouvez revenir plus tard, la vérification se poursuit seule.

Un domaine nu (sans sous-domaine, par exemple exemple.com) demande un enregistrement A, pas un CNAME.

L'instance refuse avant tout envoi un nom invalide, une adresse IP, localhost ou le nom technique lui-même. Le serveur de support refuse de son côté un domaine déjà utilisé par une autre instance ou réservé.

Les états

État	Ce qui se passe
En attente du DNS	L'enregistrement affiché n'est pas encore visible. Créez-le, puis vérifiez.
Activation en cours	DNS vérifié : le certificat et le routage sont en cours. La page se met à jour au prochain passage du suivi (5 minutes au plus).
Actif	Le domaine sert l'instance.
En échec	La cause est indiquée (DNS introuvable ou différent, certificat, routage), avec le détail du serveur. Corrigez, puis Réessayez.
Retrait en cours	Le domaine est en cours de retrait.

À l'activation

L'instance prend d'elle-même le nouveau nom comme adresse publique (App:BaseUrl) : les liens des e-mails et les adresses absolues l'utilisent. Elle ne le fait que lorsque le serveur de support annonce le domaine actif, jamais sur la seule saisie.
Le nom technique reste actif : l'instance répond aussi sous ce nom.
Les utilisateurs doivent se reconnecter sur le nouveau domaine : une session est liée au nom d'hôte. L'ancien nom reste utilisable.
Connexions externes : la page liste chaque fournisseur de connexion configuré (Microsoft 365, Google Workspace, OpenID Connect) avec l'adresse de retour exacte à déclarer chez lui pour le nouveau domaine, par exemple https://support.exemple.com/auth/login/m365/callback dans l'application Entra ID. Déclarez-la en plus de l'actuelle, avant l'activation.
Intégrations externes : mettez à jour celles qui appellent l'instance par son adresse (webhooks, connecteurs, liens enregistrés).

Tant qu'un domaine est géré par cette page, l'adresse publique est en lecture seule dans la configuration (/configuration), avec un lien vers cette page.

Votre propre adresse l'emporte (WEBBASE-3869). Si vous avez saisi une autre adresse publique dans la configuration pendant qu'elle était modifiable (avant la demande, en mode manuel, pendant une indisponibilité du serveur de support), l'instance la garde : elle ne la remplace ni à l'activation ni au retrait, et la clé reste modifiable. La page le signale. C'est l'auteur de la valeur qui compte, pas la valeur elle-même (WEBBASE-3872) : même le nom technique retapé dans la configuration reste votre valeur. Pour rendre la main au domaine personnalisé, cliquez sur Rendre la main au domaine personnalisé dans le bandeau : l'instance écrit aussitôt sa propre valeur (le domaine s'il est actif, sinon le nom technique, en gardant le chemin de base) et la clé repasse en lecture seule. Le geste est inscrit au journal d'audit. Une adresse saisie d'avance qui est exactement le domaine demandé n'est pas « gardée » : l'instance l'adopte à l'activation.

Retirer le domaine

Dans la carte Retirer le domaine, saisissez le domaine pour confirmer. L'instance rétablit aussitôt son nom technique comme adresse publique et le serveur de support retire le routage. Les utilisateurs connectés par le domaine personnalisé devront se reconnecter sous le nom technique.

Historique

Chaque demande, activation, échec et retrait est inscrit au journal d'audit, avec son auteur (l'administrateur qui a retiré le domaine, ou l'instance si le serveur de support l'a retiré), de même que « Rendre la main au domaine personnalisé ».