Opções de Configuração
observação
O SDK não recebe nenhuma chave de API. A autenticação é feita por um JWT de curta duração gerado pelo seu backend e passado para verify(). Veja Autenticação.
GuardianOptions
| Campo | Tipo | Padrão | Plataformas | Descrição |
|---|---|---|---|---|
failurePolicy | FailurePolicy | fail | iOS, Android | O que verify() retorna quando a chamada falha. O React Native não expõe esta opção e sempre usa fail. |
logLevel | LogLevel | warn | iOS | Nível de detalhe dos logs. O Android ignora esta opção na inicialização e registra logs no nível INFO. |
collectLocation | boolean | false | iOS, Android | Coleta de GPS (requer a permissão de localização) |
collectWifiInfo | boolean | false | Android | Detalhes do WiFi (requer a permissão de localização). Sem efeito no iOS. |
collectSimCardInfo | boolean | false | Android | Informações de SIM/operadora (requer READ_PHONE_STATE). Sem efeito no iOS. |
collectCameraInfo | boolean | false | Android | Quantidade de câmeras. Nenhuma permissão necessária. Sem efeito no iOS. |
No React Native, as mesmas opções são props de GuardianProvider e campos de GuardianSDK.initialize(), e cada uma se comporta como na plataforma subjacente.
FailurePolicy
failurePolicy se aplica apenas a verify(). collect() sempre retorna o erro.
| Política | Comportamento |
|---|---|
fail (padrão) | verify() retorna o erro. Seu código decide o que fazer. |
allow | verify() retorna allowed: true com riskLevel unknown e a mensagem de erro em errors. |
custom(handler) | verify() retorna o VerificationResult que seu handler constrói a partir do erro. Em Swift: .custom { error in ... }. Em Kotlin: FailurePolicy.Custom { error -> ... }. |
No iOS, a política se aplica a toda falha de verify(). No Android, ela se aplica apenas quando o SDK encontra um erro interno inesperado. Uma falha de rede ou um erro HTTP da Surt é retornado como falha, qualquer que seja a política.