Widget einbinden¶
Das Widget wird in drei Schritten eingebunden:
- ■ ein Skript im Kopfbereich der Seite
- ■ ein Element an der Stelle des Logos
- ■ eine Prüfung des Tokens auf Ihrem Server
Änderungen am DNS sind nicht erforderlich.
Die folgenden Voraussetzungen müssen erfüllt sein:
- ☑ Sie haben einen Sitekey angelegt. Siehe Ersten Sitekey anlegen.
- ☑ Sie kennen den öffentlichen Sitekey und das Secret. Beide stehen in der Ansicht Details des Sitekeys. Siehe Ansicht Details.
- ☑ Sie können das HTML und den serverseitigen Quelltext Ihrer Website bearbeiten.
Schritt 1: Skript einbinden¶
Fügen Sie das folgende Element in den Bereich <head> Ihrer Seite ein:
Note
Wenn Ihre Website eine Content Security Policy sendet, dann muss diese die Adressen https://cdn.eu-captcha.eu und https://api.eu-captcha.eu freigeben. Ohne diese Freigabe blockiert der Browser das Widget. Siehe Content Security Policy.
Schritt 2: Widget-Element einfügen¶
Fügen Sie das folgende Element an der Stelle ein, an der das Myra-Logo erscheinen soll, üblicherweise innerhalb des zu schützenden Formulars:
Ersetzen Sie den Wert von data-sitekey durch Ihren öffentlichen Sitekey.
Schritt 3: Token serverseitig prüfen¶
Prüfen Sie das Token auf Ihrem Server, bevor Sie das Formular verarbeiten:
POST https://api.eu-captcha.eu/v1/verify
Content-Type: application/json
{
"sitekey": "a1b2c3d4-0000-0000-0000-000000000000",
"secret": "a1b2c3d4••••",
"token": "TOKEN_AUS_DEM_WIDGET"
}
Wenn die Antwort den Erfolg bestätigt, dann verarbeiten Sie die Absendung. Andernfalls weisen Sie die Absendung zurück.
Warning
Das Secret gehört ausschließlich auf Ihren Server. Geben Sie es niemals im HTML oder in JavaScript aus.
Plattformspezifische Anleitungen¶
Für die verbreiteten Plattformen stehen Bibliotheken und Erweiterungen bereit, die diese drei Schritte übernehmen. Siehe Integration.
Siehe Integration testen.