Présentation
La validation de domaine vous permet de prouver qu'un domaine configuré dans Axeptio vous appartient bien, et optionnellement de restreindre l'exécution de votre widget à ce seul domaine.
La validation repose sur l'ajout d'un enregistrement DNS de type TXT dans la zone DNS de votre domaine. Une fois le domaine validé, vous pouvez choisir entre deux modes de fonctionnement :
Autoriser le SDK Axeptio à fonctionner sur tous les domaines (comportement par défaut).
Restreindre l'exécution du SDK uniquement au domaine validé, afin d'éviter que votre widget soit utilisé depuis un domaine non autorisé.
AprĂšs toute modification, vous devez publier le widget pour que les changements soient pris en compte.
Prérequis
Avant de commencer, assurez-vous d'avoir :
accĂšs Ă votre projet Axeptio ;
les droits nécessaires pour modifier la configuration du projet ;
accÚs à la zone DNS du domaine à valider, via votre hébergeur, registrar ou outil de gestion DNS ;
identifié le domaine principal de votre site internet.
Exemple :
â
monsite.com
Ătape 1 â Renseigner le domaine principal du projet
Depuis l'interface Axeptio, ouvrez le projet concerné.
Ouvrez le détail du projet.
Accédez à la section Gestion des domaines.
Renseignez ou mettez Ă jour le domaine principal de votre site internet.
Enregistrez la modification.
Le domaine principal doit correspondre au domaine que vous souhaitez valider.
Ă utiliser :
â
monsite.com
Ă Ă©viter â URL complĂšte avec protocole ou chemin :
â
https://www.monsite.com/page
Ătape 2 â Ajouter l'enregistrement DNS de validation
Une fois le domaine principal renseigné, Axeptio génÚre une clé de validation à ajouter dans votre zone DNS. Cette clé permet à Axeptio de vérifier que vous avez bien accÚs à la configuration DNS du domaine.
Enregistrement DNS à créer
Dans votre outil de gestion DNS, ajoutez un nouvel enregistrement avec les informations suivantes :
Champ DNS | Valeur |
Type |
|
Nom / Host / Sous-domaine |
|
Valeur | Clé de validation fournie par Axeptio |
TTL | Valeur par défaut ou automatique |
Selon votre fournisseur DNS, le champ Nom, Host ou Sous-domaine peut ĂȘtre demandĂ© sous diffĂ©rents formats. Vous devrez renseigner soit la forme courte :
â
_axeptio-verify
Soit la forme complĂšte :
â
_axeptio-verify.monsite.com
La valeur TXT doit ĂȘtre copiĂ©e exactement telle qu'elle est affichĂ©e dans Axeptio.
â
Exemple :
â
axeptio-verify=xxxxxxxxxxxxxxxx
Ătape 3 â Valider le domaine dans Axeptio
Une fois l'enregistrement DNS ajouté, retournez dans Axeptio.
Lancez la vérification.
Axeptio vérifie la présence de l'enregistrement TXT dans votre zone DNS.
Si l'enregistrement est trouvé, le domaine passe au statut validé.
Une fois validĂ©, Axeptio considĂšre que vous ĂȘtes bien propriĂ©taire ou administrateur du domaine configurĂ©.
Ătape 4 â Choisir le mode de fonctionnement du SDK
AprĂšs validation, deux comportements sont possibles.
â
Option 1 â Laisser le SDK fonctionner sur tous les domaines
Par dĂ©faut, le SDK Axeptio peut s'exĂ©cuter sur tous les domaines oĂč il est installĂ©. Ce mode est utile si votre widget est volontairement utilisĂ© sur plusieurs domaines, environnements ou sites.
Exemples :
monsite.com blog.monsite.com landing-page-partenaire.com preprod.monsite.com
Dans ce cas, la validation du domaine permet uniquement de justifier la propriété du domaine principal. Elle ne bloque pas l'exécution du SDK ailleurs.
â
Option 2 â Restreindre le SDK au domaine validĂ©
Vous pouvez également activer la restriction de domaine à l'aide de la checkbox dédiée. Lorsque cette option est activée, le SDK Axeptio est autorisé à s'exécuter uniquement sur le domaine validé.
Cela renforce le contrĂŽle sur l'utilisation de votre widget et empĂȘche qu'une configuration Axeptio soit exĂ©cutĂ©e depuis un domaine non autorisĂ©.
Pour activer la restriction :
Rendez-vous dans Gestion des domaines.
Assurez-vous que le domaine principal est bien validé.
Activez la checkbox de restriction de domaine.
Enregistrez la modification.
à partir de ce moment, aprÚs publication, le widget sera limité au domaine validé.
Ătape 5 â Publier le widget
AprÚs avoir modifié le domaine, validé la propriété ou activé la restriction, vous devez publier le widget. Cette étape est indispensable pour que les changements soient appliqués sur votre site internet.
Cliquez sur Publier en haut de la fenĂȘtre.
Attendez la confirmation de publication.
Rechargez votre site pour vérifier le bon fonctionnement.
Sans publication, les modifications effectuées dans la gestion des domaines ne seront pas encore prises en compte par le SDK.