Saltar al contenido principal
Version: Guardian v0.5.3

Inicio rápido

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 nuevo y luego llama a verify()

1. Instalar​

npm install @surtai/guardian-web@0.5.0

2. Inicializar​

No hay paso de inicialización: el SDK web expone una única función estática collect(), sin proveedor ni configuración. Pasa al paso 3.

El cliente nunca maneja tu clave de API sp_live_*. Esta reside en tu backend, que genera los JWTs de corta duración usados a continuación.

3. Generar un JWT y verificar​

Antes de cada verificación, tu app obtiene un JWT de corta duración desde tu propio backend (que lo genera mediante el endpoint de preflight de Surt). En los ejemplos siguientes, fetchVerifyJwt() es tu función auxiliar que devuelve la cadena del JWT.

tip

Solicita un JWT nuevo justo antes de cada llamada a verify(). Un JWT expira 30 minutos después de emitirse.

La versión web es solo de recopilación: el SDK devuelve un payload cifrado que tu backend reenvía a Surt.

SignInButton.tsx
import { collect } from '@surtai/guardian-web';

async function handleSignIn() {
const { payload } = await collect({ collectLocation: false });

await fetch('/api/sign-in', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ userId: 'user_123', payload }),
});
// Your /api/sign-in forwards `payload` to Surt's evaluate endpoint
// and decides what to return to the client.
}

Próximos pasos​

Elige tu plataforma para ver la guía de integración completa: