Method: hashes.search

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

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önteminin kullanılmasını ifade etmez).

HTTP isteği

GET https://safebrowsing.googleapis.com/v5/hashes:search

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
hashPrefixes[]

string (bytes format)

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 ön eki göndermesi GEREKMEZ.

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

Base64 kodlu bir dize.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

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 fullHashes alanı boş olarak OK durumu (HTTP durum kodu 200) döndürür.

5. sürümdeki 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 cacheDuration alanıyla basitleştirildi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "fullHashes": [
    {
      object (FullHash)
    }
  ],
  "cacheDuration": string
}
Alanlar
fullHashes[]

object (FullHash)

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

string (Duration format)

İ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 fullHashes alanı boşsa istemci, sunucu tarafından belirtilenden daha geç bir yeni son kullanma tarihi belirlemek için cacheDuration 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.

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

FullHash

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

JSON gösterimi 
{
  "fullHash": string,
  "fullHashDetails": [
    {
      object (FullHashDetail)
    }
  ]
}
Alanlar
fullHash

string (bytes format)

Eşleşen tam karma. Bu, SHA256 karma değeridir. Uzunluk tam olarak 32 bayt olur.

Base64 kodlu bir dize.
fullHashDetails[]

object (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.

İleri 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 müşterinin sorumluluğundadır. Herhangi bir değer geçersiz kabul edilirse müşteri, FullHashDetail mesajının tamamını dikkate ALMAMALIDIR.

JSON gösterimi 
{
  "threatType": enum (ThreatType),
  "attributes": [
    enum (ThreatAttribute)
  ]
}
Alanlar
threatType

enum (ThreatType)

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

enum (ThreatAttribute)

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

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 threatType'ın yaptırım için kullanılmaması gerektiğini belirtir.
FRAME_ONLY threatType'ın yalnızca çerçevelerde yaptırım için kullanılması gerektiğini gösterir.