Esta página mostra como ativar o App Check em um app em Unity usando os provedores padrão: Play Integrity no Android e Device Check ou App Attest em plataformas da Apple. Ao ativar o App Check, você ajuda a garantir que apenas seu app possa acessar os recursos do Firebase do seu projeto. Consulte a Visão geral desse recurso.
1. Configurar seu projeto do Firebase
Adicione o Firebase ao seu projeto em Unity, caso ainda não tenha feito isso.
Registre seus apps para usar o App Check nos provedores Play Integrity, Device Check ou App Attest na seção Configurações do projeto > App Check do console do Firebase.
Geralmente, é necessário registrar todos os apps do projeto porque, depois de ativar a aplicação de um produto do Firebase, somente apps registrados poderão acessar os recursos de back-end do produto.
Para ver instruções detalhadas sobre como se registrar em cada provedor, consulte a documentação específica para Android e iOS.
Opcional: nas configurações de registro do aplicativo, defina um time to live (TTL) personalizado para os tokens do App Check emitidos pelo provedor. É possível definir o TTL como qualquer valor entre 30 minutos e 7 dias. Ao mudar esse valor, esteja ciente das seguintes compensações:
- Segurança: os TTLs mais curtos oferecem maior segurança, porque reduzem a janela em que um token vazado ou interceptado pode ser usado por um invasor.
- Desempenho: TTLs mais curtos significam que seu app realizará atestados com mais frequência. Como o processo de atestado do app adiciona latência às solicitações de rede sempre que é executado, um TTL curto pode afetar o desempenho do app.
- Cota e custo: TTLs mais curtos e novos atestados frequentes esgotam sua cota mais rapidamente e, para serviços pagos, podem custar mais. Consulte Cotas e limites.
O TTL padrão é bom para a maioria dos apps. Observe que a biblioteca do App Check atualiza os tokens em aproximadamente metade da duração do TTL.
2. Adicionar a biblioteca do App Check ao seu app
Inclua a biblioteca do App Check no seu conjunto de dependências, seguindo as instruções de configuração do App Check.
3. Inicializar o App Check
Adicione o código de inicialização a seguir no app para que ele seja executado antes de você usar os serviços do Firebase, incluindo a criação de apps do Firebase.
Android
Adicione a declaração de uso para
Firebase.AppCheck:using Firebase.AppCheck
Inicialize a biblioteca do App Check com o provedor Play Integrity:
FirebaseAppCheck.SetAppCheckProviderFactory( PlayIntegrityProviderFactory.Instance);
iOS+
Adicione a declaração de uso para
Firebase.AppCheck:using Firebase.AppCheck
Inicialize a biblioteca do App Check com o provedor Device Check ou App Attest:
FirebaseAppCheck.SetAppCheckProviderFactory( DeviceCheckProviderFactory.Instance);
Próximas etapas
Depois que a biblioteca do App Check estiver instalada no seu app, comece a distribuir o app atualizado para os usuários.
O app cliente atualizado vai começar a enviar tokens do App Check em todas as solicitações feitas ao Firebase, mas os produtos dessa plataforma não exigirão que os tokens sejam válidos até que você ative a aplicação obrigatória na seção "App Check" do Console do Firebase.
Monitorar métricas e ativar a aplicação obrigatória
Antes de ativar a aplicação obrigatória, verifique se isso não vai afetar seus usuários legítimos. Por outro lado, se você perceber um uso suspeito dos recursos do seu app, convém ativar a aplicação obrigatória antes do previsto.
Para tomar essa decisão, analise as métricas do App Check nos serviços usados:
- Monitorar as métricas de solicitação do App Check no Realtime Database, no Cloud Firestore e no Cloud Storage.
- Monitorar as métricas de solicitação do App Check no Cloud Functions.
Ativar a aplicação obrigatória do App Check
Assim que você entender como o App Check vai afetar seus usuários, e se estiver tudo pronto para seguir o processo, ative a aplicação do App Check:
- Ativar a aplicação do App Check no Realtime Database, no Cloud Firestore e no Cloud Storage.
- Ativar a aplicação do App Check no Cloud Functions.
Usar o App Check em ambientes de depuração
Se, depois de registrar seu aplicativo no App Check, você quiser executá-lo em um ambiente que o App Check normalmente não classificaria como válido, como um computador, um emulador durante o desenvolvimento ou de uma integração contínua (CI), será possível criar um build de depuração do seu app que use o provedor de depuração do App Check em vez de um provedor de atestado real.
Consulte Usar App Check com o provedor de depuração em apps em Unity.