Configuração da atestação de dispositivo
Os SDKs nativos atestam o dispositivo com o Google Play Integrity no Android e o Apple App Attest no iOS. Esta página cobre as configurações que a sua organização controla no painel da Surt: com que frequência os dispositivos atestam, contra qual projeto do Google Cloud o Android atesta e quais apps iOS o App Attest aceita. Nenhuma dessas configurações exige mudança de código no SDK nem uma nova versão do app.
Todas as configurações ficam em um só lugar:
- Faça login no seu Surt Dashboard.
- Navegue até Settings → Developer.
- Role até a seção Device Attestation.
Cada mudança entra em vigor quando você clica em Save.
| Configuração | Plataforma | Obrigatória |
|---|---|---|
| Attestation cadence | Android e iOS | Não. O padrão é Once every N days per user com 7 dias |
| Android project | Android | Não. O projeto compartilhado da Surt funciona sem configuração |
| iOS apps | iOS | Sim. O App Attest só passa para os App IDs que você adicionar |
Cadência de atestação
Attestation cadence define com que frequência um dispositivo atesta:
| Opção | Comportamento |
|---|---|
| Once every N days per user | Recomendado. Digite o número de dias em Days (mínimo 1, padrão 7). |
| Every transaction | O dispositivo atesta em toda transação. Isso consome rapidamente a cota diária de Play Integrity (10.000 por dia) em escala. |
O intervalo é contado por cliente, e somente um veredito limpo do Play Integrity o inicia. Um veredito com sinais de risco, ou uma transação em que o Google não retorna veredito, não o inicia. O App Attest não tem cota diária, então os vereditos do iOS nunca iniciam o intervalo: um cliente que usa apenas dispositivos iOS atesta em toda transação.
O SDK aplica a cadência quando o seu app passa um JWT. Uma chamada a collect() sem JWT atesta em toda chamada. Veja Autenticação.
Android: projeto de Play Integrity próprio
Por padrão, o Android atesta contra o projeto compartilhado do Google Cloud da Surt, então a atestação funciona sem nenhuma configuração. Use o seu próprio projeto para ter a sua própria cota de Play Integrity, incluindo qualquer aumento de cota que você solicitar ao Google.
Antes de começar, no seu projeto do Google Cloud:
- Ative a Play Integrity API.
- Crie uma conta de serviço com o papel
playintegrity.verifiere baixe a chave JSON dela. - Anote o número do projeto. Ele contém apenas dígitos, por exemplo
817986950837, e não é o ID do projeto.
Depois, na seção Device Attestation:
- Em Android project, selecione Your own GCP project.
- Preencha os campos:
- Cloud Project Number: o número do projeto, apenas dígitos.
- Package Name: o nome do pacote do seu app, por exemplo
com.example.app. - Service Account JSON: clique em Upload file e escolha o arquivo da chave, ou cole o JSON da chave.
- Clique em Save.
A Surt verifica a chave junto ao Google quando você salva. Se o Google a rejeitar, o painel mostra um erro. Uma causa comum é uma conta de serviço sem o papel playintegrity.verifier. Corrija e salve novamente. A chave é armazenada de forma criptografada e nunca mais é exibida. Alterar depois o número do projeto ou o nome do pacote exige enviar a chave novamente.
iOS: App IDs próprios
O App Attest só aceita chaves dos apps iOS que a sua organização registra. Até você adicionar os seus App IDs, toda chave do App Attest vinda do seu app falha na validação, e as transações iOS nunca contam como atestadas.
Um App ID é o seu Team ID da Apple mais o bundle ID do app:
| Parte | Onde encontrar | Formato |
|---|---|---|
| Team ID | Sua conta Apple Developer, em Membership | 10 caracteres, letras maiúsculas e dígitos, por exemplo ABCDE12345 |
| Bundle ID | Xcode, na aba General do target do seu app, Bundle Identifier | Identificador em domínio reverso, por exemplo com.example.app |
Na seção Device Attestation:
- Em iOS apps, selecione Your own iOS app(s).
- Informe o Team ID e o Bundle ID do seu primeiro app.
- Clique em Add app para cada outro build que roda o SDK, por exemplo os seus apps de staging e de produção. Você pode adicionar até 20 App IDs, e cada um deve ser único.
- Clique em Save.
Apps instalados pela App Store ou pelo TestFlight geram chaves de App Attest de produção. Builds que você instala pelo Xcode geram chaves de desenvolvimento, e a produção as rejeita. Teste a atestação no iOS com um build do TestFlight.
Restaurar os padrões da Surt
Revert to Surt defaults remove o seu projeto Android e a chave dele e os seus App IDs do iOS, e retorna as duas plataformas aos padrões da Surt. A cadência de atestação é mantida. Depois de restaurar, as chaves do App Attest dos seus próprios apps voltam a falhar na validação até você adicionar os seus App IDs novamente.