Pular para o conteúdo principal
Versão: Guardian v0.5.3

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:

  1. Faça login no seu Surt Dashboard.
  2. Navegue até Settings → Developer.
  3. Role até a seção Device Attestation.

Cada mudança entra em vigor quando você clica em Save.

ConfiguraçãoPlataformaObrigatória
Attestation cadenceAndroid e iOSNão. O padrão é Once every N days per user com 7 dias
Android projectAndroidNão. O projeto compartilhado da Surt funciona sem configuração
iOS appsiOSSim. 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çãoComportamento
Once every N days per userRecomendado. Digite o número de dias em Days (mínimo 1, padrão 7).
Every transactionO 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.verifier e 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:

  1. Em Android project, selecione Your own GCP project.
  2. 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.
  3. 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:

ParteOnde encontrarFormato
Team IDSua conta Apple Developer, em Membership10 caracteres, letras maiúsculas e dígitos, por exemplo ABCDE12345
Bundle IDXcode, na aba General do target do seu app, Bundle IdentifierIdentificador em domínio reverso, por exemplo com.example.app

Na seção Device Attestation:

  1. Em iOS apps, selecione Your own iOS app(s).
  2. Informe o Team ID e o Bundle ID do seu primeiro app.
  3. 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.
  4. Clique em Save.
Produção aceita apenas chaves de App Attest de produção

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.