Jeśli po zarejestrowaniu aplikacji w Sprawdzaniu aplikacji chcesz ją uruchomić w środowisku, którego Sprawdzanie aplikacji normalnie nie sklasyfikowało, np. w symulatorze w trakcie tworzenia, lub w środowisku ciągłej integracji (CI), możesz utworzyć kompilację do debugowania aplikacji, która korzysta z dostawcy debugowania funkcji Sprawdzanie aplikacji zamiast z App Attest.
Korzystanie z dostawcy debugowania w symulatorze
Aby korzystać z dostawcy debugowania podczas interaktywnego uruchamiania aplikacji w symulatorze (np. podczas programowania), wykonaj te czynności:
Wyszukaj klucz interfejsu API iOS dla swojego projektu na stronie Dane logowania w sekcji Interfejsy API i usługi w konsoli Google Cloud.
W kompilacji do debugowania skonfiguruj Sprawdzanie aplikacji, aby korzystało z dostawcy debugowania. Musisz określić klucz interfejsu API uzyskany w poprzednim kroku.
#if targetEnvironment(simulator) GIDSignIn.sharedInstance.configureDebugProvider(withAPIKey: apiKey) { error in if let error { print("Error configuring `GIDSignIn` for App Check: \(error)") } } #else // Configure App Check for production. #endif
Uruchom aplikację. Gdy pakiet SDK spróbuje wysłać żądanie do backendu, w konsoli Xcode zostanie zarejestrowany lokalny token debugowania. Na przykład:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
W sekcji Sprawdzanie aplikacji w konsoli Firebase wybierz w rozszerzonym menu aplikacji Zarządzaj tokenami debugowania. Następnie zarejestruj token debugowania zapisany w poprzednim kroku.
Gdy zarejestrujesz token, punkty końcowe protokołu Google OAuth 2.0 będą go akceptować jako prawidłowe w Twoim projekcie.
Ponieważ ten token umożliwia dostęp do punktów końcowych uwierzytelniania bez ważnego urządzenia, ważne jest zachowanie jego prywatności. Nie przekazuj go w repozytorium publicznym, a jeśli któryś z zarejestrowanych tokenów zostanie naruszony, unieważnij go natychmiast w konsoli Firebase.
Korzystanie z dostawcy debugowania w środowisku CI
Aby korzystać z dostawcy debugowania w środowisku ciągłej integracji (CI), wykonaj te czynności:
W sekcji Sprawdzanie aplikacji w konsoli Firebase wybierz w rozszerzonym menu aplikacji Zarządzaj tokenami debugowania. Następnie utwórz nowy token debugowania. Będzie on potrzebny w następnym kroku.
Ponieważ ten token umożliwia dostęp do punktów końcowych uwierzytelniania bez prawidłowego urządzenia, ważne jest, aby utrzymać jego prywatność. Nie przekazuj go w repozytorium publicznym, a jeśli któryś z zarejestrowanych tokenów zostanie naruszony, unieważnij go natychmiast w konsoli Firebase.
Dodaj utworzony właśnie token debugowania do magazynu kluczy bezpiecznego systemu CI (np. zaszyfrowane obiekty tajne w działaniach GitHub lub zmienne zaszyfrowane w Travis CI).
W razie potrzeby skonfiguruj system CI tak, aby token debugowania był dostępny w środowisku CI w postaci zmiennej środowiskowej. Nadaj tej zmiennej nazwę np.
APP_CHECK_DEBUG_TOKEN_FROM_CI
.W Xcode dodaj do schematu testowania zmienną środowiskową o nazwie
FIRAAppCheckDebugToken
i wartością na przykład$(APP_CHECK_DEBUG_TOKEN)
.Skonfiguruj skrypt testowy CI tak, aby przekazywał token debugowania jako zmienną środowiskową. Na przykład:
xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \ APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)
Wyszukaj klucz interfejsu API iOS dla swojego projektu na stronie Dane logowania w sekcji Interfejsy API i usługi w konsoli Google Cloud.
W kompilacji do debugowania skonfiguruj Sprawdzanie aplikacji, aby korzystało z dostawcy debugowania. Musisz określić klucz interfejsu API uzyskany w poprzednim kroku.
#if targetEnvironment(simulator) GIDSignIn.sharedInstance.configureDebugProvider(withAPIKey: apiKey) { error in if let error { print("Error configuring `GIDSignIn` for App Check: \(error)") } } #else // Configure App Check for production. #endif
Gdy Twoja aplikacja działa w środowisku CI, punkty końcowe protokołu OAuth 2.0 Google będą akceptować token wysłany jako prawidłowy dla Twojego projektu.