Saltar al contenido principal
Version: Guardian v0.5.3

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.

1
Instalar
Agrega el SDK a tu proyecto
2
Inicializar
Configura al iniciar la app
3
Generar un JWT y verificar
Obtén un JWT desde tu backend y luego llama a verify()

Cómo funciona​

  1. Instala el SDK en tu proyecto
  2. Inicializa el SDK al iniciar la app (sin clave de API en el cliente)
  3. 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
  4. Llama a verify(jwt) con un JWT nuevo para obtener una decisión de riesgo directa, o a collect(jwt?) para el flujo servidor a servidor
  5. Recibe una decisión de riesgo de verify(), o un payload cifrado de collect() 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 devuelve allowed: true/false a 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​

PlataformaPaqueteDistribuciónverify()collect()
Web (navegador)@surtai/guardian-webnpmn/a✓
React Native@surtai/guardian-rnnpm✓✓
iOS (Swift)SurtGuardianSDKSwift Package Manager✓✓
Android (Kotlin)com.surt.guardian:securitysdkMaven (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​