# Captcha & Formularschutz für Shopware: Handbuch

> Handbuch zu Captcha & Formularschutz: Installation, Übersicht, Arten des Captchas, weitere Formulare, Bremse, E-Mail-Prüfung und alle Einstellungen.

Quelle / Source: https://stoneandwater.online/de/handbuch-captcha-formularschutz.html

# Handbuch Captcha & Formularschutz.

Von der Installation bis zur Feineinstellung: was ab Werk geschützt ist, wie du sichtbare Aufgaben wählst, Formulare anderer Plugins aufnimmst und die Zahlen der Übersicht liest.

[Zur Produktseite](https://stoneandwater.online/de/captcha-formularschutz.html)[Direkt anfragen](https://stoneandwater.online/de/kontakt.html)

## Systemvoraussetzungen

Shopware 6.6 oder 6.7. Das Plugin legt bei der Installation eigene Tabellen für Stempel, Zählung, Statistik und Protokoll an. Ein Neuaufbau des Themes ist nicht nötig.

**Gut zu wissen:** Geschützte Formulare lassen sich nur mit eingeschaltetem JavaScript absenden, weil der Browser die Aufgabe lösen muss.

## Installation

Am einfachsten über die Plugin Suite: Plugin auswählen, installieren, fertig. Alternativ das ZIP im Admin unter Erweiterungen, Meine Erweiterungen, Erweiterung hochladen einspielen, danach installieren und aktivieren. Ein SSH-Zugang ist nicht nötig.

## Lizenz

Das Plugin braucht eine Lizenz. Startest du in der Plugin Suite den Test oder mietest das Plugin, trägt die Plugin Suite den Schlüssel von selbst ein. Hast du einen Schlüssel von uns bekommen, gibst du ihn in der Lizenzansicht des Moduls ein.

**Wichtig:** Ohne gültige Lizenz greift der Schutz nicht. Die Formulare laufen dann ungeprüft durch, und das Modul zeigt nur die Lizenzansicht.

## Aufruf

Das Modul liegt unter Administration, Plugin Suite, Captcha & Formularschutz. Es hat drei Reiter: Übersicht, Protokoll und Einstellungen. Oben wählst du den Verkaufskanal und die Darstellung (hell, dunkel oder wie das System).

## Erste Schritte

Nach dem Aktivieren ist nichts weiter zu tun. Ab Werk gilt:

- Der Schutz ist aktiv und arbeitet unsichtbar
- Registrierung, Anmeldung, Kontaktformular, Newsletter, Passwort-Anfrage, Bewertungen und Widerruf sind geschützt
- Rechenaufgabe, Zeitprüfung, verstecktes Feld und Bremse sind eingeschaltet
- Wegwerf-Adressen und Domains ohne Mailserver werden abgelehnt
- Unter geschützten Formularen steht die Zeile "Geschützt ohne Cookies und ohne Dritte"

**Tipp:** Sende nach der Installation einmal selbst das Kontaktformular ab. In der Übersicht erscheint die Absendung danach unter "Angenommen".

## Die Übersicht

Die Übersicht zeigt für 7, 30 oder 90 Tage, was passiert ist:

- **Kennzahlen:** heute abgewehrt, in 7 Tagen abgewehrt, im Zeitraum abgewehrt und angenommen, Anteil abgewehrt und die Zahl der gerade gebremsten Adressen
- **Absendungen je Tag:** ein Diagramm mit angenommenen und abgewehrten Absendungen. Fahre mit der Maus über einen Tag oder tippe ihn an, um die Zahlen zu sehen
- **Formulare:** welche Formulare geschützt sind und wie viele Absendungen je Formular angenommen oder abgewehrt wurden
- **Gründe der Abwehr:** warum abgewiesen wurde, etwa "Zu schnell abgesendet" oder "Wegwerf-Adresse"
- **Wegwerf-Adressen:** Zahl der Domains in der Liste und ihr Stand, mit dem Knopf "Liste jetzt laden"
- **Erkannte Formulare:** Absendungen an Formulare, die noch nicht geschützt sind

## Das Protokoll

Das Protokoll listet jede abgewiesene Absendung mit Zeit, Formular, Grund, Bremsstufe und Verkaufskanal. Du kannst nach Formular und Grund filtern und nach Adresse oder Domain suchen.

Gespeichert wird die gekürzte Adresse und bei E-Mail-Prüfungen nur die Domain, keine vollständige Adresse und kein Inhalt. "Protokoll leeren" löscht alle Einträge, die Zahlen der Übersicht bleiben erhalten.

## Gründe der Abwehr

Diese Gründe können in Übersicht und Protokoll stehen:

- **Verstecktes Feld ausgefüllt**
- **Formular nie im Browser geöffnet**
- **Gefälschter Stempel**
- **Stempel eines anderen Formulars**
- **Aufgabe falsch beantwortet**
- **Aufgabe nicht gelöst**
- **Stempel abgelaufen**
- **Anderes Netz als beim Öffnen**
- **Zu schnell abgesendet**
- **Rechenaufgabe nicht gelöst**
- **Stempel zweimal benutzt**
- **Wegwerf-Adresse**
- **Domain ohne Mailserver**
- **Gesperrte Domain**

## Art des Captchas wählen

Unter Einstellungen, Art des Captchas legst du fest, ob der Schutz unsichtbar arbeitet oder der Besucher eine sichtbare Aufgabe löst. Es gibt einen Standard für alle Formulare und eine eigene Auswahl je Formular.

- **Unsichtbar:** stört niemanden, ab Werk eingestellt
- **Feld zum Anklicken:** ein Haken "Ich bin ein Mensch"
- **Schieberegler:** den Regler nach rechts schieben
- **Knopf gedrückt halten:** für die eingestellte Haltezeit
- **Rechen- oder Textfrage:** eine kleine Rechenaufgabe oder eine eigene Frage
- **Bildauswahl:** das genannte Bild aus zwölf Symbolen wählen

Die unsichtbaren Prüfungen laufen in jedem Fall mit. Frage und Bildauswahl verlangen eine richtige Antwort, je Stempel gibt es einen Versuch.

**Tipp:** Im Fuß der Seite ist wenig Platz. Für den Newsletter passt Unsichtbar oder das Feld zum Anklicken am besten.

## Eigene Fragen

Im Feld "Eigene Fragen" trägst du eine Frage je Zeile ein. Frage und Antwort trennst du durch einen senkrechten Strich, mehrere richtige Antworten durch einen Strichpunkt. Groß- und Kleinschreibung spielt keine Rolle.

Beispiel: `Welche Farbe hat der Himmel bei gutem Wetter|blau;hellblau`

Ohne eigene Fragen stellt das Plugin kleine Rechenaufgaben.

## Aufgabe bei Verdacht

Greift die Bremse bei einer Adresse, bekommt diese Adresse statt der unsichtbaren Prüfung eine sichtbare Aufgabe. Ab Werk ist das der Schieberegler. Formulare, für die du selbst eine sichtbare Aufgabe gewählt hast, behalten ihre.

## Weitere Formulare schützen

Formulare anderer Plugins nimmst du über ihren Pfad auf. Trage unter Einstellungen, Geschützte Formulare, Weitere Formulare einen Pfad je Zeile ein, zum Beispiel `/mein-plugin/anfrage`. Ein Stern am Ende schützt alle Pfade, die so beginnen.

Einfacher geht es über die Erkennung: Ist "Neue Formulare erkennen" eingeschaltet, merkt sich das Plugin Absendungen an ungeschützte Formulare und zeigt sie in der Übersicht unter "Erkannte Formulare". Mit "Schützen" wird der Pfad übernommen, mit "Ausblenden" verschwindet die Zeile. Gespeichert werden nur Pfad, Route und Anzahl.

**Gut zu wissen:** Routen von Shopware selbst wie Warenkorb, Bestellung und Kundenkonto werden nicht erfasst.

## Die Bremse

Die Bremse zählt Absendungen je Adresse in einem Fenster von zehn Minuten. Eine angenommene Absendung zählt einen Punkt, eine abgewiesene drei.

- **Erste Stufe:** ab dem eingestellten Wert (ab Werk 8 Punkte), Wartezeit 5 Sekunden
- **Zweite Stufe:** ab dem Doppelten, Wartezeit 15 Sekunden
- **Dritte Stufe:** ab dem Vierfachen, die längste Wartezeit (ab Werk 30 Sekunden)

Mit jeder Stufe wird die Rechenaufgabe schwerer. Der Besucher sieht während der Wartezeit einen Hinweis, danach wird das Formular von selbst abgesendet. Gesperrt wird niemand.

## Prüfung der E-Mail-Adresse

Bei Registrierung, Newsletter und Kontaktformular prüft das Plugin die Adresse:

- **Wegwerf-Adressen:** Adressen von Diensten für Wegwerf-Postfächer werden abgelehnt. Die Liste liegt dem Plugin bei und wird einmal je Woche erneuert, wenn das eingeschaltet ist
- **Domains ohne Mailserver:** per DNS wird geprüft, ob die Domain E-Mails empfangen kann. Das fängt Tippfehler und erfundene Adressen ab
- **Eigene Listen:** Domains, die du zusätzlich sperren oder ausdrücklich erlauben willst

**Gut zu wissen:** Ist die Namensauflösung des Servers gestört, wird niemand abgewiesen. Beim Nachladen der Liste werden keine Daten des Shops oder der Kunden übertragen.

## Verkaufskanäle und Vererbung

Oben im Modul wählst du "Alle Verkaufskanäle" oder einen einzelnen Verkaufskanal. Felder ohne eigenen Wert übernehmen die Einstellung aus "Alle Verkaufskanäle". Mit einem Klick auf "Geerbt" oder "Eigener Wert" wechselst du zwischen beidem.

## Texte ändern

Alle Texte, die der Besucher sieht, sind Textbausteine und lassen sich unter Einstellungen, Textbausteine ändern. Die wichtigsten:

- `stawFormGuard.badge`: Hinweiszeile unter geschützten Formularen ("Geschützt ohne Cookies und ohne Dritte")
- `stawFormGuard.checkbox`: Text am Feld zum Anklicken ("Ich bin ein Mensch")
- `stawFormGuard.slider`: Text am Schieberegler ("Regler nach rechts schieben")
- `stawFormGuard.hold`: Text am Knopf zum Halten ("Gedrückt halten")
- `stawFormGuard.alternative`: Link zur Ersatzfrage ("Stattdessen eine Frage beantworten")
- `stawFormGuard.wait`: Hinweis während der Wartezeit ("Viele Versuche von deinem Anschluss. Das Formular wird in wenigen Sekunden abgesendet")
- `error.STAW_FORM_GUARD_FAILED`: Meldung bei fehlgeschlagener Prüfung ("Die Sicherheitsprüfung ist fehlgeschlagen. Bitte lade die Seite neu und sende das Formular noch einmal ab.")
- `error.STAW_FORM_GUARD_EMAIL`: Meldung bei abgelehnter Adresse ("Diese E-Mail-Adresse wird nicht angenommen. Bitte verwende eine andere Adresse.")

## Hinter Proxy oder CDN

Steht der Shop hinter einem Proxy oder CDN, sieht er zunächst nur dessen Adresse. Die Übersicht zeigt dann einen Hinweis. Trage den Proxy in der Datei `.env` unter `TRUSTED_PROXIES` ein, damit Bremse und Zählung die echte Adresse der Besucher verwenden.

## Grenzen des Schutzes

Ein Captcha hält die Masse der Bots ab. Gezielte Angreifer mit echten Browsern oder gekaufter Rechenzeit hält es nicht sicher auf. Für solche Fälle helfen zusätzlich die Bremse, die Prüfung der E-Mail-Adresse und ein Blick in das Protokoll.

## Problemlösung

**Ein echter Kunde wird abgewiesen:** Schau im Protokoll nach dem Grund. Bei "Zu schnell abgesendet" hilft eine kürzere Mindestzeit, bei "Anderes Netz als beim Öffnen" das Ausschalten der Bindung an das Netz.

**Eine Anbindung kann kein Formular mehr absenden:** Trage ihre Adresse unter Allgemein, Adressen ohne Prüfung ein.

**Die Bremse greift bei allen Besuchern zugleich:** Der Shop steht vermutlich hinter einem Proxy und sieht nur dessen Adresse. Siehe "Hinter Proxy oder CDN".

**Die Hinweiszeile soll weg:** Schalte unter Allgemein "Hinweiszeile im Formular zeigen" aus.

## Support

Fragen und Wünsche gern direkt an uns - der Support kommt vom Entwickler, nicht aus einer Warteschleife. Über die Plugin Suite im Admin lässt sich zusätzlich ein Feature anfragen.

## Alle Einstellungen

Jede Einstellung des Plugins mit Standardwert und Erklärung, in derselben Reihenfolge wie im Administrationsbereich. Die Texte stammen direkt aus dem Plugin (Version 1.1.1).

### Allgemein

Schutz ein- und ausschalten, Hinweiszeile im Formular und Ausnahmen.

**Schutz aktiv** Standard: an

Schaltet den gesamten Schutz ein oder aus. Ausgeschaltet werden keine Formulare geprüft und kein Skript geladen.

**Hinweiszeile im Formular zeigen** Standard: an

Zeigt unter geschützten Formularen die Zeile Geschützt ohne Cookies und ohne Dritte. Der Text lässt sich unter Einstellungen, Textbausteine ändern (stawFormGuard.badge).

**Angemeldete Kunden nicht prüfen** Standard: aus

Absendungen angemeldeter Kunden laufen ohne Prüfung durch. Gäste zählen nicht als angemeldet. Nur einschalten, wenn die Registrierung selbst geschützt ist.

**Adressen ohne Prüfung** Standard: leer

Eine Adresse oder ein Netz je Zeile, zum Beispiel 203.0.113.7 oder 203.0.113.0/24. Für eigene Überwachung oder Anbindungen, die Formulare automatisch absenden.

### Art des Captchas

Ob der Schutz unsichtbar arbeitet oder der Besucher eine sichtbare Aufgabe löst. Einstellbar als Standard und je Formular. Die unsichtbaren Prüfungen laufen in jedem Fall mit.

**Standard für alle Formulare** Standard: Unsichtbar

Unsichtbar stört niemanden. Feld zum Anklicken, Schieberegler und Halten zeigen den Schutz und halten einfache Bots ab. Frage und Bildauswahl verlangen eine richtige Antwort. Die Bildauswahl ist der schwächste Schutz und für Screenreader nur über die Ersatzfrage lösbar.

**Aufgabe bei Verdacht** Standard: Schieberegler

Greift die Bremse bei einer Adresse, bekommt sie statt der unsichtbaren Prüfung diese sichtbare Aufgabe. Formulare mit eigener sichtbarer Aufgabe behalten ihre.

**Art bei der Registrierung** Standard: Wie Standard

Eigene Art für die Registrierung. Wie Standard übernimmt die Einstellung oben.

**Art bei der Anmeldung** Standard: Wie Standard

Eigene Art für die Anmeldung. Wie Standard übernimmt die Einstellung oben.

**Art beim Kontaktformular** Standard: Wie Standard

Eigene Art für das Kontaktformular. Wie Standard übernimmt die Einstellung oben.

**Art beim Newsletter** Standard: Wie Standard

Eigene Art für den Newsletter. Im Fuß der Seite ist wenig Platz, dort passt Unsichtbar oder das Feld zum Anklicken am besten.

**Art bei der Passwort-Anfrage** Standard: Wie Standard

Eigene Art für das Formular Passwort vergessen. Wie Standard übernimmt die Einstellung oben.

**Art bei Bewertungen** Standard: Wie Standard

Eigene Art für die Abgabe von Bewertungen. Wie Standard übernimmt die Einstellung oben.

**Art beim Widerruf** Standard: Wie Standard

Eigene Art für das Widerrufsformular. Wie Standard übernimmt die Einstellung oben.

**Art bei weiteren Formularen** Standard: Wie Standard

Eigene Art für die unter Weitere Formulare eingetragenen Pfade.

**Haltezeit in Sekunden** Standard: 2

Wie lange der Knopf im Modus Gedrückt halten gehalten werden muss.

**Eigene Fragen** Standard: leer

Eine Frage je Zeile, Frage und Antwort durch einen senkrechten Strich getrennt, mehrere richtige Antworten durch Strichpunkt. Beispiel: Welche Farbe hat der Himmel bei gutem Wetter, dann der Strich, dann blau. Groß- und Kleinschreibung ist egal. Ohne eigene Fragen stellt das Plugin eine Rechenfrage in Worten. Eigene Fragen gelten in allen Sprachen.

**Farbe der Aufgabe** Standard: leer

Farbe für Haken, Regler und Auswahl als Hex-Wert, zum Beispiel #0b5c7d. Leer übernimmt die Hauptfarbe des Themes. Schrift, Rahmen und Rundungen kommen immer aus dem Theme.

### Geschützte Formulare

Welche Formulare der Storefront geprüft werden. Jedes Formular ist einzeln schaltbar.

**Registrierung** Standard: an

Kundenkonto anlegen, auch im Bestellabschluss und als Gast.

**Anmeldung** Standard: an

Anmeldung der Kunden in der Storefront. Bremst das Durchprobieren von Passwörtern.

**Kontaktformular** Standard: an

Das Kontaktformular von Shopware, auch in Erlebniswelten.

**Newsletter** Standard: an

An- und Abmeldung zum Newsletter, auch im Fuß der Seite und in Erlebniswelten.

**Passwort-Anfrage** Standard: an

Formular Passwort vergessen. Verhindert Wellen von Passwort-E-Mails.

**Bewertungen** Standard: an

Abgabe von Produktbewertungen.

**Widerruf** Standard: an

Das Widerrufsformular neuerer Shopware-Versionen. In älteren Versionen ohne Wirkung.

**Weitere Formulare** Standard: leer

Pfade weiterer Formulare, einer je Zeile, zum Beispiel /mein-plugin/anfrage. Ein Stern am Ende schützt alle Pfade, die so beginnen. Geeignet für Formulare aus anderen Plugins, die per POST absenden.

**Neue Formulare erkennen** Standard: an

Merkt sich Absendungen an Formulare, die nicht geschützt sind, und zeigt sie in der Übersicht unter Erkannte Formulare. Gespeichert werden nur Pfad, Route und Anzahl.

### Prüfungen

Die unsichtbaren Prüfungen der ersten Stufe: Rechenaufgabe, Zeit, verstecktes Feld und signierter Stempel.

**Rechenaufgabe im Hintergrund** Standard: an

Der Browser löst vor dem Absenden unbemerkt eine Rechenaufgabe. Für Besucher kaum messbar, für Massenversand teuer.

**Schwierigkeit der Rechenaufgabe** Standard: Normal (empfohlen)

Bestimmt, wie lange der Browser rechnet. Die Bremse erhöht die Schwierigkeit bei vielen Versuchen zusätzlich.

**Zeitprüfung** Standard: an

Ein Formular, das schneller abgesendet wird, als ein Mensch es ausfüllen kann, wird abgewiesen. Echte Besucher merken davon nichts, ihr Browser wartet die Zeit selbst ab.

**Mindestzeit in Sekunden** Standard: 2

Zeit zwischen dem ersten Klick in das Formular und dem Absenden. Empfohlen sind 2 bis 4 Sekunden.

**Verstecktes Feld** Standard: an

Fügt ein für Menschen unsichtbares Feld ein. Bots, die alle Felder ausfüllen, verraten sich damit.

**Stempel an das Netz des Besuchers binden** Standard: aus

Der Stempel gilt nur für das Netz, aus dem das Formular geöffnet wurde. Strenger, kann aber Besucher abweisen, deren Anbieter während des Ausfüllens die Adresse stark wechselt. Ab Werk aus.

**Gültigkeit des Stempels in Minuten** Standard: 60

So lange darf ein Formular nach dem ersten Klick offen bleiben. Danach holt der Browser beim Absenden von selbst einen neuen Stempel.

### Bremse bei vielen Versuchen

Adressen mit vielen Absendungen in kurzer Zeit müssen warten und bekommen eine schwerere Rechenaufgabe. Niemand wird gesperrt.

**Bremse aktiv** Standard: an

Bremst Adressen mit vielen Absendungen in zehn Minuten in drei Stufen: 5 Sekunden, 15 Sekunden und die längste Wartezeit, jeweils mit schwererer Rechenaufgabe.

**Bremse ab Punkten** Standard: 8

Eine angenommene Absendung zählt einen Punkt, eine abgewiesene drei. Ab diesem Wert in zehn Minuten greift die erste Stufe, ab dem Doppelten die zweite, ab dem Vierfachen die dritte.

**Längste Wartezeit in Sekunden** Standard: 30

Wartezeit der dritten Stufe. Der Besucher sieht währenddessen einen Hinweis, das Formular wird danach von selbst abgesendet.

### Prüfung der E-Mail-Adresse

Lehnt Wegwerf-Adressen und Domains ohne Mailserver bei Registrierung, Newsletter und Kontaktformular ab.

**Wegwerf-Adressen ablehnen** Standard: an

Lehnt Adressen von Diensten für Wegwerf-Postfächer ab. Der Besucher bekommt den Hinweis, eine andere Adresse zu verwenden.

**Domains ohne Mailserver ablehnen** Standard: an

Prüft per DNS, ob die Domain E-Mails empfangen kann. Fängt Tippfehler und erfundene Adressen ab. Ist die Namensauflösung des Servers gestört, wird niemand abgewiesen.

**Eigene gesperrte Domains** Standard: leer

Eine Domain je Zeile. Subdomains sind eingeschlossen.

**Immer erlaubte Domains** Standard: leer

Eine Domain je Zeile. Diese Domains werden nie abgelehnt, auch wenn sie in der Liste der Wegwerf-Adressen stehen.

**Liste wöchentlich erneuern** Standard: an

Lädt die Liste der Wegwerf-Domains einmal je Woche von GitHub nach. Dabei werden keine Daten des Shops oder der Kunden übertragen.

### Protokoll

Ob abgewiesene Absendungen protokolliert werden und wie lange.

**Abgewiesene Absendungen protokollieren** Standard: an

Schreibt jede Abweisung mit Grund in das Protokoll. Die Zahlen der Übersicht werden unabhängig davon geführt.

**Aufbewahrung in Tagen** Standard: 30

Ältere Einträge löscht die tägliche Aufgabe von selbst.

## Verfügbarkeit

Direkt über Stone & Water

### Über die Plugin Suite

Monatlich 4,99 €

Bester Preis Jährlich 50,90 € 15 % günstiger

Alle Preise netto zzgl. USt.

Lade die kostenlose Plugin Suite herunter und spiele sie im Admin ein, ganz ohne SSH. Darüber installierst und aktualisierst du das Plugin mit einem Klick. Die Lizenz kaufst du direkt bei uns, mit Rechnung von uns und Support direkt vom Entwickler.

[Plugin Suite herunterladen](https://stoneandwater.online/de/plugin-suite.html)[+49 2555 9997342](tel:+4925559997342)

Testen

### 30 Tage kostenlos

In der Plugin Suite startest du den Test mit einem Klick. Nach 30 Tagen geht er in die Miete über, wenn du ihn nicht vorher beendest. Beenden kannst du jederzeit in der Plugin Suite.
