Package google.security.safebrowsing.v5alpha1

Dizin

SafeBrowsing

Güvenli Tarama API'ları, istemcilerin web kaynaklarını (en yaygın olarak kullanılan URL'ler) Google'ın sürekli güncellenen güvenli olmayan web kaynakları listeleriyle karşılaştırarak kontrol etmesini sağlar.

BatchGetHashLists

rpc BatchGetHashLists(BatchGetHashListsRequest) returns (BatchGetHashListsResponse)

Aynı anda birden fazla karma listesi alabilirsiniz.

Bir istemcinin birden çok karma listesi alması çok yaygın görülen bir durumdur. Normal Get yöntemini birden çok kez kullanmak yerine bu yöntemin kullanılması tercih edilir.

Bu, https://google.aip.dev/231 tarafından tanımlandığı şekliyle standart bir toplu Get yöntemidir ve HTTP yöntemi de GET'dir.

GetHashList

rpc GetHashList(GetHashListRequest) returns (HashList)

Karma listesinin en son içeriklerini alma. Karma liste, bir tehdit listesine veya Genel Önbellek gibi tehdit olmayan bir listeye göre olabilir.

Bu, https://google.aip.dev/131 tarafından tanımlandığı şekliyle standart bir Get yöntemidir ve HTTP yöntemi de GET'dir.

ListHashLists

rpc ListHashLists(ListHashListsRequest) returns (ListHashListsResponse)

Karma listelerini listeleme.

Google, V5 API'de bu yöntem tarafından döndürülen bir karma listesini hiçbir zaman kaldırmaz. Bu, istemcilerin bu yöntemi kullanmayı atlayabilmesini ve ihtiyaç duydukları tüm karma listelerini sabit bir şekilde kodlayabilmesini sağlar.

Bu, https://google.aip.dev/132 tarafından tanımlandığı şekliyle standart bir List yöntemidir ve HTTP yöntemi GET'dir.

SearchHashes

rpc SearchHashes(SearchHashesRequest) returns (SearchHashesResponse)

Belirtilen öneklerle eşleşen tam karmaları arayın.

Bu, https://google.aip.dev/136 tarafından tanımlandığı gibi özel bir yöntemdir (özel yöntem, bu yöntemin Google'ın genel API geliştirme terminolojisinde özel bir ada sahip olduğunu belirtir; özel bir HTTP yönteminin kullanılmasını belirtmez).

BatchGetHashListsRequest

Aynı anda birden fazla karma listesi alma isteği.

Alanlar
names[]

string

Zorunlu. Belirli karma listelerinin adları. Liste, bir tehdit listesi OLABİLİR veya Genel Önbellek olabilir. Adların yinelenen öğeler İÇERMEMESİ ZORUNLUDUR; yinelenen adlar içeriyorsa istemci hata alır.

version[]

bytes

İstemcinin zaten sahip olduğu karma liste sürümleri. İstemci karma listelerini ilk kez alıyorsa bu alan boş bırakılmalıdır. Aksi takdirde, istemcinin daha önce sunucudan aldığı sürümleri sağlaması gerekir. İstemci bu baytları DEĞİŞTİRMEMELİDİR.

İstemcinin sürümleri ilgili liste adlarıyla aynı sırada göndermesine gerek yoktur. İstemci, bir istekte, mevcut sürümden daha az veya daha fazla sürüm gönderebilir. Ancak, istemci aynı ada karşılık gelen birden çok sürüm GÖNDERMEMELİDİR. Gönderdiyse, istemci bir hata alır.

Geçmişe ilişkin not: API'nin V4'te adı states, daha net olması için şimdi version olarak yeniden adlandırıldı.

desired_hash_length

HashLength

Döndürülen karmaların bayt cinsinden istenen karma ön eki uzunluğu. Ardından sunucu, belirtilen bu uzunluktaki tüm karma önekleri döndürür.

Farklı karma listelerin, desired_hash_length alanının kabul edilebilir değerleriyle ilgili farklı gereksinimleri vardır. Bu değeri HashListMetadata ürünündeki supported_hash_lengths alanında bulabilirsiniz. desired_hash_length, supported_hash_lengths içinde bir değer belirtmezse istemcilere hata döndürülür.

Özellikle BatchGetHashListsRequest ile ilgili olarak, istemcilerin farklı listeler için farklı bir desired_hash_length belirtmesi mümkün değildir. Böyle bir ihtiyaç varsa istemci birden fazla BatchGetHashListsRequest birimine ayrılmalıdır.

size_constraints

SizeConstraints

Her bir listedeki boyut sınırlamaları. Atlanırsa herhangi bir sınırlama olmaz. Buradaki boyutların liste başına olduğunu, tüm listeler genelinde toplanmadığını unutmayın.

BatchGetHashListsResponse

Yanıt birden fazla karma liste içeriyor.

Alanlar
hash_lists[]

HashList

Karma, istekte belirtilen sırada listelenir.

FullHash

Bir veya daha fazla eşleşmeyle tanımlanan tam karma.

Alanlar
full_hash

bytes

Eşleşen tam karma. Bu, SHA256 karmasıdır. Uzunluk tam olarak 32 bayt olur.

full_hash_details[]

FullHashDetail

Sırasız liste. Bu tam karma ile ilgili ayrıntıları tanımlayan tekrarlanan bir alan.

FullHashDetail

Eşleşen tam karma ile ilgili ayrıntılar.

İleriye dönük uyumluluk hakkında önemli bir not: Sunucu herhangi bir zamanda yeni tehdit türleri ve tehdit özellikleri ekleyebilir. Bu eklemeler, küçük sürüm değişiklikleri olarak kabul edilir. Google, politikası uyarınca API'lerde alt sürüm numaralarını göstermemelidir (Sürüm oluşturma politikası için https://cloud.google.com/apis/design/versioning adresine bakın). Bu nedenle istemcilerin, istemci tarafından geçersiz olduğu düşünülen ThreatType sıralama değerleri veya ThreatAttribute numaralandırma değerleri içeren FullHashDetail iletilerini almaya hazır olması gerekir. Bu nedenle, tüm ThreatType ve ThreatAttribute enum değerlerinin geçerliliğini kontrol etmek müşterinin sorumluluğundadır. Herhangi bir değer geçersiz sayılırsa istemci FullHashDetail iletisinin tamamını dikkate almamalıdır.

Alanlar
threat_type

ThreatType

Tehditin türü. Bu alan hiçbir zaman boş bırakılamaz.

attributes[]

ThreatAttribute

Sırasız liste. Bu tam karmalarla ilgili ek özellikler. Bu alan boş olabilir.

GetHashListRequest

Tehdit listesi veya Genel Önbellek gibi tehdit olmayan bir liste olabilen karma listesi alma isteği.

V5'teki yenilikler: Daha önce V4'te states olarak adlandırılan özellik, daha net bir şekilde version olarak yeniden adlandırıldı. Listeler artık adlandırılmıştır, platform türleri ve tehdit giriş türleri kaldırılmıştır. Artık birden fazla listenin aynı tehdit türüne sahip olması veya birden fazla tehdit türüyle ilgili tek bir listenin olması mümkün. İstemciler, artık istedikleri karma uzunluğunu belirtebilecek. Bu, birçok istemci uygulamasında soruna neden olan V4 değişken uzunlukta karma öneklerine verilen yanıtın bir parçasıdır: Bir listedeki tüm karmalar artık tek bir uzunluğa sahiptir ve bu da çok daha verimli istemci uygulamalarına olanak tanımaktadır. Sınırlamalar basitleştirildi ve sıkıştırma türü kaldırıldı (sıkıştırma her zaman uygulanır).

Alanlar
name

string

Zorunlu. Bu karma listesinin adı. Bu bir tehdit listesi veya Genel Önbellek olabilir.

version

bytes

İstemcinin zaten sahip olduğu karma liste sürümü. İstemci karma listesini ilk kez alıyorsa bu alan boş bırakılmalıdır. Aksi takdirde, istemcinin sunucudan daha önce aldığı sürümü sağlaması GEREKİR. İstemci bu baytları DEĞİŞTİRMEMELİDİR.

V5'teki yenilikler: Bu API'nin V4'ünde states olarak adlandırılmıştı; daha açık olması için şimdi version olarak yeniden adlandırıldı.

desired_hash_length

HashLength

Döndürülen karmaların bayt cinsinden istenen karma ön eki uzunluğu. Ardından sunucu, belirtilen bu uzunluktaki tüm karma önekleri döndürür.

Farklı karma listelerin, desired_hash_length alanının kabul edilebilir değerleriyle ilgili farklı gereksinimleri vardır. Bu değeri HashListMetadata ürünündeki supported_hash_lengths alanında bulabilirsiniz. desired_hash_length, supported_hash_lengths içinde bir değer belirtmezse hata döndürülür.

size_constraints

SizeConstraints

Listedeki boyut sınırlamaları. Atlanırsa herhangi bir sınırlama olmaz. Kısıtlamalar, işlem gücü, bant genişliği veya depolama alanı sınırlı olan tüm cihazlarda önerilir.

HashList

Adıyla tanımlanan karmaların listesi.

Alanlar
name

string

Karma listesinin adı. Genel Önbelleğin aynı zamanda yalnızca bir karma listesi olduğunu ve burada belirtilebileceğini unutmayın.

version

bytes

Karma listesinin sürümü. İstemci bu baytları DEĞİŞTİRMEMELİDİR.

partial_update

bool

Doğru olduğunda bu, müşterinin hâlihazırda sahip olduklarına dayalı olarak ekleme ve kaldırma işlemleri içeren kısmi bir farktır. Yanlış değerine ayarlandığında bu, tam karma listesidir.

False (yanlış) değerine ayarlanırsa istemcinin, bu karma listesi için yerel olarak depolanan sürümleri silmesi ZORUNLUDUR. Bu, istemcinin sahip olduğu sürümün ciddi derecede eski olduğu veya istemci verilerinin bozuk olduğuna inanıldığı anlamına gelir. compressed_removals alanı boş olacaktır.

Doğru olduğunda, müşterinin kaldırma ve ardından ekleme işlemlerini uygulayarak artımlı güncelleme uygulaması GEREKİR.

compressed_removals

RiceDeltaEncoded32Bit

Kaldırma dizinlerinin Rice-delta olarak kodlanmış sürümü. Her karma listede kesinlikle 2^32'den az giriş bulunduğundan, dizinler 32 bitlik tam sayılar olarak ele alınır ve kodlanır.

minimum_wait_duration

Duration

İstemciler, karma listesini tekrar almak için en az bu kadar süre beklemelidir. Atlanırsa veya sıfırlanırsa istemcilerin hemen getirmesi GEREKİR. Çünkü bu durum, sunucunun istemciye gönderilecek ek bir güncellemesinin olduğunu, ancak istemcinin belirttiği kısıtlamalar nedeniyle yapamadığını belirtir.

metadata

HashListMetadata

Karma listesiyle ilgili meta veriler. Bu alan, GetHashList yöntemi tarafından doldurulmaz, ancak ListHashLists yöntemi tarafından doldurulur.

Birleştirme alanı compressed_additions. Eklemelerin Rice-delta olarak kodlanmış sürümü. Eklemelerin karma ön ek uzunlukları, listedeki tüm eklemeler genelinde eşittir. Bu değer, istemci tarafından gönderilen desired_hash_length veya istemci tarafından atlanmışsa sunucu tarafından seçilen bir değerdir. compressed_additions şunlardan yalnızca biri olabilir:
additions_four_bytes

RiceDeltaEncoded32Bit

4 baytlık eklemeler.

additions_eight_bytes

RiceDeltaEncoded64Bit

8 baytlık eklemeler.

additions_sixteen_bytes

RiceDeltaEncoded128Bit

16 baytlık eklemeler.

additions_thirty_two_bytes

RiceDeltaEncoded256Bit

32 baytlık eklemeler.

Birleştirme alanı checksum. Bu, sağlanan güncelleme uygulandıktan sonra veritabanında bulunan tüm karmaların sıralı listesinin sağlamasıdır. Bu, birden fazla karma oluşturma algoritmasına izin veren "oneof" alanıdır. Ayrıca sunucunun, istemcinin mevcut sağlama toplamını kullanması gerektiğini belirtmek için (güncelleme sağlanmamışsa) bu alanı çıkarması da mümkündür. checksum şunlardan yalnızca biri olabilir:
sha256_checksum

bytes

SHA256 ile tekrar karma oluşturma işlemi uygulanmış tüm karmaların sıralanmış listesi.

HashListMetadata

Belirli bir karma listesiyle ilgili meta veriler.

Alanlar
threat_types[]

ThreatType

Sırasız liste. Boş değilse bu, karma listesinin bir tür tehdit listesi olduğunu belirtir ve bu karma listesindeki karmalar veya karma öneklerle ilişkili tehditlerin türünü sıralar. Giriş bir tehdidi temsil etmiyorsa (yani güvenli olabilecek bir türü temsil ediyorsa) boş olabilir.

likely_safe_types[]

LikelySafeType

Sırasız liste. Boş değilse karma listesi, olası güvenli karmaların listesini temsil eder ve bu liste, karmaların güvenli kabul edilmesi gereken yolları sıralar. Bu alan, Threat_types alanı ile karşılıklı olarak kullanılamaz.

mobile_optimized

bool

Bu listenin mobil cihazlar (Android ve iOS) için optimize edilip edilmediği.

description

string

Bu liste hakkında kullanıcıların okuyabileceği bir açıklama. İngilizce yazılmıştır.

supported_hash_lengths[]

HashLength

Bu karma listesi için desteklenen karma uzunlukları. Her karma listesi en az bir uzunluğu destekler. Dolayısıyla bu alan boş olmayacaktır.

HashLength

Bir karma listesindeki karmaların uzunluğu.

Sıralamalar
HASH_LENGTH_UNSPECIFIED Uzunluk belirtilmedi. Sunucu istemciye yanıtlarında bu değeri döndürmez (supported_hash_lengths alanında) ancak istemcinin bu değeri sunucuya göndermesine izin verilir (desired_hash_length alanında). Böyle bir durumda sunucu otomatik olarak bir değer seçer. İstemciler sunucunun bir değer seçmesine izin vermelidir.
FOUR_BYTES Her bir karma, dört baytlık bir önektir.
EIGHT_BYTES Her bir karma, sekiz baytlık bir önektir.
SIXTEEN_BYTES Her bir karma değeri, on altı baytlık bir ön ektir.
THIRTY_TWO_BYTES Her bir karma değeri, otuz iki baytlık tam karmadır.

LikelySafeType

Güvenli olma olasılığı yüksek site türleri.

SearchHashesResponse öğesinin kasıtlı olarak LikelySafeType içermediğini unutmayın.

Sıralamalar
LIKELY_SAFE_TYPE_UNSPECIFIED Bilinmiyor.
GENERAL_BROWSING Bu site büyük olasılıkla genel göz atma için yeterince güvenli. Bu önbellek, genel önbellek olarak da bilinir.
CSD Bu site, İstemci Tarafı Algılama modellerini veya şifre koruma kontrollerini çalıştırmaya gerek kalmayacak kadar güvenli olabilir.
DOWNLOAD Bu site, siteden yapılan indirmelerin kontrol edilmesine gerek olmayacak kadar güvenlidir.

ListHashListsRequest

Kullanılabilir karma listelerini listeleme isteği.

Alanlar
page_size

int32

Döndürülecek maksimum karma listesi sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemişse sunucu bir sayfa boyutu seçer. Bu boyut, karma listelerin sayısından daha büyük olabilir ve böylece sayfalara ayırma işlemi gerekmez.

page_token

string

Önceki ListHashLists çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bu kodu sağlayın.

ListHashListsResponse

Karma listeleriyle ilgili meta verileri içeren yanıt.

Alanlar
hash_lists[]

HashList

Karma rastgele bir sırada listelenir. İçeriklerle değil, yalnızca karma listeleriyle ilgili meta veriler dahil edilir.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

RiceDeltaKodlu128Bit

RiceDeltaEncoded32Bit ile aynıdır ancak 128 bitlik sayıları kodlar.

Alanlar
first_value_hi

uint64

Kodlanmış verilerdeki (karma) ilk girişin üst 64 biti. Alan boşsa üst 64 bitin tamamı sıfırdır.

first_value_lo

fixed64

Kodlanmış verilerdeki (karma) ilk girişin düşük olan 64 biti. Alan boşsa alttaki 64 bitin tamamı sıfırdır.

rice_parameter

int32

Golomb-Rice parametresi. Bu parametrenin 99 ile 126 arasında (99 ve 126 dahil) olması garanti edilir.

entries_count

int32

Kodlanmış verilerde delta olarak kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlanmışsa bu değer sıfır olur ve tek değer first_value özelliğinde depolanır.

encoded_data

bytes

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

RiceDeltaKodlu 256Bit

RiceDeltaEncoded32Bit ile aynıdır ancak 256 bitlik sayıları kodlar.

Alanlar
first_value_first_part

uint64

Kodlanmış verilerdeki (karma) ilk girişin ilk 64 biti. Alan boşsa ilk 64 bitin tamamı sıfırdır.

first_value_second_part

fixed64

Kodlanmış verilerdeki (karmalar) ilk girişin 65 ila 128. bitleri. Alan boşsa 65 ila 128. bitlerin tamamı sıfırdır.

first_value_third_part

fixed64

Kodlanmış verilerdeki (karmalar) ilk girişin 129 ile 192. bitleri. Alan boşsa 129 ile 192. bitlerin tümü sıfır olur.

first_value_fourth_part

fixed64

Kodlanmış verilerdeki (karma) ilk girişin son 64 biti. Alan boşsa son 64 bitin tamamı sıfırdır.

rice_parameter

int32

Golomb-Rice parametresi. Bu parametrenin 227 ile 254 arasında (227 ile 254 dahil) olması garanti edilir.

entries_count

int32

Kodlanmış verilerde delta olarak kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlanmışsa bu değer sıfır olur ve tek değer first_value özelliğinde depolanır.

encoded_data

bytes

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

RiceDeltaKodlu 32Bit

Rice-Golomb kodlamalı veriler. Karma oluşturma işlemleri veya kaldırma dizinleri için kullanılır. Buradaki her karma veya dizin aynı uzunluğa sahip olur ve bu uzunluğun da tam olarak 32 bit olduğu garanti edilir.

Genel olarak, tüm girişleri sözlüksel olarak sıraladığımızda, yüksek düzeydeki bitlerin genellikle alt sıradaki bitler kadar sık değişmediğini görürüz. Bu, girişler arasındaki bitişik farkı da alırsak, yüksek düzeydeki bitlerin sıfır olma olasılığının yüksek olacağı anlamına gelir. Bu yöntem, temelde belirli bir bit sayısı seçerek bu yüksek sıfır olasılığından yararlanır; bundan daha önemli olan tüm bitler sıfır olacağından birli kodlama kullanırız. rice_parameter alanına bakın.

Geçmişe yönelik not: Rice-delta kodlaması ilk olarak bu API'nin V4'te kullanılmıştır. V5'te iki önemli iyileştirme yapılmıştır: İlk olarak, ilk olarak, Rice-delta kodlaması artık 4 bayttan uzun karma öneklerle kullanılabilmektedir; ikinci olarak, kodlanmış veriler artık maliyetli bir sıralama adımını önlemek için büyük uçlu olarak işlenmektedir.

Alanlar
first_value

uint32

Kodlanmış verilerdeki ilk giriş (karmalar veya dizinler) veya yalnızca tek bir karma öneki ya da dizin kodlanmışsa bu girişin değeridir. Alan boşsa giriş sıfır olur.

rice_parameter

int32

Golomb-Rice parametresi. Bu parametrenin 3 ile 30 arasında (30 dahil) olması garanti edilir.

entries_count

int32

Kodlanmış verilerde delta olarak kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlanmışsa bu değer sıfır olur ve tek değer first_value özelliğinde depolanır.

encoded_data

bytes

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

RiceDeltaKodlu 64Bit

RiceDeltaEncoded32Bit ile aynıdır ancak 64 bitlik sayıları kodlar.

Alanlar
first_value

uint64

Kodlanmış verilerdeki (karmalar) ilk giriş veya yalnızca tek bir karma öneki kodlanmışsa bu girişin değeridir. Alan boşsa giriş sıfır olur.

rice_parameter

int32

Golomb-Rice parametresi. Bu parametrenin 35 ile 62 arasında (35 ve 62 dahil) olması garanti edilir.

entries_count

int32

Kodlanmış verilerde delta olarak kodlanmış girişlerin sayısı. Yalnızca tek bir tam sayı kodlanmışsa bu değer sıfır olur ve tek değer first_value özelliğinde depolanır.

encoded_data

bytes

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

SearchHashesRequest

İstemcinin belirli karma öneklerini aramak için gönderdiği istek.

Bu, yalnızca tehdit listelerinde arama yapmak için tasarlanmıştır, Genel Önbellek gibi tehdit dışı listelerde arama yapmaz.

V5'teki yenilikler: Müşterilerin bir ClientInfo veya yerel veritabanlarındaki karma listelerinin durumunu belirtmesi gerekmez. Bu, gizliliğin artırılması içindir. Ayrıca, müşterilerin ilgilendikleri tehdit türlerini göndermeleri gerekmez.

Alanlar
hash_prefixes[]

bytes

Zorunlu. Aranacak karma önekler. İstemciler 1.000'den fazla karma ön ek GÖNDERMEMELİDİR. Ancak, URL işleme prosedürüne göre, istemcilerin 30'dan fazla karma ön eki göndermesi GEREKMEZ.

Şu anda her karma ön ekin tam olarak 4 bayt uzunluğunda olması gerekmektedir. Bu durum ileride yumuşatılabilir.

filter

string

İsteğe bağlı. İstemci, yalnızca belirli türdeki tehditleri almak gibi filtreleme yapmakla ilgileniyorsa bu seçenek belirtilebilir. Atlanırsa eşleşen tüm tehditler döndürülür. Güvenli Tarama'nın sunabileceği en kapsamlı korumadan yararlanmak için bu değeri atlamanız önemle tavsiye edilir.

Filtre, genel örneklerle birlikte https://github.com/google/cel-spec adresinde bulunan Google Common Expression Language kullanılarak belirtilir. Aşağıda, burada kullanılabilecek bazı özel örnekler verilmiştir:

"threat_type == ThreatType.SOCIAL_ENGINEERING" filtresi, FullHashDetail içinde tehdit türünün SOCIAL_ENGINEERING olmasını gerektirir. "threat_type" tanımlayıcısı, mevcut tehdit türünü belirtir. "ThreatType" tanımlayıcısı, olası tüm tehdit türlerinin toplanmasını ifade eder.

"threat_type in [ ThreatType.UNWANTED_SOFTWARE, ThreatType.MALWARE ]" filtresi, tehdit türünün UNWANTED_SOFTWARE veya MALWARE olmasını gerektirir.

SearchHashesResponse

Tehdit karmaları arandıktan sonra döndürülen yanıt.

Hiçbir şey bulunmazsa sunucu NOT_FOUND durumu (HTTP durum kodu 404) döndürmek yerine full_hashes alanı boş olacak şekilde bir OK durumu (HTTP durum kodu 200) döndürür.

V5'teki yenilikler: FullHash ile FullHashDetail arasında bir fark vardır. Karma, birden fazla tehdidi olan bir siteyi (ör. hem MALWARE hem de SOCIAL_ENGINEERING) temsil ediyorsa karmanın tamamının, V4'tekinden iki kez gönderilmesine gerek yoktur. Ayrıca, önbellek süresi tek bir cache_duration alanı olacak şekilde basitleştirildi.

Alanlar
full_hashes[]

FullHash

Sırasız liste. Bulunan tam karmaların sıralanmamış listesi.

cache_duration

Duration

İstemci taraflı önbellek süresi. Müşterinin, son kullanma zamanını belirlemek için bu süreyi geçerli saate eklemesi ZORUNLUDUR. Sonrasında geçerlilik süresi, yanıtta döndürülen tam karmalardan bağımsız olarak, istekteki istemci tarafından sorgulanan her karma ön ek için geçerlidir. Sunucu belirli bir karma ön ek için tam karmalar döndürmese bile, bu bilginin istemci tarafından önbelleğe alınması ZORUNLUDUR.

Yalnızca full_hashes alanı boşsa istemci, sunucu tarafından belirtilenden daha sonra yeni bir son kullanma tarihi belirlemek için cache_duration değerini artırabilir. Hiçbir durumda, artırılmış önbellek süresi 24 saatten uzun olmamalıdır.

Önemli: İstemci, sunucunun tüm yanıtlar için aynı önbellek süresini döndüreceğini KABUL ETMEMELİDİR. Sunucu duruma bağlı olarak farklı yanıtlar için farklı önbellek süreleri seçebilir.

SizeConstraints

Karma listelerinin boyutlarındaki kısıtlamalar.

Alanlar
max_update_entries

int32

Giriş sayısındaki maksimum boyut. Güncellemede bu değerden daha fazla giriş bulunmasa da güncellemede bu değerden daha az giriş olması mümkündür. Bu değer en az 1.024 olmalıdır. Atlanırsa veya sıfırsa güncelleme boyutu sınırı ayarlanmaz.

max_database_entries

int32

İstemcinin liste için yerel veritabanında sahip olmak istediği maksimum giriş sayısını belirler. (Sunucu, istemcinin bu sayıdan az giriş depolamasına neden OLABİLİR.) Atlanırsa veya sıfırsa herhangi bir veritabanı boyut sınırı ayarlanmaz.

ThreatAttribute

Tehditlerin özellikleri. Bu özellikler, belirli bir tehdide ek anlam kazandırabilir ancak tehdit türünü etkilemez. Örneğin, bir özellik düşük bir güven değeri belirtirken farklı bir özellik yüksek bir güven değeri belirtebilir. Gelecekte daha fazla özellik eklenebilir.

Sıralamalar
THREAT_ATTRIBUTE_UNSPECIFIED Bilinmeyen özellik. Bu değer sunucu tarafından döndürülürse, istemci kapsayıcı FullHashDetail öğesini tamamen dikkate almaz.
CANARY Tehdit_türünün, yaptırım için kullanılmaması gerektiğini belirtir.
FRAME_ONLY Threat_type [tehdit_türü] özelliğinin yalnızca karelere yaptırım için kullanılması gerektiğini belirtir.

ThreatType

Tehdit türleri.

Sıralamalar
THREAT_TYPE_UNSPECIFIED Bilinmeyen tehdit türü. Bu değer sunucu tarafından döndürülürse, istemci kapsayıcı FullHashDetail öğesini tamamen dikkate almaz.
MALWARE

Kötü amaçlı yazılım tehdit türü. Kötü amaçlı yazılımlar bilgisayarlara, mobil cihazlara, çalıştırdıkları yazılımlara veya kullanıcılarına zarar vermek için özel olarak tasarlanmış her türlü yazılım veya mobil uygulamadır. Kötü amaçlı yazılımlar, zararlı davranışlar sergiler (örneğin, kullanıcının izni olmadan yazılım yükleme ve virüs gibi zararlı yazılımlar yükleme).

Daha fazla bilgiye buradan ulaşabilirsiniz.

SOCIAL_ENGINEERING

Sosyal mühendislik tehdit türü. Sosyal mühendislik sayfaları, görüntüleyen kişilerin yalnızca üçüncü tarafın gerçek bir aracısına güveneceği bir eylemi gerçekleştirmek üzere izleyicileri yanıltmak amacıyla yanlış bir şekilde üçüncü bir taraf adına hareket ediyormuş gibi davranır. Kimlik avı, görüntüleyen kişiyi, giriş kimlik bilgileri gibi bilgileri sağlamak üzere belirli bir işlem yapması için kandıran bir sosyal mühendislik türüdür.

Daha fazla bilgiye buradan ulaşabilirsiniz.

UNWANTED_SOFTWARE İstenmeyen yazılım tehdit türü. İstenmeyen yazılım Google Yazılım İlkeleri'ne bağlı olmayan ancak kötü amaçlı olmayan her türlü yazılımdır.
POTENTIALLY_HARMFUL_APPLICATION Play Store için Google Play Protect tarafından kullanıldığı şekliyle potansiyel zararlı uygulama tehdit türü.