Saltar al contenido principal
Version: Guardian v0.5.3

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​

CampoTipoPredeterminadoPlataformasDescripción
failurePolicyFailurePolicyfailiOS, AndroidLo que devuelve verify() cuando la llamada falla. React Native no expone esta opción y siempre usa fail.
logLevelLogLevelwarniOSNivel de registro. Android ignora esta opción en la inicialización y registra en el nivel INFO.
collectLocationbooleanfalseiOS, AndroidRecopilación GPS (requiere el permiso de ubicación)
collectWifiInfobooleanfalseAndroidDetalles de WiFi (requiere el permiso de ubicación). Sin efecto en iOS.
collectSimCardInfobooleanfalseAndroidInformación de SIM/operador (requiere READ_PHONE_STATE). Sin efecto en iOS.
collectCameraInfobooleanfalseAndroidCantidad 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íticaComportamiento
fail (predeterminado)verify() devuelve el error. Tu código decide qué hacer.
allowverify() 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.