reCAPTCHA v3

reCAPTCHA Version 3 gibt für jede Anfrage eine Punktzahl zurück, ohne dass der Vorgang störungsfrei ist. Der Wert basiert auf Interaktionen mit Ihrer Website und ermöglicht es Ihnen, entsprechende Maßnahmen zu ergreifen. Registriere reCAPTCHA v3-Schlüssel in der reCAPTCHA-Admin-Konsole.

Auf dieser Seite wird erläutert, wie Sie reCAPTCHA, Version 3, auf Ihrer Webseite aktivieren und anpassen.

Platzierung auf Ihrer Website

reCAPTCHA v3 unterbricht Ihre Nutzer nie, sodass Sie es jederzeit ausführen können, ohne die Conversion zu beeinträchtigen. reCAPTCHA funktioniert am besten, wenn es den meisten Kontext zu Interaktionen mit Ihrer Website hat, da sowohl legitimes als auch missbräuchliches Verhalten erkannt wird. Aus diesem Grund empfehlen wir, die reCAPTCHA-Bestätigung für Formulare oder Aktionen sowie für die Analyse von Seiten im Hintergrund zu verwenden.

Sie können reCAPTCHA für beliebig viele Aktionen auf derselben Seite ausführen.

Den Wettkampf automatisch an eine Schaltfläche binden

Die einfachste Methode zur Verwendung von reCAPTCHA, Version 3 auf deiner Seite, besteht darin, die erforderliche JavaScript-Ressource einzubinden und der HTML-Schaltfläche einige Attribute hinzuzufügen.

  1. Laden Sie die JavaScript API.

     <script src="https://www.google.com/recaptcha/api.js"></script>

  2. Fügen Sie eine Callback-Funktion zum Verarbeiten des Tokens hinzu.

     <script>
   function onSubmit(token) {
     document.getElementById("demo-form").submit();
   }
 </script>

  3. Fügen Sie der HTML-Schaltfläche Attribute hinzu.

    <button class="g-recaptcha" 
        data-sitekey="reCAPTCHA_site_key" 
        data-callback='onSubmit' 
        data-action='submit'>Submit</button>

Aufruf programmatisch starten

Wenn Sie mehr Kontrolle darüber haben möchten, wann reCAPTCHA ausgeführt wird, können Sie die Methode execute im Objekt grecaptcha verwenden. Dazu müssen Sie dem reCAPTCHA-Skriptaufruf den Parameter render hinzufügen.

  1. Laden Sie die JavaScript API mit Ihrem Websiteschlüssel.

    <script src="https://www.google.com/recaptcha/api.js?render=reCAPTCHA_site_key"></script>

  2. Rufen Sie bei jeder Aktion, die Sie schützen möchten, grecaptcha.execute auf.

       <script>
      function onClick(e) {
        e.preventDefault();
        grecaptcha.ready(function() {
          grecaptcha.execute('reCAPTCHA_site_key', {action: 'submit'}).then(function(token) {
              // Add your logic to submit to your backend server here.
          });
        });
      }
  </script>

  3. Senden Sie das Token sofort mit der Anfrage zur Bestätigung an Ihr Back-End.

Die Punktzahl interpretieren

reCAPTCHA v3 gibt einen Wert zurück (1.0 ist sehr wahrscheinlich eine gute Interaktion, 0.0 ist sehr wahrscheinlich ein Bot). Je nach Bewertung können Sie im Kontext Ihrer Website variable Aktionen ausführen. Jede Website ist anders. Nachfolgend finden Sie einige Beispiele dafür, wie Websites die Bewertung verwenden. Gehen Sie wie in den folgenden Beispielen im Hintergrund vor, anstatt den Traffic zu blockieren, um Ihre Website besser zu schützen.

Anwendungsfall Empfehlung
Startseite Zeigen Sie eine zusammenhängende Ansicht Ihres Traffics in der Admin-Konsole an, während Sie Scraper filtern.
login Bei niedrigen Punktzahlen ist eine Bestätigung in zwei Schritten oder eine E-Mail-Bestätigung erforderlich, um Credential Stuffing-Angriffe zu verhindern.
social Begrenzen Sie unbeantwortete Freundschaftsanfragen von missbräuchlichen Nutzern und senden Sie riskante Kommentare zur Moderation.
E-Commerce Stellen Sie Ihren realen Umsatz vor Bots und identifizieren Sie riskante Transaktionen.

reCAPTCHA lernt anhand von realem Traffic auf Ihrer Website. Aus diesem Grund können Punktzahlen in einer Staging-Umgebung oder kurz nach der Implementierung von der Produktion abweichen. Da bei reCAPTCHA v3 der Nutzerfluss nie unterbrochen wird, können Sie reCAPTCHA zuerst ausführen, ohne Maßnahmen zu ergreifen, und dann die Schwellenwerte festlegen, indem Sie den Traffic in der Admin-Konsole prüfen. Standardmäßig können Sie einen Grenzwert von 0, 5 verwenden.

Aktionen

Mit reCAPTCHA v3 wird ein neues Konzept eingeführt: Aktionen. Wenn Sie an jedem Ort, an dem Sie reCAPTCHA ausführen, einen Aktionsnamen angeben, werden die folgenden neuen Funktionen aktiviert:

  • Eine detaillierte Aufschlüsselung der Daten für Ihre zehn wichtigsten Aktionen in der Admin-Konsole
  • Adaptive Risikoanalyse basierend auf dem Kontext der Aktion, da missbräuchliches Verhalten variieren kann.

Wichtig: Wenn Sie die reCAPTCHA-Antwort prüfen, sollten Sie prüfen, ob der Aktionsname der erwartete Name ist.

Bestätigung der Website bestätigen

Stellen Sie die Anfrage zur Bestätigung des Antworttokens wie bei reCAPTCHA v2 oder Invisible reCAPTCHA.

Die Antwort ist ein JSON-Objekt:

{
  "success": true|false,      // whether this request was a valid reCAPTCHA token for your site
  "score": number             // the score for this request (0.0 - 1.0)
  "action": string            // the action name for this request (important to verify)
  "challenge_ts": timestamp,  // timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
  "hostname": string,         // the hostname of the site where the reCAPTCHA was solved
  "error-codes": [...]        // optional
}

tipps

  1. grecaptcha.ready() führt die Funktion aus, wenn die reCAPTCHA-Bibliothek geladen wird. Fügen Sie vor den Skripts, die grecaptcha aufrufen, den api.js ein oder verwenden Sie weiterhin den Onload-Callback, der mit der API V2 definiert ist, um Race-Bedingungen mit api.js zu vermeiden.
  2. Versuchen Sie, den execute-Aufruf für interessante oder sensible Aktionen wie Registrieren, Zurücksetzen des Passworts, Kaufen oder Spielen zu aktivieren.
  3. Verwenden Sie https://www.google.com/recaptcha/api.js?trustedtypes=true, um Code zu laden, der mit Vertrauenswürdigen Typen kompatibel ist.