Auf dieser Seite wird erläutert, wie Sie Feedback zur Genauigkeit der von reCAPTCHA Enterprise erstellten Bewertungen geben können. Anhand dieser Informationen kann reCAPTCHA Enterprise Ihr websitespezifisches Modell optimieren und im Laufe der Zeit die Leistung Ihrer Website verbessern.
Wann sollten Bewertungen annotiert werden?
reCAPTCHA Enterprise gibt beim Erstellen einer Bewertung eine Bewertung aus, mit der Sie das Risiko von Nutzerinteraktionen nachvollziehen können.
Wenn Ihre Website später weitere Informationen zu Nutzerinteraktionen hat, um festzustellen, ob die Interaktion legitim oder betrügerisch war, können Sie die Bewertung von reCAPTCHA Enterprise bestätigen oder korrigieren. Dazu senden Sie die reCAPTCHA-Bewertungs-IDs mit dem Label LEGITIMATE
oder FRAUDULENT
an Google zurück.
Wenn Sie die Bewertung von reCAPTCHA Enterprise bestätigen oder korrigieren, wird die Leistung von reCAPTCHA Enterprise für Ihre Website verbessert.
Um die Leistung von reCAPTCHA Enterprise zu verbessern, können Sie die Annotationen für richtig positive und richtig negative Bewertungen zusätzlich zu den Annotationen für potenzielle Bewertungsfehler 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 die reCAPTCHA-Punktzahl niedrig war und Ihre Website feststellte, dass die Interaktion betrügerisch oder missbräuchlich war, können Sie die Bewertung 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 Anzeichen für Betrug deuten darauf hin, dass eine frühere Finanztransaktion betrügerisch war.
- Ein neues Konto, über das Nachrichten gesendet werden, die von anderen Nutzern als Spam markiert wurden, kann darauf hindeuten, dass die Kontoerstellung betrügerisch war.
- 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 reCAPTCHA Enterprise zum Schutz vor Scraping verwendet, kann darauf hindeuten, dass der Nutzer legitim ist.
Hinweise
Sie benötigen die folgende Rolle für Identity and Access Management: reCAPTCHA Enterprise-Agent (
roles/recaptchaenterprise.agent
).Je nachdem, wo Sie reCAPTCHA Enterprise eingerichtet haben, führen Sie den entsprechenden Schritt aus:
Bewertungs-ID abrufen
Wenn Sie eine Bewertung annotieren möchten, rufen Sie die eindeutige Bewertungs-ID so ab:
Bei Web- und mobilen Integrationen 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
der JSON-Antwort ab.{ 'tokenProperties': { 'valid': True, 'hostname': 'www.google.com', 'action': 'homepage', 'createTime': u'2019-03-28T12:24:17.894Z' }, 'riskAnalysis': { 'score': 0.1, 'reasons': ['AUTOMATION'] }, 'event': { 'token': 'RESPONSE_TOKEN', 'siteKey': 'KEY_ID' }, 'name': 'ASSESSMENT_ID' }
Für WAF-Integrationen können Sie die eindeutige Bewertungs-ID aus dem reCAPTCHA-Token abrufen. Die eindeutige Bewertungs-ID ist ein eindeutiger alphanumerischer String mit 16 Zeichen, der am Ende des reCAPTCHA-Tokens nach
:U=
steht. Wenn das reCAPTFHA-Token beispielsweise.................U=6ZZZZe73fZZZZZZ0
ist, ist die Bewertungs-ID6ZZZZe73fZZZZZZ0
.
Bewertung mit Anmerkungen versehen
Legen Sie je nach Anwendungsfall die Informationen und Labels fest, die dem JSON-Anfragetext hinzugefügt werden sollen.
In der folgenden Tabelle sind die Labels und Werte aufgeführt, mit denen Sie Ereignisse annotieren können:
Label Beschreibung Anfragebeispiel reasons
Optional. Ein Label zur Unterstützung Ihrer Bewertungen. Geben Sie wenige Sekunden oder Minuten nach dem Ereignis mit dem Label
reasons
Echtzeitdetails zu Ereignissen an, da sie die Echtzeiterkennung beeinflussen.Eine Liste der möglichen Werte finden Sie unter Werte für die Gründe.
Beispiel: Zum Erkennen von Kontoübernahmen können Sie mit den Werten
CORRECT_PASSWORD
oderINCORRECT_PASSWORD
annotieren, ob das eingegebene Passwort korrekt war. Wenn Sie Ihre eigene MFA bereitgestellt haben, können Sie die folgenden Werte hinzufügen:INITIATED_TWO_FACTOR
undPASSED_TWO_FACTOR
oderFAILED_TWO_FACTOR
.{ "reasons": ["INCORRECT_PASSWORD"] }
annotation
Optional. Ein Label zur Angabe der Rechtmäßigkeit von Bewertungen. Geben Sie im Label
annotation
Informationen zu Anmelde- und Registrierungsereignissen an, um Ihre Risikobewertungen zu validieren oder zu korrigieren.Mögliche Werte:
LEGITIMATE
oderFRAUDULENT
.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" }
Kommentieren Sie eine Bewertung mit der Methode
projects.assessments.annotate
über die gcloud CLI oder einen API-Schlüssel.gcloud-CLI
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
- ASSESSMENT_ID: Der vom
projects.assessments.create
-Aufruf zurückgegebene Wert des Feldsname
. - ANNOTATION_LABEL: Label zur Angabe, ob die Bewertung legitim oder betrügerisch ist
Mögliche Werte sind
LEGITIMATE
undFRAUDULENT
. - ANNOTATION_REASON: Beschreibt den Kontext für die Anmerkung, die für diese Bewertung ausgewählt wurde. Weitere Informationen zu möglichen Werten finden Sie im Artikel Gründe für das Kommentieren 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 ContentSie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.
API-Schlüssel
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
- ASSESSMENT_ID: Wert des
name
-Felds, der vomprojects.assessments.create
-Aufruf zurückgegeben wurde - ANNOTATION_LABEL: Label zur Angabe, ob die Bewertung legitim oder betrügerisch ist
Mögliche Werte sind
LEGITIMATE
undFRAUDULENT
. - ANNOTATION_REASON: Beschreibt den Kontext für die Anmerkung, die für diese Bewertung ausgewählt wurde. Weitere Informationen zu möglichen Werten finden Sie im Artikel Gründe für das Kommentieren 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 ContentSie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.
- ASSESSMENT_ID: Der vom