Ein Widget auf Ihrer Seite zeigt nur eine Bewertung. Echter Schutz beginnt, wenn Ihr Server das Ergebnis prüft, sobald ein Formular ankommt. Dieser Beitrag zeigt, wie Sie diese Prüfung einbauen und wie Sie im Dashboard sehen, dass sie wirkt. Der Film unten zeigt es mit einem Testserver und Beispieldaten, ohne Ton und mit kurzen Einblendungen. Der Text darunter sagt dasselbe in Worten, sodass Sie auch ohne Film mitkommen.
Der Film in Kürze
Der Film öffnet den „Integrations-Guide“ eines Schlüssels, zeigt, dass das Widget sich meldet, aber noch kein Server geprüft hat, zeigt den Node.js-Code aus Schritt 2, lässt einen Besucher das Formular eines Testshops absenden, dessen Server genau diesen Code ausführt, und endet, wenn „Serverseitige Prüfung“ auf „Aktiv“ steht. Er hat keinen Ton und startet nicht von selbst.
Schritt 1: Integrationsstatus lesen
Öffnen Sie Ihren Schlüssel im Dashboard und gehen Sie zum Integrations-Guide. Unter „Integrationsstatus“ zeigen vier Anzeigen, was tatsächlich bei uns ankommt: „Skript geladen“, „Widget meldet sich“, „Serverseitige Prüfung“ und „Formularschutz“. Solange Ihr Server nichts geprüft hat, steht bei „Serverseitige Prüfung“ „Noch nie“ und der Satz: „Für diesen Schlüssel hat noch nie ein Server ein Token geprüft. Ohne diese Prüfung lässt sich ein Formular weiterhin direkt absenden.“
Schritt 2: Die Prüfung in Ihren Server einbauen
Schritt 2 der Seite, „Formulare absichern (wichtig)“, erklärt es: Der Server prüft den Nonce, bevor er die Übermittlung annimmt. Wählen Sie Ihren Stack in den Reitern: Node.js, PHP, Go, Python, React oder Frontend. Der Reiter Node.js zeigt eine Express-Route: Sie liest den Nonce, den das Widget ins Formular gelegt hat, fragt SilentShield mit Ihrem Schlüssel im Header „X-Api-Key“ danach, nimmt die Übermittlung nur an, wenn die Antwort „human“ mit einer Sicherheit von mindestens 0,7 lautet, und antwortet sonst mit 403 und „Bot detected“.
Schritt 3: Ein Formular ankommen lassen
Starten Sie die Route in Ihrem Server und richten Sie Ihr Formular darauf aus. Im Film füllt ein Besucher das Kontaktformular eines Testshops aus und klickt auf den Knopf; das Formular schickt den Nonce an die Route, und die Route fragt SilentShield. Dafür muss das Dashboard nicht geöffnet sein.
Schritt 4: Das Ergebnis lesen
Laden Sie den Integrations-Guide neu. „Serverseitige Prüfung“ steht jetzt auf „Aktiv“, und der Status wechselt von „Ungeschützt“ auf „Teilweise geschützt“: „Drei von vier Gliedern tragen.“ Die vierte Anzeige, „Formularschutz“, ist eine eigene Sache: Die Seite sagt „Nicht jedes Formular ist geschützt“, bis Sie Ihre Formulare eingeschaltet haben. Wie Sie den Rest des Dashboards lesen, steht in Ergebnisse von SilentShield lesen.
Das Paket statt eigenem Code
Mit Node.js können Sie statt der eigenen Anfrage auch das Paket „@forge12interactive/silentshield-sdk-js“ nutzen; auf npm liegt zum Zeitpunkt dieses Beitrags die Version 1.5.0. Die Dokumentation führt das Paket und die anderen Sprachen auf. Welchen Weg Sie auch wählen: Die Anzeige im Integrations-Guide sagt Ihnen, ob Ihr Server wirklich prüft.
Was der Film nicht zeigt
Der Film zeigt nicht, was der Testserver geantwortet hat, und sagt nichts darüber, wie gut Bots erkannt werden; der Besucher darin ist ein Testskript. Der Integrations-Guide bietet außerdem eine Liste möglicher Ursachen, falls die Anzeige auf „Noch nie“ bleibt, und eine Anleitung für das Widget deckt den Teil davor ab.