Richtlinienbasierte Schlüssel für Aufgaben auf Websites installieren

Sie können einen richtlinienbasierten Challenge-Schlüssel auf Ihrer Website installieren, um visuelle CAPTCHA-Challenges nur dann auszulösen, wenn eingehende Anfragen den konfigurierten Sicherheitsrichtlinien entsprechen. Durch die Einbindung richtlinienbasierter Schlüssel können Sie legitimen Besuchern ein reibungsloses Surferlebnis bieten, während verdächtiger Traffic gezielt überprüft wird.

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 aktiviert sein, damit richtlinienbasierte Challenge-Schlüssel verwendet werden können. Sie können die Abrechnung entweder mit einer Kreditkarte oder einer vorhandenen Google Cloud -Projektabrechnungs-ID 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. Führen Sie dazu einen der folgenden Schritte aus:

    • 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 den Schlüssel, den Sie kopieren möchten, und klicken Sie dann auf .
    • Wenn Sie die ID eines vorhandenen Schlüssels mit der REST API kopieren möchten, verwenden Sie die Methode projects.keys.list.
    • Wenn Sie die ID eines vorhandenen Schlüssels mit der gcloud CLI kopieren möchten, verwenden Sie den Befehl gcloud recaptcha keys list.

Richtlinienbasierten Challenge-Schlüssel konfigurieren

Für den richtlinienbasierten Challenge-Schlüssel müssen Sie den Schwierigkeitsgrad der Challenge angeben, der die Komplexität und Häufigkeit von CAPTCHA-Challenges bestimmt. Außerdem müssen Sie einen benutzerdefinierten Schwellenwert 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 enthält, ist nur die Tabellenansicht verfügbar.

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

  5. Klicken Sie auf der Seite Schlüsseldetails auf den Tab Übersicht.

  6. Klicken Sie im Abschnitt Konfiguration unter Einstellungen für die Identitätsbestätigung 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 Standardschwellenwert für das Auslösen von CAPTCHA-Aufgaben festzulegen.

    Der Standardgrenzwert von 0.0 löst keine Challenge aus. Ein Schwellenwert von 1.0 löst bei jeder Anfrage eine Challenge aus.

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

    1. Geben Sie einen Aktionsnamen ein.

    2. Verwenden Sie den Schieberegler Aktionsschwellenwert festlegen, um einen benutzerdefinierten Schwellenwert für die Punktzahl anzugeben.

    3. Klicken Sie auf Fertig.

  10. Klicken Sie auf Speichern.

reCAPTCHA auf einem HTML-Button hinzufügen

  1. Wenn Sie reCAPTCHA auf Ihrer Webseite laden möchten, fügen Sie die JavaScript API mit Ihrem richtlinienbasierten Sicherheitsschlüssel im <head></head>-Element 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 Skript. 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().

    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 Ort für das Logo 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 einzureichen, 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