Guardian SDK
O Surt Guardian é um SDK de inteligência de dispositivos para aplicações móveis e web. Ele coleta sinais do dispositivo, executa verificações de integridade do dispositivo onde disponíveis e envia tudo ao backend da Surt para a avaliação de risco. Todas as decisões de segurança são tomadas no lado do servidor.
Como funciona
- Instale o SDK no seu projeto
- Inicialize o SDK na inicialização do app (sem chave de API no cliente)
- Seu backend gera um JWT de curta duração chamando o endpoint de preflight da Surt com sua chave de API
sp_live_*e o contexto da transação - Chame
verify(jwt)com um JWT novo para uma decisão de risco direta, oucollect(jwt?)para o fluxo servidor para servidor - Receba uma decisão de risco de
verify(), ou um payload criptografado decollect()que seu backend envia à Surt
O SDK cuida internamente da impressão digital do dispositivo e da coleta de dados. A chave de API sp_live_* nunca sai do seu backend - o cliente só guarda JWTs de curta duração.
Dois caminhos de verificação
verify(jwt): o SDK chama a Surt diretamente e retornaallowed: true/falseao seu app. Solicite um novo JWT para cada chamada. Um JWT expira 30 minutos após ser emitido. Apenas SDKs nativos.collect(jwt?): o SDK coleta e criptografa os dados localmente, e seu backend chama o endpoint evaluate da Surt. O JWT é opcional. Passe-o para resolver o IP público do dispositivo para dentro do payload e, nos SDKs nativos, para aplicar as configurações de atestação da sua organização. Suportado em todas as plataformas, incluindo web.
Suporte de plataforma
| Plataforma | Pacote | Distribuição | 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) | ✓ | ✓ |
As plataformas nativas compartilham a mesma superfície de API e são versionadas em sincronia. O SDK web é apenas collect: não tem verify() nem inicialização no nível do app.
O que coleta
Sem permissões: informações de hardware, indicadores de segurança (root/jailbreak, emulador, depurador, VPN, Frida, Xposed, Magisk), informações de software, bateria, tipo de rede.
Opcional: localização GPS (requer a permissão de localização). Apenas no Android: detalhes do WiFi e informações de SIM/operadora (ambos requerem uma permissão) e quantidade de câmeras (sem permissão).
Links rápidos
- Início Rápido: comece em 5 minutos
- Web (Navegador): npm install
@surtai/guardian-web, sem inicialização - React Native: npm install + GuardianProvider
- iOS: configuração do Swift Package Manager
- Android: configuração do Maven/Gradle
- Autenticação: geração de JWTs de curta duração via preflight
- Collect (Servidor para Servidor): verificação backend para backend
- Níveis de Risco: entenda a avaliação de risco
- Configuração: todas as opções do SDK