Utiliser l'API Evaluate

Cette page explique comment utiliser l'API Evaluate pour permettre à vos applications clientes d'évaluer le caractère malveillant d'une URL. Cette API affiche un score de confiance qui indique le caractère malveillant d'une URL. Si vous souhaitez obtenir un résultat binaire au lieu d'un score de confiance, utilisez l'API Lookup.

Avant de commencer

Contactez notre équipe commerciale ou votre ingénieur client pour accéder à cette fonctionnalité.

Évaluation des URL

Pour évaluer une URL, envoyez une requête HTTP POST à la méthode evaluateUri. Tenez compte des considérations suivantes lorsque vous évaluez des URL:

  • L'API Evaluate accepte une URL par requête. Si vous souhaitez vérifier plusieurs URL, envoyez une requête distincte pour chaque URL.
  • L'URL doit être valide et n'a pas besoin d'être canonique. Pour en savoir plus, consultez la RFC 2396.
  • Seul le type de menace SOCIAL_ENGINEERING est accepté pour cette API.
  • L'option allow_scan détermine si Web Risk est autorisé à analyser l'URL fournie.
  • La réponse HTTP POST renvoie un score de confiance pour le type de menace spécifié. Le score de confiance représente le niveau de confiance qui indique le niveau de risque de l'URL spécifiée.

Requête API

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

URL: URL à évaluer.

Méthode HTTP et URL :

POST "https://webrisk.googleapis.com/v1eap1:evaluateUri"

Corps JSON de la requête :

{
  "uri": "URL",
  "threatTypes": "SOCIAL_ENGINEERING",
  "allowScan": "true"
}

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://webrisk.googleapis.com/v1eap1:evaluateUri""

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://webrisk.googleapis.com/v1eap1:evaluateUri"" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "scores": [
    {
      "threatType": "SOCIAL_ENGINEERING",
      "confidenceLevel": "SAFE"
    }
  ]
}