Profile für mehrere reCAPTCHA-Aktionen konfigurieren

Von solvethree3 Min. Lesezeit

Erstellen Sie für login und checkout auf demselben Hostnamen jeweils ein aktives Profil pro Erfassungsaktion und reCAPTCHA-Typ. Senden Sie dann jeden Task mit der entsprechenden action. Ein Hostname allein reicht nicht aus, um das richtige Profil auszuwählen.

Auf dieser Seite

Anmelde- und Checkout-Profile erstellen

Konfigurieren Sie unter Website-Profile ein Profil pro Hostname, Erfassungsaktion und reCAPTCHA-Typ. In diesem Beispiel verwenden beide Profile accounts.example.com und Enterprise v3.

  1. 1.

    Anmeldeprofil hinzufügen

    Wählen Sie „Website hinzufügen“. Geben Sie die HTTPS-Seiten-URL ein, auf der die Anmeldeaktion ausgeführt wird, wählen Sie Enterprise v3 und setzen Sie die Erfassungsaktion auf login. Das Formular unterstützt außerdem optionale Werte für Navigations-URL, Website-Schlüssel und Referer. Senden Sie das Formular mit „Website hinzufügen“ ab.

  2. 2.

    Checkout-Profil hinzufügen

    Wiederholen Sie dies für die Checkout-Seite auf demselben Hostnamen. Behalten Sie Enterprise v3 bei und setzen Sie die Erfassungsaktion auf checkout.

  3. 3.

    Prüfen, ob beide Profile aktiv sind

    Ihrem Arbeitsbereich muss vor dem Erstellen von Lösungen ein aktives Profil zur Verfügung stehen. Wenn eine Erfassung fehlschlägt, prüfen Sie vor einem erneuten Versuch den angezeigten Grund. Das Senden eines Tasks mit Hostname und Aktion erstellt das fehlende Profil nicht.

Für jede Aktion einen separaten Task senden

Senden Sie jedes der folgenden Objekte als separate POST /v1/tasks-Anfrage. Authentifizieren Sie sich mit dem API-Schlüssel Ihres Arbeitsbereichs über Authorization: Bearer und bewahren Sie diesen Schlüssel auf dem Server auf.

Zwei Aktionen · Derselbe Hostname, getrennte logische Aufgaben
[
  {
    "site": "accounts.example.com",
    "action": "login",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "login-flow-001"
  },
  {
    "site": "accounts.example.com",
    "action": "checkout",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "checkout-flow-001"
  }
]

Ersetzen Sie den Hostnamen und den Proxy-Platzhalter durch Ihren Zielhostnamen und Ihre Proxy-URL. Jede Anfrage enthält einen proxy; fügen Sie nicht zusätzlich proxyCandidates hinzu. Der ausgelassene Wert recaptchaType ist standardmäßig enterprise-v3. Fügen Sie diesen reCAPTCHA-Anfragen keine Felder type oder url hinzu.

Die beiden requestId-Werte kennzeichnen separate logische Tasks. Verwenden Sie für eine neue Lösung eine neue ID. Wenn bei der Task-Erstellung ein Timeout auftritt, verwenden Sie dieselbe ID mit derselben Anfrage erneut, um den vorhandenen Task wieder abzurufen; die Wiederverwendung einer ID mit anderen Eingaben führt zu einem Konflikt.

Wenn die Ausführungsaktion nicht übereinstimmt

Für den passenden Hostnamen und reCAPTCHA-Typ wählt eine exakt übereinstimmende Ausführungsaktion das zugehörige Profil aus: login wählt das Anmeldeprofil und checkout das Checkout-Profil.

Eine andere Ausführungsaktion erfordert ein eindeutig bestimmbares erfasstes Ziel. Wenn mehrere Ziele infrage kommen, gehen Sie nicht davon aus, dass solvethree ein beliebiges Profil auswählt. Verwenden Sie nach Möglichkeit die konfigurierte Erfassungsaktion. Wenn die Auswahl als mehrdeutig gemeldet wird, vergleichen Sie Hostname, reCAPTCHA-Typ und Aktion des Tasks mit den Profilen in der Konsole und verwenden Sie die tatsächliche Konsolen-/API-Antwort, um die Abweichung zu diagnostizieren.

Ein eindeutiger Website-Schlüssel für jede Aktion ist nicht die Routing-Regel. Konfigurieren Sie die Profile nach Hostname, Erfassungsaktion und reCAPTCHA-Typ, statt zu versuchen, Aktionen anhand von Website-Schlüsseln zu unterscheiden.

Quellen und API-Referenz

Führe deinen ersten Task aus.

Starte mit $5 Workspace-Guthaben.

Workspace erstellen
Profile für mehrere reCAPTCHA-Aktionen konfigurieren · solvethree