Pierwsze kroki ze Sprawdzaniem aplikacji za pomocą Play Integrity na Androidzie

Na tej stronie dowiesz się, jak włączyć App Check w aplikacji na Androida za pomocą wbudowanego dostawcy Play Integrity. Gdy włączysz App Check, pomożesz zapewnić, że tylko Twoja aplikacja będzie miała dostęp do zasobów backendu projektu. Zobacz przegląd tej funkcji.

Dostawca Play Integrity obsługuje aplikacje na Androida opublikowane w Google Play, poza Google Play lub w obu tych miejscach. Jeśli Twój przypadek użycia wymaga funkcji Play Integrity, które nie są zaimplementowane przez App Check, lub jeśli chcesz używać App Check z własnym dostawcą, zapoznaj się z artykułem Implementowanie niestandardowego dostawcy App Check.

1. Konfigurowanie projektu w Firebase

1. Dodaj Firebase do projektu aplikacji na Androida, jeśli nie korzystasz w nim jeszcze z tej usługi.

2. Włącz interfejs Play Integrity API:

   1. W Konsoli Google Play wybierz aplikację lub dodaj ją, jeśli jeszcze nie została dodana.

   2. W sekcji Wersja kliknij Integralność aplikacji.

   3. Przejdź do sekcji Play Integrity API na stronie, kliknij Połącz projekt Google Cloud, a następnie wybierz projekt Firebase z listy projektów Google Cloud. Wybrany tutaj projekt musi być tym samym projektem w Firebase, w którym rejestrujesz aplikację (patrz następny krok).

3. W konsoli Firebase otwórz Zabezpieczenia > Sprawdzanie aplikacji.

4. Na karcie Aplikacje zarejestruj aplikacje, aby używać App Check z dostawcą Play Integrity. Musisz podać odcisk cyfrowy SHA-256 certyfikatu podpisywania aplikacji.

   Zwykle musisz zarejestrować wszystkie aplikacje w projekcie, ponieważ po włączeniu egzekwowania w przypadku usługi Firebase tylko zarejestrowane aplikacje będą mogły uzyskać dostęp do zasobów backendu usługi.

5. Opcjonalnie: ustaw czas życia danych (TTL) tokena.

   W ustawieniach rejestracji aplikacji ustaw niestandardowy czas życia (TTL) tokenów App Check wydawanych przez dostawcę. Możesz ustawić TTL na dowolną wartość od 30 minut do 7 dni. Zmieniając tę wartość, pamiętaj o tych kompromisach:

   • Bezpieczeństwo: krótsze wartości TTL zapewniają większe bezpieczeństwo, ponieważ skracają czas, w którym haker może wykorzystać przejęty lub przechwycony token.
   • Wydajność: krótsze wartości TTL oznaczają, że aplikacja będzie częściej przeprowadzać atestację. Proces atestacji aplikacji zwiększa czas oczekiwania na żądania sieciowe przy każdym wykonaniu, więc krótki czas TTL może wpływać na wydajność aplikacji.
   • Limit i koszt: krótsze wartości TTL i częste ponowne atestowanie szybciej wyczerpują limit, a w przypadku usług płatnych mogą potencjalnie kosztować więcej. Zobacz Limity i ograniczenia.

   Domyślna wartość TTL wynosząca 1 godzinę jest odpowiednia dla większości aplikacji. Pamiętaj, że biblioteka App Check odświeża tokeny po upływie mniej więcej połowy czasu TTL.

Skonfiguruj ustawienia zaawansowane (opcjonalnie)

App Check oferuje szereg ustawień obsługujących zaawansowane przypadki użycia, w tym rozpowszechnianie aplikacji poza Google Play. Te ustawienia możesz skonfigurować dla każdej zarejestrowanej aplikacji na Androida na karcie App Check > Aplikacje w konsoli Firebase. Zalecamy skonfigurowanie tych ustawień zgodnie z poniższą tabelą podczas pierwszej rejestracji aplikacji.

Szczegóły

Każde ustawienie zaawansowane odpowiada etykiecie oceny Play Integrity. Więcej informacji znajdziesz w dokumentacji Play Integrity.

• Domyślnie App Check wymaga etykiety rozpoznawania aplikacji PLAY_RECOGNIZED. Aplikacje, które nie zostały opublikowane w Google Play, nie mogą otrzymać tej etykiety.
• Domyślnie App Check nie wymaga etykiety licencji aplikacji LICENSED. Tę etykietę mogą otrzymać tylko użytkownicy, którzy zainstalowali lub zaktualizowali Twoją aplikację bezpośrednio z Google Play.

• Domyślnie App Check nie sprawdza bezpośrednio stanu integralności urządzenia. App Check obsługuje sprawdzanie 3 poziomów integralności urządzenia, które są wymienione poniżej w kolejności od najniższego do najwyższego.

  • Podstawowa integralność. Powoduje, że App Check wymaga etykiety rozpoznawania urządzenia MEETS_BASIC_INTEGRITY. Aby Twoja aplikacja mogła otrzymać tę opcjonalną etykietę, musisz najpierw wyrazić na to zgodę w Konsoli Google Play.

  • Integralność urządzenia. Powoduje, że App Check wymaga etykiety rozpoznawania urządzenia MEETS_DEVICE_INTEGRITY. Wszystkie aplikacje automatycznie kwalifikują się do otrzymania tej etykiety.

  • Silna integralność. Powoduje, że App Check wymaga etykiety rozpoznawania urządzenia MEETS_STRONG_INTEGRITY. Aby Twoja aplikacja mogła otrzymać tę opcjonalną etykietę, musisz najpierw wyrazić na to zgodę w Konsoli Google Play.

2. Dodawanie biblioteki App Check do aplikacji

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:35.0.2"))

    // Add the dependencies for the App Check libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-appcheck-playintegrity")
}

Gdy korzystasz z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

dependencies {
    // Add the dependencies for the App Check libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-appcheck-playintegrity:20.0.0")
}

3. Zainicjuj App Check

Dodaj do aplikacji ten kod inicjowania, aby uruchamiał się przed użyciem innych pakietów SDK Firebase:

Firebase.initialize(context = this)
Firebase.appCheck.installAppCheckProviderFactory(
    PlayIntegrityAppCheckProviderFactory.getInstance(),
)
MainActivity.kt

FirebaseApp.initializeApp(/*context=*/ this);
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
        PlayIntegrityAppCheckProviderFactory.getInstance());
MainActivity.java

Dalsze kroki

Po zainstalowaniu biblioteki App Check w aplikacji zacznij rozpowszechniać zaktualizowaną aplikację wśród użytkowników.

Zaktualizowana aplikacja kliencka zacznie wysyłać tokeny App Check wraz z każdym żądaniem wysyłanym do Firebase, ale usługi Firebase nie będą wymagać, aby tokeny były prawidłowe, dopóki nie włączysz egzekwowania w sekcji App Check konsoli Firebase.

Monitorowanie wskaźników i włączanie egzekwowania zasad

Zanim jednak włączysz egzekwowanie, upewnij się, że nie zakłóci to działania obecnych, uprawnionych użytkowników. Jeśli jednak zauważysz podejrzane wykorzystanie zasobów aplikacji, możesz wcześniej włączyć egzekwowanie.

Aby podjąć tę decyzję, możesz sprawdzić dane App Check dotyczące usług, z których korzystasz:

• Monitorowanie danych o żądaniach App Check w przypadku Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity na iOS, Maps JavaScript API i Places API (nowego).
• Monitorowanie danych żądań App Check dla Cloud Functions.

Włącz egzekwowanie zasad App Check

Gdy zrozumiesz, jak App Check wpłynie na użytkowników, i będziesz gotowy(-a) do dalszych działań, możesz włączyć egzekwowanie App Check:

• Włącz egzekwowanie zasad App Check w przypadku: Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity na iOS, Maps JavaScript API i Places API (nowy).
• Włącz egzekwowanie App Check dla: Cloud Functions.

Używanie App Check w środowiskach debugowania

Jeśli po zarejestrowaniu aplikacji w App Check chcesz uruchomić ją w środowisku, które App Check zwykle nie klasyfikuje jako prawidłowe, np. w emulatorze podczas programowania lub w środowisku trybu ciągłej integracji, możesz utworzyć kompilację do debugowania aplikacji, która używa dostawcy debugowania App Check zamiast rzeczywistego dostawcy atestu.

Zobacz Korzystanie z App Check z dostawcą debugowania na Androidzie.