Wykrywanie powtarzających się przypadków nadużyć za pomocą funkcji przywracania urządzenia (beta)

Na tej stronie opisano, jak używać zapamiętywania urządzenia do przechowywania i pobierania danych niestandardowych na określonych urządzeniach. Możesz niezawodnie przywoływać dane niestandardowe później, gdy aplikacja zostanie zainstalowana na tym samym urządzeniu, nawet po jego zresetowaniu. Umożliwia to wykrywanie i zapobieganie ponownemu użyciu urządzenia na podstawie określonego działania lub zachowania, przy jednoczesnym zachowaniu prywatności użytkownika.

Jak działa zapamiętywanie urządzenia?

Zapamiętanie urządzenia umożliwia aplikacjom przechowywanie i odczytywanie danych niestandardowych powiązanych z konkretnym urządzeniem w taki sposób, aby zachować prywatność użytkownika. Dane są przechowywane na serwerach Google, dzięki czemu aplikacja może niezawodnie przywoływać dane niestandardowe nawet po ponownej instalacji aplikacji lub zresetowaniu urządzenia. Możesz na przykład użyć tej funkcji do przywrócenia urządzeń, na których wykryto dowody poważnego nadużycia, urządzeń, na których wykorzystano już przedmioty o wysokiej wartości (np. bezpłatny okres próbny), lub urządzeń, które są wielokrotnie używane do tworzenia nowych kont w celu nadużycia. Zapamiętanie urządzenia chroni prywatność użytkownika, ponieważ aplikacja wysyłająca żądanie może przywołać tylko ograniczone dane powiązane z urządzeniami, bez dostępu do identyfikatorów urządzeń lub użytkowników. Po włączeniu zapamiętywania urządzenia możesz wykonać te czynności:

  • Odczytywanie danych z poszczególnych urządzeń: po uzyskaniu oceny integralności możesz odczytać 3 niestandardowe wartości lub bity z każdego urządzenia. Możesz samodzielnie określić znaczenie tych wartości. Możesz na przykład traktować je jako 3 osobne flagi lub połączyć je, aby reprezentowały 8 etykiet niestandardowych.
  • Modyfikowanie danych na urządzeniu: po uzyskaniu tokena integralności możesz go użyć, aby wykonać wywołanie po stronie serwera do serwera Google Play i zmodyfikować co najmniej 1 wartość. Na wykorzystanie tokena masz 14 dni. Dzięki temu możesz zmienić wartość, jeśli na przykład nadużycie stanie się widoczne dopiero w ciągu 2 tygodni od pierwszego sprawdzenia integralności. Gdy zmienisz wartość, zapisywany jest też miesiąc i rok, w którym wprowadzono zmianę.

Wymagania wstępne i kwestie do rozważenia dotyczące zapamiętywania urządzenia

Zapamiętanie urządzenia może służyć tylko do przechowywania i przywoływania informacji w celu ochrony bezpieczeństwa aplikacji oraz ograniczania nadużyć, oszustw i nieautoryzowanego dostępu. Nie możesz używać zapamiętywania urządzenia do identyfikowania ani śledzenia poszczególnych użytkowników lub urządzeń. Nie możesz też używać tej funkcji do śledzenia poufnych cech użytkowników lub urządzeń, takich jak płeć, wiek czy dane o lokalizacji.

Aby korzystać z funkcji zapamiętania urządzenia, musisz spełnić te wymagania:

  • Z funkcji zapamiętania urządzenia można korzystać na telefonach, tabletach, urządzeniach składanych, telewizorach, urządzeniach z Wear OS i w samochodach. Na Wear OS funkcja zapamiętania urządzenia jest dostępna tylko na urządzeniach z systemem Wear OS 5 lub nowszym. Zapamiętanie urządzenia nie jest obsługiwane na emulatorach.
  • Zapamiętanie urządzenia wymaga zainstalowania i włączenia na urządzeniu najnowszych wersji Sklepu Google Play i Usług Google Play.
  • Zapamiętanie urządzenia wymaga, aby konto użytkownika miało licencję Google Play. W przeciwnym razie ocena nie zostanie przeprowadzona.

W przypadku zapamiętywania urządzenia należy wziąć pod uwagę te kwestie związane z czasem:

  • Po zweryfikowaniu tokena integralności masz do 14 dni na użycie go do przechowywania niestandardowych danych zapamiętania urządzenia.
  • Zapamiętanie urządzenia obejmuje sygnatury czasowe, dzięki czemu możesz traktować ostatnio zmodyfikowane dane jako dane o wyższym priorytecie niż dane, które zostały zmodyfikowane dawno temu. Rozważ ignorowanie lub resetowanie danych po upływie wystarczająco długiego czasu, aby uwzględnić fakt, że urządzenia mogą zmieniać właścicieli lub zostać odnowione i odsprzedane.
  • Bity wycofania urządzenia będą przechowywane przez 3 lata od ostatniego dostępu do odczytu lub zapisu.
  • Jeśli chcesz usunąć wszystkie dane powiązane z urządzeniem, aplikacja może zresetować wszystkie 3 wartości na tym urządzeniu do wartości „false”. Spowoduje to automatyczne zresetowanie sygnatur czasowych.

W przypadku deweloperów, którzy mają wiele aplikacji lub przenoszą aplikacje, zapamiętanie urządzenia działa w ten sposób:

  • Wszystkie aplikacje na Twoim koncie dewelopera w Google Play mają dostęp do tych samych 3 wartości na urządzeniu. Innymi słowy, jeśli jedna z Twoich aplikacji zmodyfikuje jedną z wartości, wszystkie Twoje aplikacje będą odczytywać zmodyfikowaną wartość, gdy zostaną zainstalowane na tym samym urządzeniu.
  • Jeśli aplikacja zostanie przeniesiona z jednego konta dewelopera na inne, funkcja zapamiętania urządzenia będzie odzwierciedlać dane na urządzeniu z nowego konta dewelopera, a nie ze starego.

Włączanie zapamiętywania urządzenia

Gdy wszystko będzie gotowe, włącz zapamiętywanie urządzenia w Konsoli Play:

  1. Zaloguj się w Konsoli Play.
  2. Wybierz aplikację, która będzie korzystać z zapamiętywania urządzenia.
  3. W menu po lewej stronie kliknij Chronione przez Google Play.
  4. Obok opcji Play Integrity API kliknij Zarządzaj.
  5. W sekcji Odpowiedzi na stronie kliknij Zmień odpowiedzi.
  6. Włącz zapamiętywanie urządzenia.
  7. Kliknij Zapisz zmiany.

Gdy włączysz lub wyłączysz zapamiętywanie urządzenia, wszystkie odpowiedzi testowe interfejsu Play Integrity API skonfigurowane w Konsoli Play zostaną usunięte i będzie trzeba utworzyć je ponownie.

Odczytywanie wartości zapamiętania urządzenia

Funkcja zapamiętania urządzenia działa zarówno w przypadku żądań klasycznych, jak i standardowych interfejsu Play Integrity API. W przypadku żądań standardowych zapamiętanie urządzenia jest odświeżane podczas wywołania wstępnego. Innymi słowy, po zmodyfikowaniu danych na urządzeniu musisz przeprowadzić kolejną rozgrzewkę, aby zobaczyć zaktualizowaną wartość. Po włączeniu zapamiętywania urządzenia będziesz mieć możliwość odczytywania wartości zapamiętywania urządzenia w ocenach integralności.

Modyfikowanie wartości zapamiętania urządzenia

Wartości zapamiętania urządzenia możesz modyfikować, wykonując wywołanie interfejsu API między serwerami, podobnie jak w przypadku dekodowania oceny integralności. Ustawienie bitu na true spowoduje też zaktualizowanie daty zapisu (nawet jeśli była już ustawiona na true). Ustawienie bitu na false spowoduje zresetowanie daty zapisu do wartości pustej. Wszystkie bity, które nie zostały określone w żądaniu, pozostaną niezmienione. Między zapisaniem bitów a możliwością ich odczytania w werdykcie występuje niewielkie opóźnienie propagacji. Opóźnienie może wynosić do 30 sekund, ale zwykle jest znacznie krótsze. Żądania zapisu zapamiętania urządzenia powinny być rzadsze niż żądania tokena integralności. Nie wliczają się do limitu żądań tokenów integralności, ale podlegają osobnym limitom liczby żądań.

playintegrity.googleapis.com/v1/PACKAGE_NAME/deviceRecall:write -d \
'{
  "integrityToken": "INTEGRITY_TOKEN",
  "newValues": {
    "bitFirst": true,
    "bitThird": false
  }
}'
newValues.BitFirst = true // ForceSendFields optional for value true
newValues.BitSecond = false // ForceSendFields required for value false
newValues.BitThird = nil // do not set ForceSendFields for unspecified bits
newValues.ForceSendFields = []string{"BitSecond"}