REST Resource: hashList

Kaynak: HashList

Adıyla tanımlanan karma listesi.

JSON gösterimi 
{
  "name": string,
  "version": string,
  "partialUpdate": boolean,
  "compressedRemovals": {
    object (RiceDeltaEncoded32Bit)
  },
  "minimumWaitDuration": string,
  "sha256Checksum": string,
  "metadata": {
    object (HashListMetadata)
  },

  // Union field compressed_additions can be only one of the following:
  "additionsFourBytes": {
    object (RiceDeltaEncoded32Bit)
  },
  "additionsEightBytes": {
    object (RiceDeltaEncoded64Bit)
  },
  "additionsSixteenBytes": {
    object (RiceDeltaEncoded128Bit)
  },
  "additionsThirtyTwoBytes": {
    object (RiceDeltaEncoded256Bit)
  }
  // End of list of possible types for union field compressed_additions.
}
Alanlar
name

string

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

string (bytes format)

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

Base64 kodlu bir dize.
partialUpdate

boolean

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, istemcinin sahip olduğu sürümün ciddi şekilde güncel olmadığı veya istemci verilerinin bozuk olduğu anlamına gelir. compressedRemovals alanı boş olur.

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

object (RiceDeltaEncoded32Bit)

Kaldırma dizinlerinin Rice-delta kodlu sürümü. Her karma liste kesinlikle 2^32'den daha az giriş içerdiğinden dizinler 32 bit tamsayı olarak değerlendirilir ve kodlanır.
minimumWaitDuration

string (Duration format)

İ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.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
sha256Checksum

string (bytes format)

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.

Base64 kodlu bir dize.
metadata

object (HashListMetadata)

Karma listesiyle ilgili meta veriler. Bu alan hashList.get 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:
additionsFourBytes

object (RiceDeltaEncoded32Bit)

4 baytlık eklemeler.
additionsEightBytes

object (RiceDeltaEncoded64Bit)

8 baytlık eklemeler.
additionsSixteenBytes

object (RiceDeltaEncoded128Bit)

16 baytlık eklemeler.
additionsThirtyTwoBytes

object (RiceDeltaEncoded256Bit)

32 baytlık eklemeler.

RiceDeltaEncoded32Bit

Rice-Golomb kodlu veriler. Karma 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 unary kodlama kullanılır. riceParameter 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.

JSON gösterimi 
{
  "firstValue": integer,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
Alanlar
firstValue

integer (uint32 format)

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.
riceParameter

integer

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

integer

Ş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 firstValue içinde saklanır.
encodedData

string (bytes format)

Golomb-Rice kodlayıcı kullanılarak kodlanan kodlanmış delta değerleri.

Base64 kodlu bir dize.

RiceDeltaEncoded64Bit

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

JSON gösterimi 
{
  "firstValue": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
Alanlar
firstValue

string

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.
riceParameter

integer

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

integer

Ş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 firstValue içinde saklanır.
encodedData

string (bytes format)

Golomb-Rice kodlayıcı kullanılarak kodlanan kodlanmış delta değerleri.

Base64 kodlu bir dize.

RiceDeltaEncoded128Bit

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

JSON gösterimi 
{
  "firstValueHi": string,
  "firstValueLo": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
Alanlar
firstValueHi

string

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

string (uint64 format)

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

integer

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

integer

Ş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 firstValue içinde saklanır.
encodedData

string (bytes format)

Golomb-Rice kodlayıcı kullanılarak kodlanan kodlanmış delta değerleri.

Base64 kodlu bir dize.

RiceDeltaEncoded256Bit

RiceDeltaEncoded32Bit ile aynıdır. Ancak bu işlev 256 bit sayıları kodlar.

JSON gösterimi 
{
  "firstValueFirstPart": string,
  "firstValueSecondPart": string,
  "firstValueThirdPart": string,
  "firstValueFourthPart": string,
  "riceParameter": integer,
  "entriesCount": integer,
  "encodedData": string
}
Alanlar
firstValueFirstPart

string

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

string (uint64 format)

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.
firstValueThirdPart

string (uint64 format)

Kodlanmış verilerdeki (karma) ilk girişin 129. ila 192. bitleri. Alan boşsa 129. ile 192. bitler sıfırdır.
firstValueFourthPart

string (uint64 format)

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

integer

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

integer

Ş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 firstValue içinde saklanır.
encodedData

string (bytes format)

Golomb-Rice kodlayıcı kullanılarak kodlanan kodlanmış delta değerleri.

Base64 kodlu bir dize.

HashListMetadata

Belirli bir karma listesiyle ilgili meta veriler.

JSON gösterimi 
{
  "threatTypes": [
    enum (ThreatType)
  ],
  "likelySafeTypes": [
    enum (LikelySafeType)
  ],
  "description": string,
  "hashLength": enum (HashLength)
}
Alanlar
threatTypes[]

enum (ThreatType)

Sırasız liste. Boş değilse bu, 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.
likelySafeTypes[]

enum (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, threatTypes alanı ile aynı anda kullanılamaz.
description

string

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

enum (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 kullanıma sunulur.

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 tehdit 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ü.

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.

HashLength

Karma listesindeki karma değerlerinin uzunluğu.

Sıralamalar
HASH_LENGTH_UNSPECIFIED Belirtilmeyen 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 önekten oluşur.
THIRTY_TWO_BYTES Her karma, otuz iki baytlık tam bir karmadır.

Yöntemler

get

 Karma listesinin en son içeriklerini alır.