Konfiguracja

Z tego artykułu dowiesz się, jak skonfigurować aplikację, grę lub pakiet SDK pod kątem interfejsu Play Integrity API. Aby zintegrować interfejs API, musisz mieć projekt Google Cloud, który jest niezbędny do rozpoczęcia wysyłania żądań. Następnie możesz połączyć projekt Google Cloud w Konsoli Google Play (w przypadku aplikacji) lub w Google Play SDK Console (w przypadku pakietów SDK). Połączenie projektu jest wymagane, aby uzyskać dostęp do dodatkowych opcji konfiguracji, funkcji testowania, raportowania interfejsu API i poprosić o zwiększenie dziennego limitu żądań.

Włączanie interfejsu Play Integrity API

Każda aplikacja lub pakiet SDK wywołujący interfejs Play Integrity API musi mieć projekt Google Cloud, aby korzystać z interfejsu API i monitorować jego użycie. Jest to obowiązkowy pierwszy krok w przypadku wszystkich integracji. Interfejs Play Integrity API możesz włączyć w konsoli Google Cloud lub przejść bezpośrednio do połączenia projektu Cloud z Google Play. W tym przypadku interfejs Play Integrity API zostanie włączony automatycznie.

W konsoli Google Cloud utwórz nowy projekt Cloud lub wybierz istniejący projekt Cloud, którego chcesz używać z interfejsem Play Integrity API.

1. Otwórz Interfejsy API i usługi.
2. Kliknij Włącz interfejsy API i usługi.
3. Wyszukaj Play Integrity API.
4. Kliknij Włącz.

Możesz teraz zintegrować interfejs Play Integrity API z aplikacją. Aby uzyskać dostęp do zaawansowanych funkcji i zwiększyć limit, musisz przejść do kroku łączenia.

Łączenie z Google Play (zalecane)

Aby połączyć aplikację lub pakiet SDK z Google Play, postępuj zgodnie z tymi instrukcjami.

W przypadku aplikacji i gier w Google Play

Aplikacje rozpowszechniane w Google Play powinny połączyć swój projekt Google Cloud w Konsoli Google Play, aby włączyć dodatkowe funkcje i poprosić o zwiększenie dziennego limitu interfejsu API.

1. Otwórz Konsolę Google Play i wybierz aplikację.
2. Kliknij Testowanie i publikowanie > Integralność aplikacji.
3. W sekcji Play Integrity API kliknij Połącz z projektem w chmurze.
4. Wybierz projekt Google Cloud, którego chcesz używać z interfejsem Play Integrity API. Jeśli interfejs Play Integrity API nie jest jeszcze włączony w projekcie, zostanie włączony automatycznie po połączeniu.

Dla dostawców SDK w Google Play SDK Console

Dostawcy pakietów SDK korzystający z Google Play SDK Console mogą połączyć swój projekt Google Cloud, aby przypisywać wykorzystanie interfejsu API do pakietu SDK, a nie do poszczególnych aplikacji, które go używają. Mogą też włączyć dodatkowe funkcje i poprosić o zwiększenie dziennego limitu interfejsu API. Pamiętaj, że dostęp do Google Play SDK Console podlega kryteriom kwalifikacji.

1. Otwórz Google Play SDK Console i wybierz pakiet SDK.
2. Otwórz stronę Integralność pakietu SDK.
3. W sekcji Play Integrity API kliknij Połącz z projektem w chmurze.
4. Wybierz projekt Google Cloud, którego chcesz używać z interfejsem Play Integrity API. Jeśli interfejs Play Integrity API nie jest jeszcze włączony w tym projekcie, zostanie włączony automatycznie po połączeniu.

Limity wykorzystania interfejsu Play Integrity API

Aplikacja lub pakiet SDK ma domyślny dzienny limit 10 tys. żądań, który jest powiązany z numerem projektu w Google Cloud. Jeśli przewidujesz większą liczbę wyświetleń, możesz poprosić o zwiększenie limitu.

Zwiększanie maksymalnej dziennej liczby żądań

Zwiększenie limitu zależy od spełnienia kryteriów kwalifikacji. Zwiększenie limitu dotyczy zarówno generowania tokenów po stronie klienta, jak i wywołań odszyfrowywania po stronie serwera. Rozpatrywanie próśb może potrwać do tygodnia. Zalecamy monitorowanie wykorzystania interfejsu Play Integrity API w konsoli Google Cloud i ustawianie alertów o limicie, aby uniknąć przerw w działaniu usługi.

Nawet przy wyższym limicie nadal ograniczaj klasyczne żądania do rzadkich, wartościowych działań, aby oszczędzać baterię użytkownika i zużycie danych.

W przypadku aplikacji i gier w Google Play

Aby kwalifikować się do zwiększenia limitu, aplikacja musi być dostępna w Google Play i ewentualnie w innych kanałach dystrybucji. Musisz połączyć projekt Google Cloud z aplikacją w Konsoli Play. Prośby o zwiększenie limitu z niepołączonych projektów będą odrzucane.

Aby poprosić o zwiększenie limitu:

1. Połącz odpowiedni projekt Google Cloud w Konsoli Play.
2. Sprawdź, czy logika interfejsu API została prawidłowo zaimplementowana, w tym odpowiednie strategie ponawiania.
3. Prześlij formularz prośby o zwiększenie limitu.

Dla dostawców SDK w Google Play SDK Console

Aby kwalifikować się do zwiększenia limitu, musisz zarejestrować swój pakiet SDK w Google Play SDK Console i połączyć z nim projekt Google Cloud. Dostęp do Google Play SDK Console podlega kryteriom kwalifikacji.

Aby poprosić o zwiększenie limitu:

1. Połącz swój projekt Google Cloud w Google Play SDK Console.
2. Wypełnij formularz pomocy dotyczący Google Play SDK Console.

W sekcji komentarzy opisz swój przypadek użycia, typ wysyłanych żądań API (standardowe, klasyczne lub oba), częstotliwość wysyłania żądań oraz dzienną maksymalną liczbę żądań, którą chcesz uzyskać.

Integrowanie interfejsu Play Integrity API z aplikacją

Aby zintegrować interfejs Play Integrity API z aplikacją lub pakietem SDK, wykonaj jedną z tych czynności w zależności od środowiska programistycznego:

Kotlin lub Java

Najnowsza biblioteka na Androida dla interfejsu Play Integrity API jest dostępna w repozytorium Google Maven. Dodaj do pliku build.gradle aplikacji tę zależność:

implementation 'com.google.android.play:integrity:1.6.0'

Unity

W sekcjach poniżej znajdziesz informacje o tym, jak zintegrować i skonfigurować interfejs Google Play Integrity API w projektach Unity. Obejmują one obsługiwane wersje Unity, metody instalacji i konfigurację środowiska.

Obsługiwane wersje Unity

• Obsługiwane są wszystkie wersje 2019.x, 2020.x i nowsze.
• Jeśli korzystasz z Unity 2018.x, obsługiwane są wersje 2018.4 i nowsze.
• Gry z silnikiem Unity 2017.x i starszym nie są obsługiwane.

Konfigurowanie środowiska programistycznego

openupm add com.google.play.integrity

Unreal Engine

W kolejnych sekcjach opisujemy, jak zintegrować i skonfigurować interfejs Google Play Integrity API w projektach Unreal Engine.

Obsługiwane wersje Unreal Engine

Wtyczka obsługuje Unreal Engine 5.0 i wszystkie kolejne wersje.

Konfigurowanie środowiska programistycznego

1. Pobierz wtyczkę Play Unreal Engine Plugin z repozytorium GitHub.

2. Skopiuj folder GooglePlay w folderze Plugins w projekcie Unreal Engine.

3. Otwórz projekt w Unreal Engine i kliknij Edit → Plugins (Edytuj → Wtyczki).

4. Wyszukaj Google Play i zaznacz pole wyboru Włączone.

5. Uruchom ponownie projekt gry i aktywuj kompilację.

6. Otwórz plik Build.cs projektu i dodaj moduł PlayIntegrity do PublicDependencyModuleNames:

   using UnrealBuildTool;
   
   public class MyGame : ModuleRules
   {
     public MyGame(ReadOnlyTargetRules Target) : base(Target)
     {
       // ...
   
       PublicDependencyModuleNames.Add("PlayIntegrity");
   
       // ...
     }
   }
   

Rodzimy użytkownik

Postępuj zgodnie z przewodnikiem konfiguracji reklam natywnych. Więcej informacji znajdziesz w dokumentacji referencyjnej natywnego interfejsu API Play Integrity.

Konfigurowanie odpowiedzi interfejsu API (opcjonalnie)

Odpowiedź interfejsu API zawiera domyślne wyniki zwracane w każdym żądaniu. Jeśli masz połączony projekt Cloud w Konsoli Play lub Google Play SDK Console, możesz dostosować odpowiedź interfejsu API, aby zawierała dodatkowe informacje.

Domyślne oceny integralności

W odpowiedzi interfejsu Play Integrity API domyślnie zwracane są te oceny integralności:

Gry Google Play na PC

W przypadku rozpowszechniania treści w Grach Google Play na PC automatycznie włączona jest opcja otrzymywania dodatkowej etykiety w wyniku weryfikacji integralności urządzenia:

Opcjonalne oceny integralności

Jeśli masz połączony projekt Cloud w Konsoli Play lub Play SDK Console, możesz wyrazić zgodę na otrzymywanie dodatkowych informacji.

Aby wprowadzić zmiany, otwórz Konsolę Play i kliknij Testowanie i wdrażanie > Integralność aplikacji. Obok opcji Play Integrity API kliknij Ustawienia. Kliknij Zmień odpowiedzi, edytuj i zapisz zmiany.

Informacje o urządzeniu

Dodatkowe etykiety urządzenia w deviceIntegritywerdykcie zawierają więcej informacji o środowisku urządzenia, na którym działa aplikacja. Pojedyncze urządzenie może zwrócić wiele etykiet, jeśli spełnia kryteria każdej z nich. Za pomocą tych etykiet możesz utworzyć wielopoziomową strategię egzekwowania. Możesz na przykład bardziej ufać urządzeniu, które zwraca 3 etykiety (MEETS_STRONG_INTEGRITY, MEETS_DEVICE_INTEGRITY i MEETS_BASIC_INTEGRITY), niż urządzeniu, które zwraca tylko 1 etykietę (MEETS_BASIC_INTEGRITY).

Atrybuty urządzenia informują o wersji pakietu Android SDK systemu operacyjnego Android na urządzeniu. W przyszłości może zostać rozszerzona o inne atrybuty urządzenia.

Ostatnia aktywność na urządzeniach zwraca poziom w zakresie od LEVEL_1 (niewielka liczba żądań) do LEVEL_4 (duża liczba żądań). Wysoki poziom aktywności może wskazywać, że urządzenie jest używane do generowania nadmiernej liczby tokenów w celu ich nadużywania i rozpowszechniania na niezaufanych urządzeniach.

Przywoływanie urządzenia umożliwia przechowywanie niektórych niestandardowych danych dotyczących poszczególnych urządzeń, które można niezawodnie odzyskać, gdy aplikacja zostanie później ponownie zainstalowana na tym samym urządzeniu.

Gdy wyrazisz zgodę na udostępnianie informacji opcjonalnych, w odpowiedzi interfejsu API pojawią się nowe pola i odpowiedzi w ocenie:

Szczegóły środowiska

Ryzyko dotyczące dostępu do aplikacji informuje, czy uruchomione są inne aplikacje, które mogą przechwytywać ekran, wyświetlać nakładki lub sterować urządzeniem. Zweryfikowane usługi ułatwień dostępu, które są znane Google Play, są automatycznie wykluczane z tej oceny.

Ocena Play Protect informuje, czy usługa Google Play Protect jest włączona na urządzeniu i czy wykryła znane złośliwe oprogramowanie.

Gdy wyrazisz zgodę na udostępnianie informacji opcjonalnych, w odpowiedzi interfejsu API pojawią się nowe pola i odpowiedzi w ocenie:

Konfigurowanie ustawień żądań klasycznych (opcjonalnie)

Pomiń tę sekcję, jeśli planujesz tylko wysyłać standardowe żądania do interfejsu API.

Domyślnie Google Play zarządza szyfrowaniem odpowiedzi, co oznacza, że Twój backend łączy się z serwerem Google, aby odszyfrować wyniki. Możesz też samodzielnie zarządzać kluczami, aby odszyfrowywać dane lokalnie w bezpiecznym środowisku serwera.

Pozwól Google zarządzać szyfrowaniem odpowiedzi (zalecane)

Zalecamy zezwolenie Google na generowanie kluczy i zarządzanie nimi w celu ochrony bezpieczeństwa aplikacji. Twój serwer backendu połączy się z serwerem Google Play, aby odszyfrować i zweryfikować odpowiedzi.

Zarządzanie własnymi kluczami szyfrowania

Aby odszyfrować dane lokalnie w bezpiecznym środowisku serwera, możesz pobrać klucze szyfrowania z Konsoli Play lub SDK Console. Aby korzystać z tej funkcji, Twoja aplikacja musi być dostępna w Google Play.

Zanim zmienisz strategię zarządzania szyfrowaniem odpowiedzi w Konsoli Play, upewnij się, że serwer jest prawidłowo skonfigurowany do odszyfrowywania i weryfikowania tokenów integralności na serwerach Google Play, aby uniknąć przerw w działaniu.

Przełączanie między kluczami szyfrowania zarządzanymi przez Google a kluczami zarządzanymi samodzielnie

1. Otwórz Konsolę Play i wybierz aplikację .
2. Kliknij Testowanie i publikowanie > Integralność aplikacji.
3. Obok opcji Play Integrity API kliknij Ustawienia.
4. W sekcji Żądania klasyczne obok opcji Szyfrowanie odpowiedzi kliknij Edytuj.

Aby przejść na klucze zarządzane samodzielnie:

1. Wybierz Chcę samodzielnie pobierać klucze szyfrowania odpowiedzi i nimi zarządzać i prześlij klucz publiczny.
2. Kliknij Zapisz, aby automatycznie pobrać zaszyfrowane klucze.
3. Zaktualizuj bezpieczny serwer backendu, aby odszyfrowywał dane lokalnie za pomocą tych kluczy.

Aby przejść na klucze zarządzane przez Google:

1. Wybierz Chcę, aby moje klucze szyfrowania odpowiedzi były zarządzane przez Google (zalecane).
2. Kliknij Zapisz zmiany.