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 com o provedor de depuração no iOS

Se, depois de registrar seu aplicativo para App Check, você deseja executar seu aplicativo em um ambiente que App Check normalmente não classificaria como válido, como um simulador durante o desenvolvimento, ou de um ambiente de integração contínua (CI), você pode crie uma compilação de depuração de seu aplicativo que usa o provedor de depuração App Check em vez de um provedor de atestado real.

Use o provedor de depuração em um simulador

Para usar o provedor de depuração ao executar seu aplicativo em um simulador interativamente (durante o desenvolvimento, por exemplo), faça o seguinte:

  1. Na sua versão de depuração, antes de usar qualquer serviço de back-end do Firebase, crie e defina a fábrica do provedor de depuração do App Check:

    Rápido

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

    Objective-C

    FIRAppCheckDebugProviderFactory *providerFactory =
          [[FIRAppCheckDebugProviderFactory alloc] init];
    [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    
    // Use Firebase library to configure APIs
    [FIRApp configure];
  2. Habilite o registro de depuração em seu projeto Xcode (v11.0 ou mais recente):

    1. Abrir produto> Esquema> Editar esquema.
    2. Selecione Executar no menu à esquerda, selecione a guia Argumentos.
    3. Nos argumentos aprovados na seção Lançamento, add -FIRDebugEnabled .
  3. Abra o aplicativo. Um token de depuração local será registrado quando o SDK tentar enviar uma solicitação ao back-end. Por exemplo:

    [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
    123a4567-b89c-12d3-e456-789012345678
  4. Nos Configurações do projeto> App check seção do console Firebase, escolha gerenciar tokens de depuração no menu de estouro de seu aplicativo. Em seguida, registre o token de depuração que você registrou na etapa anterior.

    Captura de tela do item de menu Gerenciar tokens de depuração

Depois de registrar o token, os serviços de back-end do Firebase o aceitarão como válido.

Como esse token permite acesso aos recursos do Firebase sem um dispositivo válido, é fundamental mantê-lo privado. Não o envie para um repositório público e, se um token registrado for comprometido, revogue-o imediatamente no console do Firebase.

Use o provedor de depuração em um ambiente de CI

Para usar o provedor de depuração em um ambiente de integração contínua (CI), faça o seguinte:

  1. Nos Configurações do projeto> App check seção do console Firebase, escolha gerenciar tokens de depuração no menu de estouro de seu aplicativo. Em seguida, crie um novo token de depuração. Você precisará do token na próxima etapa.

    Como esse token permite acesso aos recursos do Firebase sem um dispositivo válido, é fundamental mantê-lo privado. Não o envie para um repositório público e, se um token registrado for comprometido, revogue-o imediatamente no console do Firebase.

    Captura de tela do item de menu Gerenciar tokens de depuração

  2. Adicionar a depuração símbolo que você acabou de criar para armazenamento de chave segura do seu sistema CI (por exemplo, GitHub Acções segredos criptografados ou de Travis CI variáveis criptografados ).

  3. Se necessário, configure seu sistema de CI para disponibilizar seu token de depuração no ambiente de CI como uma variável de ambiente. Nome da variável algo como APP_CHECK_DEBUG_TOKEN_FROM_CI .

  4. No Xcode, adicione uma variável de ambiente para o seu programa de ensaios com o nome FIRAAppCheckDebugToken e algo como $(APP_CHECK_DEBUG_TOKEN) como o valor.

  5. Configure seu script de teste de CI para passar o token de depuração como uma variável de ambiente. Por exemplo:

    xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
    APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)
  6. Na sua versão de depuração, antes de usar qualquer serviço de back-end do Firebase, crie e defina a fábrica do provedor de depuração do App Check:

    Rápido

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

    Objective-C

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

Quando seu aplicativo é executado em um ambiente de CI, os serviços de back-end do Firebase aceitam o token enviado como válido.