Este documento se aplica al siguiente método: API de Update (v4): threatListUpdates.fetch.
Establece restricciones
Cuando se actualizan bases de datos locales (consulta Actualizaciones de bases de datos), los clientes pueden usar los campos maxUpdateEntries
y maxDatabaseEntries
en la solicitudthreatListUpdates.fetch para especificar las restricciones de tamaño. Los clientes deben establecer restricciones para mantener el consumo predecible de la RAM, el disco y el ancho de banda del cliente, y para protegerse contra el crecimiento de la lista.
- Los clientes pueden especificar un tamaño máximo de respuesta de actualización (
maxUpdateEntries
) en una cantidad de entradas (1 entrada = 1 adición o 1 eliminación). - Los clientes pueden especificar un tamaño máximo de base de datos (
maxDatabaseEntries
) en la cantidad de entradas (la gran mayoría de las entradas en la base de datos son prefijos de hash de 4 bytes, por lo que es justo suponer que 1 entrada es igual a 4 bytes).
Ancho de banda frente a almacenamiento
Si bien los clientes pueden especificar tamaños arbitrarios de la respuesta de actualización y los tamaños de la base de datos, el servidor de Navegación segura solo genera previamente una cantidad limitada de respuestas de actualización y tamaños de base de datos posibles.
- Los clientes deben usar el tamaño de respuesta de actualización (
maxUpdateEntries
) para limitar el uso del ancho de banda. - Los clientes deben usar el tamaño de la base de datos (
maxDatabaseEntries
) para limitar la cantidad de almacenamiento en disco o RAM necesaria en el dispositivo.
Guía para establecer restricciones
Las listas de Navegación segura pueden cambiar de tamaño de manera gradual o repentina. Los clientes deben configurar el maxUpdateEntries
para las solicitudes de actualización de lista, lo que limita el tamaño máximo de respuesta de actualización de lista y mejora la confiabilidad cuando no se pueden procesar actualizaciones grandes.
Ante la ausencia de requisitos más estrictos o requisitos menos estrictos, Google recomienda usar maxUpdateEntries=16777216
. Con el tamaño típico de una entrada de lista de 4 bytes por prefijo hash, esto equivale a, aproximadamente, 67 megabytes por lista. Google recomienda usar el límite más pequeño de maxUpdateEntries=2097152
para los clientes de dispositivos móviles, ya que suelen ser menos eficaces. Con un tamaño de entrada de lista típico de 4 bytes por prefijo de hash, esto equivale a, aproximadamente, 8 megabytes por lista.
Las listas de Navegación segura difieren en tamaño y tasa de crecimiento. Sin embargo, los clientes deben establecer las mismas restricciones para todas las listas, según el uso máximo de memoria o ancho de banda permitido para cada lista.
Para mejorar la confiabilidad, Google recomienda que los clientes implementen la telemetría a fin de detectar el uso excesivo de la memoria o del ancho de banda, además de mecanismos para entregar restricciones nuevas a los clientes con rapidez.
Estado del cliente
El servidor de Navegación segura nunca envía una actualización que deje al cliente en un estado desactualizado; los clientes estarán completamente actualizados después de cada solicitud de actualización. Por ejemplo, si un cliente actualmente tiene una base de datos de 4,096 entradas, pero solo desea descargar 2,048 deltas como máximo, el servidor puede restablecer al cliente a una base de datos de 2,048 si está realmente desactualizado.