Güvenli Tarama Listeleri

Bu belge aşağıdaki yöntemler için geçerlidir:

Listeler hakkında

Tehdit listeleri olarak da bilinen Güvenli Tarama listeleri veya listeler, Google'ın güvenli olmayan web kaynaklarını içeren ve sürekli güncellenen listeleridir. Güvenli olmayan web kaynaklarına örnek olarak sosyal mühendislik siteleri (kimlik avı ve aldatıcı siteler) ve Kötü amaçlı veya istenmeyen yazılım barındıran siteler.

Liste adları

Her Güvenli Tarama listesi, üç parametre veya tür kombinasyonu kullanılarak adlandırılır (tanımlanır): threatType, platformType ve threatEntryType (bkz. ThreatListDescriptor) ikincil boyut olarak kullanabilirsiniz.

İstemci, Güvenli Tarama sunucularına istek göndermeden önce şu anda kullanılabilen Güvenli Tarama listeleri Böylece, parametrelerin veya tür kombinasyonların geçerli olduğundan emin olun.

Güvenli Tarama listelerinin adlarını almak için threatLists.list yöntemini ve HTTP GET isteğini/yanıtını gönderin.

Örnek: tehditLists.list

HTTP GET isteği

İstek yalnızca bir başlık içerir (istek gövdesi yoktur).

İstek başlığı

İstek başlığı, istek URL'sini ve içerik türünü içerir. Önceki videoda, URL'deki API_KEY için API anahtarı.

GET https://safebrowsing.googleapis.com/v4/threatLists?key=API_KEY HTTP/1.1
Content-Type: application/json

İstek içeriği

Bu yöntem için istek gövdesi yok.

HTTP GET yanıtı

Yanıt, şu anda sorgulanabilen veya indirilebilen Güvenli Tarama listelerini döndürür. Burada örnek olarak, yalnızca iki liste gösterilmektedir ancak ek listeler mevcuttur ve bu listeler döndürülür.

Yanıt başlığı

Yanıt üstbilgisi, HTTP durum kodunu içerir. ve içerik türü.

HTTP/1.1 200 OK
Content-Type: application/json

Yanıt gövdesi

Güvenli Tarama listeleri, bir dizi tehdit listesi olarak döndürülür. Daha önce de belirtildiği gibi, liste, üç parametre veya tür kombinasyonuyla tanımlanır: threatType, platformType ve threatEntryType.

{
  threatLists: [{
      "threatType":      "MALWARE",
      "platformType":    "WINDOWS",
      "threatEntryType": "URL",
  }, {
      "threatType":      "MALWARE",
      "platformType":    "LINUX",
      "threatEntryType": "URL",
  }, {
    ... additional lists will be returned ...
  }]
}

İçerik listeleme

Şu anda tüm Güvenli Tarama listeleri, 4 ile 32 arasında değişken uzunlukta SHA 256 karmalarından oluşmaktadır bayt olarak kabul edilir. Bu karmalar, güvenli olmayan adreslerle ilişkili URL'lerin sonek/önek ifadelerine dayanır web kaynakları. URL'lerin Güvenli Tarama listelerinde depolanmadığını unutmayın. (URL'ler ve Karmalar konusuna bakın).

URL'leri kontrol etmek için Lookup API'yi kullanırken istemci, istekteki gerçek URL'yi gönderir ve Güvenli Tarama sunucusu, kontrolü gerçekleştirmeden önce URL'yi bir karmaya dönüştürür (Lookup API için URL'leri kontrol etme bölümüne bakın).

URL'leri kontrol etmek için Update API'yi kullanırken istemci, URL'yi karmaya dönüştürmeli ve ardından URL kontrolünü gerçekleştirmek için istekteki karma öneki (Update API için URL'leri kontrol etme bölümüne bakın).