Richtlinienbasierte Schlüssel für Aufgaben auf Websites installieren

Auf dieser Seite wird erläutert, wie Sie einen richtlinienbasierten Schlüssel für die Herausforderung auf Ihrer Website installieren. Mit einem richtlinienbasierten Aufgabenschlüssel kann reCAPTCHA CAPTCHA-Aufgaben deterministisch anhand eines Schwellenwerts für den Wert und des Schwierigkeitsgrads der Aufgabe auslösen.

Hinweis

  1. Umgebung für Google Cloud Fraud Defense vorbereiten

  2. Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.

    Für reCAPTCHA muss die Abrechnung mit dem Projekt verknüpft und für das Projekt aktiviert sein, damit richtlinienbasierte Schlüssel für Aufgaben verwendet werden können. Sie können die Abrechnung entweder mithilfe einer Kreditkarte oder anhand einer vorhandenen Abrechnungs-ID im Google Cloud -Projekt aktivieren. Wenn Sie Hilfe bei der Abrechnung benötigen, wenden Sie sich an den Cloud Billing-Support.

  3. Richtlinienbasierten Challenge-Schlüssel erstellen

    Alternativ können Sie die ID eines vorhandenen richtlinienbasierten Challenge-Schlüssels kopieren, indem Sie einen der folgenden Schritte ausführen:

    • So kopieren Sie die ID eines vorhandenen Schlüssels aus der Google Cloud Console:

      1. Rufen Sie die Seite Google Cloud Fraud Defense auf.

        Zu Google Cloud Fraud Defense

      2. Wählen Sie den Tab Keys aus.
      3. Suchen Sie in der Liste der reCAPTCHA-Schlüssel nach dem Schlüssel, den Sie kopieren möchten, und klicken Sie dann auf .
    • Verwenden Sie die Methode projects.keys.list, um die ID eines vorhandenen Schlüssels mithilfe der REST API zu kopieren.
    • Verwenden Sie den Befehl gcloud recaptcha keys list, um die ID eines vorhandenen Schlüssels mit der gcloud CLI zu kopieren.

Schlüssel für richtlinienbasierte Aufgabe konfigurieren

Für Ihren richtlinienbasierten Schlüssel für die Aufgabe müssen Sie den Schwierigkeitsgrad der Aufgabe angeben, der die Komplexität und Häufigkeit von CAPTCHA-Aufgaben bestimmt, und einen benutzerdefinierten Schwellenwert für den Wert für bestimmte Aktionen definieren, der den Standardschwellenwert überschreibt.

  1. Rufen Sie in der Google Cloud Console die Seite reCAPTCHA auf.

    Zu reCAPTCHA

  2. Prüfen Sie, ob der Name Ihres Projekts in der Ressourcenauswahl oben auf der Seite angezeigt wird.

    Wenn Sie den Namen Ihres Projekts nicht sehen, klicken Sie auf die Ressourcenauswahl und wählen Sie Ihr Projekt aus.

  3. Wählen Sie den Tab Keys aus.

    Der Tab Schlüssel hat zwei Ansichten: Tabelle und Karten. Wenn Ihr Projekt viele reCAPTCHA-Schlüssel hat, ist nur die Tabellenansicht verfügbar.

  4. Suchen Sie im Bereich reCAPTCHA-Schlüssel nach dem richtlinienbasierten Challenge-Schlüssel, den Sie konfigurieren möchten, und klicken Sie darauf.

  5. Klicken Sie auf der Seite Wichtige Details auf den Tab Übersicht.

  6. Klicken Sie im Abschnitt Konfiguration bei Einstellungen für Challenges auf Konfigurieren.

  7. Wählen Sie auf der Seite Einstellungen für Aufgaben konfigurieren den Schwierigkeitsgrad der Aufgabe aus.

  8. Verwenden Sie den Schieberegler, um den Standard-Schwellenwert für das Auslösen von CAPTCHA-Aufgaben festzulegen.

    Beim Standardgrenzwert von 0.0 wird keine Challenge ausgelöst. Bei einem Schwellenwert von 1.0 wird für jede Anfrage eine Challenge ausgelöst.

  9. So konfigurieren Sie einen benutzerdefinierten Grenzbereich für einzelne Aktionen, der den Standardgrenzbereich überschreibt:

    1. Geben Sie einen Aktionsnamen ein.

    2. Mit dem Schieberegler Aktionsschwellenwert festlegen können Sie einen benutzerdefinierten Grenzbereich für die Punktzahl festlegen.

    3. Klicken Sie auf Fertig.

  10. Klicken Sie auf Speichern.

reCAPTCHA auf einem HTML-Button hinzufügen

  1. Wenn Sie reCAPTCHA auf Ihre Webseite laden möchten, fügen Sie die JavaScript API mit Ihrem richtlinienbasierten Schlüssel für die Aufgabe im Element <head></head> Ihrer Webseite hinzu.

        <head>
    <script src="https://www.google.com/recaptcha/enterprise.js?render=KEY_ID"></script>
    ....
    </head>

    reCAPTCHA verwendet standardmäßig die Sprache des Browsers. Wenn Sie eine andere Sprache angeben möchten, verwenden Sie das Attribut hl=LANG in Ihrem Script. Wenn Sie beispielsweise Französisch verwenden möchten, geben Sie Folgendes an: <script src="https://www.google.com/recaptcha/enterprise.js?hl=fr"></script>. Informationen zu den unterstützten Sprachen finden Sie unter Sprachcodes für reCAPTCHA.

  2. So fügen Sie reCAPTCHA auf einem HTML-Button hinzu:

    1. Definieren Sie eine Callback-Funktion, um das Token zu verarbeiten.

      <script>
   function onSubmit(token) {
     document.getElementById("demo-form").submit();
   } // Use `requestSubmit()` for extra features like browser input validation.
</script>

      Weitere Informationen finden Sie unter requestSubmit() method.

    2. Fügen Sie dem HTML-Button Attribute hinzu.

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

      Wenn Sie einen Speicherort für das Symbol angeben möchten, verwenden Sie das Attribut data-badge=LOCATION für das Element mit class=g-recaptcha. Standardmäßig ist der Standort auf bottomright festgelegt. Die anderen möglichen Werte sind inline und bottomleft.

    3. Wenn dieser Button verwendet wird, um ein Formular auf Ihrer Website zu senden, enthält der POST-Parameter g-recaptcha-response das Antworttoken.

  3. Nachdem das Token generiert wurde, wird das reCAPTCHA-Token an Ihr Backend gesendet und es wird innerhalb von zwei Minuten eine Bewertung erstellt.

Nächste Schritte