Pierwsze kroki w Sprawdzaniu aplikacji pod kątem Logowania przez Google na iOS

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

  1. Upewnij się, że masz Xcode w wersji 12.5 lub nowszej.

  2. 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 (*).
Aby włączyć sprawdzanie aplikacji, w widoku edycji klienta na iOS włącz przycisk przełączania Chroń klienta OAuth przed nadużyciami przy pomocy funkcji Sprawdzanie aplikacji Firebase.

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

  1. 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.

  2. Jeśli nie masz jeszcze dodanych aplikacji na iOS do projektu Firebase, zrób to na stronie Ustawienia projektu w konsoli Firebase.

  3. Zarejestruj swoje aplikacje, aby korzystać z funkcji Sprawdzanie aplikacji z dostawcą App Attest w sekcji Sprawdzanie aplikacji w konsoli Firebase.

  4. 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

  1. W projekcie Xcode ustaw zależność logowania przez Google na wersję 8.0.0 lub nowszą :

    menedżer ds. partnera strategicznego

    Ustaw regułę zależności googlesignin-ios na wersję 8.0.0 lub 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.
    end
    

    Następnie uruchom pod install i otwórz utworzony plik .xcworkspace.

  2. W Xcode dodaj do aplikacji funkcję App Attest.

  3. W pliku .entitlements projektu ustaw środowisko App Attest na production.

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.