In diesem Dokument werden häufige Probleme bei der reCAPTCHA-Integration aufgeführt, die bei der Verwendung von reCAPTCHA in Ihrer Umgebung auftreten können.
Ungültiger Websiteschlüssel oder ungültiger Schlüsseltyp
Wenn der Fehler Invalid site key oder Invalid key type angezeigt wird, prüfen Sie Folgendes:
- Prüfen Sie, ob die Schlüsselversion in der Google Cloud Console mit der Version übereinstimmt, die auf Ihrer Website oder im CMS-Plug-in eines Drittanbieters konfiguriert ist (z. B.
Website • scorefürv3oderWebsite • checkboxfürv2 Checkbox). Informationen zum Prüfen der Schlüsselversion finden Sie unter Schlüsselversion in derGoogle Cloud Console ansehen. - Wenn Ihr reCAPTCHA-Websiteschlüssel gelöscht wurde oder nicht mehr gültig ist, erstellen Sie einen neuen Schlüssel und aktualisieren Sie Ihr CMS-Plug-in oder installieren Sie den Schlüssel auf Ihren Webseiten.
Fehler bei der Schlüsselmigration
In den folgenden Szenarien kann die Migration von Websiteschlüsseln fehlschlagen:
Sie haben die maximale Anzahl an Projekten, die Sie oder Ihre Organisation erstellen können, überschritten.
Wenn Sie weitere Projekte erstellen möchten, können Sie ein vorhandenes Projekt wiederverwenden, die Erhöhung Ihres Kontingents beantragen oder warten, bis die automatische Migration abgeschlossen ist.
Ihre Workspace-Organisation hat das Erstellen neuer Google Cloud-Projekte eingeschränkt.
Wenn Sie den Dienst „ Google Cloud “ in der Admin-Konsole aktivieren möchten, wenden Sie sich an Ihren Administrator. Weitere Informationen finden Sie im Hilfeartikel Google Cloud für Nutzer aktivieren oder deaktivieren.
SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "<your domain>"
Dies tritt in der Regel auf, wenn das HTML-Element des reCAPTCHA-Widgets irgendwann nach dem Klicken auf das Kästchen durch den Endnutzer programmatisch entfernt wird. Wir empfehlen, die JavaScript-Funktion grecaptcha.enterprise.reset() zu verwenden, um das reCAPTCHA-Widget zurückzusetzen.
Localhost ist nicht in der Liste der unterstützten Domains enthalten
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 Google Cloud -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 für den Schlüssel der Entwicklungswebsite nur „localhost“ zuzulassen.
reCAPTCHA hat beim Erstellen einer Bewertung BROWSER_ERROR zurückgegeben
BROWSER_ERROR-Tokens treten auf, wenn das reCAPTCHA-Script keinen execute-Vorgang ausführen kann. In den meisten Fällen ist dies auf einen clientseitigen Netzwerkausfall oder eine Zeitüberschreitung zurückzuführen. Sie müssen execute() mit dem JavaScript wiederholen.