Der Tag ist ein einziges Skript. Setzen Sie es in den <head> jeder Seite, auf der eine geschützte Aktion beginnt: die Registrierungsseite, die Anmeldeseite, der Checkout.
<script src="https://korzen.dev/v1/tag.js" data-site-key="YOUR_SITE_KEY" async></script>
Er lädt asynchron und hält die Seite nie auf. Er liest, wie sich der Browser verhält (Eingaben, Timing, was der Browser über sich sagt), sendet das an Bot Protection und speichert die Antwort als _kz-Cookie auf Ihrer Domain. Ihr Server liest dieses Cookie und sendet es mit der Anfrage nach einer Entscheidung.
Ihre Domains
Es gibt nichts einzutragen: Setzen Sie den Tag auf Ihre Seiten, und Bot Protection lernt Ihre Domains aus seinen Beacons und den Aufrufen Ihres Servers. Eine Domain kommt unter Ihre Domains auf der Seite Einrichtung mit der ersten Entscheidung, die Ihr Server zu einem Besucher einer ihrer Seiten anfragt, der kein Bot ist. Eine Domain zählt mit jeder Subdomain darunter: shop.example, www.shop.example und app.shop.example sind in Ihrem Plan eine Domain. Seiten auf localhost, 127.0.0.1 oder [::1] funktionieren zum Testen immer und erscheinen nie in der Liste. Ihr Plan legt fest, wie viele Domains geschützt sind: die zuerst gesehenen, bis zu dieser Zahl. Beacons von einer Seite auf jeder weiteren Domain werden mit 402 abgelehnt, bis Sie auf der Einrichtungsseite eine Domain entfernen oder einen größeren Plan wählen; entfernen Sie dort auch eine Domain, die nicht Ihre ist, etwa eine Kopie Ihrer Website. Im kostenlosen Test bekommt jede Domain einen kostenlosen Test: Beacons von einer Domain, die ihren kostenlosen Test schon in einem anderen Konto hatte, werden mit 402 abgelehnt, bis Sie einen Plan wählen.
Vor der Aktion
Warten Sie vor jeder geschützten Aktion auf den Tag und senden Sie dann das Formular:
await window.korzen?.ready();
Er meldet, was der Besucher seit der letzten Meldung des Tags getan hat: Wer auf der Seite wartet, das Formular vom Browser ausfüllen lässt und Enter drückt, hat all das nach dieser Meldung getan. Das Promise wird innerhalb weniger Sekunden aufgelöst, selbst wenn Bot Protection langsam oder blockiert ist, sodass ein Formular nie hängen bleibt. Ein Formular, das der Browser ohne Ihr JavaScript sendet, wird gemeldet, während die Seite verlassen wird; das erreicht Bot Protection meist, nicht immer, bevor Ihr Server fragt.
Optionen
| Attribut | Standard | Was es tut |
|---|---|---|
data-site-key | erforderlich | Ihr öffentlicher Site Key |
data-wait-ms | 2500 | wie lange der Tag Eingaben erfasst, bevor er berichtet |
data-ready-ms | 2000 | wie viel länger korzen.ready() warten darf |
Bot Protection erkennt den Tag von selbst: Sobald eine Ihrer Entscheidungen das Token des Tags mitbringt, zählt eine Entscheidung ohne _kz-Cookie als schwacher Hinweis auf einen Bot. Bis dahin zählt ein fehlendes Token nicht.
Content Security Policy
Eine Seite mit dem Header Content-Security-Policy muss dem Tag erlauben, zu laden, zu melden und seinen Worker zu starten. Ergänzen Sie diese Quellen in den Direktiven, die Ihre Richtlinie schon hat:
script-src https://korzen.dev; connect-src https://korzen.dev; worker-src blob:
Ohne worker-src blob: funktioniert der Tag weiter und jeder Besucher kommt durch: Bot Protection verliert nur ein Signal. Eine Seite ohne den Header braucht nichts.
Ihre Datenschutzhinweise
Sie sind Verantwortlicher für das, was der Tag auf Ihren Seiten liest, und Korzen ist Ihr Auftragsverarbeiter, nach dem Auftragsverarbeitungsvertrag, der die Daten und die Dauer ihrer Aufbewahrung aufführt. Ein Satz, den Ihre Datenschutzhinweise verwenden können:
„Um Registrierungen, Anmeldungen und Zahlungen vor Bots und Betrug zu schützen, nutzen unsere Seiten Korzen Bot Protection. Es liest technische Merkmale Ihres Browsers und wie Sie die Seite nutzen, nie, was Sie eingeben, und speichert eine zufällige Kennung Ihres Browsers, damit ein wiederkehrender Browser erkannt wird. Wir tun das aus unserem berechtigten Interesse an der Verhinderung von Betrug (Erwägungsgrund 47 DSGVO).“
Nach den ePrivacy-Regeln der EU können das Cookie _kz und der Local Storage des Tags für die Aktion, die der Besucher angefragt hat, unbedingt erforderlich sein; das entscheiden Sie mit Ihren Beratern, oder Sie bitten um Einwilligung (die Cookie-Richtlinie führt jeden Eintrag auf). Eine Aktion, die Sie mit require_token markieren, schickt einen Besucher ohne gültiges Token auf die Challenge-Seite von Korzen, die Korzens eigenen Tag ausführt: Abschnitt 2 des Auftragsverarbeitungsvertrags sagt, was das bedeutet.