Aller au contenu

Personnalisation · Guide pratique

Domaines personnalisés

Connectez et vérifiez un domaine de marque pour votre portail.

Un domaine personnalisé diffuse le portail Kokobi de votre organisation depuis un nom d'hôte que vous contrôlez, comme formation.example.com. Il fournit aussi le contexte d'organisation utilisé par les pages de marque, l'authentification, les liens et la configuration des courriels.

Chaque organisation peut avoir un domaine personnalisé. Un même nom d'hôte ne peut pas être attribué à plusieurs organisations.

Avant de commencer

Vous avez besoin :

  • De la permission de gérer l'organisation.
  • D'un accès au fournisseur DNS du nom d'hôte.
  • D'un sous-domaine valide comme formation.example.com.

Kokobi exige actuellement un sous-domaine dédié. Les domaines racines comme example.com ne sont pas acceptés.

Ajouter un domaine

  1. Ouvrez Administration > Domaines.
  2. Saisissez le nom d'hôte complet, sans https:// ni chemin.
  3. Créez le domaine.
  4. Kokobi affiche les enregistrements DNS nécessaires au routage, à l'authentification et aux courriels.
  5. Ajoutez ces enregistrements exactement comme affichés chez votre fournisseur DNS.
  6. Revenez à la page du domaine et actualisez-la jusqu'à ce que le domaine devienne ACTIVE.

Le domaine reste PENDING tant que le nom d'hôte de routage n'est pas vérifié. Les enregistrements DNS de courriel sont vérifiés séparément et ne bloquent pas l'activation du portail.

Enregistrements DNS

Copiez toujours les noms, valeurs et priorités depuis le tableau de Kokobi. Les valeurs exactes sont générées pour votre nom d'hôte.

Vous pouvez voir :

  • Un CNAME obligatoire qui dirige le nom d'hôte du portail vers Kokobi.
  • Des CNAME DKIM qui vérifient la signature des courriels.
  • Un enregistrement MX et un TXT SPF pour le chemin de retour des courriels.
  • Un enregistrement TXT DMARC facultatif.

Les fournisseurs DNS diffèrent : certains attendent un nom relatif au domaine racine, tandis que d'autres demandent le nom d'hôte complet. Utilisez les noms affichés par Kokobi et vérifiez la convention de votre fournisseur avant d'ajouter le suffixe du domaine racine.

Ne copiez pas les guillemets d'une valeur TXT sauf si votre fournisseur les exige. N'activez pas le proxy ni l'aplatissement du CNAME de routage à moins de savoir que votre fournisseur préserve la vérification du nom d'hôte personnalisé.

Vérification et activation

La propagation des changements DNS peut prendre du temps. Kokobi vérifie le nom d'hôte de routage et l'identité de courriel, puis affiche un statut pour chaque ligne :

  • SUCCESS signifie que l'enregistrement a été vérifié.
  • MISSING ou un autre statut en attente signifie que la vérification n'est pas terminée.
  • OPTIONAL désigne un enregistrement recommandé qui ne bloque pas l'activation du portail.

Le domaine devient actif lorsque le nom d'hôte de routage est actif. TLS est généré pour ce nom d'hôte; aucun certificat ne doit être téléversé dans Kokobi.

La vérification des courriels peut se terminer séparément de l'activation du portail. Conservez tous les enregistrements DKIM, MX et SPF obligatoires afin que l'envoi des notifications de marque continue de fonctionner.

Tester le domaine

Après l'activation :

  1. Ouvrez le nom d'hôte en HTTPS.
  2. Confirmez que la page d'accueil de l'organisation se charge.
  3. Connectez-vous et ouvrez les espaces Administration et Apprenant.
  4. Testez un lien d'accès à un cours ou une collection généré pour ce domaine.
  5. Envoyez une notification et vérifiez sa marque et sa livraison.
  6. Vérifiez les personnalisations de marque blanche en modes clair et sombre.

Dépannage

Le CNAME reste en attente

  • Confirmez que le nom de l'enregistrement correspond au bon nom d'hôte.
  • Confirmez que la valeur correspond exactement au tableau du domaine.
  • Désactivez temporairement le proxy DNS s'il masque la cible CNAME.
  • Supprimez les enregistrements A, AAAA ou CNAME incompatibles portant le même nom.
  • Attendez l'expiration du TTL, puis actualisez la page du domaine.

Les enregistrements de courriel restent en attente

  • Vérifiez chaque enregistrement DKIM; plusieurs jetons peuvent être générés.
  • Confirmez que la priorité MX correspond à la valeur affichée dans Kokobi.
  • Confirmez que le TXT SPF est associé au sous-domaine de courriel affiché.
  • Recherchez des guillemets ajoutés par le fournisseur ou un suffixe de domaine dupliqué.

Supprimer ou remplacer un domaine

La suppression d'un domaine retire sa configuration de routage et de courriel de Kokobi. Les anciens liens d'invitation, de partage et d'achèvement utilisant ce nom d'hôte cesseront de fonctionner.

Pour remplacer un domaine, relevez les endroits où l'ancien nom est utilisé, supprimez-le de Kokobi, ajoutez le nouveau nom, publiez les nouveaux enregistrements DNS et mettez à jour les liens externes. Conservez des redirections dans votre propre infrastructure lorsque cela est possible.

Guides connexes