--- type: explanation title: Mode aperçu summary: Approuve automatiquement chaque vérification sur une clé de site pendant que tu construis et testes ton intégration, sans cacher le vrai widget ni le vrai jeu. --- Une vérification ne passe que lorsqu'un visiteur franchit vraiment le contrôle, ce qui est lent et instable tant que tu câbles encore ton frontend et ton backend `/siteverify`. Le **mode aperçu** enlève cette friction : active-le pour une clé de site et chaque vérification est approuvée automatiquement, alors que le widget montre toujours exactement ce que verrait un vrai visiteur. C'est une aide au développement et à l'intégration, et il **désactive** la protection anti-bot de la clé tant qu'il est actif, donc il n'est pas fait pour la production. ## Ce qu'il fait Le mode aperçu est un interrupteur sur la page [Sécurité](/docs/site-keys/security) d'une clé de site. Quand il est actif : - La clé **sert toujours son expérience normale**, le contrôle de fond discret, ainsi que le jeu et son plein écran si tu [exiges un jeu](/docs/site-keys/security#require-a-game). Le mode aperçu ne cache ni ne saute rien de ce que le visiteur verrait en production. - Le backend **approuve chaque vérification, peu importe comment le visiteur joue**. Le jeu n'est pas rejoué pour un verdict et le proof of work n'est pas imposé, donc `/siteverify` renvoie `success` à chaque fois. - **Les sessions sont toujours enregistrées.** Chacune est marquée **Aperçu** dans le [journal des sessions](/docs/site-keys/statistics#the-session-log), pour que ton tableau de bord et tes statistiques se remplissent de vraies données et que le trafic d'aperçu ne soit jamais pris pour un vrai passage humain. Comme l'approbation se fait de notre côté et non dans le navigateur, tu obtiens de vraies sessions et de vraies statistiques ; un client qui falsifierait un passage ne produirait ni l'une ni l'autre. ## Quand l'utiliser - **Construire ton intégration.** Câble le widget dans ton formulaire et l'appel `/siteverify` de ton backend, et confirme que tout l'aller-retour fonctionne avant que ton défi soit définitif. - **Démos.** Montre le vrai widget et le vrai jeu à une partie prenante avec un passage garanti, sans rien à résoudre. Ne le laisse **pas** actif en production : tant qu'il est actif, n'importe qui (y compris un bot) passe. Désactive-le avant de mettre en ligne. ## L'activer Dans le tableau de bord, ouvre la clé de site et va dans **Sécurité → Mode aperçu**. Il est disponible de deux façons : - **Par clé de site.** Active-le pour une clé pendant que tu travailles sur cette intégration. - **Comme réglage par défaut de l'équipe.** Règle-le sur la page Sécurité de l'équipe et chaque clé de site en hérite, sauf si une clé le remplace. Une clé peut l'activer même quand le défaut de l'équipe est désactivé, ou le désactiver même quand le défaut est activé. La carte t'avertit tant qu'il est actif, parce que la clé n'a aucune protection anti-bot dans cet état. ## Le mode aperçu et la porte de proxy Le mode aperçu est la même idée (observer et laisser passer, jamais imposer), appliquée partout où une clé protège quelque chose. Pour le widget simple, il approuve la vérification, comme décrit ci-dessus. Pour la [porte de proxy](/docs/proxy-page-gate/set-up), le même interrupteur fait tourner la porte en mode **surveillance seule** : la porte note ce qu'elle *aurait* fait de chaque requête mais laisse passer chaque requête, pour que tu puisses confirmer le câblage de ton proxy inverse avant qu'elle ne bloque un seul vrai visiteur. C'est un seul réglage avec un seul sens sur les deux surfaces. ## Voir aussi - [Sécurité](/docs/site-keys/security), la page où vit l'interrupteur, et le reste de la protection d'une clé. - [Statistiques et sessions](/docs/site-keys/statistics#the-session-log), où les sessions d'aperçu sont listées et marquées. - [Configurer la porte de proxy](/docs/proxy-page-gate/set-up), le même interrupteur côté porte, en mode surveillance seule.