Package google.security.safebrowsing.v5alpha1

Dizin

SafeBrowsing

Güvenli Tarama API'leri, istemcilerin web kaynaklarını (en yaygın olarak URL'ler) Google'ın sürekli güncellenen güvenli olmayan web kaynakları listelerine göre kontrol etmesini sağlar.

BatchGetHashLists

rpc BatchGetHashLists(BatchGetHashListsRequest) returns (BatchGetHashListsResponse)

Aynı anda birden fazla karma listesi alma

Bir müşterinin birden fazla karma listesi alması çok yaygın bir durumdur. Bu yöntemi kullanmak, normal Get yöntemini birden çok kez kullanmaktan daha iyidir.

Bu, https://google.aip.dev/231 adresinde tanımlandığı şekilde standart bir toplu GET yöntemidir ve HTTP yöntemi de GET'tir.
GetHashList

rpc GetHashList(GetHashListRequest) returns (HashList)

Karma listesinin en son içeriklerini alma. Karma listesi, tehdit listesi veya Global Cache gibi tehdit içermeyen bir liste olabilir.

Bu, https://google.aip.dev/131 tarafından tanımlanan standart bir Get yöntemidir ve HTTP yöntemi de GET'tir.
ListHashLists

rpc ListHashLists(ListHashListsRequest) returns (ListHashListsResponse)

Liste karması listeleri.

V5 API'de Google, bu yöntem tarafından döndürülmüş bir karma listesini hiçbir zaman kaldırmaz. Bu sayede istemciler bu yöntemi kullanmayı atlayabilir ve ihtiyaç duydukları tüm karma listelerini doğrudan kodlayabilir.

Bu, https://google.aip.dev/132 tarafından tanımlanan standart bir Liste yöntemidir ve HTTP yöntemi GET'tir.
SearchHashes

rpc SearchHashes(SearchHashesRequest) returns (SearchHashesResponse)

Belirtilen ön eklerle eşleşen tam karma değerleri arayın.

Bu, https://google.aip.dev/136 tarafından tanımlanan özel bir yöntemdir (özel yöntem, bu yöntemin Google'ın genel API geliştirme adlandırma sisteminde özel bir ada sahip olmasını ifade eder; özel bir HTTP yöntemi kullanılmasını ifade etmez).
SearchUrls

rpc SearchUrls(SearchUrlsRequest) returns (SearchUrlsResponse)

Bilinen tehditlerle eşleşen URL'leri arama Her URL, ana makine soneki ve yol öneki ifadeleri (sınırlı derinliğe kadar) kontrol edilir. Bu, yanıtın, istekte yer almayan ancak istenen URL'lerin ifadeleri olan URL'ler içerebileceği anlamına gelir.

BatchGetHashListsRequest

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

Alanlar
names[]

string

Zorunlu. Belirli karma listelerinin adları. Liste, tehdit listesi veya genel önbellek olabilir. Adlar yinelenen öğeler içermemelidir. Aksi takdirde istemci hata alır.
version[]

bytes

İstemcinin sahip olduğu karma listesinin sürümleri. İstemci, karma listelerini ilk kez getiriyorsa alan boş bırakılmalıdır. Aksi takdirde, istemci daha önce sunucudan alınan sürümleri sağlamalıdır. İstemci bu baytları MANİPÜLE ETMEMELİDİR.

İstemcinin, sürümleri ilgili liste adlarıyla aynı sırada göndermesi gerekmez. İstemci, bir istekte ad sayısından daha az veya daha fazla sürüm gönderebilir. Ancak istemci, aynı ada karşılık gelen birden fazla sürüm göndermemelidir. Aksi takdirde istemci hata alır.

Geçmişle ilgili not: API'nin V4 sürümünde bu states olarak adlandırılıyordu. Şimdi ise daha anlaşılır olması için version olarak yeniden adlandırıldı.
size_constraints

SizeConstraints

Her listedeki boyut kısıtlamaları. Atlanırsa kısıtlama yoktur. Buradaki boyutların tüm listeler genelinde toplanmadığını, liste başına olduğunu unutmayın.

BatchGetHashListsResponse

Birden fazla karma listesi içeren yanıt.

Alanlar
hash_lists[]

HashList

Karma listeleri, istekte verilen sırayla aynıdır.

FullHash

Tam karma, bir veya daha fazla eşleşmeyle tanımlanır.

Alanlar
full_hash

bytes

Eşleşen tam hash. Bu, SHA256 karma değeridir. 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 hakkındaki ayrıntılar.

İleriye dönük uyumlulukla ilgili önemli bir not: Sunucu tarafından yeni tehdit türleri ve tehdit özellikleri eklenebilir. Bu eklemeler, küçük sürüm değişiklikleri olarak kabul edilir. Google'ın politikası, API'lerde küçük sürüm numaralarını göstermemektir (sürüm oluşturma politikası için https://cloud.google.com/apis/design/versioning adresine bakın). Bu nedenle, istemciler ThreatType enum değerlerini veya istemci tarafından geçersiz kabul edilen ThreatAttribute enum değerlerini içeren FullHashDetail mesajlarını almaya hazır OLMALIDIR. Bu nedenle, tüm ThreatType ve ThreatAttribute enum değerlerinin geçerliliğini kontrol etmek istemcinin sorumluluğundadır. Herhangi bir değer geçersiz kabul edilirse istemci, FullHashDetail mesajının tamamını dikkate ALMAMALIDIR.

Alanlar
threat_type

ThreatType

Tehdidin türü. Bu alan hiçbir zaman boş olmaz.
attributes[]

ThreatAttribute

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

GetHashListRequest

Genel önbellek gibi bir tehdit listesi veya tehdit içermeyen liste olabilecek bir karma listesi alma isteği.

V5'teki yenilikler: V4'te states olarak adlandırılan özellik, netlik sağlamak için version olarak yeniden adlandırıldı. Listeler artık adlandırılıyor, platform türleri ve tehdit girişi türleri kaldırılıyor. Artık birden fazla listenin aynı tehdit türüne sahip olması veya tek bir listenin birden fazla tehdit türüyle ilgili olması mümkündür. V4'ün değişken uzunluklu karma ön eklerinin birçok istemci uygulamasında sorunlara yol açmasının aksine, bir listedeki tüm karmalar artık tek bir uzunluğa sahip ve bu da çok daha verimli istemci uygulamalarına olanak tanıyor. Kısıtlamalar 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 belirli karma listesinin adı. Bu, tehdit listesi veya genel önbellek olabilir.
version

bytes

İstemcinin sahip olduğu karma listesinin sürümü. İstemci, karma listesini ilk kez getiriyorsa bu alan BOŞ bırakılmalıdır. Aksi takdirde, istemci daha önce sunucudan alınan sürümü SAĞLAMALIDIR. İstemci bu baytları MANİPÜLE ETMEMELİDİR.

V5'teki yenilikler: API'nin V4 sürümünde bu işlevin adı states idi. Şimdi daha anlaşılır olması için version olarak yeniden adlandırıldı.
size_constraints

SizeConstraints

Listedeki boyut kısıtlamaları. Atlanırsa kısıtlama yoktur. İşlem gücü, bant genişliği veya depolama alanı sınırlı olan tüm cihazlarda kısıtlamalar önerilir.

HashList

Adıyla tanımlanan karma listesi.

Alanlar
name

string

Karma listesinin adı. Global önbelleğin de yalnızca bir karma listesi olduğunu ve buradan referans alınabileceğini unutmayın.
version

bytes

Karma listesinin sürümü. İstemci bu baytları MANİPÜLE ETMEMELİDİR.
partial_update

bool

Doğruysa bu, istemcide zaten bulunanlara göre eklemeler ve kaldırmalar içeren kısmi bir farklılık göstergesidir. Yanlış olduğunda bu, karma listesinin tamamıdır.

Yanlış olduğunda istemci, bu karma listesinin yerel olarak depolanan tüm sürümlerini SİLMELİDİR. Bu, istemcideki sürümün ciddi şekilde güncel olmadığı veya istemci verilerinin bozuk olduğu anlamına gelir. compressed_removals alanı boş olur.

Doğruysa istemci, önce kaldırma ve ardından ekleme işlemlerini uygulayarak artımlı bir güncelleme uygulamalıdır.
compressed_removals

RiceDeltaEncoded32Bit

Kaldırma dizinlerinin Rice-delta kodlu sürümü. Her karma liste kesinlikle 2^32'den az giriş içerdiğinden 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 süre kadar beklemelidir. Atlanırsa veya sıfırsa istemciler, sunucunun istemciye gönderilecek ek bir güncellemesi olduğunu ancak istemci tarafından belirtilen kısıtlamalar nedeniyle gönderilemediğini gösterdiğinden hemen getirme İŞLEMİNİ YAPMALIDIR.
sha256_checksum

bytes

Tüm karmaların sıralanmış listesi, SHA256 ile tekrar karma oluşturma işlemi uygulanmış. Bu, sağlanan güncelleme uygulandıktan sonra veritabanında bulunan tüm karma değerlerin sıralanmış listesinin sağlama toplamıdır. Güncelleme sağlanmadığı durumlarda sunucu, istemcinin mevcut sağlama toplamını kullanması gerektiğini belirtmek için bu alanı atlar.
metadata

HashListMetadata

Karma listesiyle ilgili meta veriler. Bu alan GetHashList yöntemiyle değil, ListHashLists yöntemiyle doldurulur.
compressed_additions birleşik alanı. Eklemelerin Rice-delta kodlu sürümü. Eklenenlerin karma önek uzunlukları, listedeki tüm eklenenler için aynıdır. compressed_additions aşağıdakilerden 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.

HashListMetadata

Belirli bir karma listesiyle ilgili meta veriler.

Alanlar
threat_types[]

ThreatType

Sırasız liste. Boş değilse karma listesinin bir tür tehdit listesi olduğunu belirtir ve bu karma listesindeki karmalarla veya karma önekleriyle ilişkili tehdit türlerini numaralandırır. Giriş bir tehdit oluşturmuyorsa (ör. güvenli bir türü temsil ediyorsa) boş olabilir.
likely_safe_types[]

LikelySafeType

Sırasız liste. Boş değilse bu, karma listesinin büyük olasılıkla güvenli karmaların listesini temsil ettiğini belirtir ve bunların büyük olasılıkla güvenli kabul edilme yöntemlerini numaralandırır. Bu alan, threat_types alanı ile aynı anda olamaz.
description

string

Bu liste hakkında, kullanıcılar tarafından okunabilir bir açıklama. İngilizce yazılmış olmalıdır.
hash_length

HashLength

Bu karma listesi için desteklenen karma uzunluğu. Her karma listesi yalnızca bir uzunluğu destekler. Aynı tehdit türleri veya güvenli türler grubu için farklı bir karma uzunluğu kullanıma sunulursa bu, ayrı bir liste olarak farklı bir ad ve ilgili karma uzunluğu grubuyla birlikte kullanıma sunulur.

HashLength

Karma listesindeki karmaların uzunluğu.

Sıralamalar
HASH_LENGTH_UNSPECIFIED Belirtilmemiş uzunluk.
FOUR_BYTES Her karma, dört baytlık bir önekten oluşur.
EIGHT_BYTES Her karma, sekiz baytlık bir önektir.
SIXTEEN_BYTES Her karma, on altı baytlık bir önektir.
THIRTY_TWO_BYTES Her karma, otuz iki baytlık tam bir karmadır.

LikelySafeType

Güvenli olabilecek 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, genel göz atma için yeterince güvenli olabilir. Bu, genel önbellek olarak da bilinir.
CSD Bu site, istemci 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 kalmayacak kadar güvenli olabilir.

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. Belirtilmezse sunucu, karma listelerinin sayısından daha büyük olabilecek bir sayfa boyutu seçer. Böylece, sayfalara ayırma işlemi gerekmez.
page_token

string

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

ListHashListsResponse

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

Alanlar
hash_lists[]

HashList

Karma listeleri rastgele bir sırada yer alır. İçerikler değil, yalnızca karma listeleriyle ilgili meta veriler dahil edilir.
next_page_token

string

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

RiceDeltaEncoded128Bit

128 bit sayıları kodlaması dışında RiceDeltaEncoded32Bit ile aynıdır.

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 alt 64 biti. Alan boşsa düşük 64 bitin tamamı sıfırdır.
rice_parameter

int32

Golomb-Rice parametresi. Bu parametrenin 99 ile 126 arasında (99 ve 126 dahil) olduğu garanti edilir.
entries_count

int32

Şifrelenmiş verilerde delta kodlaması yapılan 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ı kullanılarak kodlanan kodlanmış delta değerleri.

RiceDeltaEncoded256Bit

256 bitlik sayıları kodlaması dışında RiceDeltaEncoded32Bit ile aynıdır.

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 (karma) ilk girişin 65. ila 128. bitleri. Alan boşsa 65. ile 128. bitler arasındaki tüm bitler sıfırdır.
first_value_third_part

fixed64

Kodlanmış verilerdeki (karma) ilk girişin 129. ila 192. bitleri. Alan boşsa 129. ile 192. bitler sıfırdır.
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 (değerler dahil) olduğu garanti edilir.
entries_count

int32

Şifrelenmiş verilerde delta kodlaması yapılan 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ı kullanılarak kodlanan kodlanmış delta değerleri.

RiceDeltaEncoded32Bit

Rice-Golomb kodlu veriler. Karma değerler veya kaldırma dizinleri için kullanılır. Buradaki her karma veya dizinin aynı uzunlukta olduğu ve bu uzunluğun tam olarak 32 bit olduğu garanti edilir.

Genel olarak, tüm girişleri sözlük sırasına göre sıralarsak yüksek sıralı bitlerin, düşük sıralı bitler kadar sık değişmediğini görürüz. Bu, girişler arasındaki bitişik farkı da hesaba katarsak yüksek sıralı bitlerin sıfır olma olasılığının yüksek olduğu anlamına gelir. Bu, belirli sayıda bit seçerek sıfır olma olasılığının yüksek olmasından yararlanır. Bundan daha anlamlı olan tüm bitlerin sıfır olması muhtemel olduğundan tekli kodlama kullanırız. rice_parameter alanına bakın.

Geçmişle ilgili not: Rice-delta kodlaması ilk olarak bu API'nin V4 sürümünde kullanılmıştır. V5'te iki önemli iyileştirme yapıldı: Birincisi, Rice-delta kodlaması artık 4 bayttan uzun karma ön ekleriyle kullanılabiliyor. İkincisi, kodlanmış veriler artık büyük endian olarak kabul ediliyor. Böylece maliyetli bir sıralama adımından kaçınılıyor.

Alanlar
first_value

uint32

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

int32

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

int32

Şifrelenmiş verilerde delta kodlaması yapılan 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ı kullanılarak kodlanan kodlanmış delta değerleri.

RiceDeltaEncoded64Bit

64 bitlik sayıları kodlaması dışında RiceDeltaEncoded32Bit ile aynıdır.

Alanlar
first_value

uint64

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

int32

Golomb-Rice parametresi. Bu parametrenin 35 ile 62 arasında (bu değerler dahil) olması garanti edilir.
entries_count

int32

Şifrelenmiş verilerde delta kodlaması yapılan 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ı kullanılarak kodlanan kodlanmış delta değerleri.

SearchHashesRequest

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

Bu özellik yalnızca tehdit listelerini aramak üzere tasarlanmıştır ve Global Önbellek gibi tehdit içermeyen listeleri aramaz.

V5'teki yenilikler: İstemcilerin, yerel veritabanlarındaki ClientInfo veya karma listelerin durumlarını belirtmesi gerekmez. Bu, gizliliği artırmak için kullanılır. Ayrıca, istemcilerin hangi tehdit türleriyle ilgilendiklerini göndermeleri gerekmez.

Alanlar
hash_prefixes[]

bytes

Zorunlu. Aranacak karma ön ekleri. Müşteriler 1.000'den fazla karma öneki göndermemelidir. Ancak URL işleme prosedüründen sonra istemcilerin 30'dan fazla karma öneki göndermesi GEREKMEZ.

Şu anda her karma önekinin tam olarak 4 bayt uzunluğunda olması gerekmektedir. Bu kısıtlama gelecekte gevşetilebilir.
filter

string

İsteğe bağlıdır. İstemci, yalnızca belirli tehdit türlerini almak gibi filtreleme yapmak istiyorsa bu belirtilebilir. Atlanırsa eşleşen tüm tehditler döndürülür. Güvenli Tarama'nın sunabileceği en eksiksiz korumayı elde etmek için bu ayarın atlanması önemle tavsiye edilir.

Filtre, Google Common Expression Language kullanılarak belirtilir. Bu dil, genel örneklerle birlikte https://github.com/google/cel-spec adresinde bulunabilir. Burada kullanılabilecek bazı özel örnekler:

"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ü ifade eder. Tanımlayıcı "ThreatType", olası tüm tehdit türlerinin koleksiyonunu 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 bulunamazsa sunucu, NOT_FOUND durumu (HTTP durum kodu 404) döndürmek yerine full_hashes alanı boş olarak OK durumu (HTTP durum kodu 200) döndürür.

V5 sürümündeki yenilikler: FullHash ile FullHashDetail arasında ayrım yapılıyor. Bir karma, birden fazla tehdit içeren bir siteyi (ör. hem KÖTÜ AMAÇLI YAZILIM hem de SOSYAL MÜHENDİSLİK) temsil ediyorsa V4'te olduğu gibi tam karma iki kez gönderilmez. Ayrıca, önbellek süresi tek bir cache_duration alanıyla basitleştirildi.

Alanlar
full_hashes[]

FullHash

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

Duration

İstemci tarafı önbelleğinin süresi. İstemci, geçerlilik bitiş zamanını belirlemek için bu süreyi geçerli zamana EKLEMELİDİR. Geçerlilik süresi, yanıtta kaç tam karma döndürüldüğüne bakılmaksızın, istemci tarafından istekte sorgulanan her karma öneki için geçerli olur. Sunucu, belirli bir karma öneki için tam karma döndürmese bile bu durum istemci tarafından da önbelleğe alınmalıdır.

Yalnızca full_hashes alanı boşsa istemci, sunucu tarafından belirtilenden daha geç bir yeni son kullanma tarihi belirlemek için cache_duration değerini artırabilir. Her durumda, artırılan ö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 VARSAYMAMALIDIR. Sunucu, duruma bağlı olarak farklı yanıtlar için farklı önbellek süreleri seçebilir.

SearchUrlsRequest

İstemcinin, belirtilen URL'lerle eşleşen tehditleri aramak için gönderdiği istek.

Bu özellik yalnızca tehdit listelerini aramak üzere tasarlanmıştır ve Global Önbellek gibi tehdit içermeyen listeleri aramaz.

Alanlar
urls[]

string

Zorunlu. Aranacak URL'ler. Müşteriler 50'den fazla URL göndermemelidir.

SearchUrlsResponse

Belirtilen URL'lerle eşleşen tehditler arandıktan sonra döndürülen yanıt.

Hiçbir şey bulunamazsa sunucu, NOT_FOUND durumu (HTTP durum kodu 404) döndürmek yerine threats alanı boş olarak OK durumu (HTTP durum kodu 200) döndürür.

Alanlar
threats[]

ThreatUrl

Sırasız liste. Bulunan tehdit eşleşmelerinin sırasız listesi. Her giriş bir URL ve bu URL ile eşleşen tehdit türlerini içerir. URL'nin tüm ifadeleri dikkate alındığından liste boyutu, istekteki URL sayısından büyük olabilir.
cache_duration

Duration

İstemci tarafı önbelleğinin süresi. İstemci, geçerlilik bitiş zamanını belirlemek için bu süreyi geçerli zamana EKLEMELİDİR. Son kullanma süresi, yanıtta kaç URL döndürüldüğünden bağımsız olarak, istemci tarafından istekte sorgulanan her URL için geçerli olur. Sunucu, belirli bir URL için eşleşme döndürmese bile bu durum istemci tarafından önbelleğe alınmalıdır.

Yalnızca threats alanı boşsa istemci, sunucu tarafından belirtilenden daha geç bir yeni son kullanma tarihi belirlemek için cache_duration değerini artırabilir. Her durumda, artırılan ö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 VARSAYMAMALIDIR. Sunucu, duruma bağlı olarak farklı yanıtlar için farklı önbellek süreleri seçebilir.

SizeConstraints

Karma listelerinin boyutlarıyla ilgili kısıtlamalar.

Alanlar
max_update_entries

int32

Giriş sayısı olarak maksimum boyut. Güncelleme bu değerden daha fazla giriş içermez ancak bu değerden daha az giriş içerebilir. Bu değer EN AZ 1024 olmalıdır. Atlanırsa veya sıfır olarak ayarlanırsa güncelleme boyutu sınırı belirlenmez.
max_database_entries

int32

İstemcinin liste için yerel veritabanında bulundurmaya istekli olduğu maksimum giriş sayısını ayarlar. (Sunucu, istemcinin bu sayıdan daha az giriş depolamasına neden OLABİLİR.) Atlanırsa veya sıfır olarak ayarlanırsa veritabanı boyutu sınırı belirlenmez.

ThreatAttribute

Tehditlerin özellikleri. Bu özellikler belirli bir tehdide ek anlamlar katabilir ancak tehdit türünü etkilemez. Örneğin, bir özellik daha düşük güven belirtirken farklı bir özellik daha yüksek güven 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, kapsayan FullHashDetail değerini tamamen göz ardı eder.
CANARY threat_type'ın yaptırım için kullanılmaması gerektiğini belirtir.
FRAME_ONLY threat_type'ın yalnızca çerçevelerde yaptırım için kullanılması gerektiğini gösterir.

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, kapsayan FullHashDetail değerini tamamen göz ardı eder.
MALWARE

Kötü amaçlı yazılım tehdidi 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 tehdidi türü. Sosyal mühendislik sayfaları, izleyicileri üçüncü tarafın gerçek temsilcisine güvenecekleri bir işlemi yapmaya ikna etmek amacıyla üçüncü taraf adına hareket ediyormuş gibi davranır. Kimlik avı, izleyiciyi oturum açma kimlik bilgileri gibi bilgileri sağlama eylemini gerçekleştirmesi için kandıran bir sosyal mühendislik türüdür.

Daha fazla bilgiye buradan ulaşabilirsiniz.
UNWANTED_SOFTWARE İstenmeyen yazılım tehdidi türü. İstenmeyen yazılım, Google'ın Yazılım İlkeleri'ne uymayan ancak kötü amaçlı yazılım olmayan tüm yazılımlardır.
POTENTIALLY_HARMFUL_APPLICATION Google Play Protect'in Play Store için kullandığı potansiyel zararlı uygulama tehdidi türü.

ThreatUrl

Bir veya daha fazla tehditle eşleşen bir URL

Alanlar
url

string

Bir veya daha fazla tehditle eşleşen istenen URL.
threat_types[]

ThreatType

Sırasız liste. URL'nin sınıflandırıldığı tehditlerin sırasız listesi.