Configuración de la atestación de dispositivo
Los SDKs nativos atestan el dispositivo con Google Play Integrity en Android y con Apple App Attest en iOS. Esta página cubre la configuración que tu organización controla en el panel de Surt: con qué frecuencia atestan los dispositivos, contra qué proyecto de Google Cloud atesta Android y qué apps de iOS acepta App Attest. Ninguno de estos ajustes requiere cambiar el código del SDK ni publicar una nueva versión de tu app.
Toda la configuración está en un solo lugar:
- Inicia sesión en tu panel de Surt.
- Ve a Settings → Developer.
- Desplázate hasta la sección Atestación de dispositivo.
Cada cambio se aplica cuando haces clic en Guardar.
| Ajuste | Plataforma | Obligatorio |
|---|---|---|
| Frecuencia de atestación | Android e iOS | No. El valor predeterminado es Una vez cada N días por usuario con 7 días |
| Proyecto de Android | Android | No. El proyecto compartido de Surt funciona sin configuración |
| Apps de iOS | iOS | Sí. App Attest solo se aprueba para los App IDs que agregues |
Frecuencia de atestación
Frecuencia de atestación define con qué frecuencia atesta un dispositivo:
| Opción | Comportamiento |
|---|---|
| Una vez cada N días por usuario | Recomendada. Escribe el número de días en Días (mínimo 1, predeterminado 7). |
| En cada transacción | El dispositivo atesta en cada transacción. A gran escala, esto agota rápido la cuota diaria de Play Integrity (10.000 por día). |
El intervalo se cuenta por cliente, y solo un veredicto limpio de Play Integrity lo inicia. Un veredicto con señales de riesgo, o una transacción en la que Google no devuelve veredicto, no lo inicia. App Attest no tiene cuota diaria, así que los veredictos de iOS nunca inician el intervalo: un cliente que solo usa dispositivos iOS atesta en cada transacción.
El SDK aplica la frecuencia cuando tu app pasa un JWT. Una llamada a collect() sin JWT atesta en cada llamada. Consulta Autenticación.
Android: proyecto de Play Integrity propio
De forma predeterminada, Android atesta contra el proyecto compartido de Google Cloud de Surt, así que la atestación funciona sin ninguna configuración. Usa tu propio proyecto para tener tu propia cuota de Play Integrity, incluido cualquier aumento de cuota que solicites a Google.
Antes de empezar, en tu proyecto de Google Cloud:
- Habilita la Play Integrity API.
- Crea una cuenta de servicio con el rol
playintegrity.verifiery descarga su clave JSON. - Anota el número del proyecto. Son solo dígitos, por ejemplo
817986950837, no el ID del proyecto.
Después, en la sección Atestación de dispositivo:
- En Proyecto de Android, selecciona Su propio proyecto de GCP.
- Completa los campos:
- Número de proyecto de Cloud: el número del proyecto, solo dígitos.
- Nombre del paquete: el nombre de paquete de tu app, por ejemplo
com.example.app. - JSON de la cuenta de servicio: haz clic en Subir archivo y elige el archivo de la clave, o pega el JSON de la clave.
- Haz clic en Guardar.
Surt verifica la clave con Google cuando guardas. Si Google la rechaza, el panel muestra un error. Una causa común es una cuenta de servicio sin el rol playintegrity.verifier. Corrígelo y guarda de nuevo. La clave se almacena cifrada y no se vuelve a mostrar. Si más adelante cambias el número de proyecto o el nombre del paquete, tienes que volver a subir la clave.
iOS: App IDs propios
App Attest solo acepta claves de las apps de iOS que tu organización registra. Hasta que agregues tus App IDs, todas las claves de App Attest de tu app fallan la validación y las transacciones de iOS nunca cuentan como atestadas.
Un App ID es tu Team ID de Apple más el bundle ID de la app:
| Parte | Dónde encontrarla | Formato |
|---|---|---|
| Team ID | Tu cuenta de Apple Developer, en Membership | 10 caracteres, letras mayúsculas y dígitos, por ejemplo ABCDE12345 |
| Bundle ID | Xcode, en la pestaña General del target de tu app, Bundle Identifier | Identificador de dominio inverso, por ejemplo com.example.app |
En la sección Atestación de dispositivo:
- En Apps de iOS, selecciona Sus propias apps de iOS.
- Ingresa el Team ID y el Bundle ID de tu primera app.
- Haz clic en Agregar app por cada otra build que ejecute el SDK, por ejemplo tus apps de staging y de producción. Puedes agregar hasta 20 App IDs, y cada uno debe ser único.
- Haz clic en Guardar.
Las apps instaladas desde la App Store o TestFlight generan claves de App Attest de producción. Las builds que instalas desde Xcode generan claves de desarrollo, y producción las rechaza. Prueba la atestación de iOS con una build de TestFlight.
Volver a la configuración de Surt
Volver a la configuración de Surt elimina tu proyecto de Android y su clave y tus App IDs de iOS, y devuelve ambas plataformas a la configuración predeterminada de Surt. La frecuencia de atestación se conserva. Después de revertir, las claves de App Attest de tus propias apps vuelven a fallar la validación hasta que agregues de nuevo tus App IDs.