Search by

ospo / module-myra-captcha

splendidinternet

Myra EU-Captcha als weiterer Captcha-Typ neben Google reCAPTCHA für Mage-OS und Magento Open Source, mit Hyvä-Unterstützung

Package info

codeberg.org/OSPO/magento2-module-myra-captcha

Issues

Type:magento2-module

pkg:composer/ospo/module-myra-captcha

Statistics

Installs: 4

Dependents: 0

Suggesters: 0

1.0.0 2026-10-17 00:29 UTC

This package is auto-updated.

Last update: 2026-11-17 18:55:02 UTC


README

Bindet das Myra EU-Captcha als weiteren Captcha-Typ in das Captcha-Framework von Mage-OS und Magento Open Source ein. Das Captcha wird in der EU betrieben und kommt ohne Google aus. Es lässt sich wie Google reCAPTCHA je Formular auswählen.

Was das Modul tut

  • Neuer Typ „Myra EU-Captcha" in der Auswahlliste je Formular (Shops -> Konfiguration -> Sicherheit -> Google reCAPTCHA Storefront -> Storefront).
  • Das Widget erscheint in den Hyvä-Formularen an derselben Stelle wie reCAPTCHA. Das Skript https://cdn.eu-captcha.eu/verify.js wird nur auf Seiten geladen, die ein Formular mit Captcha enthalten.
  • Beim Absenden prüft der Shop das Token serverseitig bei https://api.eu-captcha.eu/v1/verify. Ist die API nicht erreichbar, wird das Formular abgewiesen, außer „Anfragen annehmen, wenn der Dienst nicht erreichbar ist" steht auf „Ja".
  • Die nötigen CSP-Freigaben sind enthalten.

Technisch hängt sich das Modul mit zwei Plugins in das Framework: Es liest das Token aus dem Feld eu-captcha-response statt g-recaptcha-response und leitet die Prüfung an die Myra-API um, wenn das Formular auf Myra eingestellt ist. Google-Typen bleiben unverändert nutzbar.

Einrichtung

  1. Unter https://app.eu-captcha.eu/ einen Sitekey je Hostname anlegen. Ein Sitekey gilt nur für den Hostnamen, für den er angelegt wurde. Bei mehreren Websites mit eigenen Domains braucht jede Website ihren eigenen Schlüssel.
  2. Im Backend unter Shops -> Konfiguration -> Sicherheit -> Google reCAPTCHA Storefront -> Myra EU-Captcha im Website-Bereich Sitekey und Secret eintragen.
  3. In derselben Seite unter Storefront bei den gewünschten Formularen „Myra EU-Captcha" wählen.
  4. Cache leeren.
PfadStandardBedeutung
recaptcha_frontend/type_myra_eu_captcha/public_keyleerSitekey, je Website
recaptcha_frontend/type_myra_eu_captcha/private_keyleerSecret, verschlüsselt gespeichert, je Website
recaptcha_frontend/type_myra_eu_captcha/failsafe0Formulare durchlassen, wenn die Myra-API nicht antwortet

Die Meldungen, die Kunden bei einer fehlgeschlagenen Prüfung sehen, sind für alle Captcha-Typen gemeinsam und stehen unter Storefront -> Fehlermeldungen (recaptcha_frontend/failure_messages/validation_failure_message und technical_failure_message). Sie sind ab Werk englisch und nennen reCAPTCHA, deshalb sollten sie je Store-Ansicht angepasst werden. Ein nicht gelöstes Captcha gilt als Prüffehler, eine nicht erreichbare Myra-API als technischer Fehler.

Solange kein Sitekey eingetragen ist, gilt das Captcha als nicht konfiguriert und Magento zeigt es nicht an.

Geeignete Formulare

Getestet mit Anmeldung, Registrierung, Passwort vergessen, Kontaktformular und Newsletter in Hyvä. Für Formulare im Luma-Checkout (Bestellung absenden, Gutschein) ist das Modul nicht gedacht, dort bleibt das Captcha aus. Formulare von Drittmodulen, die das Captcha-Framework nicht nutzen, werden nicht abgedeckt.

Installation

composer require ospo/module-myra-captcha
bin/magento module:enable Ospo_MyraCaptcha
bin/magento setup:upgrade

Im Production-Modus danach bin/magento setup:di:compile und bin/magento setup:static-content:deploy.

Lizenz: OSL-3.0, wie Magento Open Source und Mage-OS.