Início 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 ..
No Xcode: File → Add Package Dependencies → informe https://github.com/surtTech/surt-guardian-sdk, versão 0.5.2.
dependencies {
implementation("com.surt.guardian:securitysdk:0.5.2")
}
2. Inicializar
- Web
- React Native
- iOS
- Android
Não há etapa de inicialização: o SDK web expõe uma única função estática collect(), sem provider e sem configuração. Vá para a etapa 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()
)
O cliente nunca guarda sua chave de API sp_live_*. Ela fica no seu backend, que gera os JWTs de curta duração usados abaixo.
3. Gerar um JWT e Verificar
Antes de cada verificação, seu app obtém um JWT de curta duração do seu próprio backend (que o gera pelo endpoint de preflight da Surt). Nos exemplos abaixo, fetchVerifyJwt() é a sua função auxiliar que retorna a string do JWT.
Solicite um novo JWT imediatamente antes de cada chamada verify(). Um JWT expira 30 minutos após ser emitido.
- Web
- React Native
- iOS
- Android
Web é apenas collect: o SDK retorna um payload criptografado que seu backend encaminha à 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 Passos
Escolha sua plataforma para o guia de integração completo: