Package google.security.safebrowsing.v5alpha1

색인

SafeBrowsing

Safe Browsing API를 사용하면 클라이언트가 지속적으로 업데이트되는 Google의 안전하지 않은 웹 리소스 목록을 기준으로 웹 리소스 (일반적으로 URL)를 확인할 수 있습니다.

BatchGetHashLists

rpc BatchGetHashLists(BatchGetHashListsRequest) returns (BatchGetHashListsResponse)

한 번에 여러 해시 목록을 가져옵니다.

클라이언트가 여러 해시 목록을 가져와야 하는 경우가 매우 많습니다. 이 방법을 사용하는 것이 일반 Get 메서드를 여러 번 사용하는 것보다 좋습니다.

이는 https://google.aip.dev/231에 정의된 표준 일괄 가져오기 메서드이며 HTTP 메서드도 GET입니다.
GetHashList

rpc GetHashList(GetHashListRequest) returns (HashList)

해시 목록의 최신 콘텐츠를 가져옵니다. 해시 목록은 위협 목록이거나 전역 캐시와 같은 비위협 목록일 수 있습니다.

이는 https://google.aip.dev/131에 정의된 표준 Get 메서드이며 HTTP 메서드도 GET입니다.
ListHashLists

rpc ListHashLists(ListHashListsRequest) returns (ListHashListsResponse)

해시 목록을 나열합니다.

V5 API에서 Google은 이 메서드에서 반환된 적이 있는 해시 목록을 삭제하지 않습니다. 이를 통해 클라이언트는 이 메서드 사용을 건너뛰고 필요한 모든 해시 목록을 하드 코딩할 수 있습니다.

이는 https://google.aip.dev/132에 정의된 표준 목록 메서드이며 HTTP 메서드는 GET입니다.
SearchHashes

rpc SearchHashes(SearchHashesRequest) returns (SearchHashesResponse)

지정된 접두사와 일치하는 전체 해시를 검색합니다.

이는 https://google.aip.dev/136에 정의된 맞춤 메서드입니다 (맞춤 메서드는 Google의 일반 API 개발 명명법 내에서 맞춤 이름이 있는 이 메서드를 의미하며 맞춤 HTTP 메서드 사용을 의미하지는 않음).
SearchUrls

rpc SearchUrls(SearchUrlsRequest) returns (SearchUrlsResponse)

알려진 위협과 일치하는 URL을 검색합니다. 각 URL과 호스트 서픽스 및 경로 프리픽스 표현식 (제한된 깊이까지)이 확인됩니다. 즉, 응답에 요청에 포함되지 않았지만 요청된 URL을 표현하는 URL이 포함될 수 있습니다.

BatchGetHashListsRequest

여러 해시 목록을 동시에 가져오기 위한 요청입니다.

필드
names[]

string

필수 항목입니다. 특정 해시 목록의 이름입니다. 목록은 위협 목록일 수도 있고 전역 캐시일 수도 있습니다(MAY). 이름에 중복이 포함되면 안 됩니다(MUST NOT). 중복이 포함되면 클라이언트에 오류가 표시됩니다.
version[]

bytes

클라이언트가 이미 보유한 해시 목록의 버전입니다. 클라이언트가 해시 목록을 가져오는 것이 처음인 경우 이 필드는 비워 두어야 합니다. 그렇지 않으면 클라이언트는 서버에서 이전에 수신한 버전을 제공해야 합니다. 클라이언트는 이러한 바이트를 조작하면 안 됩니다(MUST NOT).

클라이언트는 해당 목록 이름과 동일한 순서로 버전을 전송하지 않아도 됩니다. 클라이언트는 요청에서 이름보다 적거나 많은 버전을 보낼 수 있습니다. 하지만 클라이언트는 동일한 이름에 해당하는 버전을 여러 개 전송해서는 안 됩니다(MUST NOT). 이렇게 하면 클라이언트에 오류가 발생합니다.

이전 참고사항: API V4에서는 states라고 불렸으며, 이제 명확성을 위해 version로 이름이 변경되었습니다.
size_constraints

SizeConstraints

각 목록의 크기 제약 조건입니다. 생략하면 제약 조건이 없습니다. 여기 표시되는 크기는 모든 목록에 걸쳐 집계된 크기가 아니라 목록별 크기입니다.

BatchGetHashListsResponse

해시 목록이 여러 개 포함된 응답입니다.

필드
hash_lists[]

HashList

요청에 지정된 순서와 동일한 순서의 해시 목록입니다.

FullHash

하나 이상의 일치 항목으로 식별된 전체 해시입니다.

필드
full_hash

bytes

일치하는 전체 해시입니다. SHA256 해시입니다. 길이는 정확히 32바이트입니다.
full_hash_details[]

FullHashDetail

순서가 지정되지 않은 목록 이 전체 해시와 관련된 세부정보를 식별하는 반복 필드입니다.

FullHashDetail

일치하는 전체 해시에 관한 세부정보입니다.

향후 호환성에 관한 중요한 참고사항: 새 위협 유형과 위협 속성은 언제든지 서버에서 추가될 수 있으며 이러한 추가는 부 버전 변경으로 간주됩니다. Google의 정책에 따라 API에 마이너 버전 번호가 노출되지 않으므로(버전 관리 정책은 https://cloud.google.com/apis/design/versioning 참고) 클라이언트는 클라이언트에서 유효하지 않은 것으로 간주되는 ThreatType enum 값 또는 ThreatAttribute enum 값이 포함된 FullHashDetail 메시지를 수신할 준비가 되어 있어야 합니다(MUST). 따라서 모든 ThreatType 및 ThreatAttribute enum 값의 유효성을 확인하는 것은 클라이언트의 책임입니다. 값이 유효하지 않은 것으로 간주되면 클라이언트는 전체 FullHashDetail 메시지를 무시해야 합니다(MUST).

필드
threat_type

ThreatType

위협 유형입니다. 이 필드는 비어 있지 않습니다.
attributes[]

ThreatAttribute

순서가 지정되지 않은 목록 전체 해시에 관한 추가 속성입니다. 비어 있을 수 있습니다.

GetHashListRequest

해시 목록을 가져오기 위한 요청입니다. 해시 목록은 위협 목록일 수도 있고 전역 캐시와 같은 비위협 목록일 수도 있습니다.

V5의 새로운 기능: 이전 V4에서 states라고 불리던 것이 명확성을 위해 version로 이름이 변경되었습니다. 이제 목록에 이름이 지정되고 플랫폼 유형과 위협 항목 유형이 삭제됩니다. 이제 여러 목록이 동일한 위협 유형을 갖거나 단일 목록이 여러 위협 유형과 관련될 수 있습니다. 많은 클라이언트 구현에서 문제를 일으킨 V4의 가변 길이 해시 접두사와 달리 목록의 모든 해시는 이제 단일 길이를 가지므로 훨씬 더 효율적인 클라이언트 구현이 가능합니다. 제약 조건이 간소화되었으며 압축 유형이 삭제되었습니다 (압축은 항상 적용됨).

필드
name

string

필수 항목입니다. 이 특정 해시 목록의 이름입니다. 위협 목록일 수도 있고 전역 캐시일 수도 있습니다.
version

bytes

클라이언트가 이미 보유한 해시 목록의 버전입니다. 클라이언트가 해시 목록을 가져오는 것이 처음인 경우 이 필드는 비워 두어야 합니다(MUST). 그렇지 않으면 클라이언트는 서버에서 이전에 수신한 버전을 제공해야 합니다(SHOULD). 클라이언트는 이러한 바이트를 조작하면 안 됩니다(MUST NOT).

V5의 새로운 기능: API의 V4에서는 states로 불렸으며, 이제 명확성을 위해 version로 이름이 변경되었습니다.
size_constraints

SizeConstraints

목록의 크기 제약 조건입니다. 생략하면 제약 조건이 없습니다. 처리 능력, 대역폭 또는 저장소가 제한된 모든 기기에서 제약 조건을 사용하는 것이 좋습니다.

HashList

이름으로 식별되는 해시 목록입니다.

필드
name

string

해시 목록의 이름입니다. 전역 캐시도 해시 목록일 뿐이며 여기에서 참조할 수 있습니다.
version

bytes

해시 목록의 버전입니다. 클라이언트는 이러한 바이트를 조작하면 안 됩니다(MUST NOT).
partial_update

bool

true인 경우 클라이언트가 이미 보유한 항목을 기반으로 추가 및 삭제가 포함된 부분 차이입니다. false인 경우 이는 전체 해시 목록입니다.

false인 경우 클라이언트는 이 해시 목록에 대해 로컬로 저장된 버전을 삭제해야 합니다(MUST). 이는 클라이언트가 보유한 버전이 심각하게 오래되었거나 클라이언트 데이터가 손상된 것으로 간주됨을 의미합니다. compressed_removals 필드가 비어 있습니다.

true인 경우 클라이언트는 삭제를 적용한 다음 추가를 적용하여 증분 업데이트를 적용해야 합니다(MUST).
compressed_removals

RiceDeltaEncoded32Bit

삭제 색인의 Rice-delta 인코딩 버전입니다. 각 해시 목록에는 항목이 2^32개 미만이므로 색인은 32비트 정수로 처리되고 인코딩됩니다.
minimum_wait_duration

Duration

클라이언트는 해시 목록을 다시 가져오기 위해 최소한 이 시간만큼 기다려야 합니다. 생략되거나 0인 경우 클라이언트는 즉시 가져와야 합니다(SHOULD). 이는 서버에 클라이언트에 전송해야 하는 추가 업데이트가 있지만 클라이언트 지정 제약 조건으로 인해 전송할 수 없음을 나타내기 때문입니다.
sha256_checksum

bytes

모든 해시의 정렬된 목록으로, SHA256으로 다시 해싱됩니다. 제공된 업데이트를 적용한 후 데이터베이스에 있는 모든 해시의 정렬된 목록에 대한 체크섬입니다. 업데이트가 제공되지 않은 경우 서버는 클라이언트가 기존 체크섬을 사용해야 함을 나타내기 위해 이 필드를 생략합니다.
metadata

HashListMetadata

해시 목록에 관한 메타데이터입니다. GetHashList 메서드에 의해 채워지지 않지만 ListHashLists 메서드에 의해 채워집니다.
통합 필드 compressed_additions. 추가 항목의 Rice-delta 인코딩 버전입니다. 추가 항목의 해시 접두사 길이가 목록의 모든 추가 항목에서 균일합니다. compressed_additions은 다음 중 하나여야 합니다.
additions_four_bytes

RiceDeltaEncoded32Bit

4바이트 추가
additions_eight_bytes

RiceDeltaEncoded64Bit

8바이트 추가
additions_sixteen_bytes

RiceDeltaEncoded128Bit

16바이트 추가
additions_thirty_two_bytes

RiceDeltaEncoded256Bit

32바이트 추가

HashListMetadata

특정 해시 목록에 관한 메타데이터입니다.

필드
threat_types[]

ThreatType

순서가 지정되지 않은 목록 비어 있지 않은 경우 해시 목록이 일종의 위협 목록임을 지정하며 이 해시 목록에 있는 해시 또는 해시 접두사와 연결된 위협의 종류를 열거합니다. 항목이 위협을 나타내지 않는 경우(예: 안전한 유형을 나타내는 경우) 비어 있을 수 있습니다.
likely_safe_types[]

LikelySafeType

순서가 지정되지 않은 목록 비어 있지 않으면 해시 목록이 안전할 가능성이 높은 해시 목록을 나타내며, 안전할 가능성이 높은 것으로 간주되는 방식을 열거합니다. 이 필드는 threat_types 필드와 상호 배타적입니다.
description

string

이 목록에 대한 사람이 읽을 수 있는 설명입니다. 영어로 작성되어 있습니다.
hash_length

HashLength

이 해시 목록에 지원되는 해시 길이입니다. 각 해시 목록은 정확히 하나의 길이를 지원합니다. 동일한 위협 유형 또는 안전 유형 집합에 다른 해시 길이가 도입되면 고유한 이름과 해당 해시 길이 집합이 있는 별도의 목록으로 도입됩니다.

HashLength

해시 목록의 해시 길이입니다.

열거형
HASH_LENGTH_UNSPECIFIED 길이가 지정되지 않았습니다.
FOUR_BYTES 각 해시는 4바이트 접두사입니다.
EIGHT_BYTES 각 해시는 8바이트 접두사입니다.
SIXTEEN_BYTES 각 해시는 16바이트 접두사입니다.
THIRTY_TWO_BYTES 각 해시는 32바이트 전체 해시입니다.

LikelySafeType

안전한 사이트일 가능성이 높은 유형입니다.

SearchHashesResponse에는 의도적으로 LikelySafeType이 포함되지 않습니다.

열거형
LIKELY_SAFE_TYPE_UNSPECIFIED 알 수 없음
GENERAL_BROWSING 이 사이트는 일반적인 탐색에 충분히 안전한 것으로 보입니다. 이를 전역 캐시라고도 합니다.
CSD 이 사이트는 클라이언트 측 감지 모델이나 비밀번호 보호 검사를 실행하지 않아도 될 만큼 안전한 것으로 보입니다.
DOWNLOAD 이 사이트는 안전한 것으로 간주되어 사이트에서 다운로드한 항목을 검사하지 않아도 됩니다.

ListHashListsRequest

사용 가능한 해시 목록을 나열하는 요청입니다.

필드
page_size

int32

반환할 최대 해시 목록 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 서버에서 페이지 크기를 선택하며, 이 크기는 해시 목록 수보다 클 수 있으므로 페이지로 나누기가 필요하지 않습니다.
page_token

string

이전 ListHashLists 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

ListHashListsResponse

해시 목록에 관한 메타데이터가 포함된 응답입니다.

필드
hash_lists[]

HashList

해시는 임의의 순서로 나열됩니다. 콘텐츠가 아닌 해시 목록에 관한 메타데이터만 포함됩니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

RiceDeltaEncoded128Bit

128비트 숫자를 인코딩한다는 점을 제외하면 RiceDeltaEncoded32Bit와 동일합니다.

필드
first_value_hi

uint64

인코딩된 데이터 (해시)의 첫 번째 항목의 상위 64비트입니다. 필드가 비어 있으면 상위 64비트가 모두 0입니다.
first_value_lo

fixed64

인코딩된 데이터 (해시)의 첫 번째 항목의 하위 64비트입니다. 필드가 비어 있으면 하위 64비트가 모두 0입니다.
rice_parameter

int32

Golomb-Rice 매개변수입니다. 이 매개변수는 99~126(포함) 사이의 값입니다.
entries_count

int32

인코딩된 데이터에서 델타 인코딩된 항목의 수입니다. 단일 정수만 인코딩된 경우 이 값은 0이 되고 단일 값은 first_value에 저장됩니다.
encoded_data

bytes

Golomb-Rice 코더를 사용하여 인코딩된 인코딩된 델타입니다.

RiceDeltaEncoded256Bit

256비트 숫자를 인코딩한다는 점을 제외하고 RiceDeltaEncoded32Bit와 동일합니다.

필드
first_value_first_part

uint64

인코딩된 데이터 (해시)의 첫 번째 항목의 처음 64비트입니다. 필드가 비어 있으면 처음 64비트는 모두 0입니다.
first_value_second_part

fixed64

인코딩된 데이터 (해시)의 첫 번째 항목의 65~128번째 비트입니다. 필드가 비어 있으면 65~128번째 비트가 모두 0입니다.
first_value_third_part

fixed64

인코딩된 데이터 (해시)의 첫 번째 항목의 129~192번째 비트입니다. 필드가 비어 있으면 129~192번째 비트가 모두 0입니다.
first_value_fourth_part

fixed64

인코딩된 데이터 (해시)의 첫 번째 항목의 마지막 64비트입니다. 필드가 비어 있으면 마지막 64비트가 모두 0입니다.
rice_parameter

int32

Golomb-Rice 매개변수입니다. 이 매개변수는 227~254(포함) 사이의 값입니다.
entries_count

int32

인코딩된 데이터에서 델타 인코딩된 항목의 수입니다. 단일 정수만 인코딩된 경우 이 값은 0이 되고 단일 값은 first_value에 저장됩니다.
encoded_data

bytes

Golomb-Rice 코더를 사용하여 인코딩된 인코딩된 델타입니다.

RiceDeltaEncoded32Bit

Rice-Golomb으로 인코딩된 데이터입니다. 해시 또는 삭제 색인에 사용됩니다. 여기에서 모든 해시 또는 색인의 길이가 동일하며 이 길이는 정확히 32비트입니다.

일반적으로 모든 항목을 사전순으로 정렬하면 상위 비트가 하위 비트만큼 자주 변경되지 않는 경향이 있습니다. 즉, 항목 간의 인접한 차이도 고려하면 상위 비트가 0일 가능성이 높습니다. 이는 특정 비트를 선택하여 0일 가능성이 높은 점을 활용합니다. 이보다 더 중요한 모든 비트는 0일 가능성이 높으므로 단항 인코딩을 사용합니다. rice_parameter 필드를 참고하세요.

기록 참고: Rice-delta 인코딩은 이 API의 V4에서 처음 사용되었습니다. V5에서는 두 가지 중요한 개선사항이 적용되었습니다. 첫째, 이제 4바이트보다 긴 해시 접두사를 사용하여 Rice-delta 인코딩을 사용할 수 있습니다. 둘째, 비용이 많이 드는 정렬 단계를 피하기 위해 인코딩된 데이터가 이제 big-endian으로 처리됩니다.

필드
first_value

uint32

인코딩된 데이터 (해시 또는 색인)의 첫 번째 항목 또는 단일 해시 접두사나 색인만 인코딩된 경우 해당 항목의 값입니다. 필드가 비어 있으면 항목은 0입니다.
rice_parameter

int32

Golomb-Rice 매개변수입니다. 이 매개변수는 3~30 사이의 값(3과 30 포함)을 갖습니다.
entries_count

int32

인코딩된 데이터에서 델타 인코딩된 항목의 수입니다. 단일 정수만 인코딩된 경우 이 값은 0이 되고 단일 값은 first_value에 저장됩니다.
encoded_data

bytes

Golomb-Rice 코더를 사용하여 인코딩된 인코딩된 델타입니다.

RiceDeltaEncoded64Bit

64비트 숫자를 인코딩한다는 점을 제외하고 RiceDeltaEncoded32Bit와 동일합니다.

필드
first_value

uint64

인코딩된 데이터 (해시)의 첫 번째 항목 또는 단일 해시 접두사만 인코딩된 경우 해당 항목의 값입니다. 필드가 비어 있으면 항목은 0입니다.
rice_parameter

int32

Golomb-Rice 매개변수입니다. 이 매개변수는 35~62(포함) 사이의 값입니다.
entries_count

int32

인코딩된 데이터에서 델타 인코딩된 항목의 수입니다. 단일 정수만 인코딩된 경우 이 값은 0이 되고 단일 값은 first_value에 저장됩니다.
encoded_data

bytes

Golomb-Rice 코더를 사용하여 인코딩된 인코딩된 델타입니다.

SearchHashesRequest

클라이언트가 특정 해시 접두사를 검색하기 위해 발행하는 요청입니다.

이는 위협 목록만 검색하도록 설계되었으며 전역 캐시와 같은 비위협 목록은 검색하지 않습니다.

V5의 새로운 기능: 클라이언트가 로컬 데이터베이스에서 ClientInfo 또는 해시 목록의 상태를 지정할 필요가 없습니다. 이는 개인 정보 보호를 강화하기 위한 조치입니다. 또한 클라이언트는 관심 있는 위협 유형을 전송할 필요가 없습니다.

필드
hash_prefixes[]

bytes

필수 항목입니다. 조회할 해시 접두사입니다. 클라이언트는 해시 접두사를 1,000개 이상 전송하면 안 됩니다(MUST NOT). 하지만 URL 처리 절차에 따라 클라이언트는 30개 이상의 해시 프리픽스를 전송할 필요가 없습니다(SHOULD NOT).

현재 각 해시 프리픽스는 정확히 4바이트여야 합니다. 이 제한은 향후 완화될 수 있습니다(MAY).
filter

string

선택사항입니다. 클라이언트가 특정 종류의 위협만 가져오는 등 필터링에 관심이 있는 경우 이를 지정할 수 있습니다. 생략하면 일치하는 모든 위협이 반환됩니다. 세이프 브라우징에서 제공하는 가장 완전한 보호 기능을 사용하려면 이를 생략하는 것이 좋습니다.

필터는 Google Common Expression Language를 사용하여 지정되며, 일반적인 예와 함께 https://github.com/google/cel-spec에서 확인할 수 있습니다. 다음은 여기에서 사용할 수 있는 구체적인 예입니다.

필터 "threat_type == ThreatType.SOCIAL_ENGINEERING"에는 FullHashDetail 내에서 위협 유형이 SOCIAL_ENGINEERING이어야 합니다. 식별자 "threat_type"는 현재 위협 유형을 나타냅니다. 식별자 "ThreatType"는 가능한 모든 위협 유형의 모음을 나타냅니다.

"threat_type in [ ThreatType.UNWANTED_SOFTWARE, ThreatType.MALWARE ]" 필터를 사용하려면 위협 유형이 UNWANTED_SOFTWARE 또는 MALWARE여야 합니다.

SearchHashesResponse

위협 해시를 검색한 후 반환된 응답입니다.

아무것도 찾지 못하면 서버는 NOT_FOUND 상태 (HTTP 상태 코드 404)를 반환하는 대신 full_hashes 필드가 비어 있는 OK 상태 (HTTP 상태 코드 200)를 반환합니다.

V5의 새로운 기능: FullHash와 FullHashDetail가 분리되었습니다. 해시가 여러 위협 (예: 멀웨어와 사회 공학)이 있는 사이트를 나타내는 경우 V4에서와 같이 전체 해시를 두 번 보낼 필요가 없습니다. 또한 캐시 기간이 단일 cache_duration 필드로 간소화되었습니다.

필드
full_hashes[]

FullHash

순서가 지정되지 않은 목록 찾은 전체 해시의 순서가 지정되지 않은 목록입니다.
cache_duration

Duration

클라이언트 측 캐시 지속 시간입니다. 클라이언트는 이 기간을 현재 시간에 더하여 만료 시간을 결정해야 합니다(MUST). 그러면 응답에서 반환되는 전체 해시 수와 관계없이 요청에서 클라이언트가 쿼리한 모든 해시 프리픽스에 만료 시간이 적용됩니다. 서버가 특정 해시 프리픽스에 대해 전체 해시를 반환하지 않더라도 이 사실은 클라이언트가 캐시해야 합니다(MUST).

full_hashes 필드가 비어 있는 경우에만 클라이언트는 cache_duration를 늘려 서버에서 지정한 것보다 늦은 새 만료일을 결정할 수 있습니다(MAY). 어떤 경우든 캐시 기간은 24시간을 초과해서는 안 됩니다.

중요: 클라이언트는 서버가 모든 응답에 동일한 캐시 기간을 반환한다고 가정해서는 안 됩니다(MUST NOT). 서버는 상황에 따라 응답별로 다른 캐시 기간을 선택할 수 있습니다(MAY).

SearchUrlsRequest

클라이언트가 지정된 URL과 일치하는 위협을 검색하기 위해 발행하는 요청입니다.

이는 위협 목록만 검색하도록 설계되었으며 전역 캐시와 같은 비위협 목록은 검색하지 않습니다.

필드
urls[]

string

필수 항목입니다. 조회할 URL입니다. 클라이언트는 50개가 넘는 URL을 전송하면 안 됩니다(MUST NOT).

SearchUrlsResponse

지정된 URL과 일치하는 위협을 검색한 후 반환된 응답입니다.

아무것도 찾지 못하면 서버는 NOT_FOUND 상태 (HTTP 상태 코드 404)를 반환하는 대신 threats 필드가 비어 있는 OK 상태 (HTTP 상태 코드 200)를 반환합니다.

필드
threats[]

ThreatUrl

순서가 지정되지 않은 목록 발견된 위협 일치의 순서가 지정되지 않은 목록입니다. 각 항목에는 URL과 해당 URL과 일치하는 것으로 확인된 위협 유형이 포함됩니다. URL의 모든 표현식이 고려되었으므로 목록 크기는 요청의 URL 수보다 클 수 있습니다.
cache_duration

Duration

클라이언트 측 캐시 지속 시간입니다. 클라이언트는 이 기간을 현재 시간에 더하여 만료 시간을 결정해야 합니다(MUST). 그러면 응답에 반환되는 URL 수와 관계없이 요청에서 클라이언트가 쿼리한 모든 URL에 만료 시간이 적용됩니다. 서버가 특정 URL에 대해 일치하는 항목을 반환하지 않더라도 이 사실은 클라이언트에서 캐시해야 합니다(MUST).

threats 필드가 비어 있는 경우에만 클라이언트는 cache_duration를 늘려 서버에서 지정한 것보다 늦은 새 만료일을 결정할 수 있습니다(MAY). 어떤 경우든 캐시 기간은 24시간을 초과해서는 안 됩니다.

중요: 클라이언트는 서버가 모든 응답에 동일한 캐시 기간을 반환한다고 가정해서는 안 됩니다(MUST NOT). 서버는 상황에 따라 응답별로 다른 캐시 기간을 선택할 수 있습니다(MAY).

SizeConstraints

해시 목록 크기에 관한 제약 조건입니다.

필드
max_update_entries

int32

최대 크기(항목 수)입니다. 업데이트에는 이 값보다 많은 항목이 포함되지 않지만 이 값보다 적은 항목이 포함될 수는 있습니다. 이 값은 1024 이상이어야 합니다(MUST). 생략되거나 0인 경우 업데이트 크기 제한이 설정되지 않습니다.
max_database_entries

int32

클라이언트가 목록의 로컬 데이터베이스에 포함하고자 하는 최대 항목 수를 설정합니다. (서버는 클라이언트가 이 수보다 적은 항목을 저장하도록 할 수 있습니다(MAY).) 생략하거나 0인 경우 데이터베이스 크기 제한이 설정되지 않습니다.

ThreatAttribute

위협의 속성입니다. 이러한 속성은 특정 위협에 추가 의미를 부여할 수 있지만 위협 유형에는 영향을 미치지 않습니다. 예를 들어 한 속성은 낮은 신뢰도를 지정하고 다른 속성은 높은 신뢰도를 지정할 수 있습니다. 향후 더 많은 속성이 추가될 수 있습니다.

열거형
THREAT_ATTRIBUTE_UNSPECIFIED 알 수 없는 속성입니다. 서버에서 이를 반환하면 클라이언트는 FullHashDetail을 완전히 무시해야 합니다.
CANARY 위협_유형을 시정 조치에 사용해서는 안 됨을 나타냅니다.
FRAME_ONLY threat_type이 프레임에 대한 시행에만 사용되어야 함을 나타냅니다.

ThreatType

위협 유형입니다.

열거형
THREAT_TYPE_UNSPECIFIED 알 수 없는 위협 유형입니다. 서버에서 이를 반환하면 클라이언트는 FullHashDetail을 완전히 무시해야 합니다.
MALWARE

멀웨어 위협 유형입니다. 멀웨어란 컴퓨터, 휴대기기, 실행 중인 소프트웨어 또는 사용자에게 해를 끼치기 위해 설계된 소프트웨어 또는 모바일 애플리케이션입니다. 멀웨어는 사용자의 동의 없이 소프트웨어를 설치하거나 바이러스와 같은 유해한 소프트웨어를 설치하는 등 악의적인 방식으로 작동합니다.

자세한 정보는 여기를 참조하세요.
SOCIAL_ENGINEERING

소셜 엔지니어링 위협 유형입니다. 소셜 엔지니어링 페이지는 시청자가 해당 서드 파티의 실제 대리인만 신뢰할 수 있는 행동을 하도록 혼동시키기 위해 서드 파티를 대신하여 행동하는 것처럼 허위로 주장합니다. 피싱은 시청자를 속여 로그인 사용자 인증 정보와 같은 정보를 제공하는 특정 작업을 수행하게 하는 소셜 엔지니어링의 한 유형입니다.

자세한 정보는 여기를 참조하세요.
UNWANTED_SOFTWARE 원치 않는 소프트웨어 위협 유형입니다. 원치 않는 소프트웨어는 Google의 소프트웨어 정책을 준수하지 않지만 멀웨어는 아닌 소프트웨어입니다.
POTENTIALLY_HARMFUL_APPLICATION Google Play 프로텍트에서 Play 스토어에 사용하는 잠재적으로 위험한 애플리케이션 위협 유형입니다.

ThreatUrl

하나 이상의 위협과 일치하는 URL입니다.

필드
url

string

하나 이상의 위협에 의해 일치된 요청된 URL입니다.
threat_types[]

ThreatType

순서가 지정되지 않은 목록 URL이 분류된 위협의 순서가 지정되지 않은 목록입니다.