Übersicht
Mit der Evaluate API können Ihre Client-Anwendungen die Schädlichkeit einer URL bewerten. Diese API unterscheidet sich von der Lookup API darin, dass sie einen Konfidenzwert in Bezug auf die Schädlichkeit einer URL anstelle eines binären Ergebnisses zurückgibt.
Hinweis
Wenden Sie sich an den Vertrieb oder Ihren Customer Engineer, um Zugriff auf diese Funktion zu erhalten.
URLs auswerten
Senden Sie zum Auswerten einer URL eine HTTP-POST
-Anfrage an die Methode evaluateUri
:
- Die Evaluate API unterstützt eine URL pro Anfrage. Um mehrere URLs zu prüfen, müssen Sie für jede URL eine separate Anfrage senden.
- Für diese API wird nur der threatType SOCIAL_ENGINEERING unterstützt.
- Mit der Option
allow_scan
wird festgelegt, ob Web Risk die angegebene URL scannen darf. - Die URL muss gültig sein (siehe RFC 2396), muss jedoch nicht kanonisiert werden.
- Die HTTP-
POST
-Antwort gibt eine Bewertung pro threatType zurück, die das Konfidenzniveau angibt, inwieweit die angegebene URL schädlich ist.
Beispiel: evaluateUri
HTTP-Methode und URL:
POST "https://webrisk.googleapis.com/v1eap1:evaluateUri"
JSON-Text der Anfrage:
{ "uri": "http://www.google.com", "threatTypes": "SOCIAL_ENGINEERING", "allowScan": "true" }
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 application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://webrisk.googleapis.com/v1eap1:evaluateUri"
PowerShell
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
und führen Sie den folgenden Befehl aus:
$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
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ "scores": [ { "threatType": "SOCIAL_ENGINEERING", "confidenceLevel": "SAFE" } ] }