Google reCAPTCHA v3 ist in drei verschiedene Stufen unterteilt. Dieser Artikel konzentriert sich auf die Integration des Essentials-Tarifs, da er kostenlos verwendet werden kann. Die unten gezeigte Integration funktioniert grundsätzlich auch mit den Tarifen Standard und Enterprise, aber Sie können einen benutzerdefinierten Connector und SSBO hinzufügen, um stattdessen die Enterprise REST API mit API-Schlüsseln zu verwenden.
Um Google reCAPTCHA v3 zu verwenden, müssen Sie:
Fügen Sie das Captcha-Widget zum Bildschirm in Ihrer Anwendung hinzu, der durch Google reCAPTCHA v3 geschützt sein soll. Mindestens die folgende Konfiguration der Eigenschaften des Widgets ist erforderlich:
| Eigentum | Wert | Beschreibung |
|---|---|---|
| ID | Standardeinstellung: Captcha1 | Passen Sie die ID nach Bedarf an, um sie an allen Stellen wie Process Designer leicht zu identifizieren |
| captchaTyp | reCAPTCHA v3 | – |
| Aktion | Standardeinstellung: Senden | Definieren Sie einen beliebigen Aktionsnamen, den Sie verwenden möchten |
| siteKey (englisch) | <Ihr Google Site Key> | Geben Sie den reCAPTCHA Site Key ein, den Sie erstellt haben (siehe Voraussetzungen) |
| AbzeichenSichtbar | wahr|falsch | Google ermöglicht es Ihnen, das reCAPTCHA-Abzeichen auszublenden, solange Sie das reCAPTCHA-Branding sichtbar in den Nutzerfluss einbeziehen. (Lesen Sie mehr). Wenn Sie das Abzeichen ausblenden, müssen Sie das Branding manuell hinzufügen. |
Um die Bewertung von reCAPTCHA v3 auszulösen, müssen Sie Ihrem Bildschirm eine Schaltfläche hinzufügen. Aktivieren Sie die Eigenschaft ‘testCaptcha’. Nun wird das Captcha getestet bzw. die Bewertung des Captcha ausgelöst, sobald der Button gedrückt wird.
Jetzt müssen wir wissen, wann Google das Captcha bewertet hat und der Score innerhalb Ihres Backend-Prozesses analysiert werden kann. Fügen Sie dazu eine neue Story im Process Designer hinzu (z.B. ‘Formular senden’), abonnieren Sie das ‘validationFinished’ Event Ihres Captcha-Widgets und lösen Sie die serverseitige Business Object Funktion aus, die den weiteren Prozess ausführt. In unserem Fall rufen wir eine serverseitige Demo-Business-Objekt-Funktion auf und zeigen bei Erfolg ein Nachrichtentoast an.
Es ist wichtig, den Wert der Captcha-Eigenschaft ‘resultToken’ im Eingabe-Mapping zu übergeben. Dieses Token ist erforderlich, um die Punktzahl von Google abzurufen.
Um die Bewertung innerhalb des serverseitigen Business Objekts zu validieren, rufen Sie die Funktion ‘verifySite’ unseres standardmäßigen serverseitigen Business Objekts ‘SF_reCAPTCHA’ auf. Für die Payload sind das im Eingabemapping übergebene Ergebnistoken und Ihr geheimer Schlüssel erforderlich, der mit Ihrem Google-Websiteschlüssel erstellt wurde. (Siehe Voraussetzungen) Im Tarif “Essentials” kann die Bewertung einen der folgenden 4 Werte aufweisen: 0,1, 0,3, 0,7, 0,9. Je höher der Wert, desto wahrscheinlicher ist es, dass ein Mensch die Handlung ausgeführt hat. In unserem Demo-Case überprüfen wir zunächst den Erfolg des Scorings und analysieren dann den Score. Als Beispiel werfen wir einen Fehler, wenn die Punktzahl niedriger als 0,9 ist. Passen Sie die Analyse nach Bedarf an und fügen Sie Ihre Prozesslogik nach der Prüfung hinzu.
Bereitstellen und das Captcha ist integriert
