세이프 브라우징 목록

이 문서는 다음 메서드에 적용됩니다.

목록 정보

세이프 브라우징 목록(위협 목록이라고도 함) 단순히 목록으로, 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 확인을 참조하세요.