SDK Guardian
Surt Guardian es un SDK de inteligencia de dispositivos para aplicaciones móviles y web. Recopila señales del dispositivo, realiza verificaciones de integridad del dispositivo donde están disponibles y envía todo al backend de Surt para la evaluación de riesgo. Todas las decisiones de seguridad se toman del lado del servidor.
Cómo funciona
- Instala el SDK en tu proyecto
- Inicializa el SDK al iniciar la app (sin clave de API en el cliente)
- Tu backend genera un JWT de corta duración llamando al endpoint de preflight de Surt con tu clave de API
sp_live_*y el contexto de la transacción - Llama a
verify(jwt)con un JWT nuevo para obtener una decisión de riesgo directa, o acollect(jwt?)para el flujo servidor a servidor - Recibe una decisión de riesgo de
verify(), o un payload cifrado decollect()que tu backend envía a Surt
El SDK gestiona internamente la huella digital del dispositivo y la recopilación de datos. La clave de API sp_live_* nunca sale de tu backend: el cliente solo maneja JWTs de corta duración.
Dos rutas de verificación
verify(jwt): el SDK llama a Surt directamente y devuelveallowed: true/falsea tu aplicación. Solicita un JWT nuevo para cada llamada. Un JWT expira 30 minutos después de emitirse. Solo SDKs nativos.collect(jwt?): el SDK recopila y cifra los datos localmente, y tu backend llama al endpoint de evaluación de Surt. El JWT es opcional. Pásalo para resolver la IP pública del dispositivo e incluirla en el payload y, en los SDKs nativos, para aplicar la configuración de atestación de tu organización. Compatible con todas las plataformas, incluyendo web.
Plataformas compatibles
| Plataforma | Paquete | Distribución | verify() | collect() |
|---|---|---|---|---|
| Web (navegador) | @surtai/guardian-web | npm | n/a | ✓ |
| React Native | @surtai/guardian-rn | npm | ✓ | ✓ |
| iOS (Swift) | SurtGuardianSDK | Swift Package Manager | ✓ | ✓ |
| Android (Kotlin) | com.surt.guardian:securitysdk | Maven (GitHub Packages) | ✓ | ✓ |
Las plataformas nativas comparten la misma superficie de API y se versionan en sincronía. El SDK web es solo de recopilación: no tiene verify() ni inicialización a nivel de aplicación.
Qué recopila
Sin permisos: Información de hardware, indicadores de seguridad (root/jailbreak, emulador, depurador, VPN, Frida, Xposed, Magisk), información de software, batería, tipo de red.
Opcional (opt-in): Ubicación GPS (requiere el permiso de ubicación). Solo en Android: detalles de WiFi e información de SIM/operador (ambos requieren un permiso) y cantidad de cámaras (sin permiso).
Enlaces rápidos
- Inicio rápido: ponlo en marcha en 5 minutos
- Web (navegador): npm install
@surtai/guardian-web, sin inicialización - React Native: npm install + GuardianProvider
- iOS: configuración con Swift Package Manager
- Android: configuración con Maven/Gradle
- Autenticación: generación de JWTs de corta duración mediante preflight
- Collect (Servidor a servidor): verificación de backend a backend
- Niveles de riesgo: entiende la evaluación de riesgo
- Configuración: todas las opciones del SDK