Comienza a usar la Verificación de aplicaciones para el Acceso con Google en iOS

En esta página, se muestra cómo habilitar la Verificación de aplicaciones en una app para iOS. Cuando habilitas la Verificación de aplicaciones, ayudas a garantizar que solo tu app pueda acceder a los extremos de OAuth 2.0 de Google en nombre de tu proyecto. Consulta una descripción general de esta función.

La Verificación de aplicaciones usa App Attest para verificar que las solicitudes de OAuth 2.0 provengan de tu app auténtica. La Verificación de aplicaciones no usa App Attest para analizar riesgos de fraude.

Antes de comenzar

  1. Asegúrate de tener Xcode 12.5 o una versión más reciente.

  2. Integra el Acceso con Google en tu app para iOS mediante la biblioteca de Acceso con Google.

1. Configura tu proyecto

  1. Debes tener un proyecto de Firebase para usar la Verificación de aplicaciones mediante Acceso con Google.

    • Si tu app ya usa Firebase, utiliza el mismo proyecto.

    • Si tu app usa el Acceso con Google, pero no Firebase, ya tienes un proyecto de Google Cloud. Para agregar Firebase a tu proyecto de Google Cloud, selecciónalo cuando crees un proyecto nuevo en Firebase console.

    Consulta también: Relación entre los proyectos de Firebase y Google Cloud

  2. Si aún no lo has hecho, agrega tus apps para iOS a tu proyecto de Firebase en la página Configuración del proyecto de Firebase console.

  3. Registra tus apps para que usen la Verificación de aplicaciones mediante el proveedor de App Attest en la sección Verificación de aplicaciones de Firebase console.

  4. Asegúrate de que todos los clientes de OAuth de tu proyecto estén vinculados a una app.

    Si desvinculaste clientes, verás un mensaje en la sección Google Identity para iOS de la página Verificación de aplicaciones que dice: Tienes n clientes de OAuth desvinculados que requieren una configuración adicional.

    Además, si borraste algunos clientes de OAuth después de configurarlos en la Verificación de aplicaciones, verás un mensaje que dice: Tienes n anulaciones sin un cliente de OAuth que coincida. Para realizar una limpieza de forma segura, borra esas anulaciones.

    Puedes vincular clientes desvinculados con una app nueva o existente en la página clientes de OAuth de Firebase console.

2. Agrega la biblioteca beta de Acceso con Google a tu app

  1. En tu proyecto de Xcode, configura la dependencia de Acceso con Google en la versión 7.1.0-fac-beta-1.1.0:

    SPM

    Establece la regla de dependencia de googlesignin-ios en la versión exacta: 7.1.0-fac-beta-1.1.0.

    CocoaPods

    Actualiza tu Podfile:

    source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/firebase/SpecsDev.git'

target 'YourAppName' do
  use_frameworks!

  pod 'GoogleSignIn',
      :git => 'https://github.com/google/GoogleSignIn-iOS.git',
      :tag => '7.1.0-fac-beta-1.1.0'
  pod 'GoogleSignInSwiftSupport'  # If you use SwiftUI.
end

    Luego, ejecuta pod install y abre el archivo .xcworkspace creado.

  2. En Xcode, agrega la función de App Attest a tu app.

  3. En el archivo .entitlements de tu proyecto, configura el entorno de App Attest como production.

3. Inicializa la Verificación de aplicaciones

En el método didFinishLaunchingWithOptions del delegado de la app, llama a GIDSignIn.sharedInstance.configure(completion:). Debes llamar a este método lo antes posible en el ciclo de vida de tu app para minimizar la latencia percibida por el usuario.

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

  // ...
}

Próximos pasos

Una vez que esté instalada la biblioteca de la Verificación de aplicaciones en la app, comienza a distribuir la app actualizada a tus usuarios.

La app cliente actualizada comenzará a enviar tokens de la Verificación de aplicaciones junto con cada solicitud que realice a los extremos de autenticación de Google, pero los extremos no exigirán que los tokens sean válidos hasta que habilites la aplicación forzosa en la sección de la Verificación de aplicaciones de Firebase console.

Supervisa las métricas

Sin embargo, antes de habilitar la aplicación forzosa, debes asegurarte de que esto no interrumpa a tus usuarios legítimos existentes. Por otro lado, si ves un uso sospechoso de los recursos de tu app, te convendrá habilitar la aplicación más pronto.

Para ayudarte a tomar esta decisión, puedes consultar las métricas de la Verificación de aplicaciones para el Acceso con Google.

Habilita la aplicación forzosa de la Verificación de aplicaciones

Cuando comprendas cómo la Verificación de aplicaciones afectará a los usuarios y cuentes con todo lo necesario para continuar, puedes habilitar la aplicación forzosa de la Verificación de aplicaciones.

Usa la Verificación de aplicaciones en entornos de depuración

Si, después de registrar la app para la Verificación de aplicaciones, quieres ejecutarla en un entorno que la Verificación de aplicaciones normalmente no clasificaría como válido, como un simulador durante el desarrollo o desde un entorno de integración continua (CI), puedes crear una compilación de depuración de la app que use el proveedor de depuración de la Verificación de aplicaciones en lugar de App Attest.

Consulta Usa la Verificación de aplicaciones mediante el proveedor de depuración.