개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
세이프 브라우징 API란 무엇인가요?
다음 세이프 브라우징 API는 비상업적 용도로만 사용할 수 있습니다. 상업적 목적으로 악성 URL을 감지하기 위해 API를 사용해야 하는 경우(즉, '판매 또는 수익 창출 목적') Web Risk API를 참고하세요.
Safe Browsing API (v4)를 사용하면 클라이언트 애플리케이션이 URL을 Google에서 지속적으로 업데이트하는 안전하지 않은 웹 리소스 목록과 비교하여 확인할 수 있습니다. 안전하지 않은 웹 리소스의 예시로는 소셜 엔지니어링 사이트 (피싱 및 사기성 사이트)와 멀웨어 또는 원치 않는 소프트웨어를 호스팅하는 사이트가 있습니다.
세이프 브라우징 목록에 있는 URL은 안전하지 않은 것으로 간주됩니다.
클라이언트는 URL이 Safe Browsing 목록에 있는지 확인하기 위해 Lookup API (v4) 또는 Update API (v4)를 사용할 수 있습니다.
Lookup API (v4)
Lookup API를 사용하면 클라이언트 애플리케이션이 Google Safe Browsing 서버에 URL을 보내 상태를 확인할 수 있습니다. Update API의 복잡성을 피하므로 이 API는 사용하기 간단하며 쉽습니다.
장점:
- 단순 URL 검사: 실제 URL과 함께 HTTP
POST 요청을 전송하면 서버가 URL 상태 (안전하거나 안전하지 않은 상태)로 응답합니다.
단점:
- 개인 정보 보호: URL이 해싱되지 않으므로 서버에서 조회한 URL을 파악합니다.
- 응답 시간: 모든 조회 요청은 서버에서 처리됩니다. Google에서는 조회 응답 시간을 보장하지 않습니다.
쿼리된 URL의 개인 정보 보호에 대해 크게 신경 쓰지 않고 네트워크 요청에 따른 지연 시간을 용인할 수 있으면 사용하기 쉬운 Lookup API를 사용해 보세요.
Update API (v4)
Update API를 사용하면 클라이언트 애플리케이션이 URL의 로컬 클라이언트 측 확인을 위해 암호화된 버전의 Safe Browsing 목록을 다운로드할 수 있습니다. Update API는 빈도가 높고 지연 시간이 짧은 결과를 요구하는 클라이언트를 위해 설계되었습니다. 여러 웹브라우저와 소프트웨어 플랫폼에서 이 API를 사용하여 많은 사용자를 보호합니다.
장점:
- 개인 정보 보호: 서버와 데이터를 자주 교환하지 않고 (로컬 해시 프리픽스 일치 이후에만) 해시된 URL을 사용하므로 서버는 클라이언트가 쿼리하는 실제 URL을 알 수 없습니다.
- 응답 시간: 세이프 브라우징 목록의 사본이 포함된 로컬 데이터베이스를 유지 관리합니다. URL을 확인할 때마다 서버를 쿼리 할 필요가 없습니다.
단점:
- 구현: 로컬 데이터베이스를 설정한 다음 Safe Browsing 목록의 로컬 사본을 다운로드하고 주기적으로 업데이트해야 합니다 (변수 길이 SHA256 해시로 저장됨).
- 복잡한 URL 확인: URL을 표준화하고 서픽스/프리픽스 표현식을 만들고 SHA256 해시를 계산하여 서버에 저장된 세이프 브라우징 목록 및 세이프 브라우징 목록의 로컬 사본과 비교하는 방법을 알아야 합니다.
쿼리된 URL의 개인 정보 보호 또는 네트워크 요청으로 인한 지연 시간이 우려되는 경우 Update API를 사용하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThe Safe Browsing APIs (v4) enable client applications to check URLs against Google's lists of unsafe web resources, including phishing sites and those hosting malware.\u003c/p\u003e\n"],["\u003cp\u003eTwo APIs are available: Lookup API (v4) for simple URL checks and Update API (v4) for local, privacy-focused checks.\u003c/p\u003e\n"],["\u003cp\u003eLookup API (v4) offers ease of use but has privacy and response time limitations.\u003c/p\u003e\n"],["\u003cp\u003eUpdate API (v4) prioritizes privacy and speed but requires more complex implementation and URL handling.\u003c/p\u003e\n"],["\u003cp\u003eThese APIs are for non-commercial use only; commercial users should refer to the Web Risk API.\u003c/p\u003e\n"]]],["Safe Browsing APIs allow client applications to check URLs against Google's unsafe web resource lists, distinguishing between non-commercial and commercial use (Web Risk API). The Lookup API checks URL status via server requests, offering simplicity but compromising privacy and response time. The Update API downloads encrypted lists for local checks, prioritizing privacy and speed but requiring complex implementation, database setup, and hash management. Users can choose between these based on privacy needs and latency tolerance.\n"],null,["# Overview\n\nWhat are the Safe Browsing APIs?\n--------------------------------\n\nThe following Safe Browsing APIs are for non-commercial use only. If you need to use APIs\nto detect malicious URLs for commercial purposes -- meaning \"for sale or revenue-generating\npurposes\" -- please refer to the [Web Risk API](https://cloud.google.com/web-risk).\n\nThe Safe Browsing APIs (v4) let your client applications check URLs against Google's\nconstantly updated lists of unsafe web resources. Examples of unsafe web resources are social\nengineering sites (phishing and deceptive sites) and sites that host malware or unwanted software.\nAny URL found on a Safe Browsing list is considered unsafe.\n\nTo determine if a URL is on any of the Safe Browsing lists, clients can use either\nthe [Lookup API (v4)](/safe-browsing/v4/lookup-api)\nor the [Update API (v4)](/safe-browsing/v4/update-api).\n\nLookup API (v4)\n---------------\n\nThe Lookup API lets your client applications send URLs to the Google Safe Browsing server to\ncheck their status. The API is simple and easy to use, as it avoids the complexities of the\nUpdate API.\n\nAdvantages:\n\n- Simple URL checks: You send an HTTP `POST` request with the actual URLs, and the server responds with the state of the URLs (safe or unsafe).\n\nDrawbacks:\n\n- Privacy: URLs are not hashed, so the server knows which URLs you look up.\n- Response time: Every lookup request is processed by the server. We don't provide guarantees on lookup response time.\n\nIf you are not too concerned about the privacy of the queried URLs, and you can tolerate the\nlatency induced by a network request, consider using the Lookup API since it's fairly easy to\nuse.\n\nUpdate API (v4)\n---------------\n\nThe Update API lets your client applications download encrypted versions of the Safe Browsing\nlists for local, client-side checks of URLs. The Update API is designed for clients that require\nhigh frequency, low-latency verdicts. Several web browsers and software platforms use this\nAPI to protect large sets of users.\n\nAdvantages:\n\n- Privacy: You exchange data with the server infrequently (only after a local hash prefix match) and using hashed URLs, so the server never knows the actual URLs queried by the clients.\n- Response time: You maintain a local database that contains copies of the Safe Browsing lists; they do not need to query the server every time they want to check a URL.\n\nDrawbacks:\n\n- Implementation: You need to set up a local database and then download, and periodically update, the local copies of the Safe Browsing lists (stored as variable-length SHA256 hashes).\n- Complex URL checks: You need to know how to canonicalize URLs, create suffix/prefix expressions, and compute SHA256 hashes (for comparison with the local copies of the Safe Browsing lists as well as the Safe Browsing lists stored on the server).\n\nIf you are concerned about the privacy of the queried URLs or the latency induced by a\nnetwork request, use the Update API."]]
