Usar la API de evaluación

Resumen

La API de Evaluación permite que tus aplicaciones cliente evalúen la malicia de una URL. Esta API se diferencia de la API de Lookup en que muestra una puntuación de confianza en la maliciosidad de una URL en lugar de un resultado de objeto binario.

Antes de comenzar

Comunícate con Ventas o con tu Ingeniero de Atención al cliente para obtener acceso a esta función.

Evalúa URL

Para evaluar una URL, envía una solicitud HTTP POST al método evaluateUri:

  • La API de evaluación admite una URL por solicitud. Si deseas verificar varias URL, debes enviar una solicitud diferente para cada una.
  • Solo se admite el tipo de amenaza SOCIAL_ENGINEERING para esta API.
  • La opción allow_scan determina si Web Risk puede analizar la URL proporcionada.
  • La URL debe ser válida (consulte RFC 2396), pero no es necesario que sea canonicalizada.
  • En la respuesta HTTP POST, se muestra una puntuación por cada threatType proporcionado que representa el nivel de confianza en el que la URL proporcionada es maliciosa.

Ejemplo: evaluateUri

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "uri": "http://www.google.com",
  "threatTypes": "SOCIAL_ENGINEERING",
  "allowScan": "true"
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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