Vérification du hostname

Prouvez que vous contrôlez un domaine à l’aide d’un enregistrement DNS TXT ou d’un fichier HTTPS, pour pouvoir le préchauffer.

9 min read

Avant que Cache Rocket envoie une seule requête à un domaine, vous devez prouver que vous le contrôlez. Cette page couvre à la fois les méthodes de vérification et ce qu'il faut faire en cas d'échec.

Hostnames en direct sous Compte → Hostnames.

Pourquoi c'est nécessaire

Un cache warmer est une machine qui envoie très rapidement de nombreuses requêtes à un site Web. Cela est utile lorsqu'il est pointé vers votre propre serveur et hostile lorsqu'il est pointé vers celui de quelqu'un d'autre – il s'agit, fonctionnellement, d'un outil de déni de service.

La vérification est ce qui sépare les deux. Cela signifie que chaque demande envoyée par Cache Rocket en votre nom est dirigée vers une infrastructure dont vous avez prouvé que vous contrôlez. Il n’existe aucun moyen de se désinscrire, ni aucun plan supprimant cette exigence.

Note

Cela vous protège également. Personne d'autre ne peut créer un warmer pointant sur votre domaine, car il ne peut pas réussir le défi de vérification.

Choisir une méthode

	Enregistrement DNS TXT	Fichier HTTPS ou balise méta
Vous devez accéder à	Votre fournisseur DNS	Les fichiers ou modèles de votre site
Attente typique	Quelques minutes à une heure, pour la propagation	Aussi vite que possible
Meilleur quand	Vous gérez le DNS et souhaitez un changement qui survit aux redéploiements	Vous déployez une application mais ne contrôlez pas le DNS
Bon ajustement pour	Hébergement traditionnel, cPanel, serveurs autogérés	Next.js, Vercel, Netlify, hôtes statiques

Les deux méthodes aboutissent au même statut vérifié. Choisissez ce que vous pouvez faire le plus rapidement.

Obtenir le bon hostname

Il s’agit de la source de confusion la plus courante, il convient donc d’être précis. Un hostname est la partie exacte du domaine de vos URL. Ce sont tous *différents* hostnames en ce qui concerne la vérification :

text

example.com
www.example.com
shop.example.com
blog.example.com

Vérifiez celui qui apparaît dans les URL d'entrée que vous avez l'intention d'utiliser. Si votre site redirige example.com vers www.example.com, votre URL d'entrée doit être la version www, c'est donc la hostname à vérifier.

Vous gérez plusieurs sous-domaines ? Vérifiez chacun séparément. Il n'y a pas de vérification par caractère générique.

Tip

Vous ne savez pas quel formulaire votre site utilise ? Ouvrez-le dans un navigateur et regardez la barre d'adresse une fois le chargement terminé. Tout ce qui y est affiché, après toute redirection, est le hostname à vérifier.

Méthode A – Enregistrement DNS TXT

1
Ajoutez le hostname
Sur Compte → Hostnames, saisissez le domaine et sélectionnez Enregistrement DNS TXT comme méthode de vérification.
2
Commencer la vérification
Cliquez sur Démarrer la vérification. Cache Rocket génère un jeton unique et vous montre le nom de l'enregistrement et la valeur exacte à publier.
3
Créez l'enregistrement auprès de votre fournisseur DNS
Connectez-vous partout où votre DNS est géré — Cloudflare, votre registraire, le panneau de contrôle de votre hôte — et ajoutez un nouvel enregistrement TXT en utilisant le nom et la valeur indiqués. Copiez et collez la valeur ; ne le retapez pas.
4
Attendre la propagation
Les modifications DNS ne sont pas instantanées. Quelques minutes sont typiques ; jusqu'à une heure est normale si votre fournisseur utilise une longue durée de vie.
5
Cliquez sur Vérifier
De retour dans Cache Rocket, cliquez sur Vérifier à côté du hostname. En cas d'échec, attendez plus longtemps et cliquez à nouveau : réessayer est gratuit et ne réinitialise rien.

Vérifier vous-même le dossier

Si la vérification continue d'échouer, confirmez que l'enregistrement est réellement visible sur l'Internet public avant de supposer que Cache Rocket est en faute :

macOS et Linux

bash

dig +short TXT _cacherocket.example.com

Fenêtres

powershell

Resolve-DnsName -Type TXT _cacherocket.example.com

Remplacez le nom de l'enregistrement Cache Rocket que vous avez montré. Si la commande ne renvoie rien, l'enregistrement ne s'est pas encore propagé ou n'a pas été enregistré correctement.

Erreurs DNS courantes

Les fournisseurs varient selon qu'ils attendent le nom complet de l'enregistrement ou uniquement la partie du sous-domaine : saisir _cacherocket.example.com là où le fournisseur ajoute déjà votre domaine produit _cacherocket.example.com.example.com. Surveillez également les guillemets ajoutés automatiquement et les espaces de fin lors du collage.

Méthode B – Fichier HTTPS ou balise méta

Choisissez Fichier HTTPS ou balise méta et cliquez sur Démarrer la vérification. Cache Rocket affiche alors trois choses : l'URL qu'elle va vérifier, le contenu exact que l'URL doit renvoyer et une balise <meta> équivalente. Vous devez publier soit le fichier soit la balise méta, pas les deux.

Publication du fichier

Créez un fichier au chemin indiqué, contenant exactement le contenu affiché et rien d'autre. Sur un projet Next.js, cela signifie le déposer dans votre répertoire public/ :

Next.js, Vite, Astro et la plupart des hôtes statiques

text

public/
  └── .well-known/
        └── cacherocket-verification.txt

Déployez, puis ouvrez l'URL de vérification dans un navigateur. Vous ne devriez voir que le jeton. Si vous voyez la page 404 de votre site, un style HTML ou une redirection, cela signifie qu'il n'est pas encore publié correctement.

Ou en utilisant la balise méta

Si l'ajout de fichiers est difficile, placez plutôt la balise <meta> fournie dans le <head> de votre page d'accueil. Dans l'App Router Next.js, vous pouvez l'ajouter via l'exportation des métadonnées :

app/layout.tsx

export const metadata = {
  other: {
    'cacherocket-site-verification': 'YOUR_TOKEN_HERE',
  },
};

Déployez, puis cliquez sur Vérifier.

Le fichier doit être accessible publiquement

Si votre site se trouve derrière une authentification de base HTTP, une liste blanche IP, un mot de passe intermédiaire ou une page « à venir », Cache Rocket ne peut pas lire le fichier de vérification. Soit autorisez l’accès public à ce chemin, soit utilisez la méthode DNS à la place.

J'ai ajouté l'enregistrement DNS mais la vérification échoue toujours.: Presque toujours propagation. Confirmez que l'enregistrement est visible publiquement avec la commande dig ci-dessus. Si dig le trouve mais pas Cache Rocket, recherchez un suffixe de domaine dupliqué dans le nom de l'enregistrement, ou un deuxième enregistrement TXT en conflit sur le même nom.
Le fichier de vérification s'ouvre correctement dans mon navigateur mais Cache Rocket ne peut pas le lire.: Votre navigateur peut être authentifié là où Cache Rocket ne l'est pas. Essayez l'URL dans une fenêtre privée. Vérifiez également qu'il est servi sur https sans redirection et que la réponse est du texte brut plutôt qu'une page HTML contenant le jeton.
Quel hostname dois-je vérifier si mon site redirige ?: La destination — le hostname qui apparaît dans la barre d'adresse une fois la redirection terminée. C'est celui que vos URL d'entrée doivent utiliser.
Dois-je vérifier chaque sous-domaine ?: Oui. Chaque hostname est vérifié indépendamment et il n'y a pas d'option générique. shop.example.com nécessite sa propre vérification même si example.com est déjà vérifié.
Puis-je vérifier un domaine que je gère pour un client mais que je ne possède pas ?: Oui, à condition que vous puissiez ajouter un enregistrement DNS ou publier un fichier – c’est exactement ce que teste le défi. Les agences vérifient généralement chaque client hostname dans l'espace de travail de ce client. Voir Équipes et rôles.
Puis-je réchauffer une adresse localhost ou interne uniquement ?: Non. Le Cache Rocket est diffusé à partir de l'Internet public, le hostname doit donc être résoluble et accessible publiquement.