Häufig gestellte Fragen

Sollte ich reCAPTCHA Enterprise verwenden?

reCAPTCHA Enterprise bietet bis zu 10.000 kostenlose Bewertungen pro Monat und zusätzliche Funktionen. Andere Funktionen wie Echtzeitanalysen sind für die meisten Entwickler der beste Ausgangspunkt. Hier starten

Kann ich reCAPTCHA mit Lösungen von Drittanbietern verwenden?

Ja, Sie können sowohl reCAPTCHA (Nicht-Enterprise-Version) als auch reCAPTCHA Enterprise verwenden. In der Regel werden Sie von der Drittanbieterlösung nach Ihrem öffentlichen Schlüssel und entweder Ihrem Secret- oder Ihrem API-Schlüssel gefragt. Geben Sie Ihren geheimen Schlüssel und Ihren API-Schlüssel nur an vertrauenswürdige Drittanbieter weiter.

Wie migriere ich von v2 oder v3 zu reCAPTCHA Enterprise?

Die Migration dauert 5–10 Minuten und erfordert keine Codeänderungen.

Sollte ich reCAPTCHA V2 oder V3 verwenden?

reCAPTCHA V3 ist für Websiteinhaber gedacht, die mehr Daten zu ihrem Traffic erhalten möchten. Weitere Informationen finden Sie im Entwicklerleitfaden für reCAPTCHA V3.

Wir unterstützen Sicherheit und Nutzerfreundlichkeit für v2.

Weitere Informationen zu den Unterschieden zwischen reCAPTCHA V2 und V3 finden Sie im Versionsvergleich.

Verwendet reCAPTCHA Cookies?

reCAPTCHA setzt bei der Ausführung ein erforderliches Cookie (_GRECAPTCHA), um die Risikoanalyse bereitzustellen. Wenn Sie die Domain www.google.com nicht verwenden möchten, weil dort möglicherweise andere Cookies gesetzt sind, können Sie stattdessen www.recaptcha.net verwenden.

Gibt es Einschränkungen bei den Abfragen pro Sekunde oder Tageslimits für die Verwendung von reCAPTCHA?

Wenn Sie mehr als 1.000 Aufrufe pro Sekunde oder 1.000.000 Aufrufe pro Monat ausführen möchten, müssen Sie reCAPTCHA Enterprise verwenden oder dieses Formular ausfüllen und auf die Genehmigung einer Ausnahme warten. Wenn ein Websiteschlüssel 1.000 Abfragen pro Sekunde überschreitet, werden einige Anfragen möglicherweise nicht verarbeitet. Wenn ein v3-Websiteschlüssel das monatliche Kontingent überschreitet, kann „site_verify“ fehlschlagen und für den Rest des Monats einen statischen Faktor von 0,9 und die Fehlermeldung „Over free quota.“ zurückgeben. Es gibt keine für Nutzer sichtbaren Hinweise, wenn v3-Websites das Kontingent überschreiten. Wenn ein v2-Websiteschlüssel das monatliche Kontingent überschreitet, wird Nutzern im reCAPTCHA-Widget für den Rest des Monats möglicherweise die folgende oder eine ähnliche Meldung angezeigt: „Diese Website überschreitet das reCAPTCHA-Kontingent.“ Bevor das Kontingent durchgesetzt wird, werden Websiteinhaber dreimal per E-Mail benachrichtigt und haben mindestens 90 Tage Zeit, zu reCAPTCHA Enterprise zu migrieren. Websiteschlüssel gelten als über dem Kontingent, wenn für eine Domain mehr als 1.000.000 Aufrufe pro Monat verwendet werden. Dies gilt auch, wenn dieses Volumen auf mehrere Schlüssel in derselben Domain verteilt ist.

Ich möchte das reCAPTCHA-Logo ausblenden. Was ist zulässig?

Sie dürfen das Logo ausblenden, solange Sie das reCAPTCHA-Branding im User Flow sichtbar einbinden. Geben Sie bitte den folgenden Text an:

This site is protected by reCAPTCHA.

Beispiel:

Hinweis: Wenn Sie das Logo ausblenden möchten, verwenden Sie bitte 

.grecaptcha-badge { visibility: hidden; }

Ich möchte automatisierte Tests mit reCAPTCHA ausführen. Was soll ich tun?

Erstellen Sie für reCAPTCHA V3 einen separaten Schlüssel für Testumgebungen. Die Werte sind möglicherweise nicht genau, da reCAPTCHA V3 auf realen Traffic angewiesen ist.

Verwenden Sie für reCAPTCHA V2 die folgenden Testschlüssel. Sie erhalten immer „Kein CAPTCHA“ und alle Bestätigungsanfragen werden genehmigt.

  • Websiteschlüssel: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
  • Geheimer Schlüssel: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

Im reCAPTCHA-Widget wird eine Warnmeldung angezeigt, um sicherzustellen, dass es nicht für Produktionstraffic verwendet wird.

Wie kann ich vermeiden, dass beim Debuggen meiner Website reCAPTCHA-Code ausgeführt wird?

Wenn Sie beim Debuggen von anderem JavaScript auf Ihrer Website nicht in den reCAPTCHA-Code gelangen möchten, fügen Sie das reCAPTCHA-Script /recaptcha__.+\.js$ der Ignorierliste Ihres Browsers hinzu. Eine Anleitung für Chrome finden Sie unter Benutzerdefinierte Liste von Skripts ignorieren. Ähnliche Funktionen sind auch in anderen Browsern verfügbar.

Wie kann ich mehr über die Zugriffe auf meine Website erfahren?

reCAPTCHA meldet Tagesstatistiken in der Admin-Konsole.

Kann ich reCAPTCHA weltweit verwenden?

Ja, verwenden Sie „www.recaptcha.net“ in Ihrem Code, wenn „www.google.com“ nicht zugänglich ist.

  • Ersetzen Sie zuerst <script src="https://www.google.com/recaptcha/api.js"></script> durch <script src="https://www.recaptcha.net/recaptcha/api.js"></script>.
  • Wenden Sie dies dann auf alle anderen Stellen auf Ihrer Website an, an denen „www.google.com/recaptcha/“ verwendet wird.

Kann ich das reCAPTCHA-Widget oder -Logo anpassen?

Ja. reCAPTCHA bietet zwei Designs, hell und dunkel, wie unten dargestellt. Wenn Sie ein Design auswählen möchten, legen Sie einfach das Attribut „data-theme“ im Parameter „grecaptcha.render“ fest.

Helles Design:

Dunkles Design:

Wie kann ich reCAPTCHA V3 anpassen?

Die für unsichtbares reCAPTCHA verfügbare JavaScript API funktioniert auch für v3. Verwenden Sie einfach die JavaScript API, um reCAPTCHA mit einem v3-Websiteschlüssel explizit zu rendern, um auf Optionen wie das Neupositionieren des Logos oder das Ändern des Designs zuzugreifen.

Wenn Sie reCAPTCHA V3 mit dieser Methode rendern, müssen Sie den Parameter size auf 'invisible' setzen und beim Aufrufen von grecaptcha.execute die von grecaptcha.render zurückgegebene Client-ID anstelle des Websiteschlüssels verwenden.

Seit Kurzem wird in meinem reCAPTCHA-Widget „Ungültiger Websiteschlüssel“ angezeigt. Was steht an?

Wenn dieser Fehler angezeigt wird, ist Ihr reCAPTCHA-Websiteschlüssel nicht mehr gültig. Wenn Sie die Funktion aktivieren möchten, registrieren Sie einen neuen Schlüssel und folgen Sie der Anleitung auf dieser Seite.

Ich erhalte einen nicht abgefangenen SecurityError: Ein Frame mit dem Ursprung „https://www.google.com“ wurde daran gehindert, auf einen Frame mit dem Ursprung „<Ihre Domain>“ zuzugreifen. Was soll ich tun?

Dies geschieht in der Regel, wenn das HTML-Element des reCAPTCHA-Widgets irgendwann nach dem Klicken auf das Kästchen durch den Endnutzer programmatisch entfernt wird. Wir empfehlen, das reCAPTCHA-Widget mit der JavaScript-Funktion grecaptcha.reset() zurückzusetzen.

Ich verwende auf meiner Website eine Content Security Policy (CSP). Wie kann ich es für die Verwendung mit reCAPTCHA konfigurieren?

Wir empfehlen, den in CSP3 dokumentierten Nonce-basierten Ansatz zu verwenden. Fügen Sie die Nonce in das reCAPTCHA-Script-Tag api.js ein. Wir kümmern uns um den Rest.

Hinweis: reCAPTCHA funktioniert auch mit 'strict-dynamic' in Browsern, die dies unterstützen.

Alternativ können Sie den Anweisungen die folgenden Werte hinzufügen:

  • script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
  • frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
  • connect-src https://www.google.com/recaptcha/

Ich erhalte die Fehlermeldung „Localhost is not in the list of supported domains“ (Localhost ist nicht in der Liste der unterstützten Domains enthalten). Was soll ich tun?

localhost-Domains werden standardmäßig nicht unterstützt. Wenn Sie sie weiterhin für die Entwicklung unterstützen möchten, können Sie sie der Liste der unterstützten Domains für Ihren Websiteschlüssel hinzufügen. Rufen Sie die reCAPTCHA Enterprise-Konsole oder die reCAPTCHA-Konsole auf, um die Liste der unterstützten Domains zu aktualisieren. Wir empfehlen, separate Schlüssel für die Entwicklung und die Produktion zu verwenden und nur Localhost für den Websiteschlüssel für die Entwicklung zuzulassen.

Nur unter iOS 10: Wird die Seite nach unten gescrollt, wenn der Nutzer die Sicherheitsaufgabe ausführt?

Dies ist ein Fokusfehler aufseiten von Apple, den wir dem Unternehmen gemeldet haben. Es betrifft nur Nutzer mit iOS 10 und nur einige Websites. Wenn Sie davon betroffen sind, können Sie das reCAPTCHA-Widget auf der Seite nach oben oder unten verschieben oder reCAPTCHA V3 verwenden.

Mein Computer oder Netzwerk sendet möglicherweise automatisierte Anfragen?

Wenn Sie vom reCAPTCHA-Widget auf diese Seite weitergeleitet wurden, haben Sie die Meldung „Es tut uns leid, aber Ihr Computer oder Netzwerk sendet möglicherweise automatisierte Anfragen. Zum Schutz unserer Nutzer können wir deine Anfrage derzeit nicht bearbeiten.“

Das kann leider aus verschiedenen Gründen auch bei Nutzern passieren, die sich an die Regeln halten:

  • Möglicherweise befinden Sie sich in einem gemeinsam genutzten Netzwerk, das missbräuchlich verwendet wird.
  • Ihr Internetanbieter hat Ihnen möglicherweise vor Kurzem eine verdächtige IP-Adresse zugewiesen.
  • Die Website, auf die Sie zugreifen möchten, wird möglicherweise gerade stark angegriffen

Informationen zur Behebung dieser Probleme finden Sie auf der Hilfeseite zu ungewöhnlichem Traffic. Sie können es auch später noch einmal versuchen.

Welche Aktionsnamen sind gültig?

Aktionen dürfen nur alphanumerische Zeichen, Schrägstriche und Unterstriche enthalten. Aktionen dürfen nicht nutzerspezifisch sein.