Package google.security.safebrowsing.v4

Dizin

SafeBrowsing

Güvenli Tarama API'leri, istemcilerin web kaynaklarını (genellikle URL'leri) Google'ın sürekli güncellenen güvenli olmayan web kaynakları listeleriyle karşılaştırarak kontrol etmesini sağlar. Güvenli Tarama API'leri (v4), Update API ve Lookup API'yi içerir.

Update API, büyük ölçekli müşterilerimiz için tasarlanmıştır ve FindFullHashes ile FetchThreatListUpdates yöntemlerini içerir . Update API, istemcilerin indirilen tehdit listelerini yerel bir veritabanında tutmasını gerektirir.

İstemciler, belirli bir web kaynağının durumunu (güvenli veya güvenli değil) belirlemek için önce yerel listeleriyle eşleşme yapar. Listeler genellikle kara listeye alınmış URL ifadelerinin karma ön eklerinden oluşur. İstemciler, bir URL'yi kontrol etmek için belirli bir URL'nin karma oluşturma işlemlerini oluşturur ve yerel listelerinde ön ek çakışması olup olmadığını kontrol eder. Ön ek eşleşmesi bulunursa istemci, FindFullHashes yöntemi aracılığıyla eşleşen karma ön ekiyle ilişkili tam karma oluşturma işlemlerini alır. Ardından istemci, yerel tam karmayı döndürülen tam karmalarla karşılaştırır. Eşleşme, URL'nin güvenli olmadığını gösterir.

İkinci olarak, istemciler FetchThreatListUpdates yöntemi aracılığıyla yerel veritabanlarında güncellemeler alır. Bu yöntem , istemcinin mevcut durumunu alır ve istemcinin yerel tehdit listelerine uygulaması gereken değişikliklerle birlikte güncellenmiş bir istemci durumu döndürür.

Lookup API, küçük müşterilerimiz için tasarlanmıştır ve FindThreatMatches yöntemi aracılığıyla kaynakları doğrudan Güvenli Tarama tehdit listeleriyle eşleştirmelerine olanak tanır.

Update API veya Lookup API'yi kullanan istemciler, ListThreatLists yöntemi aracılığıyla indirilebilen Güvenli Tarama tehdit listelerinin bir listesini alabilir.

{-- TRUSTED_THREAT_REPORTER: Güvenilir tehdit istemcileri, SubmitThreatReport yöntemi aracılığıyla analiz için Google'a rapor gönderebilir. --}

FetchThreatListUpdates

rpc FetchThreatListUpdates(FetchThreatListUpdatesRequest) returns (FetchThreatListUpdatesResponse)

En son tehdit listesi güncellemelerini getirir. İstemciler aynı anda birden fazla liste için güncelleme isteğinde bulunabilir.
FindFullHashes

rpc FindFullHashes(FindFullHashesRequest) returns (FindFullHashesResponse)

İstenen karma ön ekleriyle eşleşen tam karmaları bulur.
FindThreatMatches

rpc FindThreatMatches(FindThreatMatchesRequest) returns (FindThreatMatchesResponse)

Güvenli Tarama listeleriyle eşleşen tehdit girişlerini bulur.
ListThreatLists

rpc ListThreatLists(Empty) returns (ListThreatListsResponse)

İndirilebilen Güvenli Tarama tehdit listelerini listeler.

Denetim Toplamı

İstemcinin yerel veritabanının beklenen durumu.

Alanlar
sha256

bytes

İstemci durumunun SHA256 karması, yani veritabanındaki tüm karmaların sıralanmış listesi.

ClientInfo

Güvenli Tarama API istekleriyle ilişkili istemci meta verileri.

Alanlar
client_id

string

Güvenli Tarama API'sinin istemci uygulamasını benzersiz şekilde tanımlayan (umarız) bir istemci kimliği.
client_version

string

İstemci uygulamasının sürümü.

CompressionType

Tehdit girişi kümelerinin sıkıştırılabileceği yöntemler.

Sıralamalar
COMPRESSION_TYPE_UNSPECIFIED Bilinmiyor.
RAW Ham, sıkıştırılmamış veriler.
RICE Rice-Golomb kodlu veriler.

FetchThreatListUpdatesRequest

Güvenli Tarama API güncelleme isteğini açıklar. İstemciler tek bir istekte birden fazla liste için güncelleme isteğinde bulunabilir. Sunucu, söz konusu liste için güncellemesi yoksa tüm isteklere yanıt vermeyebilir. NOT: Alan dizini 2 kullanılmamaktadır. SONRAKİ: 5

Alanlar
client

ClientInfo

Müşteri meta verileri.
list_update_requests[]

ListUpdateRequest

İstenen tehdit listesi güncellenir.

ListUpdateRequest

Tek bir liste güncelleme isteği.

Alanlar
threat_type

ThreatType

Listede bulunan girişlerin oluşturduğu tehdit türü.
platform_type

PlatformType

Listede bulunan girişlere göre risk altındaki platform türü.
threat_entry_type

ThreatEntryType

Listede bulunan giriş türleri.
state

bytes

İstenen liste için istemcinin mevcut durumu (son başarılı liste güncellemesinden alınan şifrelenmiş istemci durumu).
constraints

Constraints

Bu istekle ilişkili kısıtlamalar.

Sınırlamalar

Bu güncellemeyle ilgili kısıtlamalar.

Alanlar
max_update_entries

int32

Giriş sayısı olarak maksimum boyut. Güncelleme, bu değerden fazla giriş içermez. Bu değer, 2**10 ile 2**20 arasında bir 2 kuvveti olmalıdır. Sıfır ise güncelleme boyutu sınırı ayarlanmamıştır.
max_database_entries

int32

İstemcinin, yerel veritabanında belirtilen liste için olmasını istediği maksimum giriş sayısını ayarlar. Bu değer, 2**10 ile 2**20 arasında bir 2 kuvveti olmalıdır. Sıfır ise veritabanı boyutu sınırı ayarlanmamıştır.
region

string

Belirli bir coğrafi konumun listesini ister. Ayarlanmamışsa sunucu bu değeri kullanıcının IP adresine göre seçebilir. ISO 3166-1 alpha-2 biçimi beklenir.
supported_compressions[]

CompressionType

İstemci tarafından desteklenen sıkıştırma türleri.
language

string

Belirli bir dilin listelerini ister. ISO 639 alfa-2 biçimi beklenir.
device_location

string

ISO 31166-1 alpha-2 bölge kodu olarak ifade edilen istemcinin fiziksel konumu.

FetchThreatListUpdatesResponse

Alanlar
list_update_responses[]

ListUpdateResponse

İstemciler tarafından istenen liste güncellemeleri. Buradaki yanıt sayısı, istemciler tarafından gönderilen isteklerin sayısından az olabilir. Örneğin, sunucunun belirli bir listeyle ilgili güncellemesi yoksa bu durum ortaya çıkar.
minimum_wait_duration

Duration

İstemcinin güncelleme isteği göndermeden önce beklemesi gereken minimum süre. Bu alan ayarlanmamışsa istemciler istedikleri zaman güncelleme yapabilir.

ListUpdateResponse

Belirli bir listede yapılan bir güncelleme.

Alanlar
threat_type

ThreatType

Verilerin döndürüldüğü tehdit türü.
threat_entry_type

ThreatEntryType

Tehditlerin biçimi.
platform_type

PlatformType

Verilerin döndürüldüğü platform türü.
response_type

ResponseType

Yanıtın türü. Bu durum, yanıt alındığında müşterinin bir işlem yapması gerektiğini gösterebilir.
additions[]

ThreatEntrySet

Yerel tehdit türü listesine eklenecek girişler grubu. Tek bir yanıtta sıkıştırılmış ve ham verilerin bir kombinasyonunun gönderilmesine izin vermek için tekrarlanır.
removals[]

ThreatEntrySet

Yerel tehdit türünün listesinden kaldırılacak girişler grubu. Uygulamada bu alan boştur veya tam olarak bir ThreatEntrySet içerir.
new_client_state

bytes

Şifrelenmiş biçimdeki yeni istemci durumu. İstemciler tarafından görülemez.
checksum

Checksum

İstemci durumunun beklenen SHA256 karması; yani, sağlanan güncelleme uygulandıktan sonra veritabanında bulunan tüm karmaların sıralı listesi. İstemci durumu beklenen durumla eşleşmiyorsa istemcinin bu güncellemeyi yoksayıp daha sonra tekrar denemesi gerekir.

ResponseType

İstemciye gönderilen yanıt türü.

Sıralamalar
RESPONSE_TYPE_UNSPECIFIED Bilinmiyor.
PARTIAL_UPDATE Kısmi güncellemeler, istemcinin mevcut yerel veritabanına uygulanır.
FULL_UPDATE Tam güncellemeler, istemcinin yerel veritabanının tamamını değiştirir. Bu durum, istemcinin güncel olmadığı veya bozuk olduğu anlamına gelir.

FindFullHashesRequest

Sağlanan karma ön ekleriyle eşleşen tam karmaları döndürme isteği.

Alanlar
client

ClientInfo

Müşteri meta verileri.
client_states[]

bytes

İstemcinin yerel tehdit listelerinin her biri için geçerli istemci durumları.
threat_info

ThreatInfo

Kontrol edilecek listeler ve karma oluşturma işlemleri.
api_client

ClientInfo

İstemcinin uygulamasının üzerine inşa edilen daha yüksek düzeyli API'lerin arayanlarıyla ilişkili istemci meta verileri.

FindFullHashesResponse

Alanlar
matches[]

ThreatMatch

İstenen ön eklerle eşleşen tam karma oluşturma işlemleri.
minimum_wait_duration

Duration

İstemcinin, karma oluşturma isteği göndermeden önce beklemesi gereken minimum süre. Bu alan ayarlanmamışsa istemciler istedikleri zaman istek gönderebilir.
negative_cache_duration

Duration

Tehdit listesiyle eşleşmeyen istenen öğeler için yanıtın ne kadar süreyle önbelleğe alınacağı.

FindThreatMatchesRequest

Girişlerin listelerle karşılaştırılmasını isteyin.

Alanlar
client

ClientInfo

Müşteri meta verileri.
threat_info

ThreatInfo

Eşleşmeler için kontrol edilecek listeler ve girişler.

FindThreatMatchesResponse

Alanlar
matches[]

ThreatMatch

Tehdit listesi eşleşiyor.

ListThreatListsResponse

Alanlar
threat_lists[]

ThreatListDescriptor

Müşteri tarafından indirilebilen listeler.

PlatformType

Platform türleri.

Sıralamalar
PLATFORM_TYPE_UNSPECIFIED Bilinmeyen platform.
WINDOWS Windows için tehdit oluşturma.
LINUX Linux için tehdit oluşturma.
ANDROID Android için tehdit oluşturma.
OSX OS X için tehdit oluşturma.
IOS iOS için tehdit oluşturma.
ANY_PLATFORM Tanımlanmış platformlardan en az biri için tehdit oluşturma.
ALL_PLATFORMS Tanımlanmış tüm platformlar için tehdit oluşturma.
CHROME Chrome'a yönelik tehdit.

RawHashes

Belirli bir ön ek uzunluğuna sahip karma biçimindeki sıkıştırılmamış tehdit girişleri. Karma oluşturma işlemleri 4 ila 32 bayt arasında olabilir. Çoğu 4 bayttır ancak popüler bir URL'nin karmasıyla çakışan bazı karmalar uzatılır.

Sıkıştırmayı desteklemeyen istemcilere ThreatEntrySet göndermek veya sıkıştırmayı destekleyen istemcilere 4 bayttan uzun karma oluşturma işlemleri göndermek için kullanılır.

Alanlar
prefix_size

int32

Aşağıda kodlanmış her ön ek için bayt sayısı. Bu alan 4 ile 32 arasında (tam SHA256 karma değeri) olabilir.
raw_hashes

bytes

İkili biçimdeki karma oluşturma işlemleri tek bir uzun dize halinde birleştirilir. Karma oluşturma işlemleri, sözlük sırasına göre sıralanır. JSON API kullanıcıları için karma oluşturma işlemleri base64 kodludur.

RawIndices

Yerel listeden kaldırılacak ham dizin grubu.

Alanlar
indices[]

int32

Alfabetik olarak sıralanmış yerel listeden kaldırılacak dizinler.

RiceDeltaEncoding

Rice-Golomb kodlu veriler. Sıkıştırılmış 4 baytlık karma oluşturma işlemleri veya sıkıştırılmış kaldırma dizinleri göndermek için kullanılır.

Alanlar
first_value

int64

Kodlanmış verilerdeki ilk girişin ofseti veya yalnızca tek bir tam sayı kodlandıysa bu tek tam sayının değeri. Alan boşsa veya eksikse sıfır değerinin geçerli olduğu varsayılır.
rice_parameter

int32

2 ile 28 arasında bir sayı olan Golomb-Rice parametresi. num_entries sıfır ise bu alan eksiktir (yani sıfırdır).
num_entries

int32

Kodlanmış verilerde delta kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlandıysa bu değer sıfır olur ve tek değer first_value içinde saklanır.
encoded_data

bytes

Golomb-Rice kodlayıcısı kullanılarak kodlanan kodlanmış deltalar.

ThreatEntry

Bireysel tehdit (ör. kötü amaçlı bir URL veya karma oluşturma işlemiyle oluşturulmuş temsili). Bu alanlardan yalnızca biri ayarlanmalıdır.

Alanlar
hash

bytes

SHA256 karma değerinin en önemli 4-32 baytından oluşan bir karma ön eki. Bu alan ikili biçimdedir. JSON isteklerinde karma oluşturma işlemleri base64 kodlu olur.
url

string

URL.
digest

bytes

SHA256 biçiminde bir yürütülebilir dosyanın özeti. API hem ikili hem de onaltılık özetleri destekler. JSON isteklerinde özetler base64 kodludur.

ThreatEntryMetadata

Belirli bir tehdit girişiyle ilişkili meta veriler. İstemcinin her tehdit türüyle ilişkili meta veri anahtar/değer çiftlerini bilmesi beklenir.

Alanlar
entries[]

MetadataEntry

Meta veri girişleri.

MetadataEntry

Tek bir meta veri girişi.

Alanlar
key

bytes

Meta veri giriş anahtarı. JSON isteklerinde anahtar base64 kodludur.
value

bytes

Meta veri giriş değeri. JSON isteklerinde değer base64 kodludur.

ThreatEntrySet

Bir istemcinin yerel veritabanına eklenmesi veya veritabanından kaldırılması gereken bir tehdit grubu.

Alanlar
compression_type

CompressionType

Bu gruptaki girişlerin sıkıştırma türü.
raw_hashes

RawHashes

Ham SHA256 biçimli girişler.
raw_indices

RawIndices

Yerel bir liste için ham kaldırma dizini.
rice_hashes

RiceDeltaEncoding

Golomb-Rice kodlaması kullanılarak SHA256 biçimli girişlerin kodlanmış 4 baytlık ön ekleri. Karma oluşturma işlemleri uint32'ye dönüştürülür, artan düzende sıralanır, ardından delta kodlanır ve encoded_data olarak depolanır.
rice_indices

RiceDeltaEncoding

Golomb-Rice kodlaması kullanılarak kodlanmış yerel, alfabetik olarak sıralanmış liste dizini. Sıkıştırılmış kaldırma dizinlerini göndermek için kullanılır. Kaldırma dizinleri (uint32), artan düzende sıralanır, ardından delta kodlanır ve encoded_data olarak depolanır.

ThreatEntryType

Tehdit oluşturan giriş türleri. Tehdit listeleri, tek bir türden girişlerden oluşan koleksiyonlardır.

Sıralamalar
THREAT_ENTRY_TYPE_UNSPECIFIED Belirtilmedi.
URL URL.
EXECUTABLE Yürütülebilir program.

ThreatInfo

Bir istemcinin, tehdit listelerinde eşleşme olup olmadığını kontrol ederken gönderdiği bir veya daha fazla tehditle ilgili bilgiler.

Alanlar
threat_types[]

ThreatType

Kontrol edilecek tehdit türleri.
platform_types[]

PlatformType

Kontrol edilecek platform türleri.
threat_entry_types[]

ThreatEntryType

Kontrol edilecek giriş türleri.
threat_entries[]

ThreatEntry

Kontrol edilecek tehdit girişleri.

ThreatListDescriptor

Bireysel bir tehdit listesini açıklar. Listeler üç parametreyle tanımlanır: Tehdit türü, tehdit tarafından hedeflenen platform türü ve listedeki girişlerin türü.

Alanlar
threat_type

ThreatType

Listenin girişlerinin oluşturduğu tehdit türü.
platform_type

PlatformType

Listenin girişleri tarafından hedeflenen platform türü.
threat_entry_type

ThreatEntryType

Listede yer alan giriş türleri.

ThreatMatch

Güvenli Tarama tehdit listelerindeki bir tehdit girişi kontrol edilirken eşleşme.

Alanlar
threat_type

ThreatType

Bu tehditle eşleşen tehdit türü.
platform_type

PlatformType

Bu tehditle eşleşen platform türü.
threat_entry_type

ThreatEntryType

Bu tehditle eşleşen tehdit girişi türü.
threat

ThreatEntry

Bu tehditle eşleşen tehdit.
threat_entry_metadata

ThreatEntryMetadata

Bu tehditle ilişkili isteğe bağlı meta veriler.
cache_duration

Duration

Döndürülen eşleşmenin önbelleği ömrü. İstemciler, yanlış pozitifleri önlemek için bu yanıtı bu süreden daha uzun süre önbelleğe almamalıdır.

ThreatType

Tehdit türleri.

Sıralamalar
THREAT_TYPE_UNSPECIFIED Bilinmiyor.
MALWARE Kötü amaçlı yazılım tehdidi türü.
SOCIAL_ENGINEERING Sosyal mühendislik tehdit türü.
UNWANTED_SOFTWARE İstenmeyen yazılım tehdidi türü.
POTENTIALLY_HARMFUL_APPLICATION Potansiyel zararlı uygulama tehdit türü.