Danh sách duyệt web an toàn

Tài liệu này áp dụng cho các phương pháp sau:

Giới thiệu về danh sách

Danh sách của tính năng Duyệt web an toàn (còn được gọi là danh sách mối đe doạ hoặc danh sách—là danh sách được cập nhật liên tục của Google về các tài nguyên không an toàn trên web. Ví dụ về tài nguyên web không an toàn là các trang web tấn công phi kỹ thuật (trang web lừa đảo và giả mạo) và các trang web lưu trữ phần mềm độc hại hoặc phần mềm không mong muốn.

Tên danh sách

Mỗi danh sách Duyệt web an toàn được đặt tên (đã xác định) bằng cách sử dụng 3 tổ hợp tham số hoặc loại: threatType, platformType và threatEntryType (xem ThreatListDescriptor).

Trước khi gửi yêu cầu tới các máy chủ Duyệt web an toàn, ứng dụng cần truy xuất tên của hiện có sẵn danh sách Duyệt web an toàn. Điều này giúp đảm bảo rằng các thông số hoặc kiểu các kết hợp được chỉ định trong yêu cầu đều hợp lệ.

Để truy xuất tên của các danh sách Duyệt web an toàn, hãy sử dụng threatLists.list và yêu cầu/phản hồi HTTP GET.

Ví dụ: takeoutLists.list

Yêu cầu HTTP GET

Yêu cầu chỉ chứa tiêu đề (không có nội dung yêu cầu).

Tiêu đề yêu cầu

Tiêu đề yêu cầu bao gồm URL yêu cầu và loại nội dung. Hãy nhớ thay thế Khoá API cho API_KEY trong URL.

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

Nội dung yêu cầu

Không có nội dung yêu cầu cho phương thức này.

Phản hồi HTTP GET

Phản hồi sẽ trả về các danh sách của tính năng Duyệt web an toàn hiện có sẵn để truy vấn hoặc tải xuống. Trong phần này ví dụ: chỉ hiển thị 2 danh sách, nhưng có các danh sách khác và sẽ được trả về.

Tiêu đề phản hồi

Tiêu đề phản hồi có mã trạng thái HTTP và loại nội dung.

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

Nội dung phản hồi

Danh sách Duyệt web an toàn được trả về dưới dạng một mảng danh sách các mối đe doạ. Như đã lưu ý, mỗi danh sách được xác định bởi 3 tham số hoặc tổ hợp kiểu: threatType, platformType và threatEntryType.

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

Nội dung danh sách

Hiện tại, tất cả các danh sách Duyệt web an toàn đều bao gồm hàm băm SHA 256 có độ dài thay đổi trong khoảng từ 4 đến 32 byte. Các hàm băm này dựa trên hậu tố/biểu thức có tiền tố của những URL liên kết với trang web không an toàn tài nguyên trên web. Lưu ý rằng bản thân các URL không được lưu trữ trong danh sách của Duyệt web an toàn (xem URL và hàm băm).

Khi sử dụng Lookup API để kiểm tra URL, ứng dụng sẽ gửi URL thực tế trong yêu cầu và Máy chủ Duyệt web an toàn chuyển đổi URL thành một hàm băm trước khi thực hiện quy trình kiểm tra (xem phần Kiểm tra URL để biết API Lookup).

Khi sử dụng Update API để kiểm tra URL, ứng dụng phải chuyển đổi URL thành một hàm băm rồi gửi tiền tố hàm băm trong yêu cầu để thực hiện kiểm tra URL (xem phần Kiểm tra URL để biết API Cập nhật).