Bewertungen annotieren

In Google Cloud Fraud Defense annotieren Sie Bewertungen, um Grundwahrheitsfeedback zur Genauigkeit der Bewertung und zur Legitimität des Nutzers zu geben. Wenn Sie Interaktionsergebnisse und Bestätigungsdetails an Fraud Defense senden, können Sie Ihr websitespezifisches Modell optimieren und die Erkennungsleistung im Laufe der Zeit verbessern.

Wann Bewertungen annotiert werden sollten

Fraud Defense liefert beim Erstellen einer Bewertung einen Wert, der Ihnen hilft, das Risiko von Nutzerinteraktionen einzuschätzen. Wenn Ihre Website später mehr Informationen zu Nutzerinteraktionen hat, um festzustellen, ob die Interaktion legitim oder betrügerisch war, können Sie die Bewertung von reCAPTCHA bestätigen oder korrigieren. Dazu senden Sie die reCAPTCHA-Bewertungs-IDs mit dem Label LEGITIMATE oder FRAUDULENT an Google zurück. Durch das Bestätigen oder Korrigieren der Bewertung von reCAPTCHA wird die Leistung von Fraud Defense für Ihre Website verbessert.

Um die Leistung von Fraud Defense zu verbessern, können Sie zusätzlich zu den Annotationen für potenzielle Bewertungsfehler auch die Annotationen für richtig positive und richtig negative Ergebnisse bestätigen. Beispiel: Sie können die Bewertung für einen Nutzer, der sich erfolgreich mit einer 2-Faktor-Authentifizierung authentifiziert und eine hohe reCAPTCHA-Punktzahl erhalten hat, als LEGITIMATE annotieren. Wenn der Google Cloud Fraud Defense-Wert niedrig war und Ihre Website die Interaktion als betrügerisch oder missbräuchlich eingestuft hat, können Sie die Bewertung alternativ als FRAUDULENT annotieren.

Folgende Liste enthält zusätzliche Informationen zu einigen beispielhaften Nutzerinteraktionen, bei denen angeben wird, ob eine Nutzerinteraktion legitim oder betrügerisch war:

  • Kreditkartenrückbuchungen oder andere konkrete Beweise für Betrug deuten darauf hin, dass eine frühere Finanztransaktion betrügerisch war.
  • Wenn ein neues Konto Nachrichten sendet, die von anderen Nutzern als Spam markiert werden, kann das darauf hindeuten, dass das Konto betrügerisch erstellt wurde.
  • Ein Support-Fall, der eingereicht wird, wenn ein Nutzer Schwierigkeiten beim Einloggen in sein Konto hat, könnte darauf hinweisen, dass der Login-Versuch legitim ist.
  • Ein Kauf oder eine Buchung auf einer Website, die Fraud Defense zum Schutz vor Scraping verwendet, kann darauf hindeuten, dass der Nutzer legitim ist.

Hinweis

Bewertungs-ID abrufen

Wenn Sie eine Bewertung annotieren möchten, rufen Sie die eindeutige Bewertungs-ID so ab:

  • Bei Web- und Mobilintegrationen können Sie die eindeutige Bewertungs-ID aus der Bewertungsantwort abrufen.

    Nachdem Sie eine Bewertung erstellt haben, erhalten Sie eine JSON-Antwort, wie im folgenden Beispiel gezeigt.

    Rufen Sie die eindeutige Bewertungs-ID aus dem Feld name in der JSON-Antwort ab.

    {
"tokenProperties": {
  "valid": true,
  "hostname": "www.google.com",
  "action": "homepage",
  "createTime": "2019-03-28T12:24:17.894Z"
},
"riskAnalysis": {
  "score": 0.1,
  "reasons": ["AUTOMATION"]
},
"event": {
  "token": "RESPONSE_TOKEN",
  "siteKey": "KEY_ID"
},
"name": "ASSESSMENT_ID"
}

  • Bei WAF-Integrationen können Sie die eindeutige Bewertungs-ID aus dem reCAPTCHA-Token abrufen. Die eindeutige Bewertungs-ID ist der eindeutige alphanumerische String mit 16 Zeichen, der am Ende des reCAPTCHA-Tokens nach :U= angezeigt wird. Wenn das reCAPTCHA-Token beispielsweise .................U=6ZZZZe73fZZZZZZ0 ist, lautet die Bewertungs-ID 6ZZZZe73fZZZZZZ0.

Bewertung annotieren

  1. Legen Sie die Informationen und Labels fest, die je nach Anwendungsfall im JSON-Anfragetext hinzugefügt werden sollen.

    In der folgenden Tabelle sind die Labels und Werte aufgeführt, die Sie zum Annotieren von Ereignissen verwenden können:

    Label Beschreibung Beispielanfrage
    reasons Optional. Ein Label zur Unterstützung Ihrer Bewertungen.

    Geben Sie im Label reasons innerhalb weniger Sekunden oder Minuten nach dem Ereignis Echtzeit-Ereignisdetails an, da sie die Echtzeiterkennung beeinflussen.

    Eine Liste der möglichen Werte finden Sie unter Werte für Gründe.

    Beispiel: Wenn Sie Kontoübernahmen erkennen möchten, fügen Sie eine Annotation hinzu, ob das eingegebene Passwort mit den Werten CORRECT_PASSWORD oder INCORRECT_PASSWORD korrekt war. Wenn Sie Ihre eigene MFA bereitgestellt haben, können Sie die folgenden Werte hinzufügen: INITIATED_TWO_FACTOR und PASSED_TWO_FACTOR oder FAILED_TWO_FACTOR. 

          {
      "reasons": ["INCORRECT_PASSWORD"]
      }
    annotation Optional. Ein Label, das die Legitimität von Bewertungen angibt.

    Geben Sie Fakten zu Anmelde- und Registrierungsereignissen an, um Ihre Risikobewertungen im Label annotation zu validieren oder zu korrigieren.

    Mögliche Werte: LEGITIMATE oder FRAUDULENT.

    Sie können diese Informationen jederzeit oder im Rahmen eines Batchjobs senden. Wir empfehlen jedoch, diese Informationen innerhalb weniger Sekunden oder Minuten nach dem Ereignis zu senden, da sie die Echtzeiterkennung beeinflussen.

    		 
          {
       "annotation": "LEGITIMATE"
      }

  2. Annotieren Sie eine Bewertung mit der Methode projects.assessments.annotate über die gcloud CLI oder einen API-Schlüssel.

    gcloud-CLI

    Ersetzen Sie diese Werte in den folgenden Anfragedaten:

    • ASSESSMENT_ID: Wert des Felds name, der vom Aufruf projects.assessments.create zurückgegeben wird.
    • ANNOTATION_LABEL: Das Label, das angibt, ob die Bewertung legitim oder betrügerisch ist. Mögliche Werte sind LEGITIMATE oder FRAUDULENT.
    • ANNOTATION_REASON: Beschreibt den Kontext für die Annotation, die für diese Bewertung ausgewählt wurde. Informationen zu möglichen Werten finden Sie unter Gründe für das Annotieren einer Bewertung.

    HTTP-Methode und URL: 

    POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate

    JSON-Text der Anfrage:

    {
"annotation": "ANNOTATION_LABEL"
"reasons": "ANNOTATION_REASON"
}

    Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

    curl

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
         "https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate"

    PowerShell

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate" | Select-Object -Expand Content

    Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

    API-Schlüssel

    Ersetzen Sie diese Werte in den folgenden Anfragedaten:

    • ASSESSMENT_ID: Wert des name-Felds, der vom projects.assessments.create-Aufruf zurückgegeben wurde
    • ANNOTATION_LABEL: Das Label, das angibt, ob die Bewertung legitim oder betrügerisch ist. Mögliche Werte sind LEGITIMATE oder FRAUDULENT.
    • ANNOTATION_REASON: Beschreibt den Kontext für die Annotation, die für diese Bewertung ausgewählt wurde. Informationen zu möglichen Werten finden Sie unter Gründe für das Annotieren einer Bewertung.

    HTTP-Methode und URL: 

    POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments/ASSESSMENT_ID:annotate?key=API_KEY

    JSON-Text der Anfrage:

    {
"annotation": "ANNOTATION_LABEL"
"reasons": "ANNOTATION_REASON"
}

    Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

    curl

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

    curl -X POST \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
         "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments/ASSESSMENT_ID:annotate?key=API_KEY"

    PowerShell

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

    $headers = @{  }

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments/ASSESSMENT_ID:annotate?key=API_KEY" | Select-Object -Expand Content

    Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Nächste Schritte