Zum Hauptinhalt springen

reCAPTCHA Enterprise

reCAPTCHA Enterprise ist ein Google-Dienst, der Websites mit fortschrittlicher Bot-Erkennung vor Betrug und Missbrauch schützt, ohne das Benutzererlebnis zu beeinträchtigen. Diese Anleitung führt dich durch den Prozess der Einrichtung von reCAPTCHA Enterprise mit Logto.

Voraussetzungen​

  • Ein Google Cloud-Projekt

reCAPTCHA-Schlüssel einrichten​

  1. Gehe zur reCAPTCHA-Seite der Google Cloud Console.
  2. Klicke auf die Schaltfläche Schlüssel erstellen neben "reCAPTCHA-Schlüssel".
  3. Fülle das Formular mit folgenden Angaben aus:
    • Anzeigename: Beliebiger Name, den du dem Schlüssel geben möchtest
    • Anwendungstyp: Website
    • Domainliste: Füge die Endpunkt-Domain von Logto hinzu
    • Verifizierungstyp: Wähle zwischen Punktbasiert (unsichtbar) oder Checkbox-Herausforderung. Dies bestimmt, wie reCAPTCHA den Benutzern angezeigt wird. Siehe Verifizierungsmodus für weitere Details.
  4. Nach dem Erstellen des Schlüssels wirst du zur Schlüsseldetailseite weitergeleitet, kopiere die ID.

API-Schlüssel einrichten​

  1. Gehe zur Anmeldedaten-Seite der Google Cloud Console.
  2. Klicke auf die Schaltfläche Anmeldedaten erstellen und wähle API-Schlüssel aus.
  3. Kopiere den API-Schlüssel.
  4. Optional kannst du den API-Schlüssel auf die reCAPTCHA Enterprise API beschränken, um ihn sicherer zu machen.
  5. Denke daran, "Anwendungsbeschränkungen" auf Keine zu belassen, wenn du nicht weißt, was das ist.

Projekt-ID abrufen​

  1. Kopiere die Projekt-ID von der Startseite der Google Cloud Console.

Verifizierungsmodus​

reCAPTCHA Enterprise unterstützt zwei Verifizierungsmodi:

  • Unsichtbar: Punktbasierte Verifizierung, die automatisch im Hintergrund ohne Benutzerinteraktion abläuft. Dies ist der Standardmodus.
  • Checkbox: Zeigt das klassische "Ich bin kein Roboter"-Checkbox-Widget an, das eine Benutzerinteraktion erfordert.
hinweis:

Der in Logto ausgewählte Verifizierungsmodus muss mit dem in der Google Cloud Console erstellten Schlüsseltyp übereinstimmen. Wenn du einen punktbasierten Schlüssel erstellt hast, wähle Unsichtbar. Wenn du einen Checkbox-Herausforderungsschlüssel erstellt hast, wähle Checkbox.

Bring your UI​

Wenn du Bring your UI verwendest, kann Logto reCAPTCHA nicht automatisch in dein individuelles Frontend einfügen oder ausführen. Nachdem du CAPTCHA in der Logto Console aktiviert hast, muss dein individuelles UI das reCAPTCHA Enterprise-Skript laden, ein CAPTCHA-Token erhalten und es an die Experience API senden.

Für den Unsichtbar-Modus lade das Skript mit deinem Site-Key:

<script src="https://www.google.com/recaptcha/enterprise.js?render=<siteKey>" async defer></script>

Wenn du eine benutzerdefinierte Domain in Logto konfiguriert hast, ersetze www.google.com durch diese Domain, zum Beispiel recaptcha.net.

Bevor die Interaktion beginnt, führe reCAPTCHA mit der festen Aktion interaction aus und übergebe das zurückgegebene Token als captchaToken in PUT /api/experience:

const captchaToken = await grecaptcha.enterprise.execute('<siteKey>', {
  action: 'interaction',
});

await fetch('/api/experience', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    interactionEvent: 'SignIn',
    captchaToken,
  }),
});

Für den Checkbox-Modus lade das Skript mit render=explicit, rendere das Widget auf deiner Seite und verwende das Callback-Token als captchaToken, wenn du PUT /api/experience aufrufst.

Benutzerdefinierte Domain​

Standardmäßig lädt Logto das reCAPTCHA-Skript von www.google.com. In einigen Regionen, in denen die Standarddomain von Google nicht erreichbar ist, kannst du jedoch eine alternative Domain konfigurieren.

Unterstützte Domains:

  • www.google.com (Standard)
  • recaptcha.net

Um eine benutzerdefinierte Domain zu konfigurieren, gib die Domain im Feld Domain ein, wenn du reCAPTCHA Enterprise in der Logto Console einrichtest.

CAPTCHA aktivieren​

Denke daran, den CAPTCHA-Bot-Schutz zu aktivieren, nachdem du den CAPTCHA-Anbieter eingerichtet hast.

Gehe zur Sicherheitsseite, finde den CAPTCHA-Tab und aktiviere den Schalter "CAPTCHA aktivieren".