Einschränkungen aktualisieren

Dieses Dokument gilt für die Update API (Version 4): threatListUpdates.fetch.

Einschränkungen festlegen

Beim Aktualisieren lokaler Datenbanken (siehe Datenbankupdates) können Clients die Felder maxUpdateEntries und maxDatabaseEntries in der Anfrage „threatListUpdates.fetch“ verwenden, um Größenbeschränkungen anzugeben. Clients sollten Einschränkungen festlegen, um einen vorhersehbaren Verbrauch von RAM, Laufwerk und Bandbreite des Clients aufrechtzuerhalten und das Listenwachstum zu verhindern.

  • Clients können für die Anzahl der Einträge eine maximale Größe für die Updateantwort (maxUpdateEntries) angeben (1 Eintrag = 1 hinzugefügt oder 1 entfernt).
  • Clients können eine maximale Datenbankgröße (maxDatabaseEntries) in Bezug auf die Anzahl der Einträge angeben (die überwiegende Mehrheit der Einträge in der Datenbank sind 4-Byte-Hash-Präfixe). Daher kann davon ausgegangen werden, dass ein Eintrag AVERAGE 4 Byte umfasst.

Bandbreite im Vergleich zu Speicher

Clients können zwar beliebige Größen für die Updateantwort und die Datenbankgrößen angeben, der Safe Browsing-Server generiert jedoch nur eine begrenzte Anzahl möglicher Updateantworten und Datenbankgrößen vorab.

  • Clients sollten die Größe der Updateantwort (maxUpdateEntries) verwenden, um die Bandbreitennutzung zu begrenzen.
  • Clients sollten die Datenbankgröße (maxDatabaseEntries) verwenden, um den auf dem Gerät erforderlichen RAM- oder Festplattenspeicher zu begrenzen.
Beide Limits wirken sich auf die Größe der Datenbank aus, die aktualisiert wird. Sie wirken sich daher auf den Schutz des Nutzers aus (d. h. je größer die Größe der lokalen Datenbank, desto besser ist der Schutz).

Anleitung zum Festlegen von Einschränkungen

Die Größe von Safe Browsing-Listen kann sich allmählich oder plötzlich ändern. Clients sollten maxUpdateEntries für Anfragen zur Listenaktualisierung festlegen. Dadurch wird die maximale Größe der Listenaktualisierungsantwort begrenzt und die Zuverlässigkeit erhöht, wenn große Aktualisierungen nicht verarbeitet werden können.

Falls keine strengeren oder weniger strengen Anforderungen vorliegen, empfiehlt Google die Verwendung von maxUpdateEntries=16777216. Bei der typischen Größe eines Listeneintrags von 4 Byte pro Hash-Präfix entspricht dies etwa 67 Megabyte pro Liste. Google empfiehlt, für mobile Clients das kleinere Limit maxUpdateEntries=2097152 zu verwenden, da diese in der Regel weniger leistungsstark sind. Bei der typischen Größe von Listeneinträgen von 4 Byte pro Hash-Präfix entspricht dies etwa 8 Megabyte pro Liste.

Safe Browsing-Listen unterscheiden sich in Größe und Wachstumsrate. Clients sollten jedoch für alle Listen dieselben Einschränkungen basierend auf der maximal zulässigen Arbeitsspeicher- oder Bandbreitennutzung für jede Liste festlegen.

Zur Verbesserung der Zuverlässigkeit empfiehlt Google Clients, Telemetrie zur Erkennung von Überlastung des Arbeitsspeichers oder der Bandbreite sowie Mechanismen zu implementieren, um Clients schnell neue Einschränkungen bereitzustellen.

Clientstatus

Der Safe Browsing-Server sendet niemals ein Update, das den Client in einem veralteten Status zurücklässt. Clients sind nach jeder Aktualisierungsanfrage vollständig auf dem neuesten Stand. Wenn ein Client beispielsweise derzeit eine Datenbank mit 4.096 Einträgen hat, aber nur höchstens 2.048 Deltas herunterladen möchte, kann der Server den Client auf eine 2048-Datenbank zurücksetzen, wenn der Client wirklich veraltet ist.