Aller au contenu principal

Utiliser votre propre domaine

Objectif​

Servir votre portail à une adresse qui appartient à votre organisation — portal.acme.com — à la place de l’adresse que votre installation Parsware lui a attribuée, ou en plus de celle-ci.

Avant de commencer​

Il vous faut deux choses, et aucune ne se trouve dans Parsware :

  1. Un domaine que vous contrôlez, et quelqu’un qui peut ajouter des enregistrements à son DNS. Dans beaucoup d’organisations, ce n’est pas la personne qui construit le portail : mieux vaut donc demander tôt, car le délai entre la demande d’un enregistrement DNS et son obtention se compte généralement en jours.
  2. Un enregistrement CNAME qui fait pointer le nom choisi vers votre installation Parsware. Demandez à la personne qui gère votre installation quelle doit être la cible — c’est l’adresse à laquelle votre portail répond déjà, celle qui figure dans la zone Adresse web.

Étapes​

  1. Ouvrez votre solution, choisissez Portails, puis ouvrez le portail.

  2. Sous Vos propres domaines, appuyez sur Ajouter un domaine et saisissez le nom complet qu’un visiteur taperait — portal.acme.com, pas acme.com et pas https://portal.acme.com.

  3. Appuyez sur Enregistrer. C’est l’étape qui compte : l’enregistrement que vous devez publier n’existe pas tant que le domaine n’est pas enregistré, car il contient un code créé pour ce portail et ce domaine.

  4. Rouvrez le portail. Sous le domaine, vous voyez maintenant un enregistrement TXT — un nom et une valeur.

  5. Demandez à votre administrateur DNS de publier exactement cet enregistrement. Il se présente ainsi :

    TypeTXT
    Nom_parsware-verification.portal.acme.com
    Valeurparsware-domain-verification= suivi de votre code

  6. Appuyez sur Vérifier maintenant. Si l’enregistrement s’est propagé, le domaine passe à Vérifié et l’adresse commence à répondre. Sinon, l’écran l’indique et retient que nous avons regardé — ce n’est pas une erreur, c’est la réponse, et c’est la réponse habituelle pendant les premières minutes. Réappuyez plus tard ; une modification DNS peut mettre un certain temps à nous parvenir, et vérifier aussi souvent que vous le souhaitez ne coûte rien.

Pourquoi vous devez le prouver​

Toute personne autorisée à modifier un portail peut saisir n’importe quel domaine dans cette zone. Si la saisie suffisait, une personne pourrait faire pointer le portail d’un collègue — ou celui d’un tout autre client — vers un nom sur lequel elle n’a aucun droit, et la plateforme obtiendrait un certificat pour ce nom et commencerait à le servir.

Un domaine est donc une revendication tant qu’il n’est pas prouvé, et une revendication ne fait rien du tout :

  • Il ne répond pas. Le visiter n’aboutit à rien, quoi que dise votre DNS.
  • Aucun certificat n’est obtenu pour lui : un navigateur envoyé là-bas affiche donc un avertissement de sécurité plutôt que votre portail.
  • Il n’apparaît nulle part comme adresse, et un portail sans autre adresse ne peut pas être Publié.

Seule une personne capable de publier un enregistrement dans un domaine peut prouver qu’elle le contrôle, et c’est exactement la question à laquelle il faut répondre.

Deux personnes peuvent revendiquer le même domaine. Une seule peut le prouver.

Contrairement à la zone Adresse web — où un nom est pris dès que quelqu’un l’enregistre, car l’installation possède ces noms — un domaine qui vous appartient est arbitré par le DNS. Deux portails peuvent tous deux lister portal.acme.com, et c’est celui dont le code est réellement publié qui l’obtient. C’est voulu : refuser la seconde revendication permettrait à quiconque a saisi un nom en premier d’empêcher son véritable propriétaire d’accéder à son propre domaine.

Une fois qu’un domaine est vérifié pour un portail, aucun autre portail ne peut le vérifier. Pour déplacer un domaine, retirez-le du portail qui le détient, enregistrez, puis vérifiez-le sur l’autre.

Ce qui peut mal se passer​

« Aucune preuve n’a été trouvée. » L’enregistrement n’est pas encore là, ou il ne correspond pas. Vérifiez trois choses, dans cet ordre : que le nom commence par _parsware-verification. (le trait de soulignement compte — un simple enregistrement TXT sur portal.acme.com ne peut pas coexister avec le CNAME), que la valeur est la chaîne entière, partie parsware-domain-verification= comprise, et que suffisamment de temps s’est écoulé.

« Nous n’avons pas pu consulter… » Celle-là vient de nous, pas de vous. Votre DNS va bien ; notre requête n’a pas obtenu de réponse. Réessayez dans quelques minutes.

Le domaine est vérifié mais la page ne se charge pas. La vérification prouve que le nom est le vôtre ; elle ne le fait pas pointer vers nous. Vérifiez le CNAME.

Cela a cessé de fonctionner après que quelqu’un a modifié le portail. Retirer un domaine de la liste retire aussi sa preuve. Le rajouter constitue une nouvelle revendication avec un nouveau code : l’ancien enregistrement TXT ne correspondra donc plus — publiez le nouveau.

Quelle adresse les liens utilisent-ils ?​

Lorsque la plateforme doit construire un lien elle-même — un e-mail de confirmation d’inscription, une invitation — elle utilise l’Adresse web attribuée par votre installation, de préférence à un domaine qui vous appartient. Cette adresse fonctionne toujours. Votre propre domaine n’est utilisé pour ces liens que lorsque le portail n’a aucune adresse de plateforme, et seulement une fois vérifié.

Voir aussi​