Korzen
NL
InloggenGratis starten
Bot Protection

Installeren met AI

Eén prompt voor Claude Code, Codex, Cursor of een andere coding agent: die voegt de tag en de call vanaf je server toe, in monitor mode, en laat je de diff zien.

Open je coding agent in de map van je project, plak deze prompt en lees de diff die hij voorstelt. Ben je ingelogd, dan vullen deze pagina en de pagina Set-up van het dashboard je eigen site key in.

Prompt
Voeg Korzen Bot Protection toe aan dit project. Lees eerst de installatiegids op https://korzen.dev/bot-protection/docs/setup.md en volg die.

Site key: YOUR_SITE_KEY
API: https://korzen.dev
De API key staat in de omgevingsvariabele KORZEN_API_KEY; schrijf de key zelf nooit uit.

1. Zet de tag in de <head> van elke pagina waar een registratie, een inlog of een checkout begint:
   <script src="https://korzen.dev/v1/tag.js" data-site-key="YOUR_SITE_KEY" async></script>
2. Roep op de server, voordat de registratie-handler het account aanmaakt (en vóór inloggen en checkout, als dit project die heeft), POST https://korzen.dev/v1/decide aan zoals de gids laat zien (met de headers die hij noemt), met een timeout van 200 ms.
3. Lees het veld "action" in het antwoord en handel ernaar:
   - "allow": ga gewoon door.
   - "challenge": vraag eerst om één extra bewijs, met wat dit project al heeft (een CAPTCHA of verificatie van het e-mailadres); heeft het niets van dien aard, behandel het dan als "allow".
   - "block": stop, en toon dezelfde foutmelding als bij een mislukte registratie, zonder te zeggen waarom.
   Mislukt de call, duurt hij langer dan de timeout of antwoordt hij iets anders dan 200, behandel het dan als "allow": Bot Protection mag nooit een echte klant tegenhouden (fail-open).
4. Voeg KORZEN_API_KEY zonder waarde toe aan het voorbeeldbestand met omgevingsvariabelen.
5. Verander verder niets. Laat me de diff zien, en hoe ik hem kan testen.

Daarna

  1. Bekijk de diff. De call moet vóór het aanmaken van het account staan, en elk foutpad moet de bezoeker doorlaten.
  2. Zet de key. Zet je API key in KORZEN_API_KEY waar je server draait; maak er een aan op de Set-up-pagina als dat nodig is.
  3. Deploy het in monitor mode. Daar begint je account: niemand wordt tegengehouden terwijl je het overzicht ziet vollopen.
  4. Bekijk de eerste beslissingen op de pagina Beslissingen van het dashboard, en lees dan Monitor mode en block mode.

Werkt met

Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Windsurf, Gemini CLI, en elke agent die een webpagina kan lezen en bestanden kan bewerken. De gids die hij leest is gewone Markdown, op /bot-protection/docs/setup.md, en de site vermeldt hem in /llms.txt.

Doe je het liever met de hand? De tag en de call vanaf je server beschrijven elke stap.