總覽

什麼是安全瀏覽 API？

Safe Browsing API 僅供非商業用途。如需使用 API 偵測惡意網址以用於商業用途 (即「用於銷售或營利目的」)，請參閱 Web Risk API。

Safe Browsing API (第 4 版) 可讓用戶端應用程式根據 Google 持續更新的不安全網頁資源清單來檢查網址。不安全網頁資源的例子包括社交工程網站 (網路釣魚和詐欺網站)，以及放置惡意軟體與垃圾軟體的網站。如果網址出現在安全瀏覽清單中，就會被視為不安全。

如要判斷網址是否位於任何 Safe Browsing 清單中，用戶端可以使用 Lookup API (v4) 或 Update API (v4)。

Lookup API (第 4 版)

Lookup API 可讓用戶端應用程式將網址傳送至 Google Safe Browsing 伺服器，檢查網址狀態。這個 API 簡單易用，可避免 Update API 的複雜性。

優點：

• 簡單的網址檢查：您傳送含有實際網址的 HTTP POST 要求，伺服器會回應網址的狀態 (安全或不安全)。

缺點：

• 隱私權：網址不會經過雜湊處理，因此伺服器會知道您查詢的網址。
• 回應時間：伺服器會處理每項查詢要求。我們不保證查詢回應時間。

如果您不太擔心查詢網址的隱私權，且可以容忍網路要求造成的延遲，建議使用 Lookup API，因為這個 API 相當容易使用。

更新 API (第 4 版)

Update API 可讓用戶端應用程式下載加密版本的 Safe Browsing 清單，以便在本機進行用戶端網址檢查。Update API 適用於需要高頻率、低延遲判斷結果的用戶端。許多網路瀏覽器和軟體平台都使用這項 API，保護大量使用者。

優點：

• 隱私權：您與伺服器交換資料的頻率不高 (只有在本機雜湊前置字串相符後才會交換)，而且使用的是雜湊網址，因此伺服器永遠不會知道用戶端查詢的實際網址。
• 回應時間：您維護的本機資料庫包含安全瀏覽清單的副本，因此不需要在每次檢查網址時查詢伺服器。

缺點：

• 實作方式：您需要設定本機資料庫，然後下載並定期更新安全瀏覽清單的本機副本 (以變數長度的 SHA256 雜湊值形式儲存)。
• 複雜的網址檢查：您需要瞭解如何正規化網址、建立後置字串/前置字串運算式，以及計算 SHA256 雜湊 (用於與安全瀏覽清單的本機副本，以及儲存在伺服器上的安全瀏覽清單進行比較)。

如果您擔心查詢網址的隱私權，或網路要求造成的延遲，請使用 Update API。