이 문서는 다음 메서드에 적용됩니다.
- Lookup API (v4) threatMatches.find
- Update API (v4): fullHashes.find
- Update API (v4): threatListUpdates.fetch
목록 정보
세이프 브라우징 목록(위협 목록이라고도 함) 단순히 목록으로, Google에서 지속적으로 업데이트하는 안전하지 않은 웹 리소스 목록입니다. 안전하지 않은 웹 리소스의 예로는 소셜 엔지니어링 사이트 (피싱 및 사기성 사이트) 및 멀웨어나 원치 않는 소프트웨어를 호스팅하는 사이트를 방문하는 것입니다.
목록 이름
각 세이프 브라우징 목록은 다음 세 가지 매개변수 또는 유형 조합을 사용하여 이름이 지정 (식별됨)됩니다.
threatType
, platformType
, threatEntryType
(
ThreatListDescriptor).
클라이언트는 세이프 브라우징 서버에 요청을 전송하기 전에 먼저 현재 사용 가능한 세이프 브라우징 목록입니다. 이렇게 하면 매개변수 또는 유형이 모두 유효합니다.
세이프 브라우징 목록의 이름을 검색하려면
threatLists.list
메서드 및 HTTP GET
요청/응답입니다.
예: ThreatLists.list
HTTP GET 요청
요청에 헤더만 포함되어 있습니다 (요청 본문 없음).
요청 헤더
요청 헤더에는 요청 URL과 콘텐츠 유형이 포함됩니다. 반드시
URL의 API_KEY
에 대한 API 키입니다.
GET https://safebrowsing.googleapis.com/v4/threatLists?key=API_KEY HTTP/1.1 Content-Type: application/json
요청 본문
이 메서드에는 요청 본문이 없습니다.
HTTP GET 응답
응답에서는 현재 쿼리 또는 다운로드에 사용할 수 있는 세이프 브라우징 목록을 반환합니다. 이 예를 들어 두 개의 목록만 표시되지만 추가 목록을 사용할 수 있어 반환됩니다.
응답 헤더
응답 헤더에는 HTTP 상태 코드가 포함됩니다. 지정할 수 있습니다.
HTTP/1.1 200 OK Content-Type: application/json
응답 본문
세이프 브라우징 목록이 위협 목록의 배열로 반환됩니다. 앞서 설명한 것처럼 각
목록은 threatType
, platformType
,
threatEntryType
입니다.
{ threatLists: [{ "threatType": "MALWARE", "platformType": "WINDOWS", "threatEntryType": "URL", }, { "threatType": "MALWARE", "platformType": "LINUX", "threatEntryType": "URL", }, { ... additional lists will be returned ... }] }
콘텐츠 나열
현재 모든 세이프 브라우징 목록은 4~32의 가변 길이 SHA 256 해시로 구성됩니다. 바이트. 이러한 해시는 안전하지 않은 URL과 연결된 URL의 접미사/접두사 표현식을 기반으로 합니다. 웹 리소스를 제공합니다 URL 자체는 세이프 브라우징 목록에 저장되지 않습니다. (URL 및 해시 참고).
Lookup API를 사용하여 URL을 확인할 때 클라이언트는 요청에 실제 URL을 보내고 세이프 브라우징 서버에서 검사를 수행하기 전에 URL을 해시로 변환합니다. Lookup API의 URL 확인을 참고하세요.
Update API를 사용하여 URL을 확인할 때 클라이언트는 URL을 해시로 변환한 다음 URL 검사를 수행하기 위해 요청에서 해시 접두어를 추가 Update API의 URL 확인을 참조하세요.