Comience a usar App Check con App Attest en las plataformas de Apple

Esta página le muestra cómo habilitar App Check en una aplicación de Apple, utilizando el proveedor de App Attest integrado. Cuando habilita App Check, ayuda a garantizar que solo su aplicación pueda acceder a los recursos de Firebase de su proyecto. Vea una descripción general de esta característica.

App Check usa App Attest para verificar que las solicitudes a los servicios de Firebase provienen de su aplicación auténtica. App Check actualmente no utiliza App Attest para analizar el riesgo de fraude .

Si desea utilizar App Check con su propio proveedor personalizado, consulte Implementar un proveedor personalizado de App Check .

1. Configura tu proyecto de Firebase

1. Necesitará Xcode 12.5+ para usar App Attest.

2. Agregue Firebase a su proyecto de Apple si aún no lo ha hecho.

3. Registre sus aplicaciones para usar App Check con el proveedor App Attest en la sección App Check de Firebase console.

   Por lo general, debe registrar todas las aplicaciones de su proyecto, porque una vez que habilite la aplicación para un producto de Firebase, solo las aplicaciones registradas podrán acceder a los recursos de back-end del producto.

4. Opcional : en la configuración de registro de la aplicación, establezca un tiempo de vida (TTL) personalizado para los tokens de App Check emitidos por el proveedor. Puede establecer el TTL en cualquier valor entre 30 minutos y 7 días. Al cambiar este valor, tenga en cuenta las siguientes ventajas y desventajas:

   • Seguridad: los TTL más cortos brindan una mayor seguridad, ya que reducen la ventana en la que un atacante puede abusar de un token filtrado o interceptado.
   • Rendimiento: los TTL más cortos significan que su aplicación realizará la atestación con más frecuencia. Debido a que el proceso de atestación de la aplicación agrega latencia a las solicitudes de red cada vez que se realiza, un TTL breve puede afectar el rendimiento de su aplicación.
   • Cuota y costo: los TTL más cortos y la recertificación frecuente agotan su cuota más rápido y, para los servicios pagos, pueden costar más. Consulte Cuotas y límites .

   El TTL predeterminado de 1 hora es razonable para la mayoría de las aplicaciones. Tenga en cuenta que la biblioteca App Check actualiza los tokens aproximadamente a la mitad de la duración del TTL.

2. Agregue la biblioteca App Check a su aplicación

1. Agregue la dependencia de App Check al Podfile de su proyecto:

   pod 'FirebaseAppCheck'

   O, alternativamente, puede usar Swift Package Manager en su lugar.

   Asegúrese de estar usando también la versión más reciente de cualquier otro SDK de Firebase del que dependa.

2. Ejecute pod install y abra el archivo .xcworkspace creado.

3. En Xcode, agregue la capacidad App Attest a su aplicación.

4. En el archivo .entitlements de su proyecto, establezca el entorno App Attest en production .

3. Inicializar verificación de aplicaciones

Deberá inicializar App Check antes de usar cualquier otro SDK de Firebase.

Primero, escriba una implementación de AppCheckProviderFactory . Los detalles de su implementación dependerán de su caso de uso.

Por ejemplo, si solo tiene usuarios en iOS 14 y versiones posteriores, siempre puede crear objetos AppAttestProvider :

class YourSimpleAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    return AppAttestProvider(app: app)
  }
}

@interface YourSimpleAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourSimpleAppCheckProviderFactory

- (nullable id<FIRAppCheckProvider>)createProviderWithApp:(nonnull FIRApp *)app {
  return [[FIRAppAttestProvider alloc] initWithApp:app];
}

@end

O bien, puede crear objetos AppAttestProvider en iOS 14 y versiones posteriores, y recurrir a DeviceCheckProvider en versiones anteriores:

class YourAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    if #available(iOS 14.0, *) {
      return AppAttestProvider(app: app)
    } else {
      return DeviceCheckProvider(app: app)
    }
  }
}

@interface YourAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourAppCheckProviderFactory

- (nullable id<FIRAppCheckProvider>)createProviderWithApp:(nonnull FIRApp *)app {
  if (@available(iOS 14.0, *)) {
    return [[FIRAppAttestProvider alloc] initWithApp:app];
  } else {
    return [[FIRDeviceCheckProvider alloc] initWithApp:app];
  }
}

@end

Después de implementar una clase AppCheckProviderFactory , configure App Check para usarla:

let providerFactory = YourAppCheckProviderFactory()
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

YourAppCheckProviderFactory *providerFactory =
        [[YourAppCheckProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];

[FIRApp configure];

Próximos pasos

Una vez que la biblioteca App Check esté instalada en su aplicación, comience a distribuir la aplicación actualizada a sus usuarios.

La aplicación cliente actualizada comenzará a enviar tokens de verificación de aplicaciones junto con cada solicitud que haga a Firebase, pero los productos de Firebase no requerirán que los tokens sean válidos hasta que habilite la aplicación en la sección Verificación de aplicaciones de la consola de Firebase.

Supervise las métricas y habilite la aplicación

Sin embargo, antes de habilitar la aplicación, debe asegurarse de que hacerlo no interrumpa a sus usuarios legítimos existentes. Por otro lado, si observa un uso sospechoso de los recursos de su aplicación, es posible que desee habilitar la aplicación antes.

Para ayudarlo a tomar esta decisión, puede consultar las métricas de App Check para los servicios que utiliza:

• Supervise las métricas de solicitud de verificación de aplicaciones para Realtime Database, Cloud Firestore y Cloud Storage.
• Supervise las métricas de solicitud de App Check para Cloud Functions .

Habilitar la aplicación de verificación de aplicaciones

Cuando comprenda cómo App Check afectará a sus usuarios y esté listo para continuar, puede habilitar la aplicación de App Check:

• Habilite el cumplimiento de App Check para Realtime Database, Cloud Firestore y Cloud Storage.
• Habilite el cumplimiento de App Check para Cloud Functions .

Usar App Check en entornos de depuración

Si, después de haber registrado su aplicación para App Check, desea ejecutar su aplicación en un entorno que App Check normalmente no clasificaría como válido, como un simulador durante el desarrollo o desde un entorno de integración continua (CI), puede cree una compilación de depuración de su aplicación que use el proveedor de depuración de App Check en lugar de un proveedor de atestación real.

Consulte Usar App Check con el proveedor de depuración en las plataformas de Apple .