Package google.security.safebrowsing.v5alpha1

Indeks

SafeBrowsing

Interfejsy API Bezpiecznego przeglądania umożliwiają klientom sprawdzanie zasobów internetowych (najczęściej adresów URL) pod kątem stale aktualizowanych przez Google list niebezpiecznych zasobów internetowych.

BatchGetHashLists

rpc BatchGetHashLists(BatchGetHashListsRequest) returns (BatchGetHashListsResponse)

Uzyskaj wiele list haszów jednocześnie.

Często zdarza się, że klient musi uzyskać wiele list haszujących. Używanie tej metody jest preferowane zamiast wielokrotnego używania metody Get.

Jest to standardowa metoda pobierania wsadowego zdefiniowana na stronie https://google.aip.dev/231. Metoda HTTP to również GET.

GetHashList

rpc GetHashList(GetHashListRequest) returns (HashList)

Pobierz najnowszą zawartość listy skrótów. Lista skrótów może obejmować listę zagrożeń lub listę niebezpieczną, na przykład globalną pamięć podręczną.

Jest to standardowa metoda get zgodnie z definicją podaną na stronie https://google.aip.dev/131. Metoda HTTP to również GET.

ListHashLists

rpc ListHashLists(ListHashListsRequest) returns (ListHashListsResponse)

Wyświetl listy haszów.

W interfejsie API V5 Google nigdy nie usuwa listy skrótów, która kiedykolwiek została zwrócona przez tę metodę. Dzięki temu klienci mogą pominąć tę metodę i po prostu zakodować na stałe wszystkie niezbędne listy skrótów.

Jest to standardowa metoda List zdefiniowana na stronie https://google.aip.dev/132, a metoda HTTP to GET.

SearchHashes

rpc SearchHashes(SearchHashesRequest) returns (SearchHashesResponse)

Wyszukaj pełne hasze pasujące do określonych prefiksów.

Jest to metoda niestandardowa zdefiniowana na stronie https://google.aip.dev/136 (metoda niestandardowa oznacza jej niestandardową nazwę zgodnie z ogólną nazwą programistyczną interfejsu API Google – nie odnosi się do używania niestandardowej metody HTTP).

BatchGetHashListsRequest

Żądanie uzyskania wielu list haszujących jednocześnie.

Pola
names[]

string

Wymagane. Nazwy konkretnych list skrótów. Może to być lista zagrożeń lub globalna pamięć podręczna. Nazwy NIE MOGĄ zawierać duplikatów. Jeśli tak się stanie, klient otrzyma komunikat o błędzie.

version[]

bytes

Wersje listy skrótów, które ma już klient. Jeśli klient po raz pierwszy pobiera listy skrótów, to pole powinno pozostać puste. W przeciwnym razie klient powinien dostarczyć wersje otrzymane wcześniej z serwera. Klient NIE MOŻE manipulować tymi bajtami.

Klient nie musi wysyłać wersji w tej samej kolejności co odpowiadające im nazwy list. Klient może wysłać w żądaniu mniej lub więcej wersji niż jest nazw. Pamiętaj jednak, że klient NIE MOŻE wysyłać wielu wersji o tej samej nazwie. Jeśli tak było, klient zobaczy komunikat o błędzie.

Uwaga historyczna: wersja 4 interfejsu API nazywała się states. Dla jasności została zmieniona na version.

desired_hash_length

HashLength

Żądana długość prefiksu skrótu dla zwróconych haszów w bajtach. Serwer zwróci wtedy wszystkie prefiksy skrótów o podanej długości.

Różne listy skrótów mają różne wymagania dotyczące akceptowanych wartości pola desired_hash_length. Można go znaleźć w polu supported_hash_lengths w HashListMetadata. Jeśli desired_hash_length nie określi wartości w elemencie supported_hash_lengths, klienci zobaczą komunikat o błędzie.

Klienci nie mogą określać innych wartości desired_hash_length dla różnych list w przypadku parametru BatchGetHashListsRequest. Jeśli zachodzi taka potrzeba, podziel klienta na kilka BatchGetHashListsRequest.

size_constraints

SizeConstraints

Ograniczenia rozmiaru każdej listy. Jeśli go pominiesz, nie będzie żadnych ograniczeń. Pamiętaj, że podane tu rozmiary odnoszą się do poszczególnych list, a nie z podanych zagregowanych danych ze wszystkich list.

BatchGetHashListsResponse

Odpowiedź zawierająca wiele list haszujących.

Pola
hash_lists[]

HashList

Kolejność skrótów jest podana w żądaniu.

FullHash

Pełny hasz z co najmniej 1 dopasowaniem.

Pola
full_hash

bytes

Pasujący hasz. Jest to hasz SHA256. Będzie ona miała dokładnie 32 bajty.

full_hash_details[]

FullHashDetail

Lista nieuporządkowana. Pole powtarzane identyfikujące szczegóły związane z tym pełnym haszem.

FullHashDetail

Szczegółowe informacje o pasującej pełnej wartości hash.

Ważna uwaga dotycząca zgodności z przejściem: serwer może w każdej chwili dodawać nowe typy zagrożeń i atrybuty zagrożeń. Takie dodatki są uznawane za drobne zmiany w wersji. Zgodnie z zasadami Google nie ujawniamy numerów wersji podrzędnych w interfejsach API (informacje o zasadach obsługi wersji znajdziesz na stronie https://cloud.google.com/apis/design/versioning). Klienci MUSZĄ przygotować się na otrzymanie wiadomości FullHashDetail z wartościami wyliczeniowymi ThreatType lub wartościami wyliczenia ThreatAttribute, które zostały uznane przez klienta za nieprawidłowe. Dlatego obowiązkiem klienta jest sprawdzenie poprawności wszystkich wartości wyliczeniowych ThreatType i ThreatAttribute. Jeśli którakolwiek wartość zostanie uznana za nieprawidłową, klient MUSI zignorować cały komunikat FullHashDetail.

Pola
threat_type

ThreatType

Rodzaj zagrożenia. To pole nigdy nie jest puste.

attributes[]

ThreatAttribute

Lista nieuporządkowana. Atrybuty dodatkowe dotyczące tych pełnych haszów. To pole może być puste.

GetHashListRequest

Żądanie uzyskania listy skrótów, która może być listą zagrożeń lub listą innych, takich jak globalna pamięć podręczna.

Nowości w wersji 5: nazwa znanego wcześniej jako states w wersji 4 została zmieniona na version, aby była bardziej zrozumiała. Listy mają teraz nazwy, a typy platform i typy wpisów zagrożeń zostały usunięte. Obecnie może się zdarzyć, że wiele list będzie miało ten sam typ zagrożenia lub 1 lista z wieloma typami zagrożeń. Klienty mają nową możliwość określenia wymaganej długości skrótu. Jest to jedna z odpowiedzi na prefiksy skrótów o zmiennej długości w wersji 4, które powodowały problemy w wielu implementacjach klienckich: wszystkie hasze na liście mają teraz tę samą długość, co pozwala na znacznie bardziej wydajne implementacje klienckie. Ograniczenia zostały uproszczone, a typ kompresji jest usunięty (kompresja jest zawsze stosowana).

Pola
name

string

Wymagane. Nazwa tej konkretnej listy skrótów. Może to być lista zagrożeń lub globalna pamięć podręczna.

version

bytes

Wersja listy skrótów, którą klient już ma. Jeśli klient po raz pierwszy pobiera listę skrótów, to pole MUSI pozostać puste. W przeciwnym razie klient POWINIEN dostarczyć wersję otrzymaną wcześniej z serwera. Klient NIE MOŻE manipulować tymi bajtami.

Co nowego w wersji 5: w wersji 4 interfejsu API nazwaliśmy ją states, a teraz została zmieniona na version, aby była bardziej zrozumiała.

desired_hash_length

HashLength

Żądana długość prefiksu skrótu dla zwróconych haszów w bajtach. Serwer zwróci wtedy wszystkie prefiksy skrótów o podanej długości.

Różne listy skrótów mają różne wymagania dotyczące akceptowanych wartości pola desired_hash_length. Można go znaleźć w polu supported_hash_lengths w HashListMetadata. Jeśli desired_hash_length nie określi wartości w elemencie supported_hash_lengths, zostanie zwrócony błąd.

size_constraints

SizeConstraints

Ograniczenia rozmiaru listy. Jeśli go pominiesz, nie będzie żadnych ograniczeń. Ograniczenia są zalecane w przypadku wszystkich urządzeń, które mają ograniczoną moc obliczeniową, przepustowość lub miejsce na dane.

HashList

Lista haszów identyfikowanych przez ich nazwy.

Pola
name

string

Nazwa listy skrótów. Pamiętaj, że globalna pamięć podręczna to tylko lista skrótów, do której można się odwołać.

version

bytes

Wersja listy skrótów. Klient NIE MOŻE manipulować tymi bajtami.

partial_update

bool

Jeśli ma wartość true (prawda), jest to częściowa różnica obejmująca dodanie i usunięcie na podstawie tego, co klient już ma. Jeśli ma wartość false (fałsz), jest to pełna lista skrótów.

Jeśli ma wartość false (fałsz), klient MUSI usunąć dowolną wersję zapisaną lokalnie dla tej listy skrótów. Oznacza to, że wersja posiadana przez klienta jest bardzo nieaktualna lub dane klienta są prawdopodobnie uszkodzone. Pole compressed_removals będzie puste.

Jeśli ma wartość true (prawda), klient MUSI wprowadzać stopniowe aktualizacje, najpierw usuwając treści, a następnie je uzupełniając.

compressed_removals

RiceDeltaEncoded32Bit

Wersja indeksów usunięcia zakodowana w formacie delta. Każda lista skrótów zawiera na pewno mniej niż 2^32, dlatego indeksy są traktowane jako 32-bitowe liczby całkowite i zakodowane.

minimum_wait_duration

Duration

Klienci powinni odczekać co najmniej tyle czasu, aby ponownie otrzymać listę skrótów. Jeśli zostanie pominięty lub zerowy, klient POWINIEN pobrać pobieranie natychmiast, ponieważ wskazuje, że serwer ma dodatkową aktualizację do wysłania do klienta, choć ze względu na ograniczenia określone przez klienta nie było to możliwe.

metadata

HashListMetadata

Metadane dotyczące listy skrótów. To pole nie jest wypełniane przez metodę GetHashList, ale jest wypełniane przez metodę ListHashLists.

Pole sumy compressed_additions. Wersja dodania zakodowana w formacie delta. Długość prefiksów skrótów jest taka sama we wszystkich elementach na liście. Jest to wartość desired_hash_length wysłana przez klienta lub wartość wybrana przez serwer, jeśli klient pominął to pole. compressed_additions może być tylko jedną z tych wartości:
additions_four_bytes

RiceDeltaEncoded32Bit

4-bajtowe dodatki.

additions_eight_bytes

RiceDeltaEncoded64Bit

8-bajtowe dodatki.

additions_sixteen_bytes

RiceDeltaEncoded128Bit

16-bajtowe dodatki.

additions_thirty_two_bytes

RiceDeltaEncoded256Bit

32-bajtowe dodatki.

Pole sumy checksum. To jest suma kontrolna dla posortowanej listy wszystkich haszów obecnych w bazie danych po zastosowaniu podanej aktualizacji. To pole „jedno z” pozwala na użycie wielu algorytmów szyfrowania. Serwer może też pomijać to pole (jeśli nie wprowadzono żadnych aktualizacji) w celu wskazania, że klient powinien użyć istniejącej sumy kontrolnej. checksum może być tylko jedną z tych wartości:
sha256_checksum

bytes

Posortowana lista wszystkich haszów, ponownie zaszyfrowana za pomocą algorytmu SHA256.

HashListMetadata

Metadane dotyczące konkretnej listy skrótów.

Pola
threat_types[]

ThreatType

Lista nieuporządkowana. Jeśli ta lista nie jest pusta, oznacza to, że lista haszowania jest rodzajem listy zagrożeń i podaje rodzaj zagrożeń związanych z haszami lub prefiksami skrótów na tej liście. Może być pusta, jeśli wpis nie stanowi zagrożenia, tzn. reprezentuje prawdopodobnie bezpieczny typ.

likely_safe_types[]

LikelySafeType

Lista nieuporządkowana. Jeśli ta wartość nie jest pusta, wskazuje, że lista skrótów przedstawia listę prawdopodobnych bezpiecznych haszów oraz podaje sposoby, w jakie są one potencjalnie bezpieczne. To pole wyklucza się wzajemnie z polem threat_types.

mobile_optimized

bool

Określa, czy lista jest zoptymalizowana pod kątem urządzeń mobilnych (Android i iOS).

description

string

Zrozumiały dla człowieka opis tej listy. Napisano w języku angielskim.

supported_hash_lengths[]

HashLength

Obsługiwane długości skrótu dla tej listy skrótów. Każda lista skrótów obsługuje co najmniej jedną długość. Dlatego to pole nie będzie puste.

HashLength

Długość skrótów na liście skrótów.

Wartości w polu enum
HASH_LENGTH_UNSPECIFIED Nieokreślona długość. Serwer nie zwraca tej wartości w odpowiedziach na żądania klienta (w polu supported_hash_lengths), ale klient może ją wysłać na serwer (w polu desired_hash_length). W takim przypadku serwer wybierze wartość automatycznie. Klienci POWINNY wybrać wartość przez serwer.
FOUR_BYTES Każdy hasz to czterobajtowy prefiks.
EIGHT_BYTES Każdy hasz to ośmiobajtowy prefiks.
SIXTEEN_BYTES Każdy hasz to 16-bajtowy prefiks.
THIRTY_TWO_BYTES Każdy hasz to 32-bajtowy hasz o długości 32 bajtów.

LikelySafeType

Typy witryn prawdopodobnie bezpiecznych.

Zauważ, że SearchHashesResponse celowo nie zawiera LikelySafeType.

Wartości w polu enum
LIKELY_SAFE_TYPE_UNSPECIFIED Nieznany.
GENERAL_BROWSING Ta witryna jest prawdopodobnie wystarczająco bezpieczna, by przeglądać strony. Jest to też tzw. globalna pamięć podręczna.
CSD Witryna jest prawdopodobnie na tyle bezpieczna, że nie trzeba w niej uruchamiać modeli wykrywania po stronie klienta ani testów ochrony haseł.
DOWNLOAD Ta witryna jest prawdopodobnie na tyle bezpieczna, że nie trzeba sprawdzać z niej pobieranych plików.

ListHashListsRequest

Prośba o listę dostępnych list skrótów.

Pola
page_size

int32

Maksymalna liczba list skrótów do zwrócenia. Usługa może zwrócić mniejszą wartość od tej wartości. Jeśli nie określono inaczej, serwer wybierze rozmiar strony, który może być większy od liczby list skrótów, więc dzielenie na strony nie jest konieczne.

page_token

string

Token strony odebrany z poprzedniego wywołania ListHashLists. Podaj je, aby pobrać kolejną stronę.

ListHashListsResponse

Odpowiedź zawierająca metadane dotyczące list haszujących.

Pola
hash_lists[]

HashList

Listy skrótów w dowolnej kolejności. Uwzględniane są tylko metadane dotyczące list skrótów, a nie ich treść.

next_page_token

string

Token, który można wysłać jako page_token, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

RyceDeltaEncoded128-bit

Taka sama jak w funkcji RiceDeltaEncoded32Bit, ale oprócz tego koduje liczby 128-bitowe.

Pola
first_value_hi

uint64

Górne 64 bity pierwszego wpisu w zakodowanych danych (hasze). Jeśli to pole jest puste, wszystkie 64 bity mają wartość zero.

first_value_lo

fixed64

Dolne 64 bity pierwszego wpisu w zakodowanych danych (hasze). Jeśli to pole jest puste, wszystkie dolne 64 bity mają wartość zero.

rice_parameter

int32

Parametr Golomb-Rice. Gwarantujemy, że ten parametr ma wartość od 99 do 126 włącznie.

entries_count

int32

Liczba wpisów zakodowanych delta w zakodowanych danych. Jeśli zakodowana jest tylko jedna liczba całkowita, wartość wynosi 0 i pojedyncza wartość zostanie zapisana w funkcji first_value.

encoded_data

bytes

Zakodowane delta zakodowane za pomocą kodera Golomb-Rice.

RyceDeltaEncoded256-bit

Taka sama jak w funkcji RiceDeltaEncoded32Bit, ale oprócz tego koduje liczby 256-bitowe.

Pola
first_value_first_part

uint64

Pierwsze 64 bity pierwszego wpisu w zakodowanych danych (hasze). Jeśli pole jest puste, pierwsze 64 bity mają wartość zero.

first_value_second_part

fixed64

Od 65 do 128 bitów pierwszego wpisu w zakodowanych danych (haszach). Jeśli pole jest puste, wartość wszystkich bitów od 65 do 128 bitów wynosi zero.

first_value_third_part

fixed64

Od 129 do 192 bitów pierwszego wpisu w zakodowanych danych (hasze). Jeśli pole jest puste, wartość od 129 do 192 bitów ma wartość zero.

first_value_fourth_part

fixed64

Ostatnie 64 bity pierwszego wpisu w zakodowanych danych (hasze). Jeśli to pole jest puste, ostatnie 64 bity mają wartość zero.

rice_parameter

int32

Parametr Golomb-Rice. Gwarantujemy, że ten parametr ma wartość od 227 do 254 włącznie.

entries_count

int32

Liczba wpisów zakodowanych delta w zakodowanych danych. Jeśli zakodowana jest tylko jedna liczba całkowita, wartość wynosi 0 i pojedyncza wartość zostanie zapisana w funkcji first_value.

encoded_data

bytes

Zakodowane delta zakodowane za pomocą kodera Golomb-Rice.

RyceDeltaEncoded32-bit

Dane zakodowane w postaci ryżu-golomba. Używana na potrzeby haszowania lub indeksów usuwania. Każdy hasz lub indeks ma taką samą długość i wynosi dokładnie 32 bity.

Jeśli posortujemy wszystkie wpisy leksykograficznie, okaże się, że bity o wyższej kolejności nie zmieniają się tak często, jak bity niższego rzędu. Oznacza to, że jeśli weźmiemy również sąsiednie różnice między wpisami, prawdopodobieństwo wystąpienia wartości zero w bitach wyższego rzędu jest duże. To wykorzystuje wysokie prawdopodobieństwo zerowe przez wybranie określonej liczby bitów. Wszystkie bity o większym znaczeniu mają wartość 0, dlatego używamy kodowania jednoargumentowego. Zobacz pole rice_parameter.

Uwaga historyczna: kodowanie Rice-delta zostało po raz pierwszy użyte w wersji 4 tego interfejsu API. W wersji 5 wprowadziliśmy dwa istotne ulepszenia: po pierwsze dostępne jest kodowanie ryżu-delta, które jest teraz dostępne z prefiksami haszującymi dłuższymi niż 4 bajty. Po drugie, zakodowane dane są teraz traktowane jako big-endian, aby uniknąć kosztownego sortowania.

Pola
first_value

uint32

Pierwszy wpis w zakodowanych danych (hasze lub indeksy) albo, jeśli został zakodowany tylko pojedynczy prefiks lub indeks skrótu, wartość tego wpisu. Jeśli pole jest puste, wartość wynosi zero.

rice_parameter

int32

Parametr Golomb-Rice. Gwarantujemy, że ten parametr ma wartość od 3 do 30 włącznie.

entries_count

int32

Liczba wpisów zakodowanych delta w zakodowanych danych. Jeśli zakodowana jest tylko jedna liczba całkowita, wartość wynosi 0 i pojedyncza wartość zostanie zapisana w funkcji first_value.

encoded_data

bytes

Zakodowane delta zakodowane za pomocą kodera Golomb-Rice.

RyceDeltaEncoded64-bit

Taka sama jak w funkcji RiceDeltaEncoded32Bit, ale oprócz tego koduje liczby 64-bitowe.

Pola
first_value

uint64

Pierwszy wpis w zakodowanych danych (hasze) lub, jeśli zakodowany był tylko pojedynczy prefiks skrótu, wartość tego wpisu. Jeśli pole jest puste, wartość wynosi zero.

rice_parameter

int32

Parametr Golomb-Rice. Gwarantujemy, że ten parametr ma wartość od 35 do 62 włącznie.

entries_count

int32

Liczba wpisów zakodowanych delta w zakodowanych danych. Jeśli zakodowana jest tylko jedna liczba całkowita, wartość wynosi 0 i pojedyncza wartość zostanie zapisana w funkcji first_value.

encoded_data

bytes

Zakodowane delta zakodowane za pomocą kodera Golomb-Rice.

SearchHashesRequest

Żądanie zgłoszone przez klienta w celu wyszukania konkretnych prefiksów skrótów.

Służy on tylko do wyszukiwania list zagrożeń i nie obejmuje list innych niż te, które nie są zagrożeniami, takich jak globalna pamięć podręczna.

Co nowego w wersji 5: klienci nie muszą określać parametru ClientInfo ani stanów list haszowanych w swojej lokalnej bazie danych. Ma to na celu poprawę prywatności. Co więcej, klienci nie muszą wysyłać informacji o typach zagrożeń, które ich interesują.

Pola
hash_prefixes[]

bytes

Wymagane. Prefiksy skrótu do wyszukania. Klienty NIE MOGĄ wysyłać więcej niż 1000 prefiksów skrótów. Pamiętaj jednak, że zgodnie z procedurą przetwarzania adresów URL klienci NIE MUSZĄ wysyłać więcej niż 30 prefiksów haszujących.

Obecnie każdy prefiks skrótu musi mieć dokładnie 4 bajty. W przyszłości MOGĄ się uspokoić.

filter

string

Opcjonalnie. Możesz to określić, jeśli klient jest zainteresowany filtrowaniem, na przykład pobieraniem tylko konkretnych rodzajów zagrożeń. W przypadku jego pominięcia zwracane są wszystkie pasujące zagrożenia. Zdecydowanie zalecamy pominięcie tego ustawienia w celu uzyskania jak największej ochrony, jaką Bezpieczne przeglądanie może zaoferować.

Do określania filtra służy Google Common Expression Language, który znajdziesz na stronie https://github.com/google/cel-spec wraz z ogólnymi przykładami. Oto kilka przykładów, których można użyć:

Filtr "threat_type == ThreatType.SOCIAL_ENGINEERING" wymaga, aby w obrębie elementu FullHashDetail typem zagrożenia musi być SOCIAL_ENGINEERING. Identyfikator "threat_type" odnosi się do bieżącego typu zagrożenia. Identyfikator "ThreatType" odnosi się do gromadzenia wszystkich możliwych typów zagrożeń.

Filtr "threat_type in [ ThreatType.UNWANTED_SOFTWARE, ThreatType.MALWARE ]" wymaga, aby typ zagrożenia to UNWANTED_SOFTWARE lub MALWARE.

SearchHashesResponse

Odpowiedź zwrócona po wyszukaniu haszów zagrożeń.

Jeśli nic nie zostanie znalezione, serwer zwróci stan OK (kod stanu HTTP 200) i pole full_hashes jest puste, a nie zwróci stan NOT_FOUND (kod stanu HTTP 404).

Nowości w wersji 5: istnieje rozdzielenie między opcjami FullHash i FullHashDetail. W przypadku, gdy hasz reprezentuje witrynę, w której występuje wiele zagrożeń (np. MALWARE i SOCIAL_ENGINEERING), nie trzeba wysyłać pełnego haszy dwa razy niż w wersji 4. Poza tym czas trwania pamięci podręcznej został uproszczony do pojedynczego pola cache_duration.

Pola
full_hashes[]

FullHash

Lista nieuporządkowana. Nieuporządkowana lista pełnych haszów.

cache_duration

Duration

Czas trwania pamięci podręcznej po stronie klienta. Klient MUSI dodać ten czas trwania do bieżącego czasu, aby określić czas wygaśnięcia. Czas wygaśnięcia jest następnie stosowany do każdego prefiksu skrótu, którego dotyczy zapytanie klienta w żądaniu, niezależnie od tego, ile pełnych haszów jest zwróconych w odpowiedzi. Nawet jeśli serwer nie zwraca pełnych haszów dla konkretnego prefiksu skrótu, ta informacja MUSI też znajdować się w pamięci podręcznej klienta.

Jeśli pole full_hashes jest puste, klient MOŻE zwiększyć cache_duration, aby określić nowy okres ważności, który przypada później niż wartość określona przez serwer. W każdym przypadku wydłużony czas trwania pamięci podręcznej nie może być dłuższy niż 24 godziny.

Ważne: klient NIE MOŻE zakładać, że serwer zwróci ten sam czas trwania pamięci podręcznej dla wszystkich odpowiedzi. Serwer MOŻE wybrać różne czasy trwania pamięci podręcznej dla różnych odpowiedzi w zależności od sytuacji.

SizeConstraints

Ograniczenia dotyczące rozmiarów list haszowania.

Pola
max_update_entries

int32

Maksymalny rozmiar w liczbie wpisów. Aktualizacja nie będzie zawierać więcej pozycji niż ta wartość, ale może zawierać mniej wpisów niż ta wartość. Wymagana jest wartość co najmniej 1024. Jeśli zostanie pominięty lub zerowy, limit rozmiaru aktualizacji nie zostanie ustawiony.

max_database_entries

int32

Określa maksymalną liczbę pozycji, które klient może mieć w lokalnej bazie danych na potrzeby listy. (Serwer MOŻE spowodować, że klient zapisze mniej wpisów niż wynosi ta liczba). Jeśli zostanie pominięty lub zerowy, limit rozmiaru bazy danych nie zostanie ustawiony.

ThreatAttribute

Cechy gróźb. Te atrybuty mogą nadać dodatkowe znaczenie określonemu zagrożeniu, ale nie mają wpływu na jego typ. Na przykład atrybut może określać niższy poziom ufności, a inny – wyższy. W przyszłości możemy dodać więcej atrybutów.

Wartości w polu enum
THREAT_ATTRIBUTE_UNSPECIFIED Nieznany atrybut. Jeśli zostanie ona zwrócona przez serwer, klient całkowicie zignoruje treść FullHashDetail.
CANARY Wskazuje, że obiektu threat_type nie należy używać do egzekwowania zasad.
FRAME_ONLY Wskazuje, że atrybut threat_type powinien być używany tylko do egzekwowania zasad dotyczących ramek.

ThreatType

Typy zagrożeń.

Wartości w polu enum
THREAT_TYPE_UNSPECIFIED Nieznany typ zagrożenia. Jeśli zostanie ona zwrócona przez serwer, klient całkowicie zignoruje treść FullHashDetail.
MALWARE

Rodzaj zagrożenia związany ze złośliwym oprogramowaniem. Termin „złośliwe oprogramowanie” odnosi się do programów komputerowych lub aplikacji mobilnych zaprojektowanych specjalnie w celu zaszkodzenia użytkownikom lub zakłócania pracy komputera, urządzenia mobilnego bądź zainstalowanych na nim aplikacji. Działanie złośliwego oprogramowania objawia się instalowaniem programów bez zgody użytkownika lub instalowaniem szkodliwych aplikacji, np. wirusów.

Więcej informacji znajdziesz tutaj.

SOCIAL_ENGINEERING

Rodzaj zagrożenia związany z inżynierią społeczną. Strony stosujące inżynierię społeczną fałszywie sugerują, że działają w imieniu osoby trzeciej w celu skłonienia widzów do wykonania czynności, którą widz zaufałby wyłącznie prawdziwemu przedstawicielowi tej firmy. Phishing (wyłudzanie informacji) to rodzaj inżynierii społecznej, który polega na nakłonieniu widza do wykonania określonej czynności polegającej na udostępnieniu informacji, takich jak dane logowania.

Więcej informacji znajdziesz tutaj.

UNWANTED_SOFTWARE Typ zagrożenia związanego z niechcianym oprogramowaniem. Niechciane oprogramowanie to takie, które nie jest zgodne z zasadami Google dotyczącymi oprogramowania, ale nie jest złośliwym oprogramowaniem.
POTENTIALLY_HARMFUL_APPLICATION Potencjalnie szkodliwy rodzaj zagrożenia dla aplikacji wykorzystywany przez Google Play Protect w Sklepie Play.