Korzen
Bot Protection

Configurer avec l'IA

Un prompt pour Claude Code, Codex, Cursor ou tout agent de code : il ajoute le tag et l'appel depuis votre serveur, en mode monitor, et vous montre le diff.

Ouvrez votre agent de code dans le dossier de votre projet, collez ce prompt et lisez le diff qu'il propose. Une fois connecté, cette page et la page Configuration du tableau de bord remplissent votre propre site key.

Prompt
Ajoute Korzen Bot Protection à ce projet. Lis d'abord le guide de configuration sur https://korzen.dev/bot-protection/docs/setup.md et suis-le.

Site key : YOUR_SITE_KEY
API : https://korzen.dev
L'API key est dans la variable d'environnement KORZEN_API_KEY ; n'écris jamais la clé elle-même.

1. Ajoute le tag dans le <head> de chaque page où commence une inscription, une connexion ou un checkout :
   <script src="https://korzen.dev/v1/tag.js" data-site-key="YOUR_SITE_KEY" async></script>
2. Sur le serveur, avant que le handler d'inscription ne crée le compte (et avant la connexion et le checkout, si ce projet en a), appelle POST https://korzen.dev/v1/decide comme le montre le guide (avec les en-têtes qu'il liste), avec un timeout de 200 ms.
3. Lis le champ "action" de la réponse et agis en conséquence :
   - "allow" : continue normalement.
   - "challenge" : demande d'abord une preuve de plus, avec ce que ce projet a déjà (un CAPTCHA, ou la vérification de l'e-mail) ; s'il n'a rien de tel, traite-le comme "allow".
   - "block" : arrête-toi, et affiche la même erreur qu'une inscription échouée, sans dire pourquoi.
   Si l'appel échoue, dépasse le timeout ou répond avec un autre statut que 200, traite-le comme "allow" : Bot Protection ne doit jamais arrêter un vrai client (fail-open).
4. Ajoute KORZEN_API_KEY au fichier d'environnement d'exemple, sans valeur.
5. Ne change rien d'autre. Montre-moi le diff, et comment le tester.

Ensuite

  1. Relisez le diff. L'appel doit se trouver avant la création du compte, et chaque chemin d'erreur doit laisser passer le visiteur.
  2. Définissez la clé. Mettez votre API key dans KORZEN_API_KEY là où tourne votre serveur ; créez-en une sur la page Configuration si besoin.
  3. Déployez en mode monitor. Votre compte commence ainsi : personne n'est arrêté pendant que vous regardez la vue d'ensemble se remplir.
  4. Vérifiez les premières décisions sur la page Décisions du tableau de bord, puis lisez Mode monitor et mode block.

Fonctionne avec

Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Windsurf, Gemini CLI, et tout agent capable de lire une page web et de modifier des fichiers. Le guide qu'il lit est en Markdown simple, à /bot-protection/docs/setup.md, et le site le liste dans /llms.txt.

Vous préférez le faire à la main ? Le tag et l'appel depuis votre serveur donnent chaque étape.