Submission API verwenden

In diesem Dokument wird beschrieben, wie Sie unsichere URLs zur Analyse an Safe Browsing senden und die Ergebnisse dieser Einreichungen asynchron prüfen können. Alle URLs, die nachweislich gegen die Safe Browsing-Richtlinien verstoßen, werden dem Safe Browsing-Dienst hinzugefügt.

Hinweise

Wenden Sie sich an den Vertrieb oder Ihren Customer Engineer, um Zugriff auf diese Funktion zu erhalten.

Best Practices

Safe Browsing-Richtlinien lesen

Die Web Risk Submission API prüft, ob die eingereichten URLs Inhalte rendern, die gegen die Safe Browsing-Richtlinien verstoßen. API-Entwickler müssen dafür sorgen, dass für die eingereichten URLs eindeutige Verstöße gegen diese Richtlinien vorliegen. Die folgenden Beispiele veranschaulichen einen Richtlinienverstoß:

  • Social-Engineering-Inhalte, die eine legitime Onlinemarke (Markenname, Logo, Design) imitieren, Systemwarnungen verwenden, betrügerische URLs verwenden oder Nutzer zur Eingabe vertraulicher Anmeldedaten wie Nutzernamen oder Passwörter auffordern.
  • Website, auf der eine bekannte ausführbare Malware-Datei gehostet wird.

API-Entwickler sollten diese Arten von URLs nicht einreichen, da sie höchstwahrscheinlich nicht zu Safe Browsing-Sperrlisten hinzugefügt werden:

  • Gefälschte Umfragen, Shopping-Websites oder andere Betrüger, bei denen kein Phishing (z. B. Kryptowährung) zum Einsatz kommt.
  • Spam mit Glücksspielen, Gewalt oder nicht jugendfreien Inhalten, bei denen es sich nicht um Phishing oder Malware handelt.

URLs einreichen

Senden Sie zum Senden einer URL eine HTTP-POST-Anfrage an die Methode projects.uris.submit.

  • Die Submission API unterstützt eine URL pro Anfrage. Um mehrere URLs zu prüfen, müssen Sie für jede URL eine separate Anfrage senden.

  • Die URL muss gültig sein, aber keine kanonische URL. Weitere Informationen finden Sie unter RFC 2396.

  • Die HTTP-POST-Antwort gibt einen long-running operation zurück. Weitere Informationen zum Abrufen des Übertragungsergebnisses und zum Prüfen des Status einer Einreichung finden Sie unter Vorgänge mit langer Ausführungszeit.

Beispiel

HTTP-Methode und URL: 

POST https://webrisk.googleapis.com/v1/projects/project-id/uris:submit

JSON-Text der Anfrage: 

{
  "submission": {
    "uri": "https://www.example.com/login.html"
  }
}

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/v1/projects/project-id/uris:submit"

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/v1/projects/project-id/uris:submit" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/project-number/operations/operation-id",
}

Einreichungsstatus prüfen

Sie können den Status der Einreichung prüfen, indem Sie die Werte project-number und operation-id aus der Antwort verwenden.

SUCCEEDED gibt an, dass die eingereichte URL der Safe Browsing-Sperrliste hinzugefügt wurde.

CLOSED gibt an, dass die eingereichte URL nicht gegen die Safe Browsing-Richtlinien verstößt und in den letzten 24 Stunden nicht der Safe Browsing-Sperrliste hinzugefügt wurde.