Comience a usar App Check con App Attest en plataformas Apple

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

App Check utiliza 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 de App Check personalizado .

1. Configura tu proyecto de Firebase

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

2. Agrega Firebase a tu proyecto de Apple si aún no lo has 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, debes registrar todas las aplicaciones de tu proyecto, porque una vez que habilitas la aplicación de medidas para un producto de Firebase, solo las aplicaciones registradas podrán acceder a los recursos backend 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 verificación de aplicaciones emitidos por el proveedor. Puede configurar el TTL en cualquier valor entre 30 minutos y 7 días. Al cambiar este valor, tenga en cuenta las siguientes compensaciones:

   • Seguridad: Los TTL más cortos proporcionan una mayor seguridad, porque 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 certificación con más frecuencia. Debido a que el proceso de certificación de aplicaciones agrega latencia a las solicitudes de red cada vez que se realiza, un TTL corto puede afectar el rendimiento de su aplicación.
   • Cuota y costo: los TTL más cortos y las repetidas certificaciones frecuentes agotan su cuota más rápido y, en el caso de los servicios pagos, potencialmente cuestan 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 para App Check al Podfile de su proyecto:

   pod 'FirebaseAppCheck'

   O, alternativamente, puede utilizar Swift Package Manager .

   Asegúrate de utilizar también la última versión de cualquier otro SDK de Firebase del que dependas.

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, configure el entorno App Attest en production .

   Nota: Actualmente, la versión beta de App Check no acepta tokens generados en el entorno sandbox de App Attest.

3. Inicializar la verificación de la aplicación

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 :

Rápido

Nota: Este producto de Firebase no está disponible en destinos de watchOS.

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

C objetivo

Nota: Este producto de Firebase no está disponible en destinos de watchOS.

@interface YourSimpleAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourSimpleAppCheckProviderFactory

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

@end

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

Rápido

Nota: Este producto de Firebase no está disponible en destinos de watchOS.

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

C objetivo

Nota: Este producto de Firebase no está disponible en destinos de watchOS.

@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 haber implementado una clase AppCheckProviderFactory , configure App Check para usarla:

Rápido

Nota: Este producto de Firebase no está disponible en destinos de watchOS.

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

FirebaseApp.configure()

C objetivo

Nota: Este producto de Firebase no está disponible en destinos de watchOS.

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.

Nota: Si agrega App Attest a una aplicación de producción con una gran base de usuarios activos, Apple recomienda incorporar usuarios gradualmente para evitar toparse con límites de cuota.

La aplicación cliente actualizada comenzará a enviar tokens de App Check junto con cada solicitud que realice 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 App Check de Firebase console.

Supervise las métricas y permita la aplicación de la ley

Sin embargo, antes de habilitar la aplicación de medidas, 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 de medidas antes.

Para ayudar 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, Cloud Storage y Authentication (beta).
• Monitorear las métricas de solicitud de verificación de aplicaciones para funciones en la nube .

Habilitar la aplicación de verificación de aplicaciones

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

• Habilite la aplicación de App Check para Realtime Database, Cloud Firestore, Cloud Storage y Authentication (beta).
• Habilite la aplicación de verificación de aplicaciones para funciones en la nube .

Utilice App Check en entornos de depuración

Si, después de haber registrado su aplicación para App Check, desea ejecutarla 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 utilice el proveedor de depuración App Check en lugar de un proveedor de certificación real.

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