Pular para o conteúdo principal
Versão: Guardian v0.5.3

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.

1
Instalar
Adicione o SDK ao seu projeto
2
Inicializar
Configure na inicialização do app
3
Gerar JWT + Verificar
Obtenha um JWT do seu backend e chame verify()

Como funciona​

  1. Instale o SDK no seu projeto
  2. Inicialize o SDK na inicialização do app (sem chave de API no cliente)
  3. 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
  4. Chame verify(jwt) com um JWT novo para uma decisão de risco direta, ou collect(jwt?) para o fluxo servidor para servidor
  5. Receba uma decisão de risco de verify(), ou um payload criptografado de collect() 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 retorna allowed: true/false ao 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​

PlataformaPacoteDistribuiçãoverify()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)✓✓

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).