Provider-Einrichtung
Option A: Provider + Hook (Empfohlen)
Umschließen Sie Ihren App-Stamm mit GuardianProvider. Dies initialisiert das SDK und macht es über den useGuardian-Hook für alle untergeordneten Komponenten zugänglich.
import { GuardianProvider } from '@surtai/guardian-rn';
export default function App() {
return (
<GuardianProvider
collectLocation={true}
>
<Navigation />
</GuardianProvider>
);
}
Das SDK hält keinen API-Schlüssel. Kunden- und Transaktionskontext stammen aus einem kurzlebigen JWT, das Ihr Backend erzeugt. Siehe Transaktionen verifizieren für Details.
Provider-Props
| Prop | Typ | Standard | Beschreibung |
|---|---|---|---|
logLevel | 'debug' | 'info' | 'warn' | 'error' | 'none' | 'warn' | SDK-Protokolldetailliertheit. Wird unter iOS angewendet. Android ignoriert die Option und protokolliert auf der Stufe INFO. |
collectLocation | boolean | false | GPS-Erfassung aktivieren (erfordert Berechtigungen) |
collectWifiInfo | boolean | false | WLAN-Netzwerkdetails aktivieren (nur Android) |
collectSimCardInfo | boolean | false | SIM-/Anbieterinfo aktivieren (nur Android) |
collectCameraInfo | boolean | false | Kameraanzahl aktivieren (nur Android) |
Option B: Imperative API
Wenn Sie keinen React-Kontext verwenden möchten, rufen Sie initialize() direkt beim App-Start auf:
import { GuardianSDK } from '@surtai/guardian-rn';
GuardianSDK.initialize({
logLevel: 'warn',
collectLocation: true,
});
useGuardian-Hook
const {
isInitialized, // boolean - true after SDK is ready
verify, // (jwt: string, options?: VerifyOptions) => Promise<VerificationResult>
collect, // (jwt?: string, options?: VerifyOptions) => Promise<CollectResult>
} = useGuardian();
useGuardian() muss innerhalb eines <GuardianProvider> aufgerufen werden. Ein Aufruf außerhalb löst einen Fehler aus.
Fehlerbehebung
| Fehler | Ursache | Lösung |
|---|---|---|
verification_failed mit not_initialized in der Meldung (iOS) | verify() wurde aufgerufen, bevor das SDK bereit war | GuardianProvider verwenden oder initialize() beim Start aufrufen |
useGuardian-Hook-Fehler | Hook außerhalb des Providers verwendet | Komponentenbaum mit <GuardianProvider> umschließen |
verification_failed | Die Anfrage an Surt ist fehlgeschlagen. Ein fehlendes, fehlerhaft aufgebautes oder abgelaufenes JWT ist eine mögliche Ursache. Unter Android enthält die Meldung den HTTP-Status. | Fordern Sie für jeden Aufruf ein neues JWT von Ihrem Backend an und übergeben Sie es an verify() |
verify() und collect() werden mit einem Fehler abgelehnt, dessen error.code auf verification_failed, collect_failed oder sdk_error gesetzt ist. Wie Sie die Details auslesen, steht unter Fehlercodes.