Na tej stronie dowiesz się, jak włączyć Sprawdzanie aplikacji w aplikacji na iOS. Gdy włączysz Sprawdzanie aplikacji, tylko Twoja aplikacja będzie mogła uzyskiwać dostęp do punktów końcowych OAuth 2.0 Google w imieniu Twojego projektu. Zapoznaj się z omówieniem tej funkcji.
Sprawdzanie aplikacji korzysta z funkcji App Attest, aby potwierdzić, że żądania OAuth 2.0 pochodzą z Twojej autentycznej aplikacji. Sprawdzanie aplikacji nie używa funkcji App Attest do analizowania ryzyka oszustwa.
Zanim zaczniesz
Upewnij się, że masz Xcode w wersji 12.5 lub nowszej.
Zintegruj funkcję Zaloguj się przez Google z aplikacją na iOS, korzystając z biblioteki Zaloguj się przez Google.
1. Konfigurowanie projektu
Sprawdzanie aplikacji można włączyć w Konsoli interfejsów API Google lub w konsoli Firebase. Nie trzeba włączać tej opcji w obu miejscach, wystarczy w jednym.
Konsola interfejsów API Google
Aby można było włączyć Sprawdzanie aplikacji dla klienta iOS, muszą zostać spełnione te wymagania:- Musisz podać identyfikator zespołu dla klienta iOS.
- W identyfikatorze pakietu nie wolno używać symbolu wieloznacznego, ponieważ może on wskazywać więcej niż 1 aplikację. Oznacza to, że identyfikator pakietu nie może zawierać gwiazdki (*).
Po włączeniu Sprawdzania aplikacji w widoku edycji klienta OAuth zaczniesz widzieć dane dotyczące żądań OAuth pochodzących od Twojego klienta. Żądania z niezweryfikowanych źródeł nie będą blokowane, dopóki nie wymusisz sprawdzania aplikacji. Informacje na stronie monitorowania danych mogą pomóc Ci określić, kiedy rozpocząć egzekwowanie zasad.
Podczas włączania funkcji Sprawdzanie aplikacji w aplikacji na iOS mogą pojawić się błędy związane z tą funkcją. Aby je naprawić, wykonaj te czynności:
- Sprawdź, czy podane przez Ciebie identyfikatory pakietu i zespołu są prawidłowe.
- Sprawdź, czy nie używasz symbolu wieloznacznego w identyfikatorze pakietu.
Konsola Firebase
Aby korzystać z funkcji Sprawdzanie aplikacji z logowaniem przez Google, musisz mieć projekt w Firebase.
Jeśli Twoja aplikacja korzysta już z Firebase, użyj tego samego projektu.
Jeśli Twoja aplikacja korzysta z Logowania przez Google, ale nie z Firebase, masz już projekt Google Cloud. Dodaj Firebase do projektu Google Cloud, wybierając go podczas tworzenia nowego projektu w konsoli Firebase.
Zobacz też: Relacja między projektami w Firebase a Google Cloud.
Jeśli nie masz jeszcze dodanych aplikacji na iOS do projektu Firebase, zrób to na stronie Ustawienia projektu w konsoli Firebase.
Zarejestruj swoje aplikacje, aby korzystać z funkcji Sprawdzanie aplikacji z dostawcą App Attest w sekcji Sprawdzanie aplikacji w konsoli Firebase.
Upewnij się, że wszystkie klienty OAuth projektu są połączone z aplikacją.
Jeśli masz niepołączonych klientów, w sekcji Google Identity na iOS na stronie Sprawdzanie aplikacji zobaczysz komunikat „Masz n niepołączonych klientów OAuth, którzy wymagają dodatkowej konfiguracji”.
Jeśli po skonfigurowaniu niektórych klientów OAuth w Sprawdzaniu aplikacji zostały one usunięte, zobaczysz komunikat „Masz n zastąpień bez pasującego klienta OAuth”. Możesz bezpiecznie usunąć te zastąpienia.
Niepołączonych klientów możesz połączyć z istniejącą lub nową aplikacją na stronie Klienty OAuth w konsoli Firebase.
2. Dodawanie biblioteki logowania przez Google do aplikacji
W projekcie Xcode ustaw zależność logowania przez Google na wersję
8.0.0lub nowszą :menedżer ds. partnera strategicznego
Ustaw regułę zależności
googlesignin-iosna wersję8.0.0lub nowszą.CocoaPods
Zaktualizuj
Podfile:source 'https://github.com/CocoaPods/Specs.git' source 'https://github.com/firebase/SpecsDev.git' target 'YourAppName' do use_frameworks! pod 'GoogleSignIn','~> 8.0' :git => 'https://github.com/google/GoogleSignIn-iOS.git' pod 'GoogleSignInSwiftSupport' # If you use SwiftUI. endNastępnie uruchom
pod installi otwórz utworzony plik.xcworkspace.W Xcode dodaj do aplikacji funkcję App Attest.
W pliku
.entitlementsprojektu ustaw środowisko App Attest naproduction.
3. Inicjowanie Sprawdzania aplikacji
W metodzie didFinishLaunchingWithOptions delegata aplikacji wywołaj GIDSignIn.sharedInstance.configure(completion:). Tę metodę należy wywołać jak najwcześniej w cyklu życia aplikacji, aby zminimalizować opóźnienie postrzegane przez użytkownika.
import SwiftUI
import GoogleSignIn
class AppDelegate: NSObject, UIApplicationDelegate {
func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
#if targetEnvironment(simulator)
// Configure for debugging.
// See: https://developers.google.com/identity/sign-in/ios/appcheck/debug-provider
#else
GIDSignIn.sharedInstance.configure { error in
if let error {
print("Error configuring `GIDSignIn` for Firebase App Check: \(error)")
}
}
#endif
return true
}
}
@main
struct YourAppNameApp: App {
@UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
// ...
}
Dalsze kroki
Po zainstalowaniu biblioteki Sprawdzania aplikacji w aplikacji zacznij rozpowszechniać jej zaktualizowaną wersję wśród użytkowników.
Zaktualizowana aplikacja kliencka zacznie wysyłać tokeny Sprawdzania aplikacji wraz z każdym żądaniem wysyłanym do punktów końcowych uwierzytelniania Google, ale punkty końcowe nie będą wymagać, aby tokeny były prawidłowe, dopóki nie włączysz wymuszania w sekcji Sprawdzanie aplikacji w konsoli Firebase.
Monitorowanie danych
Zanim jednak włączysz egzekwowanie, upewnij się, że nie zakłóci to działania aplikacji u obecnych uprawnionych użytkowników. Jeśli jednak zauważysz podejrzane wykorzystanie zasobów aplikacji, możesz wcześniej włączyć egzekwowanie.
Aby podjąć decyzję, możesz sprawdzić dane Sprawdzania aplikacji dotyczące logowania przez Google.
Włączanie wymuszania Sprawdzania aplikacji
Gdy zrozumiesz, jak Sprawdzanie aplikacji wpłynie na użytkowników, i będziesz gotowy(-a) do dalszych działań, możesz włączyć wymuszanie Sprawdzania aplikacji.
Korzystanie ze Sprawdzania aplikacji w środowiskach debugowania
Jeśli po zarejestrowaniu aplikacji w Sprawdzaniu aplikacji chcesz uruchomić ją w środowisku, które Sprawdzanie aplikacji zwykle klasyfikuje jako nieprawidłowe, np. w symulatorze podczas programowania lub w trybie ciągłej integracji (CI), możesz utworzyć kompilację do debugowania aplikacji, która zamiast App Attest używa dostawcy debugowania Sprawdzania aplikacji.
Zobacz Korzystanie ze Sprawdzania aplikacji z dostawcą debugowania.