Inicio rápido
1. Instalar
- Web
- React Native
- iOS
- Android
npm install @surtai/guardian-web@0.5.0
npm install @surtai/guardian-rn@0.5.2
cd ios && pod install && cd ..
En Xcode: File → Add Package Dependencies → ingresa https://github.com/surtTech/surt-guardian-sdk, versión 0.5.2.
dependencies {
implementation("com.surt.guardian:securitysdk:0.5.2")
}
2. Inicializar
- Web
- React Native
- iOS
- Android
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.
import { GuardianProvider } from '@surtai/guardian-rn';
export default function App() {
return (
<GuardianProvider>
<Navigation />
</GuardianProvider>
);
}
import SurtGuardianSDK
GuardianSDK.initialize(
options: GuardianOptions()
)
import com.surt.guardian.GuardianSDK
import com.surt.guardian.core.GuardianOptions
GuardianSDK.initialize(
context = this,
options = GuardianOptions()
)
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.
Solicita un JWT nuevo justo antes de cada llamada a verify(). Un JWT expira 30 minutos después de emitirse.
- Web
- React Native
- iOS
- Android
La versión web es solo de recopilación: el SDK devuelve un payload cifrado que tu backend reenvía a Surt.
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.
}
import { useGuardian } from '@surtai/guardian-rn';
function LoginScreen() {
const { verify } = useGuardian();
const handleLogin = async () => {
const jwt = await fetchVerifyJwt();
const result = await verify(jwt);
if (result.allowed) {
// Proceed
} else {
// Blocked - check result.riskLevel
}
};
}
let jwt = try await fetchVerifyJwt()
let result = try await GuardianSDK.shared.verify(jwt: jwt)
if result.allowed {
// Proceed
}
val jwt = fetchVerifyJwt()
val result = GuardianSDK.getInstance().verifySuspend(jwt = jwt).getOrThrow()
if (result.allowed) {
// Proceed
}
Próximos pasos
Elige tu plataforma para ver la guía de integración completa: