Documentation / Premiers pas
Prouver que le site est à vous
Avant de greffer un module, vous prouvez que le site vous appartient. Sans cette étape, n'importe qui pourrait déclarer le site d'un autre. Trois preuves sont acceptées, et elles valent la même chose : choisissez celle qui vous demande le moins d'effort.
Votre code de vérification
L'écran « Propriété » du site affiche votre code, de la forme blt-verif- suivi de 32 caractères. Il est tiré une fois et ne change plus tout seul : vous pouvez revenir sur l'écran autant de fois que vous voulez sans avoir à reposer la preuve.
Les trois preuves portent ce même code. Seul l'endroit où vous le placez change.
Preuve 1 : un fichier à la racine
C'est l'onglet ouvert par défaut, et la seule preuve où vous n'avez rien à recopier.
- Cliquez sur « Télécharger bonjour-la-toile.txt ». Le fichier contient déjà votre code, et rien d'autre.
- Déposez-le à la racine de votre site, au même endroit que votre page d'accueil, par FTP ou par le gestionnaire de fichiers de votre hébergeur. Ne le renommez pas et ne le rangez pas dans un sous-dossier.
- Vérifiez qu'il s'ouvre à cette adresse :
https://exemple.fr/bonjour-la-toile.txt(avec votre domaine). - Revenez sur l'écran « Propriété », ouvrez l'onglet du moyen que vous avez posé, et cliquez sur son bouton « Vérifier ».
Le contenu du fichier doit être exactement le code, sans autre texte. Une page d'erreur de votre hébergeur qui contiendrait le code par hasard ne compte pas.
L'ancienne adresse /.well-known/bonjour-la-toile.txt est encore acceptée : un fichier déjà posé là reste valable.
Preuve 2 : une ligne dans votre page
Collez cette ligne dans le <head> de votre page d'accueil, avec votre propre code à la place de celui de l'exemple :
<meta name="bonjour-la-toile" content="blt-verif-0123456789abcdef0123456789abcdef">L'écran « Propriété » affiche la ligne exacte, prête à copier. La plupart des constructeurs de sites ont un champ « code personnalisé » ou « en-tête » pour ce genre de ligne. La vérification lit la page d'accueil de votre domaine, en https puis en http.
Preuve 3 : un enregistrement DNS
La preuve la plus solide, car elle ne dépend pas du contenu du site. Elle se pose chez le fournisseur qui gère votre nom de domaine.
| Champ | Valeur |
|---|---|
| Type | TXT |
| Nom | _bonjourlatoile |
| Valeur | Votre code, par exemple blt-verif-0123456789abcdef0123456789abcdef |
Certains fournisseurs demandent le nom complet : _bonjourlatoile.exemple.fr (avec votre domaine). La propagation d'un enregistrement DNS prend parfois une heure.
Lancer la vérification
Chaque onglet a SON bouton, et on ne regarde que ce que vous avez posé : vérifier le fichier ne va pas lire votre DNS. En cas d'échec, l'écran dit ce qui a été trouvé pour ce moyen-là, par exemple « la balise est là, mais son code ne correspond pas » ou « aucun enregistrement TXT à ce nom ». Les trois valent la même chose : une seule suffit, et vous pouvez en poser une autre plus tard.
La revérification quotidienne, elle, accepte n'importe laquelle des trois : si vous passez du fichier au DNS, vos modules ne s'éteignent pas.
Une fois le site vérifié, un courriel de confirmation part à votre adresse, et les boutons « Greffer » de l'écran « Modules » s'activent.
Laissez la preuve en place après la vérification. Vous pouvez relancer la vérification à tout moment avec le bouton « Revérifier ».
Nous relisons la preuve chaque jour
Une fois par jour, nous relisons la preuve de chaque site vérifié. Les trois méthodes comptent : si vous passez de la balise à l'enregistrement DNS, rien ne se perd.
Si la preuve reste introuvable trois jours de suite, le site repasse « À vérifier » : ses modules cessent de s'afficher et un courriel vous prévient. Un seul jour sans preuve (un hébergeur en panne, un DNS qui tarde) ne coupe rien. Rien n'est effacé : reposez la preuve, cliquez « Vérifier », et tout revient.
Tirer un nouveau code
Le bouton « Tirer un nouveau code » remplace votre code par un neuf. L'ancien ne vaut plus rien, et le site repasse à l'état « À vérifier » : il faut reposer la preuve avec le nouveau code et relancer la vérification.
Changer de domaine
Dans l'écran « Réglages » du site, le bloc « Domaine » remplace l'adresse du site. Un nouveau domaine n'est pas encore prouvé : le site repasse « À vérifier » et ses modules s'éteignent jusqu'à ce que la preuve soit trouvée sur la nouvelle adresse. Votre code de vérification ne change pas.
L'ancien domaine sort aussi des « Adresses autorisées » : les modules ne s'affichent plus là-bas. Les autres adresses que vous y aviez ajoutées restent.
Ce qu'il faut savoir
- Un domaine ne peut être vérifié que par un seul site à la fois. S'il l'est déjà ailleurs, la vérification le dit : écrivez-nous.
- Le domaine vérifié est celui que vous avez déclaré en ajoutant le site, tel quel.
www.exemple.fretexemple.frsont deux noms différents, et la preuve doit répondre sur celui que vous avez déclaré. Pour en changer, voyez Changer de domaine. - La vérification accepte douze essais par heure pour un même site. Au-delà, attendez une heure.