Korzen
Bot Protection

Mit KI einrichten

Ein Prompt für Claude Code, Codex, Cursor oder jeden Coding-Agenten: Er fügt den Tag und den Aufruf von Ihrem Server hinzu, im Monitor-Modus, und zeigt Ihnen den Diff.

Öffnen Sie Ihren Coding-Agenten im Ordner Ihres Projekts, fügen Sie diesen Prompt ein und lesen Sie den vorgeschlagenen Diff. Wenn Sie angemeldet sind, enthalten diese Seite und die Seite Einrichtung des Dashboards bereits Ihren eigenen Site Key.

Prompt
Füge Korzen Bot Protection zu diesem Projekt hinzu. Lies zuerst die Einrichtungsanleitung unter https://korzen.dev/bot-protection/docs/setup.md und folge ihr.

Site Key: YOUR_SITE_KEY
API: https://korzen.dev
Der API key steht in der Umgebungsvariable KORZEN_API_KEY; schreibe nie den Schlüssel selbst.

1. Füge den Tag in den <head> jeder Seite ein, auf der eine Registrierung, eine Anmeldung oder ein Checkout beginnt:
   <script src="https://korzen.dev/v1/tag.js" data-site-key="YOUR_SITE_KEY" async></script>
2. Rufe auf dem Server, bevor der Registrierungs-Handler das Konto anlegt (und vor Anmeldung und Checkout, falls dieses Projekt sie hat), POST https://korzen.dev/v1/decide auf, wie die Anleitung zeigt (mit den Headern, die sie aufführt), mit einem Timeout von 200 ms.
3. Lies das Feld "action" der Antwort und handle danach:
   - "allow": wie gewohnt weitermachen.
   - "challenge": zuerst einen weiteren Nachweis verlangen, mit dem, was dieses Projekt schon hat (ein CAPTCHA oder die Bestätigung der E-Mail); hat es nichts dergleichen, wie "allow" behandeln.
   - "block": abbrechen und denselben Fehler zeigen wie bei einer fehlgeschlagenen Registrierung, ohne den Grund zu nennen.
   Schlägt der Aufruf fehl, dauert er länger als der Timeout oder antwortet er etwas anderes als 200, wie "allow" behandeln: Bot Protection darf nie einen echten Kunden stoppen (fail-open).
4. Füge KORZEN_API_KEY ohne Wert zur Beispiel-Umgebungsdatei hinzu.
5. Ändere nichts anderes. Zeig mir den Diff und wie man ihn testet.

Danach

  1. Prüfen Sie den Diff. Der Aufruf muss vor dem Anlegen des Kontos stehen, und jeder Fehlerpfad muss den Besucher durchlassen.
  2. Setzen Sie den Schlüssel. Legen Sie Ihren API key in KORZEN_API_KEY ab, wo Ihr Server läuft; erstellen Sie bei Bedarf einen auf der Einrichtungsseite.
  3. Deployen Sie im Monitor-Modus. Ihr Konto beginnt dort: Niemand wird gestoppt, während Sie zusehen, wie sich die Übersicht füllt.
  4. Prüfen Sie die ersten Entscheidungen auf der Seite Entscheidungen des Dashboards und lesen Sie dann Monitor- und Block-Modus.

Funktioniert mit

Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Windsurf, Gemini CLI und jedem Agenten, der eine Webseite lesen und Dateien bearbeiten kann. Die Anleitung, die er liest, ist reines Markdown, unter /bot-protection/docs/setup.md, und die Website listet sie in /llms.txt.

Lieber von Hand? Der Tag und der Aufruf von Ihrem Server enthalten jeden Schritt.