Annoter une évaluation

Cette page explique comment envoyer des commentaires sur la précision des évaluations créées par reCAPTCHA Enterprise. Grâce à ces informations, reCAPTCHA Enterprise peut ajuster le modèle spécifique à votre site et l'améliorer au fil du temps.

Avant de commencer

Créez une évaluation.

Comprendre quand annoter les évaluations

reCAPTCHA Enterprise fournit un score lors de la création d'une évaluation qui vous aide à comprendre le niveau de risque des interactions utilisateur. Plus tard, lorsque votre site aura plus d'informations sur les interactions des utilisateurs pour déterminer si l'interaction était légitime ou frauduleuse, vous pourrez confirmer ou corriger l'évaluation de reCAPTCHA Enterprise. Pour confirmer ou corriger l'évaluation de reCAPTCHA Enterprise, vous pouvez renvoyer à Google les ID d'évaluation reCAPTCHA identifiés comme LEGITIMATE ou FRAUDULENT. Le fait de confirmer ou de corriger l'évaluation reCAPTCHA Enterprise améliore les performances de reCAPTCHA Enterprise pour votre site.

Pour améliorer les performances de reCAPTCHA Enterprise, vous pouvez confirmer les annotations de vrais positifs et de vrais négatifs en plus des annotations d'erreurs d'évaluation potentielles. Par exemple, dans le cas d'un utilisateur qui s'est authentifié à l'aide d'une méthode d'authentification à deux facteurs et qui a reçu un score reCAPTCHA élevé, vous pouvez annoter l'évaluation comme LEGITIMATE. Si le score reCAPTCHA est faible et que votre site détermine que l'interaction est frauduleuse ou abusive, vous pouvez annoter l'évaluation comme FRAUDULENT.

La liste suivante contient des informations supplémentaires sur des exemples d'interactions utilisateur qui indiquent si une interaction est légitime ou frauduleuse :

  • Les rejets de débit de carte de crédit ou d'autres preuves concrètes de fraude indiquent qu'une transaction financière antérieure était frauduleuse.
  • Un nouveau compte qui envoie des messages signalés comme spam par d'autres utilisateurs peut indiquer que la création du compte est frauduleuse.
  • Une demande d'assistance envoyée si un utilisateur rencontre des difficultés pour se connecter à son compte peut indiquer que la tentative de connexion est légitime.
  • Un achat ou une réservation sur un site qui utilise reCAPTCHA Enterprise pour se protéger contre le scraping peut indiquer que l'utilisateur est légitime.

Récupérer l'ID d'évaluation

Après avoir créé une évaluation, vous recevez une réponse JSON comme illustré dans l'exemple suivant.

Pour annoter une évaluation, récupérez l'ID d'évaluation unique à partir du champ name de la réponse JSON.

{
  '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': 'SITE_KEY'
   },
  'name': u'ASSESSMENT_ID'
}

Annoter l'évaluation

Annotez une évaluation à l'aide de la méthode projects.assessments.annotate.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • ASSESSMENT_ID : valeur du champ name renvoyée par l'appel projects.assessments.create

Méthode HTTP et URL :

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

Corps JSON de la requête :

{
"annotation": "LEGITIMATE or FRAUDULENT"
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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

PowerShell

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth application-default 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

Vous devriez recevoir un code d'état indiquant le succès de l'opération (2xx), ainsi qu'une réponse vide.