O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Comece a usar o App Check com o reCAPTCHA Enterprise em apps do Flutter

Selecionar plataforma:

iOS+ Android Web Flutter

Esta página mostra como configurar App Check em um app do Flutter, usando o provedor reCAPTCHA Enterprise. App Check ajuda a garantir que apenas seu app possa acessar os recursos de back-end do seu projeto. Para saber mais, consulte nossa visão geral do App Check.

App Check exige o uso de chaves baseadas em pontuação reCAPTCHA, o que o torna invisível para os usuários. Isso significa que o reCAPTCHA Enterprise provedor não vai exigir que os usuários resolvam um desafio a qualquer momento.

Se o caso de uso exigir recursos reCAPTCHA Enterprise não implementados por App Check, ou se você quiser usar App Check com seu próprio provedor personalizado, consulte Implementar um provedor personalizado do App Check.

1. Configurar seu projeto do Firebase

Instale e inicialize o Firebase no seu projeto do Flutter, caso ainda não tenha feito isso, .
No console Google Cloud, acesse a página Fraud Defense, e faça o seguinte para o provedor reCAPTCHA Enterprise:
1. Verifique se você está no projeto correto (consulte o seletor de projetos na parte de cima da tela).
2. Se solicitado, ative a API reCAPTCHA Enterprise.
3. Crie uma chave com base na plataforma segmentada:
  iOS+
  Crie uma chave do tipo iOS e especifique o ID do pacote do app (por exemplo, com.example.my_app).
  
  Insira o mesmo ID do pacote que você forneceu ao criar o app do Firebase para Apple no seu projeto do Firebase. O valor do ID do pacote diferencia maiúsculas de minúsculas.
  
  Para App Check, cada ID do pacote só pode corresponder a uma única chave reCAPTCHA.
  Android
  Crie uma chave do tipo Android e especifique o nome do pacote do app (por exemplo, com.example.my_app).
  
  Insira o mesmo nome de pacote que você forneceu ao criar o app do Firebase para Android no seu projeto do Firebase. O valor do nome do pacote diferencia maiúsculas de minúsculas.
  
  Para App Check, cada nome de pacote só pode corresponder a uma única chave reCAPTCHA.
  Web
  Crie uma chave do tipo Web e especifique cada um dos domínios dos seus apps da Web.
  
  App Check não oferece suporte a apps da Web que atendem a mais de 250 domínios.
  
  Nunca adicione localhost como um domínio a uma chave reCAPTCHA que é implantada (ou que será implantada) na produção.
  
  Deixe a opção "Usar desafio de caixa de seleção" desmarcada.
  Para instruções detalhadas, consulte Criar chaves reCAPTCHA baseadas em pontuação.
4. Anote cada chave. Você precisará adicioná-las ao fluxo de registro no console Firebase.
No console do Firebase, acesse Segurança > App Check.
Na guia Apps, registre cada um dos apps da plataforma segmentada para usar App Check com o provedor reCAPTCHA Enterprise. Você precisará fornecer a chave que recebeu no console Google Cloud.

Importante: registre todos os apps do seu projeto com um provedor de atestação (como o reCAPTCHA Enterprise). Depois de ativar a aplicação obrigatória de um serviço, apenas os apps registrados poderão acessá-lo.
Opcional: defina o tempo de vida (TTL) do token.

Nas configurações de registro do aplicativo, defina um tempo de vida (TTL) personalizado para App Check tokens emitidos pelo provedor. Você pode definir o TTL para 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 de uma hora é razoável para a maioria dos apps. Observe que a biblioteca App Check atualiza tokens em aproximadamente metade da duração do TTL.
Opcional: defina configurações avançadas.
Clique em Salvar.

(Opcional) Definir configurações avançadas

Quando um usuário abre seu app, reCAPTCHA Enterprise avalia o nível de risco da interação do usuário na chave e retorna uma pontuação entre 0,0 e 1,0, em incrementos de 0,1.

Uma pontuação de 0,0 indica que a interação apresenta alto risco e pode ser fraudulenta.
Uma pontuação de 1,0 indica que a interação apresenta baixo risco e muito provavelmente é legítima.

App Check permite configurar um limite de risco do app para ajustar sua tolerância a esse risco.

Na maioria dos casos de uso, o valor de limite padrão de 0,5 é recomendado. Se o caso de uso exigir ajuste, você poderá configurar esse valor para cada um dos seus apps no Firebase console (acesse Segurança > App Check). Expanda e analise algumas considerações importantes sobre a configuração do limite de risco do app abaixo.

Ver considerações importantes sobre o limite de risco do app

App Check usa o limite de risco do app configurado como a pontuação mínima reCAPTCHA Enterprise necessária para que uma interação do usuário seja considerada legítima. Todas as pontuações reCAPTCHA Enterprise estritamente menores que o limite configurado serão rejeitadas. Ao ajustar o limite de risco do app, esteja ciente do seguinte:

Se o projeto do Firebase estiver no plano de preços Spark sem custo financeiro, dos 11 níveis de pontuação possíveis reCAPTCHA Enterprise, apenas os quatro níveis de pontuação a seguir estarão disponíveis: 0,1, 0,3, 0,7 e 0,9.

Durante esse período, App Check vai permitir apenas valores de limite de risco do app de 0,1, 0,3, 0,5, 0,7 e 0,9. Um valor de limite de risco do app de 0,5 ainda é recomendado para a maioria dos casos de uso.
- Para ativar todos os 11 níveis de pontuação reCAPTCHA Enterprise, vincule uma conta Cloud Billing ao seu projeto. Isso significa que você fará upgrade do projeto do Firebase para o plano de preços Blaze de pagamento por uso. Depois de fazer upgrade do projeto, App Check permitirá configurar qualquer valor de limite de risco do app entre 0,0 e 1,0, em incrementos de 0,1.
  
  Observação: depois que uma conta Cloud Billing é vinculada ao seu projeto, uma análise de segurança automática é acionada para ele. Para mais informações, consulte a reCAPTCHA Enterprise documentação.
Para monitorar a distribuição de pontuações altas e baixas reCAPTCHA Enterprise no seu app, acesse a página reCAPTCHA Enterprise no Google Cloud console e selecione a chave usada pelo app.
Defina o limite de risco do app de acordo com sua tolerância:
- Se você tiver alta tolerância ao risco de apps, mova o controle deslizante para a direita para diminuir o limite de risco do app.
  - Não é recomendável usar o valor 0,0, porque essa configuração desativa a proteção contra abusos.
- Se você tiver baixa tolerância ao risco de apps, mova o controle deslizante para a esquerda para aumentar o limite de risco.
  - Não recomendamos um valor de 1,0, já que essa configuração também pode negar o acesso a usuários legítimos que não atendem a esse alto limite de confiança.
  Aviso: Para evitar interrupções para seus usuários legítimos, aumente gradualmente o limite de risco do app quando App Check for aplicado. Sempre monitore as métricas de solicitação App Checkpara verificar se o tráfego não foi interrompido.

Para mais detalhes, consulte a reCAPTCHA Enterprise documentação para apps para dispositivos móveis e apps da Web.

2. Adicionar o plug-in App Check ao seu app

Para usar o provedor reCAPTCHA Enterprise, adicione o plug-in correspondente App Check.

Na raiz do seu projeto do Flutter, execute o seguinte comando para instalar o plug-in:
```
flutter pub add firebase_app_check
```
Após a conclusão, recrie seu projeto do Flutter:
```
flutter run
```

3. Inicializar App Check

No seu app, inicialize App Check antes de usar qualquer outro serviços do Firebase.

import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_app_check/firebase_app_check.dart';
import 'firebase_options.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  await FirebaseAppCheck.instance.activate(
    providerWeb: ReCaptchaEnterpriseProvider(WEB_SITE_KEY),
    providerAndroid: const AndroidReCaptchaProvider(ANDROID_SITE_KEY),
    providerApple: const AppleReCaptchaProvider(IOS_SITE_KEY),
  );
  runApp(App());
}

4. Monitorar métricas e ativar a aplicação obrigatória

Depois de configurar App Check no seu app, comece a distribuir o app atualizado para os usuários.

O app cliente atualizado vai começar a enviar App Check tokens em todas as solicitações feitas ao Firebase. No entanto, App Check não vai bloquear solicitações com tokens inválidos até que App Check seja aplicado.

Monitorar as métricas

_**Antes de ativar a restrição**_, verifique se isso não vai afetar seus usuários legítimos. No entanto, se você perceber um uso suspeito dos recursos do seu app, convém ativar a aplicação obrigatória antes do previsto.

Para ajudar a tomar essa decisão, analise as App Check métricas para os serviços que você usa:

Monitore as métricas de solicitação App Check para Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity para iOS, API Maps JavaScript e API Places (novo).
Monitore as métricas de solicitação do App Check para Cloud Functions.

Ativar a aplicação obrigatória de App Check

Quando você entender como App Check vai afetar seus usuários e estiver tudo pronto para seguir o processo, ative a aplicação obrigatória de App Check:

Ative App Checka aplicação obrigatória para Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity para iOS, API Maps JavaScript e API Places (novo).
Ative a aplicação de App Check para Cloud Functions.

Usar App Check em ambientes de depuração

App Check classifica alguns ambientes como inválidos, como solicitações de um emulador / simulador ou localhost durante o desenvolvimento ou de um ambiente de integração contínua (CI).

Para executar o app nesses tipos de ambientes depois que App Check for aplicado, crie um build de depuração do seu app que use o App Check provedor de depuração em vez de um provedor de atestado de produção.

Para mais detalhes, consulte Usar App Check com o provedor de depuração em apps do Flutter.

Preços

App Check cria uma avaliação em seu nome para validar o token de resposta do usuário sempre que o app atualiza o token App Check. Seu projeto do Firebase será cobrado por cada avaliação criada acima da cota sem custo. Para mais detalhes, consulte reCAPTCHA preços.

Por padrão, seu app vai atualizar esse token duas vezes a cada uma hora. Para controlar a frequência com que o app atualiza os tokens App Check (e, com isso, a frequência com que novas avaliações são criadas), você pode configurar o TTL do token.