Używanie Sprawdzania aplikacji z dostawcą debugowania na platformach Apple

Jeśli po zarejestrowaniu aplikacji w usłudze App Check chcesz uruchomić swoją aplikację w środowisku, które zwykle nie jest przez usługę App Check uznawane za prawidłowe, np. w symulatorze lub na urządzeniu podczas programowania albo w środowisku ciągłej integracji (CI), możesz utworzyć kompilację debugowania aplikacji, która będzie używać dostawcy debugowania App Check zamiast prawdziwego dostawcy atestów.

Używanie dostawcy debugowania podczas programowania

Aby używać dostawcy debugowania podczas interaktywnego uruchamiania aplikacji (np. podczas programowania), wykonaj te czynności:

1. W kompilacji debugowania przed użyciem jakichkolwiek usług backendu Firebase utwórz i ustaw App Check fabrykę dostawcy debugowania:

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

2. Uruchom aplikację. Gdy pakiet SDK spróbuje wysłać żądanie do backendu, zostanie zarejestrowany lokalny token debugowania. Przykład:

   <Warning> [AppCheckCore][I-GAC004001] App Check debug token:
   '123a4567-b89c-12d3-e456-789012345678'.

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

4. Zarejestruj token debugowania, który został właśnie zarejestrowany.

   1. W rozszerzonym menu aplikacji kliknij Zarządzaj tokenami debugowania.
   2. Aby zarejestrować token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

   

Po zarejestrowaniu tokena usługi backendu Firebase będą go akceptować jako prawidłowy.

Ten token umożliwia dostęp do zasobów Firebase bez prawidłowego urządzenia, dlatego musisz zachować go w tajemnicy. Nie przesyłaj go do publicznego repozytorium, a jeśli zarejestrowany token zostanie naruszony, natychmiast go odwołaj w Firebase konsoli.

Używanie dostawcy debugowania w środowisku CI

Aby używać dostawcy debugowania w środowisku ciągłej integracji (CI), wykonaj te czynności:

1. W konsoli Firebase otwórz Zabezpieczenia > Sprawdzanie aplikacji > Aplikacje.

2. Utwórz token debugowania. Będzie on potrzebny w następnym kroku.

   1. W rozszerzonym menu aplikacji kliknij Zarządzaj tokenami debugowania.
   2. Aby utworzyć nowy token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

   Ten token umożliwia dostęp do zasobów Firebase bez prawidłowego urządzenia, dlatego musisz zachować go w tajemnicy. Nie przesyłaj go do publicznego repozytorium, a jeśli zarejestrowany token zostanie naruszony, natychmiast go odwołaj w Firebase konsoli.

   

3. Dodaj utworzony token debugowania do bezpiecznego magazynu kluczy systemu CI (np. zaszyfrowanych tajnych danych GitHub Actions lub zaszyfrowanych zmiennych Travis CI ).

4. W razie potrzeby skonfiguruj system CI tak, aby token debugowania był dostępny w środowisku CI jako zmienna środowiskowa. Nazwij zmienną np. APP_CHECK_DEBUG_TOKEN_FROM_CI.

5. W Xcode dodaj do schematu testowania zmienną środowiskową o nazwie AppCheckDebugToken i wartości np. $(APP_CHECK_DEBUG_TOKEN).

6. Skonfiguruj scenariusz testowania CI tak, aby przekazywał token debugowania jako zmienną środowiskową. Przykład:

   xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
   APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)

7. W kompilacji debugowania przed użyciem jakichkolwiek usług backendu Firebase utwórz i ustaw App Check fabrykę dostawcy debugowania:

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

Gdy aplikacja jest uruchamiana w środowisku CI, usługi backendu Firebase akceptują wysyłany przez nią token jako prawidłowy.