Opciones de configuración
nota
El SDK no recibe ninguna clave de API. La autenticación se gestiona con un JWT de corta duración generado por tu backend y pasado a verify(). Consulta Autenticación.
GuardianOptions
| Campo | Tipo | Predeterminado | Plataformas | Descripción |
|---|---|---|---|---|
failurePolicy | FailurePolicy | fail | iOS, Android | Lo que devuelve verify() cuando la llamada falla. React Native no expone esta opción y siempre usa fail. |
logLevel | LogLevel | warn | iOS | Nivel de registro. Android ignora esta opción en la inicialización y registra en el nivel INFO. |
collectLocation | boolean | false | iOS, Android | Recopilación GPS (requiere el permiso de ubicación) |
collectWifiInfo | boolean | false | Android | Detalles de WiFi (requiere el permiso de ubicación). Sin efecto en iOS. |
collectSimCardInfo | boolean | false | Android | Información de SIM/operador (requiere READ_PHONE_STATE). Sin efecto en iOS. |
collectCameraInfo | boolean | false | Android | Cantidad de cámaras. No requiere permiso. Sin efecto en iOS. |
En React Native, las mismas opciones son props de GuardianProvider y campos de GuardianSDK.initialize(), y cada una se comporta como en la plataforma subyacente.
FailurePolicy
failurePolicy aplica solo a verify(). collect() siempre devuelve el error.
| Política | Comportamiento |
|---|---|
fail (predeterminado) | verify() devuelve el error. Tu código decide qué hacer. |
allow | verify() devuelve allowed: true con riskLevel unknown, y el mensaje de error en errors. |
custom(handler) | verify() devuelve el VerificationResult que tu handler construye a partir del error. En Swift: .custom { error in ... }. En Kotlin: FailurePolicy.Custom { error -> ... }. |
En iOS la política aplica a cada fallo de verify(). En Android aplica solo cuando el SDK encuentra un error interno inesperado. Un fallo de red o un error HTTP de Surt se devuelve como fallo sin importar la política.