Documentation Skalin

Configurer votre sous-domaine personnalisé pour le Portail Skalin

# Configurer votre sous-domaine personnalisé pour le Portail Skalin

Guide destiné aux personnes non techniques. Aucune compétence en développement n'est nécessaire : il suffit de copier-coller quelques valeurs chez votre fournisseur de nom de domaine.

# 1. À quoi sert cette manipulation ?

Le Portail Skalin vous permet de partager et de suivre des tâches avec vos propres clients.

Par défaut, votre portail est accessible à une adresse fournie par Skalin, par exemple :

votreentreprise.portal.skalin.io
1

Cette manipulation vous permet de le rendre accessible depuis votre propre nom de domaine, par exemple :

portal.votredomaine.com
1

Vos clients verront donc votre marque dans la barre d'adresse, tout en profitant du portail hébergé par Skalin.

# 2. Comment ça marche, en une phrase

Vous allez créer un alias DNS (appelé « enregistrement CNAME »).

C'est l'équivalent d'un panneau de redirection : quand quelqu'un tape portal.votredomaine.com, le panneau indique discrètement « va chercher le contenu à votreentreprise.portal.skalin.io ». Le visiteur reste sur votre adresse, mais le contenu est servi par Skalin.

   Votre adresse                    Adresse Skalin
portal.votredomaine.com   ───►   votreentreprise.portal.skalin.io
   (ce que voit le client)         (où se trouve réellement le portail)
1
2
3

# 3. Avant de commencer

Vous aurez besoin de :

  1. Un accès à la gestion DNS de votre domaine. C'est l'espace client de l'entreprise chez qui vous avez acheté votredomaine.com (OVH, Gandi, GoDaddy, Cloudflare, IONOS, Google Domains, etc.). On parle parfois de « zone DNS », « gestion des enregistrements » ou « DNS records ».
  2. La valeur cible fournie par Skalin. Nous attribuons à chaque client une cible qui lui est propre et nous vous la communiquons individuellement. Elle ressemble à votreentreprise.portal.skalin.io. Utilisez exactement la valeur que nous vous avons transmise (ne la devinez pas).
  3. Le sous-domaine que vous souhaitez utiliser. Nous recommandons portal.votredomaine.com, mais vous pouvez choisir autre chose (espace, clients, etc.).

::: tip💡 Si vous ne savez pas où acheter/gérer votre domaine, demandez à la personne qui s'occupe de votre site web : c'est généralement elle qui a ces accès. :::

# 4. Les valeurs à saisir (l'étape essentielle)

Dans votre interface DNS, créez un nouvel enregistrement avec exactement ces valeurs :

Champ (les noms varient selon le fournisseur) Valeur à saisir Précisions
Type CNAME À choisir dans la liste déroulante
Nom / Hôte / Host / Subdomain portal ⚠️ Uniquement la partie avant votre domaine. N'écrivez pas portal.votredomaine.com ici.
Cible / Valeur / Pointe vers / Target / Points to votreentreprise.portal.skalin.io La cible nominative que Skalin vous a communiquée (propre à votre compte). Certains fournisseurs exigent un point final : votreentreprise.portal.skalin.io.
TTL Automatique ou 3600 Laissez la valeur par défaut si vous avez un doute

⚠️ À retenir :

Le champ « Nom / Hôte » contient seulement le préfixe (portal), pas le domaine complet. La plupart des fournisseurs ajoutent automatiquement .votredomaine.com.

# 5. Marche à suivre selon votre fournisseur

La logique est toujours la même : ajouter un enregistrement CNAME. Voici où le trouver chez les principaux fournisseurs.

# OVH

  1. Espace client → Noms de domaine → sélectionnez votre domaine.
  2. Onglet Zone DNS → Ajouter une entrée.
  3. Choisissez CNAME, puis renseignez :
    • Sous-domaine : portal
    • Cible : votreentreprise.portal.skalin.io. (avec le point final)
  4. Validez.

# Cloudflare

  1. Sélectionnez votre domaine → onglet DNS → Add record.
  2. Type : CNAME, Name : portal, Target : votreentreprise.portal.skalin.io.
  3. Important : réglez le Proxy status sur DNS only (nuage gris, pas orange). Si le nuage est orange, le certificat SSL ne pourra pas être généré correctement.
  4. Save.

# GoDaddy

  1. My Products → votre domaine → DNS / Manage DNS.
  2. Add → Type : CNAME.
  3. Host/Name : portal — Points to : votreentreprise.portal.skalin.io.
  4. Save.

# Gandi

  1. Votre domaine → Enregistrements DNS → Ajouter.
  2. Type : CNAME, Nom : portal, Valeur : votreentreprise.portal.skalin.io..
  3. Créez.

# IONOS / autres

  1. Cherchez la section DNS ou Gérer les enregistrements.
  2. Ajoutez un enregistrement CNAME avec Hôte = portal et Cible = votreentreprise.portal.skalin.io.

Le vocabulaire change, mais vous cherchez toujours : Type = CNAME, Nom = portal, Cible = l'adresse Skalin.

# 6. Vérifier que tout fonctionne

Après l'enregistrement, la modification doit se propager sur Internet. C'est généralement rapide (quelques minutes à 1 heure), mais cela peut prendre jusqu'à 24 à 48 h dans certains cas.

Pour vérifier sans compétence technique :

  • Rendez-vous sur https://www.whatsmydns.net
  • Saisissez portal.votredomaine.com, sélectionnez le type CNAME, puis lancez la recherche.
  • Si la cible votreentreprise.portal.skalin.io s'affiche, c'est bon ✅.

# 7. Et ensuite ? (côté Skalin)

Une fois le CNAME en place :

  1. Prévenez Skalin que l'enregistrement est créé.
  2. De notre côté, nous générons le certificat SSL pour votre sous-domaine. C'est lui qui active le cadenas 🔒 et le https:// sécurisé. Cette étape ne peut être réalisée qu'après la création du CNAME, car notre système doit pouvoir « voir » votre sous-domaine pointer vers nous.
  3. Votre portail devient pleinement accessible et sécurisé via https://portal.votredomaine.com.

⚠️Ne supprimez jamais le CNAME par la suite.

Il doit rester en place tant que vous utilisez votre sous-domaine personnalisé. S'il est supprimé, le portail devient inaccessible et le certificat SSL ne pourra plus être renouvelé.

# 8. Problèmes fréquents

« Je ne peux pas créer l'enregistrement, il y a un conflit. » Un enregistrement existe peut-être déjà pour portal. Un CNAME ne peut pas cohabiter avec un autre enregistrement portant le même nom. Supprimez l'ancien (ou contactez-nous) avant d'en créer un nouveau.

« Mon navigateur affiche un avertissement de sécurité / pas de cadenas. » C'est normal avant la génération du certificat SSL par Skalin (étape 7). Prévenez-nous que le CNAME est prêt.

« Ça ne marche pas tout de suite. » Patientez : la propagation DNS peut prendre plusieurs heures. Vérifiez l'avancement sur whatsmydns.net.

« Puis-je utiliser mon domaine principal (votredomaine.com) directement, sans sous-domaine ? » Non. Pour des raisons techniques, un CNAME ne peut être posé que sur un sous-domaine (portal.votredomaine.com), jamais sur le domaine racine seul.

# 9. Récapitulatif express

  1. Allez dans la gestion DNS de votre domaine.
  2. Créez un enregistrement CNAME : Nom = portal, Cible = votreentreprise.portal.skalin.io.
  3. (Cloudflare uniquement) Mettez le proxy en DNS only (nuage gris).
  4. Vérifiez la propagation sur whatsmydns.net.
  5. Prévenez Skalin → nous générons le certificat SSL.
  6. Profitez de https://portal.votredomaine.com 🎉

# Besoin d'aide ?

Écrivez-nous à support@skalin.io en indiquant :

  • votre nom de domaine,
  • le sous-domaine choisi,
  • une copie d'écran de votre enregistrement DNS si possible.

Nous nous occupons du reste côté infrastructure.

Contributeurs: CAMILLE_PRO\camil