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 plataformas Apple

Selecionar plataforma:

iOS+ Android Web Flutter

Nesta página, mostramos como configurar o App Check em um app para plataformas da Apple usando o provedor reCAPTCHA Enterprise. O 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.

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

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

1. Configurar seu projeto do Firebase

Adicione o Firebase ao seu projeto da Apple caso ainda não tenha feito isso.
No console do 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 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 da Apple no 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.
  Para instruções detalhadas, consulte Criar chaves do reCAPTCHA com base em pontuação.
4. Anote essa chave. Você precisará adicioná-lo ao fluxo de registro no console do Firebase.
No console do Firebase, acesse Segurança > App Check.
Na guia Apps, registre seus apps de plataformas da Apple para usar App Check com o provedor reCAPTCHA Enterprise. Você vai precisar fornecer a chave que recebeu no console do Google Cloud.

Importante :registre todos os apps do seu projeto com um provedor de atestado (como o reCAPTCHA Enterprise). Depois de ativar a aplicação para um serviço, somente os apps registrados poderão acessá-lo.
Opcional: defina o time to live (TTL) do token.

Nas configurações de registro do app, 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 de uma hora é razoável para a maioria dos apps. A biblioteca App Check atualiza os tokens em aproximadamente metade da duração do TTL.
Opcional: defina as configurações avançadas.
Clique em Salvar.

(Opcional) Definir configurações avançadas

Quando um usuário abre seu app, o reCAPTCHA Enterprise avalia o nível de risco da interação do usuário sob a 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 risco baixo e muito provavelmente é legítima.

Com o App Check, é possível 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, configure esse valor para cada um dos apps no console do Firebase (acesse Segurança > App Check). Abra e leia algumas considerações importantes sobre como configurar o limite de risco do app abaixo.

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

O App Check usa o limite de risco do app configurado como a pontuação mínima do reCAPTCHA Enterprise necessária para que uma interação do usuário seja considerada legítima. Todas as pontuações do 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 do reCAPTCHA Enterprise, apenas os quatro a seguir estarão disponíveis: 0,1, 0,3, 0,7 e 0,9.

Durante esse período, o 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 do reCAPTCHA Enterprise, vincule uma conta do Cloud Billing ao seu projeto. Isso significa que você vai fazer upgrade do seu projeto do Firebase para o plano de preços Blaze de pagamento por uso. Depois de fazer upgrade do projeto, o App Check vai permitir que você configure 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 do Cloud Billing é vinculada ao seu projeto, uma análise de segurança automática é acionada para ele. Para mais informações, consulte a documentação do reCAPTCHA Enterprise.
Para monitorar a distribuição de pontuações altas e baixas do reCAPTCHA Enterprise no seu app, acesse a página do reCAPTCHA Enterprise no console do Google Cloud 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 estiver em vigor. Sempre monitore as métricas de solicitação do App Check para verificar se o tráfego não foi interrompido.

Para mais detalhes, consulte a documentação do reCAPTCHA Enterprise.

2. Adicionar o SDK do App Check ao seu app

Use o Swift Package Manager (SPM) para instalar e gerenciar as dependências do Firebase. Se você já usa o Firebase, verifique se o pacote é da versão 12.17.0 ou mais recente.

No Xcode, abra o projeto do app.
Adicione a biblioteca do Firebase:
1. Acesse File > Add Packages.
2. Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas Apple:
```
https://github.com/firebase/firebase-ios-sdk
```
3. Selecione a versão mais recente do SDK (v12.17.0 ou mais recente).
4. Selecione a biblioteca FirebaseAppCheck.
5. Clique em Adicionar pacote. O Xcode vai resolver e fazer o download das dependências.
6. Quando solicitado, adicione a biblioteca ao destino do app.
Adicione a biblioteca do reCAPTCHA Enterprise:
1. Volte para File > Add Packages.
2. Quando solicitado, adicione o repositório do SDK do reCAPTCHA Enterprise:
```
https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
```
3. Selecione a biblioteca RecaptchaEnterprise.
4. Clique em Adicionar pacote. Quando solicitado, adicione a biblioteca ao destino do app.

3. Inicializar o App Check

No app, é necessário inicializar o App Check antes de usar qualquer outro serviço do Firebase.

Crie uma instância de RecaptchaProviderFactory, transmitindo sua chave reCAPTCHA, e configure App Check para usá-la:

let providerFactory = RecaptchaProviderFactory(siteKey: "SITE_KEY")
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

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

Depois de configurar o App Check 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. No entanto, o App Check não vai bloquear solicitações com tokens inválidos até que o App Check seja aplicado.

Monitorar as métricas

Antes de ativar a aplicação obrigatória, 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 tomar essa decisão, analise as métricas do App Check nos serviços usados:

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 App Check

Assim que você entender como o App Check vai afetar seus usuários e estiver tudo pronto para prosseguir, ative a aplicação obrigatória do App Check:

Ativar a aplicação de 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).
Ative a aplicação de App Check para Cloud Functions.

Usar App Check em ambientes de depuração

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

Para executar o app nesses tipos de ambientes após a aplicação de App Check, é necessário criar um build de depuração do app que use o provedor de depuração do App Check em vez de um provedor de atestado de produção.

Para mais detalhes, consulte Usar o App Check com o provedor de depuração em plataformas da Apple.

Preços

O 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 financeiro. Para mais detalhes, consulte Preços do reCAPTCHA.

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 do App Check (e, com isso, a frequência com que novas avaliações são criadas), configure o TTL do token.