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ę do 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 do 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. Włącz logowanie debugowania w projekcie Xcode (w wersji 11.0 lub nowszej):

    1. Otwórz Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat).
    2. W menu po lewej stronie kliknij Run (Uruchom), a następnie wybierz kartę Arguments (Argumenty).
    3. W sekcji Arguments Passed on Launch (Argumenty przekazywane przy uruchamianiu) dodaj -FIRDebugEnabled.

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

    [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
123a4567-b89c-12d3-e456-789012345678

  4. W konsoli Firebase otwórz Security (Zabezpieczenia) > Sprawdzanie aplikacji.

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

    1. Na karcie Apps (Aplikacje) znajdź swoją aplikację.
    2. W rozszerzonym menu aplikacji wybierz Manage debug tokens (Zarządzaj tokenami debugowania).
    3. Aby zarejestrować token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

    Zrzut ekranu przedstawiający pozycję menu Zarządzaj tokenami debugowania

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

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

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 Security (Zabezpieczenia) > Sprawdzanie aplikacji.

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

    1. Na karcie Apps (Aplikacje) znajdź swoją aplikację.
    2. W rozszerzonym menu aplikacji wybierz Manage debug tokens (Zarządzaj tokenami debugowania).
    3. Aby utworzyć nowy token debugowania, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

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

    Zrzut ekranu przedstawiający pozycję menu Zarządzaj tokenami debugowania

  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 FIRAAppCheckDebugToken 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 do 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.