- HTTP-Anfrage
- Anfragetext
- Antworttext
- ListUpdateRequest
- Einschränkungen
- CompressionType
- ListUpdateResponse
- ResponseType
- ThreatEntrySet
- RawHashes
- RawIndices
- RiceDeltaEncoding
- Prüfsumme
Ruft die neuesten Aktualisierungen der Bedrohungsliste ab. Ein Kunde kann Aktualisierungen für mehrere Listen gleichzeitig anfordern.
HTTP-Anfrage
POST https://safebrowsing.googleapis.com/v4/threatListUpdates:fetch
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "client": { object ( |
Felder | |
---|---|
client |
Die Metadaten des Clients. |
listUpdateRequests[] |
Die angeforderte Liste der Bedrohungen wird aktualisiert. |
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"listUpdateResponses": [
{
object ( |
Felder | |
---|---|
listUpdateResponses[] |
Die von den Clients angeforderten Listenaktualisierungen. Die Anzahl der Antworten hier kann geringer sein als die Anzahl der Anfragen, die von Clients gesendet werden. Das ist beispielsweise der Fall, wenn der Server keine Aktualisierungen für eine bestimmte Liste hat. |
minimumWaitDuration |
Die Mindestdauer, die der Client warten muss, bevor er eine Aktualisierungsanfrage sendet. Wenn dieses Feld nicht festgelegt ist, können Clients schnellstmöglich aktualisiert werden. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
ListUpdateRequest
Eine einzelne Anfrage zur Listenaktualisierung.
JSON-Darstellung |
---|
{ "threatType": enum ( |
Felder | |
---|---|
threatType |
Die Art der Bedrohung durch Einträge in der Liste. |
platformType |
Der Plattformtyp, für den ein Risiko nach Einträgen in der Liste besteht. |
threatEntryType |
Die in der Liste vorhandenen Eintragstypen. |
state |
Der aktuelle Status des Clients für die angeforderte Liste. Dies ist der verschlüsselte Clientstatus, der nach der letzten erfolgreichen Listenaktualisierung empfangen wurde. Ein base64-codierter String. |
constraints |
Die mit dieser Anfrage verknüpften Einschränkungen. |
Einschränkungen
Die Einschränkungen für dieses Update.
JSON-Darstellung |
---|
{
"maxUpdateEntries": integer,
"maxDatabaseEntries": integer,
"region": string,
"supportedCompressions": [
enum ( |
Felder | |
---|---|
maxUpdateEntries |
Die maximale Größe der Anzahl von Einträgen. Die Aktualisierung enthält nicht mehr Einträge als diesen Wert. Der Wert sollte eine Potenz von 2 zwischen 2**10 und 2**20 sein. Wenn null, wird keine Größenbeschränkung für die Aktualisierung festgelegt. |
maxDatabaseEntries |
Legt die maximale Anzahl von Einträgen fest, die der Client für die angegebene Liste in der lokalen Datenbank aufnehmen möchte. Der Wert sollte eine Potenz von 2 zwischen 2**10 und 2**20 sein. Wenn null, ist keine Größenbeschränkung für die Datenbank festgelegt. |
region |
Fordert die Liste für einen bestimmten geografischen Standort an. Wenn die Richtlinie nicht konfiguriert ist, kann der Server diesen Wert anhand der IP-Adresse des Nutzers auswählen. Erfordert ISO 3166-1 alpha-2-Format. |
supportedCompressions[] |
Die vom Client unterstützten Komprimierungstypen. |
language |
Fordert die Listen für eine bestimmte Sprache an. Erwartet das ISO 639-Alpha-2-Format. |
deviceLocation |
Der physische Standort eines Clients, ausgedrückt als Regionscode nach ISO 31166-1 alpha-2. |
CompressionType
Methoden, mit denen Bedrohungseintragssätze komprimiert werden können.
Enums | |
---|---|
COMPRESSION_TYPE_UNSPECIFIED |
Unbekannt. |
RAW |
Unkomprimierte Rohdaten. |
RICE |
Mit Rice-Golomb codierte Daten. |
ListUpdateResponse
Die Aktualisierung einer einzelnen Liste.
JSON-Darstellung |
---|
{ "threatType": enum ( |
Felder | |
---|---|
threatType |
Der Bedrohungstyp, für den Daten zurückgegeben werden. |
threatEntryType |
Das Format der Bedrohungen. |
platformType |
Der Plattformtyp, für den Daten zurückgegeben werden. |
responseType |
Der Typ der Antwort. Dies kann darauf hinweisen, dass der Client eine Aktion erfordert, wenn die Antwort eingeht. |
additions[] |
Eine Reihe von Einträgen, die der Liste eines lokalen Bedrohungstyps hinzugefügt werden sollen. Wird wiederholt, damit eine Kombination aus komprimierten und Rohdaten in einer einzigen Antwort gesendet werden kann. |
removals[] |
Eine Reihe von Einträgen, die aus der Liste eines lokalen Bedrohungstyps entfernt werden sollen. In der Praxis ist dieses Feld leer oder enthält genau ein ThreatEntrySet. |
newClientState |
Der neue Clientstatus im verschlüsselten Format. Für Kunden intransparent. Ein base64-codierter String. |
checksum |
Der erwartete SHA256-Hash des Clientstatus, d. h. der sortierten Liste aller Hashes, die nach dem bereitgestellten Update in der Datenbank vorhanden sind. Wenn der Clientstatus nicht mit dem erwarteten Status übereinstimmt, muss der Client diese Aktualisierung ignorieren und es später noch einmal versuchen. |
ResponseType
Der an den Client gesendete Antworttyp.
Enums | |
---|---|
RESPONSE_TYPE_UNSPECIFIED |
Unbekannt. |
PARTIAL_UPDATE |
Teilweise Aktualisierungen werden auf die vorhandene lokale Datenbank des Clients angewendet. |
FULL_UPDATE |
Vollständige Updates ersetzen die gesamte lokale Datenbank des Clients. Das bedeutet, dass der Kunde entweder stark veraltet war oder vermutet wird, dass er korrupt war. |
ThreatEntrySet
Eine Reihe von Bedrohungen, die der lokalen Datenbank eines Clients hinzugefügt oder daraus entfernt werden sollten.
JSON-Darstellung |
---|
{ "compressionType": enum ( |
Felder | |
---|---|
compressionType |
Der Komprimierungstyp für die Einträge in diesem Satz. |
rawHashes |
Die Roheinträge im SHA256-Format. |
rawIndices |
Die Indizes der Rohentfernung für eine lokale Liste. |
riceHashes |
Die codierten 4-Byte-Präfixe von SHA-256-formatierten Einträgen mit Golomb-Rice-Codierung. Die Hashes werden in uint32 konvertiert, in aufsteigender Reihenfolge sortiert, dann deltacodiert und als EncryptData gespeichert. |
riceIndices |
Die codierten lokalen, lexikografisch sortierten Listenindexe unter Verwendung einer Golomb-Rice-Codierung. Wird zum Senden komprimierter Entfernungsindexe verwendet. Die Entfernungsindexe (uint32) werden in aufsteigender Reihenfolge sortiert, dann deltacodiert und als EncryptData gespeichert. |
RawHashes
Die unkomprimierten Bedrohungseinträge im Hash-Format mit einer bestimmten Präfixlänge. Hashes können zwischen 4 und 32 Byte groß sein. Die meisten Hashes sind 4 Byte. Einige Hashes werden jedoch verlängert, wenn sie mit dem Hash einer beliebten URL kollidieren.
Wird zum Senden von ThreatEntrySet an Clients, die keine Komprimierung unterstützen, oder zum Senden von Nicht-Byte-Hashes an Clients mit Komprimierungsunterstützung verwendet.
JSON-Darstellung |
---|
{ "prefixSize": integer, "rawHashes": string } |
Felder | |
---|---|
prefixSize |
Die Anzahl der Byte für jedes unten codierte Präfix. Der Wert in diesem Feld kann zwischen 4 (kürzestes Präfix) und 32 (vollständiger SHA256-Hash) liegen. |
rawHashes |
Die Hashes im Binärformat, die zu einem langen String verkettet sind. Hashes werden in lexikografischer Reihenfolge sortiert. Für Nutzer der JSON API sind Hashes base64-codiert. Ein base64-codierter String. |
RawIndices
Eine Reihe von Rohindexen, die aus einer lokalen Liste entfernt werden sollen
JSON-Darstellung |
---|
{ "indices": [ integer ] } |
Felder | |
---|---|
indices[] |
Indizes, die aus einer lexikografisch sortierten lokalen Liste entfernt werden sollen |
RiceDeltaEncoding
Die Rice-Golomb-codierten Daten. Wird zum Senden komprimierter 4-Byte-Hashes oder komprimierter Entfernungsindexe verwendet.
JSON-Darstellung |
---|
{ "firstValue": string, "riceParameter": integer, "numEntries": integer, "encodedData": string } |
Felder | |
---|---|
firstValue |
Der Offset des ersten Eintrags in den codierten Daten oder, wenn nur eine einzelne Ganzzahl codiert wurde, der Wert dieser einzelnen Ganzzahl. Wenn das Feld leer ist oder fehlt, wird Null angenommen. |
riceParameter |
Der Golomb-Rice-Parameter, bei dem es sich um eine Zahl zwischen 2 und 28 handelt. Dieses Feld fehlt (d. h. null), wenn |
numEntries |
Die Anzahl der Einträge, die in den codierten Daten Deltacodiert sind. Wenn nur eine einzelne Ganzzahl codiert wurde, ist dies null und der einzelne Wert wird in |
encodedData |
Die codierten Deltas, die mit dem Golomb-Rice-Coder codiert werden. Ein base64-codierter String. |
Prüfsumme
Der erwartete Status der lokalen Datenbank eines Clients.
JSON-Darstellung |
---|
{ "sha256": string } |
Felder | |
---|---|
sha256 |
SHA256-Hash des Clientstatus, also der sortierten Liste aller in der Datenbank vorhandenen Hashes. Ein base64-codierter String. |