Projet et domaines

Nom du projet, sous-domaines de marque et zone de suppression destructive.

Paramètres du projet

Onglet “Paramètres” : à gauche “Accueil”, “Sous-domaines”, “Domaines personnalisés”, “Clés API” et accès équipe.

1. Ouvrir “Paramètres”.
2. Sur “Accueil”, modifier le nom et la description du projet.
3. Enregistrer les modifications dans l’en-tête / le formulaire.

Paramètres du projet : nom, description, suppression.

Sous-domaines

Un sous-domaine donne une adresse du type https://name.<service-domain>/…. Les sous-domaines appartiennent au compte et peuvent être utilisés entre projets.

1. “Paramètres” → “Sous-domaines” → “+ Sous-domaine”.
2. Saisir un nom → “Créer”.
3. Dans le créateur de lien, sélectionner ce sous-domaine.

• Badges : “ici” — utilisé par des liens du projet actuel ; “ailleurs” — dans d’autres projets ; “supprimé · peut restaurer” — suppression logique.
• Après suppression d’un sous-domaine, les liens dessus cessent de fonctionner ; la carte affiche “Sous-domaine supprimé”.
• “Restaurer” ramène le sous-domaine ; les liens refonctionnent sauf ceux désactivés manuellement.

Liste des sous-domaines et création.

ATTENTION : “Supprimer le sous-domaine” interrompt immédiatement les URL publiques sur ce nom jusqu’à restauration. Vérifiez d’abord quels liens en dépendent.

Domaines personnalisés

Votre propre FQDN (par exemple go.company.eu) à la place d’un sous-domaine de zone de service. Après preuve de propriété TXT et un CNAME générique, les liens s’ouvrent sur votre domaine.

1. “Paramètres” → “Domaines personnalisés” → “+ Domaine” → saisir le FQDN sans https://.
2. Dans le DNS, ajouter l’enregistrement TXT de propriété (étape 1 du guide).
3. Ajouter un CNAME pour le motif `*.your-zone` → l’edge de redirection du service (étape 2).
4. Cliquer sur “Vérifier le DNS”. Quand le statut est “Actif”, choisir le domaine dans le créateur de lien.

Section “Domaines personnalisés” : liste, statuts, “+ Domaine”.

Étape 1 — propriété (TXT). Un enregistrement TXT est requis. Host est généralement `_urlshortener.{your-domain}` (certains registrars veulent seulement `_urlshortener` dans Name, sans la zone). Value : `urlshortener-verify=<token>` depuis le guide. TTL : 300–3600.

Panneau DNS : ajout du TXT `_urlshortener…` avec le jeton du guide.

Étape 2 — routage (CNAME). Un CNAME sur l’apex (`@`) n’est pas autorisé chez la plupart des registrars. Utilisez un motif : Host `*.company.eu` → Value `edge.kkoroch.ru` (l’hôte exact est dans le guide). Le motif couvre go.company.eu et les autres sous-domaines de la zone. Si vous enregistrez l’apex (company.eu), vous pouvez aussi avoir besoin de A/ALIAS sur `@` — voir l’indication dans l’application.

Panneau DNS : CNAME générique `*.zone` vers l’edge de redirection.

• Sous-domaine de service et domaine personnalisé sont mutuellement exclusifs pour un même lien.
• Statuts : “En attente de TXT” → “CNAME requis” → “Actif”. Seul Actif peut être sélectionné dans le créateur.
• Supprimer un domaine désactive les liens dessus (statut “Domaine supprimé”).
• La limite de domaines personnalisés dépend du plan (souvent 0 sur FREE+).
• Entre les vérifications DNS — pause d’environ 15 s.

Domaine au statut “Actif” après une vérification DNS réussie.

ATTENTION : Les enregistrements DNS prennent souvent effet avec un délai (minutes, parfois heures à cause du TTL et du cache des résolveurs). Si après “Vérifier le DNS” le statut n’est pas encore “Actif” — attendez et réessayez ; réenregistrer les enregistrements est généralement inutile.

ATTENTION : Vous ne pouvez pas enregistrer le motif `*.company.eu` comme domaine personnalisé lui-même — seulement un FQDN concret. L’enregistrement de routage est un CNAME générique distinct chez votre registrar.

Après activation, choisir le domaine sous “Domaines personnalisés” dans le créateur de lien. L’URL publique ressemble à https://go.company.eu/promo.

Clés API

“Clés API” permet d’émettre des clés à portée limitée pour les intégrations (CRM, scripts, CI), de limiter les permissions et de révoquer l’accès.

1. “Paramètres” → “Clés API” → “Créer une clé”.
2. Définir un nom d’intégration et des permissions : “Accès complet” ou choisir des scopes précis.
3. Enregistrer immédiatement la clé secrète après création — elle ne sera plus affichée.
4. Pour changer le nom ou les permissions, utiliser “Modifier” ; pour désactiver — “Révoquer la clé”.

• La clé est liée au projet actuel (scope) et ne fonctionne pas en dehors.
• Effectuer une rotation en révoquant l’ancienne clé et en en créant une nouvelle : le secret ne peut pas être modifié via l’édition.
• Si la limite de clés du projet est atteinte, l’interface affiche la restriction du plan.

Choix des permissions à la création d’une clé API.

ATTENTION : la clé secrète n’est affichée qu’une fois. Ne la mettez pas dans du JavaScript côté client ni dans des dépôts publics ; stockez-la dans des variables d’environnement ou un gestionnaire de secrets.

Supprimer le projet

En bas des paramètres — “Supprimer le projet” avec une longue confirmation.

1. “Paramètres” → zone de suppression → “Supprimer le projet”.
2. Attendre le minuteur de confirmation (~10 s) → “Supprimer définitivement”.

ATTENTION : supprimer un projet détruit définitivement ses dossiers et liens. Les sous-domaines du compte sont conservés. Ne pas confondre avec la suppression d’un seul lien ou dossier.

• Liens et dossiers
• Espace de travail
• Collaboration d’équipe
• Export et import

Toutes les sections de documentation · KKOROCHE