-
Sollte ich reCAPTCHA Enterprise verwenden?
-
reCAPTCHA Enterprise bietet eine Million Bewertungen pro Monat für kostenlose und zusätzliche Funktionen. Weitere Features wie Echtzeitanalysen sind für die meisten Entwickler der ideale Ausgangspunkt. Jetzt kostenlos starten
-
Kann ich reCAPTCHA mit Lösungen von Drittanbietern verwenden?
-
Ja, Sie können sowohl reCAPTCHA (nicht Enterprise) als auch reCAPTCHA Enterprise verwenden. In der Regel fragt die Drittanbieterlösung nach Ihrem öffentlichen Schlüssel und entweder nach Ihrem geheimen Schlüssel oder Ihrem API-Schlüssel. Gib deinen geheimen Schlüssel und deinen API-Schlüssel nur vertrauenswürdigen Dritten an.
-
So migrieren Sie von v2 oder v3 zu reCAPTCHA Enterprise
-
Der Migrationsprozess dauert 5–10 Minuten und erfordert keine Codeänderungen.
-
Sollte ich reCAPTCHA, V2 oder V3 verwenden?
-
reCAPTCHA, Version 3, ist für Websiteinhaber gedacht, die mehr Daten zu ihrem Traffic benötigen. Weitere Informationen finden Sie im Entwicklerleitfaden zu reCAPTCHA v3.
Wir bieten Sicherheit und Nutzerfreundlichkeit für Version 2.
Weitere Informationen zu den Unterschieden zwischen reCAPTCHA v2 und v3 finden Sie im Vergleich der Versionen.
-
Kann ich reCAPTCHA, Version 2 und Version 3 auf derselben Seite ausführen?
-
Laden Sie dazu den Websiteschlüssel aus Version 3 als dokumentiert und rendern Sie Version 2 anschließend explizit mit „grecaptcha.render“.
<html> <head> <title>reCAPTCHA demo: Running both v2 and v3</title> <script src="https://www.google.com/recaptcha/api.js?render=v3_site_key"></script> <script> grecaptcha.ready(() => { grecaptcha.render('html_element', { 'sitekey' : 'v2_site_key' }); }); </script> <script> function onSubmit() { grecaptcha.ready(() => { grecaptcha.execute('v3_site_key', {action: 'homepage'}).then((token) => { ... }); }); } </script> </head> </html>
- reCAPTCHA setzt bei der Ausführung ein erforderliches Cookie (_GRECAPTCHA) für die Bereitstellung seiner Risikoanalyse ein. Wenn Sie die Domain www.google.de nicht verwenden möchten, für die möglicherweise andere Cookies festgelegt sind, können Sie stattdessen www.recaptcha.net verwenden.
-
Gibt es Abfragen/Abfragen pro Tag oder Tageslimits für die Nutzung 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 eine Ausnahmegenehmigung warten. Wenn ein Websiteschlüssel 1.000 Abfragen pro Sekunde überschreitet, werden einige Anfragen möglicherweise nicht verarbeitet. Wenn ein Websiteschlüssel für Version 3 das monatliche Kontingent überschreitet, schlägt „site_verify“ unter Umständen für den Rest des Monats einen statischen Wert von 0,9 und die Fehlermeldung „Über kostenloses Kontingent“ zurück. Wenn das Kontingent von Websites der Version 3 überschritten ist, sind keine für Nutzer sichtbaren Hinweise vorhanden. Wenn ein V2-Websiteschlüssel das monatliche Kontingent überschreitet, wird Nutzern im reCAPTCHA-Widget für den Rest des Monats eventuell die folgende oder eine ähnliche Meldung angezeigt: „Diese Website überschreitet das reCAPTCHA-Kontingent.“ Bevor das Kontingent erzwungen wird, werden Websiteinhaber dreimal per E-Mail benachrichtigt und erhalten mindestens 90 Tage Zeit, um zu reCAPTCHA Enterprise zu migrieren. Websiteschlüssel werden als Kontingent ausgeschöpft, wenn pro Domain mehr als 1.000.000 Aufrufe pro Monat erfolgen. Das gilt auch, wenn dieses Volume über mehrere Schlüssel in derselben Domain verteilt ist.
-
Ich möchte das reCAPTCHA-Logo ausblenden. Was ist zulässig?
-
Sie dürfen das Logo verbergen, solange Sie das reCAPTCHA-Branding gut sichtbar in den Ablauf einbinden. 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 nicht verwenden möchten, verwenden Sie
.grecaptcha-badge { visibility: hidden; }
. -
Ich möchte automatisierte Tests mit reCAPTCHA durchführen. Was soll ich tun?
-
Erstellen Sie für reCAPTCHA, Version 3, einen separaten Schlüssel für Testumgebungen. Die Bewertungen sind möglicherweise nicht genau, da in reCAPTCHA Version 3 echter Traffic benötigt wird.
Verwenden Sie für reCAPTCHA, Version 2, die folgenden Testschlüssel. Sie erhalten immer kein CAPTCHA und alle Bestätigungsanfragen werden bestanden.
- Websiteschlüssel: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
- Geheimer Schlüssel: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe
Das reCAPTCHA-Widget zeigt eine Warnmeldung an, damit es nicht für Produktionstraffic verwendet wird.
-
Wie kann ich mehr über den Traffic meiner Website erfahren?
-
reCAPTCHA gibt tägliche Statistiken in der Admin-Konsole zurück.
-
Kann ich reCAPTCHA weltweit verwenden?
-
Ja. Verwenden Sie „www.recaptcha.net“ in Ihrem Code, wenn „www.google.com“ nicht verfügbar ist.
- Ersetzen Sie zuerst <script src="https://www.google.com/recaptcha/api.js" async defer></script> durch <script src="https://www.recaptcha.net/recaptcha/api.js" async defer></script>
- Verwenden Sie danach dasselbe Tag für alle anderen Websites, 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. 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, Version 3, anpassen?
-
Die JavaScript API, die für Invisible reCAPTCHA verfügbar ist, funktioniert auch mit Version 3. Verwenden Sie einfach die JavaScript API, um reCAPTCHA explizit mit einem Schlüssel einer Version 3 zu rendern, um auf Optionen wie die Neupositionierung des Logos oder die Änderung des Designs zuzugreifen.
Achte beim Rendern von Version 3 von reCAPTCHA mit dieser Methode darauf, den Parameter
size
auf'invisible'
festzulegen und beim Aufrufen vongrecaptcha.execute
anstelle des Websiteschlüssels die vongrecaptcha.render
zurückgegebene Client-ID zu verwenden. -
Seit Kurzem wird in meinem reCAPTCHA-Widget „Ungültiger Websiteschlüssel“ angezeigt. Woran liegt das?
-
Wenn dieser Fehler angezeigt wird, ist Ihr reCAPTCHA-Websiteschlüssel nicht mehr gültig. Registrieren Sie zum Aktivieren einen neuen Schlüssel und folgen Sie der Anleitung auf dieser Seite.
-
Ein nicht abgefangener SecurityError wird angezeigt: Ein Frame mit dem Ursprung „https://www.google.com“ hat keinen Zugriff auf einen Frame mit dem Ursprung „<Ihre Domain>“. Was soll ich tun?
-
Dieses Problem tritt in der Regel auf, wenn das HTML-Element des reCAPTCHA-Widgets programmatisch entfernt wird, nachdem der Endnutzer das Kästchen angeklickt hat. Wir empfehlen, das reCAPTCHA-Widget mit der JavaScript-Funktion grecaptcha.reset() zurückzusetzen.
-
Ich verwende die Content Security Policy (CSP) auf meiner Website. Wie kann ich es für reCAPTCHA konfigurieren?
-
Wir empfehlen, den nicht-basierten Ansatz zu verwenden, der mit CSP3 dokumentiert ist. Geben Sie dabei unbedingt Ihre Nonce im reCAPTCHA-Skript-Tag api.js an. Wir kümmern uns um den Rest.
Hinweis: reCAPTCHA funktioniert auch in Browsern, die strict-dynamic 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 ist nicht in der Liste der unterstützten Domains enthalten“. Was soll ich tun?
-
localhost-Domains werden standardmäßig nicht unterstützt. Wenn du sie weiterhin für die Entwicklung unterstützen möchtest, kannst du sie der Liste der unterstützten Domains für deinen Websiteschlüssel hinzufügen. Rufen Sie je nach Bedarf die reCAPTCHA Enterprise-Konsole oder die reCAPTCHA-Konsole auf, um die Liste der unterstützten Domains zu aktualisieren. Wir empfehlen, für die Entwicklung und die Produktion separate Schlüssel zu verwenden und nur localhost auf dem Schlüssel Ihrer Entwicklungswebsite zuzulassen.
-
Nur unter iOS 10 scrollt die Seite nach unten, wenn der Nutzer den Wettkampf abschließt.
-
Das ist ein Fehler, den wir bei Apple gemeldet haben. Sie betrifft nur Nutzer mit iOS 10 und nur einige Websites. Wenn Sie betroffen sind, können Sie das reCAPTCHA-Widget auf der Seite nach oben oder unten verschieben oder reCAPTCHA, Version 3 verwenden.
-
Mein Computer oder Netzwerk sendet möglicherweise automatisierte Anfragen?
-
Wenn du vom reCAPTCHA-Widget zu dieser Seite geleitet wurdest, siehst du die Meldung „Ihr Computer oder Netzwerk sendet möglicherweise automatisierte Anfragen. Zum Schutz unserer Nutzer können wir Ihre Anfrage momentan nicht bearbeiten."
Dafür gibt es verschiedene Gründe:
- Möglicherweise befinden Sie sich in einem freigegebenen Netzwerk, das missbräuchlich verwendet wird.
- Möglicherweise hat Ihnen Ihr Internetanbieter eine verdächtige IP-Adresse zugewiesen.
- Die Website, auf die Sie zugreifen möchten, wird derzeit stark angegriffen.
Informationen zur Behebung dieser Probleme finden Sie auf der Hilfeseite zu ungewöhnlichen Zugriffen. Bitte versuchen Sie es später noch einmal.
-
Welche Aktionsnamen sind gültig?
-
Aktionen dürfen nur alphanumerische Zeichen, Schrägstriche und Unterstriche enthalten. Aktionen dürfen nicht nutzerspezifisch sein.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2023-02-14 (UTC).
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Benötigte Informationen nicht gefunden"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Zu umständlich/zu viele Schritte"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Nicht mehr aktuell"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problem mit der Übersetzung"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problem mit Beispielen/Code"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Sonstiges"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Leicht verständlich"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Mein Problem wurde gelöst"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Sonstiges"
}]