Ein reCAPTCHA-Website-Profil einrichten

1. 1.

   Den Workspace prüfen

   Richten Sie das Profil für den Workspace ein, dessen API-Schlüssel Sie zum Erstellen von Aufgaben verwenden werden. Ein Profil in einem anderen Workspace reicht nicht aus. Wenn die Konsole „Guthaben hinzufügen, um fortzufahren“ anzeigt, folgen Sie dieser Aufforderung, bevor Sie die Einrichtung fortsetzen.

2. 2.

   „Website hinzufügen“ öffnen

   Wählen Sie unter „Website-Profile“ die Option „Website hinzufügen“. Geben Sie unter „Seiten-URL“ die HTTPS-Zielseite ein. Wählen Sie unter „reCAPTCHA-Typ“ passend zur Seite „Enterprise v3“ oder „Reguläres v3“.

3. 3.

   Die Erfassungsparameter festlegen

   Die Erfassungsaktion ist erforderlich. Verwenden Sie die Aktion, für die Sie eine Lösung anfordern möchten; wenn Sie unsicher sind, ermitteln Sie zuerst die reCAPTCHA-Aktion. Das Formular enthält außerdem die optionalen Felder „Navigations-URL“, „Websiteschlüssel“ und „Referer-Wert“. Der Websiteschlüssel kann automatisch ermittelt werden.

4. 4.

   Das Formular absenden

   Wählen Sie „Website hinzufügen“. Geprüfte Systemprofile können die bekannten Schnittstellenvorgaben der Seite und die Erfassungsaktion ohne Live-Abruf eintragen; das Formular erläutert die gewählte Aktion. Andere Einreichungen können die Status „In Warteschlange“, „Wird erfasst“, „Wird validiert“ oder „In Prüfung“ annehmen.

Prüfen Sie den Status des erstellten Profils. ACTIVE wird als active angezeigt; dieser Status ist zum Lösen erforderlich. Wenn die Erfassung fehlschlägt, zeigt die Konsole einen Grund an und ermöglicht einen erneuten Versuch.

Dieser Aufgaben-Body verwendet den Hostnamen und die Aktion aus dem Profil:

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• site ist der Hostname aus „Seiten-URL“, ohne Schema oder Pfad.
• action ist die Aktion für die geschützte Anfrage. Stimmen Sie sie auf das Profil ab, das Sie verwenden möchten.
• Der Standardwert für recaptchaType ist enterprise-v3. Setzen Sie ihn für ein Profil des Typs „Reguläres v3“ explizit auf v3.
• Ersetzen Sie den Proxy-Platzhalter durch den HTTP(S)-Proxy, den Sie auch für die Zielanfrage verwenden werden.

Der Python-Schnellstart und der Node.js-Schnellstart zeigen, wie Sie die Anfrage senden und das Ergebnis verwenden.

Für die Aufgabe ist kein Profil verfügbar.

Gleichen Sie den mit Ihrem API-Schlüssel verknüpften Workspace und den Hostnamen der Aufgabe mit dem konfigurierten Profil ab.

Probiere Folgendes: Fügen Sie das vorgesehene Website-Profil in dem Workspace hinzu, der die Aufgabe erstellen wird. Wiederholtes Erstellen von Aufgaben legt das fehlende Profil nicht an.

Das Profil befindet sich in der Warteschlange, wird erfasst, wird validiert oder ist in Prüfung.

Lesen Sie seinen aktuellen Status unter „Website-Profile“ ab.

Probiere Folgendes: Warten Sie, bis das Profil aktiv ist, bevor Sie eine Lösung anfordern. Diese Status ersetzen kein aktives Profil.

Die Erfassung ist fehlgeschlagen.

Lesen Sie den in der Konsole angezeigten Fehlergrund.

Probiere Folgendes: Beheben Sie das durch diesen Grund beschriebene Problem und starten Sie die Erfassung erneut.

Ein Profil ist aktiv, aber die vorgesehene Aktion lässt sich weiterhin keinem Profil zuordnen.

Vergleichen Sie Hostname, Erfassungsaktion und reCAPTCHA-Typ. Wenn die Ausführungsaktion abweicht, prüfen Sie, ob ein eindeutiges Erfassungsziel vorhanden ist.

Probiere Folgendes: Richten Sie ein Profil ein, das zum vorgesehenen Hostnamen, zur Aktion und zum Typ passt, statt die Aufgabe auf eine sachfremde Aktion umzustellen, nur um ein vorhandenes Profil auszuwählen.