Häufig gestellte Fragen

Sollte ich reCAPTCHA Enterprise verwenden?

reCAPTCHA Enterprise bietet bis zu 10.000 Bewertungen pro Monat kostenlos und bietet zusätzliche Funktionen. Andere Funktionen wie Echtzeitanalysen sind für die meisten Entwickler der beste Ausgangspunkt. Hier können Sie loslegen.

Kann ich reCAPTCHA mit Drittanbieterlösungen verwenden?

Ja, Sie können sowohl reCAPTCHA (nicht Unternehmensversion) als auch reCAPTCHA Enterprise verwenden. In der Regel fordert die Lösung des Drittanbieters Ihren öffentlichen Schlüssel an. und entweder Ihren geheimen Schlüssel oder Ihren API-Schlüssel. Geben Sie Ihren geheimen Schlüssel und API-Schlüssel nur an vertrauenswürdige Dritte weiter.

Wie migriere ich von reCAPTCHA v2 oder v3 zu reCAPTCHA Enterprise?

Der Migrationsprozess dauert fünf bis zehn Minuten und erfordert keine Codeänderungen.

Sollte ich reCAPTCHA v2 oder v3 verwenden?

reCAPTCHA v3 ist für Websiteinhaber, die mehr Daten zu ihrem Traffic benötigen. Weitere Informationen finden Sie im Entwicklerleitfaden zu reCAPTCHA Version 3.

Wir unterstützen Sicherheit und Nutzerfreundlichkeit für Version 2.

Weitere Informationen zu den Unterschieden von reCAPTCHA v2 und v3 finden Sie im Versionsvergleich.

Werden in reCAPTCHA Cookies verwendet?

reCAPTCHA legt bei der Ausführung ein erforderliches Cookie (_GRECAPTCHA) zum Bereitstellen einer Risikoanalyse fest. Wenn Sie nicht die Domain www.google.com verwenden möchten, für die möglicherweise andere Cookies festgelegt sind, können Sie stattdessen www.recaptcha.net verwenden.

Gibt es bei der Verwendung von reCAPTCHA Tageslimits oder die Anzahl der Abfragen pro Sekunde?

Wenn Sie mehr als 1.000 Anfragen pro Sekunde oder 1.000.000 Anfragen pro Monat stellen möchten, müssen Sie reCAPTCHA Enterprise verwenden oder dieses Formular ausfüllen und auf eine Ausnahmegenehmigung warten. Falls ein Websiteschlüssel 1.000 Abfragen pro Sekunde überschreitet, werden einige Anfragen möglicherweise nicht verarbeitet. Wenn ein V3-Websiteschlüssel sein monatliches Kontingent überschreitet, wird für den Rest des Monats möglicherweise der statische Wert „0,9“ und die Fehlermeldung „Überschreitet das kostenlose Kontingent“ zurückgegeben. Es gibt keine für Nutzer sichtbaren Hinweise, wenn das Kontingent für V3-Websites überschritten wird. Wenn ein V2-Websiteschlüssel das monatliche Kontingent überschreitet, gilt Folgendes: Meldung kann Nutzern für den Rest im reCAPTCHA-Widget angezeigt werden des Monats: „Diese Website überschreitet das reCAPTCHA-Kontingent.“ Bevor das Kontingent erzwungen wird, werden Websiteinhaber dreimal per E-Mail benachrichtigt und mindestens 90 Tage Zeit für die Migration zu reCAPTCHA Enterprise. Websiteschlüssel gelten als über dem Kontingent, wenn mehr als 1.000.000 Aufrufe pro Monat erfolgen. die für eine beliebige Domain verwendet werden. Das 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 das reCAPTCHA-Branding deutlich sichtbar in den Nutzerfluss eingebunden ist. Geben Sie bitte den folgenden Text an:

This site is protected by reCAPTCHA and the Google
    <a href="https://policies.google.com/privacy">Privacy Policy</a> and
    <a href="https://policies.google.com/terms">Terms of Service</a> apply.

Beispiel:

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

.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 Punktzahlen sind möglicherweise nicht genau, da für reCAPTCHA v3 echte Zugriffe erforderlich sind.

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

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

Das reCAPTCHA-Widget zeigt eine Warnmeldung an, um sicherzustellen, dass es nicht für den Produktionstraffic verwendet wird.

Wie kann ich beim Debuggen meiner Website verhindern, dass ich in den reCAPTCHA-Code eintrete?

Damit beim Debuggen anderer JavaScript-Code auf Ihrer Website nicht in den reCAPTCHA-Code eingestiegen wird, fügen Sie das reCAPTCHA-Script /recaptcha__.+\.js$ der Ignorierliste Ihres Browsers hinzu. Eine Anleitung für Chrome finden Sie unter Benutzerdefinierte Skriptliste ignorieren. Ähnliche Funktionen sind auch in anderen Browsern verfügbar.

Wo finde ich weitere Informationen zu den Zugriffen auf meine Website?

reCAPTCHA meldet täglich Statistiken in der Admin-Konsole.

Kann ich reCAPTCHA global 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 dann die gleiche Logik auf alle Stellen an, die „www.google.com/recaptcha/“ auf Ihrer Website verwenden.

Kann ich das reCAPTCHA-Widget oder -Logo anpassen?

Ja. reCAPTCHA bietet zwei Designs: hell und dunkel, wie unten gezeigt. Um ein Design auszuwählen, legen Sie einfach das Attribut „data-theme“ im Parameter „grecaptcha.render“ fest.

Helles Design:

Dunkles Design:

Wie kann ich reCAPTCHA v3 anpassen?

Die JavaScript API, die für unsichtbares reCAPTCHA verfügbar ist, funktioniert auch mit Version 3. Verwenden Sie einfach die JavaScript API, um reCAPTCHA explizit mit einem v3-Websiteschlüssel zu rendern und 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' festlegen und beim Aufruf 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 ist passiert?

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

Ich erhalte einen nicht abgefangenen SecurityError: Anzeigenblock mit Ursprung „https://www.google.com“ nicht auf einen Frame mit dem Ursprung "&ltIhre Domain&gt" zugreifen. Was soll ich tun?

Das tritt in der Regel auf, wenn das HTML-Element des reCAPTCHA-Widgets nach dem Klicken des Endnutzers auf das Kästchen programmatisch entfernt wird. Wir empfehlen, die JavaScript-Funktion grecaptcha.reset() zu verwenden, um das reCAPTCHA-Widget zurückzusetzen.

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

Wir empfehlen den nichtce-basierten Ansatz, der mit CSP3 dokumentiert ist. Fügen Sie Ihre Nonce in das reCAPTCHA-Skript-Tag api.js ein. Wir kümmern uns um den Rest.

Hinweis: reCAPTCHA funktioniert auch mit 'strict-dynamic' in Browsern, die das Programm 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/

Ich erhalte die Fehlermeldung „Localhost befindet sich nicht in der Liste der unterstützten Domains“. 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 Schlüssel Ihrer Entwicklungswebsite zuzulassen.

Wird die Seite nur unter iOS 10 nach unten gescrollt, wenn der Nutzer den Wettkampf abschließt?

Dies ist ein Fokusfehler auf Seiten von Apple, den wir gemeldet haben. Das Problem betrifft nur Nutzer mit iOS 10 und nur auf einigen Websites. Wenn Sie betroffen sind, können Sie das Problem umgehen, indem Sie das reCAPTCHA-Widget auf der Seite nach oben oder nach unten verschieben oder reCAPTCHA Version 3 verwenden.

Mein Computer oder Netzwerk sendet möglicherweise automatisierte Anfragen.

Wenn Sie über das reCAPTCHA-Widget auf diese Seite weitergeleitet wurden, haben Sie die Meldung „Wir entschuldigen uns, aber Ihr Computer oder Netzwerk sendet möglicherweise automatisierte Abfragen. Zum Schutz unserer Nutzer können wir Ihre Anfrage momentan nicht bearbeiten.“

Das kann aus verschiedenen Gründen passieren:

• Sie befinden sich möglicherweise in einem freigegebenen Netzwerk, das in missbräuchlicher Weise verwendet wird.
• Dein Internetanbieter hat dir möglicherweise vor Kurzem eine verdächtige IP-Adresse zugewiesen
• Die Website, auf die Sie zugreifen möchten, wird derzeit möglicherweise stark angegriffen

Weitere Informationen zur Fehlerbehebung bei diesen Problemen finden Sie auf der Hilfeseite zu ungewöhnlichen Zugriffen. 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.