Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Use App Check con el proveedor de depuración en iOS

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 utilice el proveedor de depuración de App Check en lugar de un proveedor de certificación real.

Utilice el proveedor de depuración en un simulador

Para usar el proveedor de depuración mientras ejecuta su aplicación en un simulador de forma interactiva (durante el desarrollo, por ejemplo), haga lo siguiente:

  1. En tu compilación de depuración, antes de usar cualquier servicio de backend de Firebase, crea y configura la fábrica de proveedores de depuración de App Check:

    Rápido

    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    
    FirebaseApp.configure()

    C objetivo

    FIRAppCheckDebugProviderFactory *providerFactory =
          [[FIRAppCheckDebugProviderFactory alloc] init];
    [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    
    // Use Firebase library to configure APIs
    [FIRApp configure];
  2. Habilite el registro de depuración en su proyecto Xcode (v11.0 o más reciente):

    1. Abrir producto> esquema Esquema> Editar.
    2. Seleccione Ejecutar en el menú de la izquierda, a continuación, seleccione la pestaña Argumentos.
    3. En los argumentos incluidos en la sección de lanzamiento, complemento -FIRDebugEnabled .
  3. Inicie la aplicación. Se registrará un token de depuración local cuando el SDK intente enviar una solicitud al backend. Por ejemplo:

    [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
    123a4567-b89c-12d3-e456-789012345678
  4. En los Ajustes del proyecto> Aplicación Comprobar la sección de la consola Firebase, seleccione Administrar fichas de depuración en el menú de desbordamiento de su aplicación. Luego, registre el token de depuración que inició sesión en el paso anterior.

    Captura de pantalla del elemento de menú Administrar tokens de depuración

Después de registrar el token, los servicios de backend de Firebase lo aceptarán como válido.

Debido a que este token permite el acceso a sus recursos de Firebase sin un dispositivo válido, es crucial que lo mantenga privado. No lo envíes a un repositorio público, y si alguna vez un token registrado se ve comprometido, revocalo inmediatamente en Firebase console.

Utilice el proveedor de depuración en un entorno de CI

Para utilizar el proveedor de depuración en un entorno de integración continua (CI), haga lo siguiente:

  1. En los Ajustes del proyecto> Aplicación Comprobar la sección de la consola Firebase, seleccione Administrar fichas de depuración en el menú de desbordamiento de su aplicación. Luego, cree un nuevo token de depuración. Necesitará el token en el siguiente paso.

    Debido a que este token permite el acceso a sus recursos de Firebase sin un dispositivo válido, es crucial que lo mantenga privado. No lo envíes a un repositorio público, y si alguna vez un token registrado se ve comprometido, revocalo inmediatamente en Firebase console.

    Captura de pantalla del elemento de menú Administrar tokens de depuración

  2. Añadir el símbolo de depuración que acaba de crear al almacén de claves seguro de su sistema de CI (por ejemplo, GitHub las acciones de los secretos cifrados o de Travis CI variables de cifrado ).

  3. Si es necesario, configure su sistema de CI para que su token de depuración esté disponible dentro del entorno de CI como una variable de entorno. Nombrar la variable algo así como APP_CHECK_DEBUG_TOKEN_FROM_CI .

  4. En Xcode, añadir una variable de entorno a su programa de ensayos con el nombre FIRAAppCheckDebugToken y algo así como $(APP_CHECK_DEBUG_TOKEN) como el valor.

  5. Configure su secuencia de comandos de prueba de CI para pasar el token de depuración como una variable de entorno. Por ejemplo:

    xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
    APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)
  6. En tu compilación de depuración, antes de usar cualquier servicio de backend de Firebase, crea y configura la fábrica de proveedores de depuración de App Check:

    Rápido

    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    
    FirebaseApp.configure()

    C objetivo

    FIRAppCheckDebugProviderFactory *providerFactory =
          [[FIRAppCheckDebugProviderFactory alloc] init];
    [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    
    // Use Firebase library to configure APIs
    [FIRApp configure];

Cuando su aplicación se ejecuta en un entorno de CI, los servicios de backend de Firebase aceptarán el token que envía como válido.