Korzen
IT
AccediInizia gratis
Bot Protection

Configura con l'AI

Un solo prompt per Claude Code, Codex, Cursor o qualsiasi agente di coding: aggiunge il tag e la chiamata dal tuo server, in monitor mode, e ti mostra il diff.

Apri il tuo agente di coding nella cartella del progetto, incolla questo prompt e leggi il diff che propone. Se hai effettuato l'accesso, questa pagina e la pagina Configurazione della dashboard inseriscono la tua site key.

Prompt
Aggiungi Korzen Bot Protection a questo progetto. Prima leggi la guida di configurazione su https://korzen.dev/bot-protection/docs/setup.md e seguila.

Site key: YOUR_SITE_KEY
API: https://korzen.dev
L'API key è nella variabile d'ambiente KORZEN_API_KEY; non scrivere mai la chiave in chiaro.

1. Aggiungi il tag nel <head> di ogni pagina da cui parte una registrazione, un login o un checkout:
   <script src="https://korzen.dev/v1/tag.js" data-site-key="YOUR_SITE_KEY" async></script>
2. Sul server, prima che l'handler di registrazione crei l'account (e prima del login e del checkout, se questo progetto li ha), chiama POST https://korzen.dev/v1/decide come mostra la guida (con gli header che elenca), con un timeout di 200 ms.
3. Leggi il campo "action" della risposta e comportati di conseguenza:
   - "allow": prosegui come al solito.
   - "challenge": chiedi prima un'ulteriore prova, con quello che il progetto ha già (un CAPTCHA, o la verifica dell'email); se non ha niente del genere, trattalo come "allow".
   - "block": fermati e mostra lo stesso errore di una registrazione fallita, senza dire perché.
   Se la chiamata fallisce, supera il timeout o risponde qualcosa di diverso da 200, trattala come "allow": Bot Protection non deve mai fermare un cliente vero (fail-open).
4. Aggiungi KORZEN_API_KEY al file d'ambiente di esempio, senza valore.
5. Non cambiare nient'altro. Mostrami il diff e come testarlo.

Poi

  1. Rivedi il diff. La chiamata deve stare prima della creazione dell'account, e ogni percorso d'errore deve lasciar passare il visitatore.
  2. Imposta la chiave. Metti la tua API key in KORZEN_API_KEY dove gira il tuo server; se ti serve, creane una nella pagina Configurazione.
  3. Fai il deploy in monitor mode. Il tuo account parte da lì: nessuno viene fermato mentre guardi la panoramica riempirsi.
  4. Controlla le prime decisioni nella pagina Decisioni della dashboard, poi leggi Monitor mode e block mode.

Funziona con

Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Windsurf, Gemini CLI e qualsiasi agente che sappia leggere una pagina web e modificare file. La guida che legge è in semplice Markdown, su /bot-protection/docs/setup.md, e il sito la elenca in /llms.txt.

Preferisci farlo a mano? Il tag e la chiamata dal tuo server hanno tutti i passi.