Konfigurationsoptionen
hinweis
Das SDK nimmt keinen API-Schlüssel entgegen. Die Authentifizierung erfolgt über ein kurzlebiges JWT, das von Ihrem Backend erzeugt und an verify() übergeben wird. Siehe Authentifizierung.
GuardianOptions
| Feld | Typ | Standard | Plattformen | Beschreibung |
|---|---|---|---|---|
failurePolicy | FailurePolicy | fail | iOS, Android | Was verify() zurückgibt, wenn der Aufruf fehlschlägt. React Native stellt diese Option nicht bereit und verwendet immer fail. |
logLevel | LogLevel | warn | iOS | Detailgrad der Protokollierung. Android ignoriert diese Option bei der Initialisierung und protokolliert auf der Stufe INFO. |
collectLocation | boolean | false | iOS, Android | GPS-Erfassung (erfordert die Standortberechtigung) |
collectWifiInfo | boolean | false | Android | WiFi-Details (erfordert die Standortberechtigung). Unter iOS ohne Wirkung. |
collectSimCardInfo | boolean | false | Android | SIM-/Carrier-Informationen (erfordert READ_PHONE_STATE). Unter iOS ohne Wirkung. |
collectCameraInfo | boolean | false | Android | Kameraanzahl. Keine Berechtigung erforderlich. Unter iOS ohne Wirkung. |
In React Native sind dieselben Optionen Props von GuardianProvider und Felder von GuardianSDK.initialize(), und jede verhält sich wie auf der zugrunde liegenden Plattform.
FailurePolicy
failurePolicy gilt nur für verify(). collect() gibt den Fehler immer zurück.
| Richtlinie | Verhalten |
|---|---|
fail (Standard) | verify() gibt den Fehler zurück. Ihr Code entscheidet, was geschieht. |
allow | verify() gibt allowed: true mit riskLevel unknown zurück, und die Fehlermeldung steht in errors. |
custom(handler) | verify() gibt das VerificationResult zurück, das Ihr Handler aus dem Fehler erzeugt. In Swift: .custom { error in ... }. In Kotlin: FailurePolicy.Custom { error -> ... }. |
Unter iOS gilt die Richtlinie für jeden Fehlschlag von verify(). Unter Android gilt sie nur, wenn das SDK auf einen unerwarteten internen Fehler stößt. Ein Netzwerkfehler oder ein HTTP-Fehler von Surt wird unabhängig von der Richtlinie als Fehlschlag zurückgegeben.