Comienza a usar la Verificación de aplicaciones mediante App Attest en plataformas de Apple

En esta página, se muestra cómo habilitar App Check en una app de Apple mediante el proveedor integrado de App Attest. Cuando habilitas App Check, ayudas a garantizar que solo la app pueda acceder a los recursos de Firebase de tu proyecto. Consulta una descripción general de esta función.

App Check usa App Attest para verificar que las solicitudes a los servicios de Firebase provengan de la app auténtica. En este momento, App Check no usa App Attest para analizar riesgos de fraude.

Si deseas usar App Check con tu propio proveedor personalizado, consulta Cómo implementar un proveedor personalizado de App Check.

1. Configura el proyecto de Firebase

1. Necesitarás Xcode 12.5 (o una versión posterior) para usar App Attest.

2. Si aún no lo has hecho, agrega Firebase al proyecto de Apple.

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

   Por lo general, debes registrar todas las apps de tu proyecto, ya que una vez que habilites la aplicación forzosa para un producto de Firebase, solo las apps registradas podrán acceder a los recursos de backend del producto.

4. Opcional: En los parámetros de configuración del registro de la app, configura un tiempo de actividad (TTL) personalizado para los tokens de App Check que emite el proveedor. Puedes configurar el TTL en cualquier valor entre 30 minutos y 7 días. Cuando cambies este valor, ten en cuenta las siguientes compensaciones:

   • Seguridad: Los TTL más cortos proporcionan una mayor seguridad, ya que reducen el período en el que un atacante puede abusar de un token filtrado o interceptado.
   • Rendimiento: Si usas TTL más cortos, la app realizará la certificación con mayor frecuencia. Debido a que el proceso de certificación de la app agrega latencia a las solicitudes de red cada vez que se realiza, un TTL corto puede afectar el rendimiento de la app.
   • Cuota y costo: Los TTL más cortos y las certificaciones frecuentes agotan tu cuota con mayor rapidez. Además, en el caso de los servicios pagados, es posible que tengan un costo mayor. Consulta Cuotas y límites.

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

2. Agrega la biblioteca App Check a tu app

1. Agrega la dependencia para App Check al Podfile de tu proyecto:

   pod 'FirebaseAppCheck'

   Como alternativa, puedes usar Swift Package Manager.

   Asegúrate de usar la versión más reciente de todos los SDK de Firebase de los que dependes.

2. Ejecuta pod install y abre el archivo .xcworkspace creado.

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

4. En el archivo .entitlements del proyecto, configura el entorno de App Attest como production.

3. Inicializa App Check

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

Primero, escribe una implementación de AppCheckProviderFactory. Los detalles de la implementación dependerán de tu caso de uso.

Por ejemplo, si solo tienes usuarios en la versión 14 y posteriores de iOS, puedes crear siempre objetos AppAttestProvider, de la siguiente manera:

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

También puedes crear objetos AppAttestProvider en iOS 14 y en versiones posteriores, y usar DeviceCheckProvider como alternativa en las versiones anteriores, como se muestra a continuación:

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, configura 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 esté instalada la biblioteca de App Check en la app, comienza a distribuir la app actualizada a tus usuarios.

La app 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 habilites la aplicación forzosa en la sección de App Check de Firebase console.

Supervisa las métricas y habilita la aplicación forzosa

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 App Check para los servicios que usas:

• Supervisa las métricas de solicitudes de App Check para Realtime Database, Cloud Firestore, Cloud Storage, Authentication (beta) y Vertex AI in Firebase.
• Supervisa las métricas de solicitudes de App Check para Cloud Functions.

Habilita la aplicación forzosa de App Check

Cuando comprendas cómo App Check afectará a los usuarios y tengas todo listo para continuar, puedes habilitar la aplicación forzosa de App Check:

• Habilita la aplicación forzosa de App Check para Realtime Database, Cloud Firestore, Cloud Storage, Authentication (beta) y Vertex AI in Firebase.
• Habilita la aplicación forzosa de App Check para Cloud Functions.

Usa App Check en entornos de depuración

Si, después de registrar la app en App Check, quieres ejecutarla en un entorno que App Check no suele clasificar 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 App Check, en lugar de un proveedor de certificación real.

Consulta Cómo usar App Check con el proveedor de depuración en plataformas de Apple.