Zum Hauptinhalt springen
Version: Guardian v0.5.3

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​

FeldTypStandardPlattformenBeschreibung
failurePolicyFailurePolicyfailiOS, AndroidWas verify() zurückgibt, wenn der Aufruf fehlschlägt. React Native stellt diese Option nicht bereit und verwendet immer fail.
logLevelLogLevelwarniOSDetailgrad der Protokollierung. Android ignoriert diese Option bei der Initialisierung und protokolliert auf der Stufe INFO.
collectLocationbooleanfalseiOS, AndroidGPS-Erfassung (erfordert die Standortberechtigung)
collectWifiInfobooleanfalseAndroidWiFi-Details (erfordert die Standortberechtigung). Unter iOS ohne Wirkung.
collectSimCardInfobooleanfalseAndroidSIM-/Carrier-Informationen (erfordert READ_PHONE_STATE). Unter iOS ohne Wirkung.
collectCameraInfobooleanfalseAndroidKameraanzahl. 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.

RichtlinieVerhalten
fail (Standard)verify() gibt den Fehler zurück. Ihr Code entscheidet, was geschieht.
allowverify() 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.