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 i raportowania interfejsu API oraz aby 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 w chmurze Google Cloud, aby korzystać z interfejsu API i monitorować wykorzystanie. Jest to obowiązkowy pierwszy krok w przypadku wszystkich integracji. Interfejs Play Integrity API możesz włączyć w konsoli Google Cloud. Możesz też od razu pominąć ten krok i połączyć swój projekt w chmurze z Google Play, a interfejs Play Integrity API zostanie włączony automatycznie.

W konsoli Google Cloud utwórz nowy projekt w chmurze lub wybierz istniejący, którego chcesz używać z 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 ze swoją aplikacją. Aby uzyskać dostęp do funkcji zaawansowanych i zwiększonych limitów, musisz przejść do kroku dotyczącego łączenia.

Połącz z Google Play (zalecane)

Aby połączyć projekt Google Cloud z aplikacją lub pakietem SDK, postępuj zgodnie z tymi instrukcjami.

Na aplikacje i gry 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 Chronione przez Google Play.
3. Obok opcji Play Integrity API kliknij przycisk Rozpocznij, aby przejść do ustawień interfejsu Play Integrity API.
4. Kliknij przycisk Połącz z projektem w chmurze.
5. 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 on automatycznie włączony po połączeniu.

Dla dostawców pakietów SDK w Play SDK Console

Dostawcy pakietów SDK korzystający z Google Play SDK Console mogą połączyć swój projekt w chmurze Google, aby przypisać użycie interfejsu API do pakietu SDK, a nie do poszczególnych aplikacji, które go używają, 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 Integralność pakietu SDK.
3. W sekcji Play Integrity API kliknij Połącz z projektem w chmurze.
4. Wybierz projekt w chmurze 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 on włączony automatycznie po połączeniu.

Limity wykorzystania interfejsu Play Integrity API

Aplikacja lub pakiet SDK mają domyślny limit dzienny wynoszący 10 tys. żądań, który jest powiązany z numerem projektu w chmurze. Jeśli spodziewasz się większej liczby, możesz poprosić o zwiększenie limitu.

Zwiększanie maksymalnej liczby żądań dziennie

Zwiększenie limitu zależy od kryteriów kwalifikacji. Zwiększenie limitu dotyczy zarówno wywołań generowania tokenów po stronie klienta, jak i wywołań odszyfrowywania po stronie serwera. Przetwarzanie próśb może potrwać do tygodnia. Zalecamy monitorowanie wykorzystania interfejsu Play Integrity API w konsoli Google Cloud i ustawienie alertów dotyczących limitów, 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ę i ograniczać wykorzystanie danych przez użytkownika.

Na aplikacje i gry w Google Play

Aby kwalifikować się do zwiększenia limitu, aplikacja musi być dostępna w Google Play i ewentualnie innych kanałach dystrybucji. Musisz połączyć projekt Google Cloud ze swoją 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 w chmurze Google Cloud w Konsoli Play.
2. Sprawdź, czy logika interfejsu API została prawidłowo wdrożona, w tym odpowiednie strategie ponownych prób.
3. Prześlij formularz prośby o zwiększenie limitu.

Dla dostawców pakietów SDK w 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 w chmurze. 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 dla deweloperów.

W komentarzach podaj szczegóły dotyczące pakietu SDK, opisz przypadek użycia, typ wysyłanych żądań do interfejsu API (standardowe, klasyczne lub oba), częstotliwość wysyłania żądań i maksymalną dzienną liczbę żądań, którą chcesz uzyskać.

Integracja 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 opisano, jak zintegrować i skonfigurować interfejs Google Play Integrity API w projektach Unity. Znajdziesz tam informacje o obsługiwanych wersjach Unity, metodach instalacji i konfiguracji środowiska.

Obsługiwane wersje Unity

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

Konfigurowanie środowiska programistycznego

openupm add com.google.play.integrity

Unreal Engine

W sekcjach poniżej opisano, 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 nowsze wersje.

Konfigurowanie środowiska programistycznego

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

2. Skopiuj folder GooglePlay do folderu Plugins w projekcie Unreal Engine.

3. Otwórz projekt 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");
   
       // ...
     }
   }
   

Natywna

Postępuj zgodnie z instrukcjami konfiguracji natywnej. Więcej informacji znajdziesz w dokumentacji interfejsu Play Integrity API.

Konfigurowanie odpowiedzi interfejsu API (opcjonalnie)

Odpowiedź interfejsu API zawiera domyślne oceny zwracane w każdym żądaniu. Jeśli masz połączony projekt w chmurze w Konsoli Play lub 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 wyrażasz zgodę na otrzymywanie dodatkowej etykiety w ocenie integralności urządzenia:

Opcjonalne oceny integralności

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

Aby wprowadzić zmiany, otwórz Konsolę Play i przejdź do sekcji Chronione przez Google Play. Obok Play Integrity API kliknij Zarządzaj. Kliknij Zmień odpowiedzi, wprowadź zmiany i je zapisz.

Informacje o urządzeniu

Dodatkowe etykiety urządzenia w ocenie deviceIntegrity zawierają więcej informacji o środowisku urządzenia, na którym działa aplikacja. Jedno urządzenie zwraca wiele etykiet, jeśli spełnia kryteria każdej z nich. Możesz użyć tych etykiet, aby utworzyć wielopoziomową strategię egzekwowania zasad. Możesz na przykład zdecydować, że bardziej ufasz 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ć rozszerzony o inne atrybuty urządzeń.

Ostatnia aktywność na urządzeniach zwraca poziom od LEVEL_1 (mała 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 nieuczciwego rozpowszechniania na niezaufanych urządzeniach.

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

Gdy wyrazisz zgodę na otrzymywanie informacji opcjonalnych, odpowiedź interfejsu API będzie zawierać nowe pola i odpowiedzi w ocenie:

Szczegóły środowiska

Ryzyko dotyczące dostępu do aplikacji wskazuje, 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 otrzymywanie informacji opcjonalnych, odpowiedź interfejsu API będzie zawierać nowe pola i odpowiedzi w ocenie:

Konfigurowanie ustawień żądań klasycznych (opcjonalnie)

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

Domyślnie to Google Play zarządza szyfrowaniem odpowiedzi, co oznacza, że Twój backend wywołuje serwer Google, aby odszyfrować oceny. Możesz też samodzielnie zarządzać kluczami, aby odszyfrowywać dane lokalnie w bezpiecznym środowisku serwera.

Chcę, aby moje klucze szyfrowania odpowiedzi były zarządzane przez Google (zalecane)

Zalecamy zezwolenie Google na generowanie kluczy i zarządzanie nimi, aby chronić bezpieczeństwo aplikacji. Twój backend 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 Play 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ąć zakłóceń.

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

1. Otwórz Konsolę Play i wybierz aplikację .
2. Otwórz stronę Chronione przez Google Play.
3. Obok Play Integrity API kliknij Zarządzaj.
4. W sekcji Żądania klasyczne obok opcji Szyfrowanie odpowiedzi kliknij Edytuj.

Aby przełączyć się 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ć lokalnie za pomocą tych kluczy.

Aby przełączyć się 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.