Utilizzo dell'API Evaluate

In questa pagina viene spiegato come utilizzare l'API Assess per consentire alle applicazioni client valutare la pericolosità di un URL. Questa API restituisce un punteggio di confidenza indica la pericolosità di un URL in base a liste bloccate, modelli e regole euristiche. Se vuoi un risultato binario anziché una confidenza utilizza l'API Lookup.

Nota:tutti gli URL inviati all'API Valuta potrebbero essere sottoposti a ulteriori elaborazioni, incluse le scansioni.

Prima di iniziare

Contatta il nostro team di vendita o il tuo cliente per ottenere l'accesso a questa funzionalità.

Valutazione degli URL

Per valutare un URL, invia una richiesta POST HTTP a il evaluateUri . Quando valuti gli URL, tieni presente le seguenti considerazioni:

  • L'API Assess supporta un solo URL per richiesta. Se vuoi selezionare più elementi per gli URL, invia una richiesta separata per ogni URL.
  • L'URL deve essere valido e non deve essere canonicalizzato. Per ulteriori informazioni informazioni, consulta RFC 2396.
  • L'API Valuta supporta tre threatType: SOCIAL_ENGINEERING, MALWARE e SOFTWARE_INDESIDERATO.
  • Deprecato. Il campo allow_scan è stato utilizzato per determinare se Web Risk è autorizzati a eseguire la scansione dell'URL fornito. Non è più possibile disattivare questa funzionalità nell'API Assess. Utilizza le API Lookup e Update per informazioni sulle opzioni prive di scansione.
  • La risposta HTTP POST restituisce un punteggio di confidenza per l'attributo specificato threatType. Il punteggio di confidenza rappresenta il livello di confidenza che indica quanto sia rischioso l'URL specificato.

Richiesta API

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

URL: un URL che deve essere valutato.

Metodo HTTP e URL: 

POST https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY

Corpo JSON della richiesta: 

{
  "uri": "URL",
  "threatTypes": ["SOCIAL_ENGINEERING", "MALWARE", "UNWANTED_SOFTWARE"]
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando: 

curl -X POST \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY"

PowerShell

Salva il corpo della richiesta in un file denominato request.json. ed esegui questo comando: 

$headers = @{  }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

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