--- title: Best Practices description: Richtlinien für die sichere Integration, Aktualisierung, Prüfung und Einführung der Unico-SDKs, einschließlich der Sicherheitsregeln der Staging-Umgebung (UAT). canonical: https://developer.unico.io/de/developers/sdks-and-tools/best-practices-for-sdk-implementation locale: de generated_by: markdown-export --- - [/de/](/de/) - [SDKs und Tools](/de/developers/sdks-and-tools/overview) - Best Practices **Auf dieser Seite# Best Practices Diese Seite fasst die wichtigsten Richtlinien für die Integration und Pflege der Unico-SDKs zusammen. Die Einhaltung dieser Praktiken reduziert Integrationsfehler, verhindert Sicherheitsvorfälle und gewährleistet einen reibungslosen Produktionsrollout. ### Erste Schritte​ Beginnen Sie mit einer Referenz-App Unico bietet für jedes SDK eine Referenz-App im Repository [reference-apps](https://github.com/unico-labs/reference-apps) an. Jede App implementiert die vollständige User Journey. Halten Sie Ihre SDKs immer aktuell SDKs werden kontinuierlich weiterentwickelt, um mehr Sicherheit und neue Funktionen zu bieten. Das zeitnahe Anwenden von Updates — insbesondere kritischer Updates — ist unerlässlich. Informationen zu Fristen und Verpflichtungen finden Sie in der [Update-Richtlinie](/de/developers/sdks-and-tools/update-policy). Identifizieren Sie die neueste verfügbare Version Überprüfen Sie die aktuelle Version für jede Plattform in den jeweiligen Release Notes: [Android Release Notes](/de/developers/sdks-and-tools/android/resources/release-notes) [iOS Release Notes](/de/developers/sdks-and-tools/ios/resources/release-notes) [Flutter Release Notes](/de/developers/sdks-and-tools/flutter/resources/release-notes) [Web — Journeys SDK Release Notes](/de/developers/sdks-and-tools/web/resources/release-notes) ### Update-Strategie​ Vermeiden Sie es, das SDK und andere Komponenten gleichzeitig zu aktualisieren Ihre Anwendung lädt wahrscheinlich mehrere Bibliotheken zusammen mit dem Unico SDK. Das gleichzeitige Aktualisieren mehrerer Abhängigkeiten erschwert die Identifizierung der Fehlerursache. Aktualisieren Sie das SDK isoliert und validieren Sie es in einer [Staging-Umgebung](#perform-tests-in-unicos-staging-environment), bevor Sie es mit anderen Änderungen kombinieren. Hilfe bei einem SDK-Update erhalten Wenn Sie ein Support-Ticket für Update-Probleme öffnen, geben Sie Folgendes an: SDK-Sprache und Implementierungstyp (nativ oder hybrid) Verwendetes Framework Aktuelle Version und Zielversion API-Key Beschreibung der Änderungen und Schritte zur Reproduktion Ergebnisse, Fehler, Logs, Screenshots oder Videos ### JWT-Sicherheit​ Manipulieren Sie das JWT-Objekt nicht Öffnen oder modifizieren Sie das verschlüsselte JWT nichtDas nach einer erfolgreichen Aufnahme zurückgegebene JWT ist **verschlüsselt**. Öffnen, parsen oder serialisieren Sie es nicht. Seine interne Struktur kann sich ohne Vorankündigung ändern. Verwenden Sie es ausschließlich beim Übermitteln von Bildern an die APIs von Unico. Verwenden Sie für Bildvorschauen das zusammen mit dem JWT bereitgestellte Base64-Attribut — decodieren Sie niemals das JWT selbst. Senden Sie das JWT innerhalb von 10 Minuten WarnungAus Sicherheitsgründen muss das JWT innerhalb von **10 Minuten** nach der Aufnahme an das Backend von Unico gesendet werden. Pakete, die nach diesem Zeitfenster eingehen, werden ungültig gemacht. Senden Sie das JWT nur einmal WarnungDas JWT darf **nur einmal** übermittelt werden. Tritt beim Übermitteln ein Fehler auf, muss eine neue biometrische Aufnahme durchgeführt werden — verwenden Sie dasselbe JWT nicht erneut. ### Testrichtlinien​ Verwenden Sie keine Virtualisierung oder Emulatoren Das Ausführen des SDK in virtuellen Maschinen oder Emulatoren löst Sicherheitsfehlercodes aus (`73006`, `73600`, `73400`). Testen Sie immer auf **physischen Geräten**, um Fehler nicht falsch zu identifizieren und unnötige Nacharbeit zu vermeiden. Halten Sie DevTools beim Web-Capture nicht geöffnet Das Web SDK erkennt geöffnete DevTools als potenzielles Betrugsindiz und macht die Übermittlung ungültig. Schließen Sie DevTools, bevor Sie End-to-End-Capture-Tests durchführen. ### Führen Sie Tests in der Staging-Umgebung von Unico durch​ Führen Sie vor dem Produktionsgang gründliche Tests in der Staging-Umgebung von Unico mit realistischen Szenarien durch. Verwenden Sie staging-spezifische API-Keys und Konfigurationen — verwenden Sie niemals Produktionszugangsdaten in Tests. Die Staging-Umgebung (UAT) von IDCloud wendet die **gleichen Sicherheitskriterien wie die Produktion** an. Die folgenden Richtlinien erklären, warum das so ist und wie Sie ohne Unterbrechungen testen. Was sich im Staging geändert hat **Vorher — erkannt, aber nicht abgelehnt** Bedingungen außerhalb des Musters einer realen Nutzung wurden erkannt, verhinderten die Erfassung jedoch nicht. **Jetzt — erkannt und abgelehnt** Dieselben Bedingungen führen nun zur Ablehnung des Lebendigkeitsnachweises, mit der gleichen Strenge wie in der Produktion. Warum diese Einschränkung besteht **Verlässlichkeit — Ähnlichkeit mit der Produktion** Was im Staging besteht, muss in der Produktion genauso funktionieren — so wird verhindert, dass eine in Tests freigegebene Integration nach dem Go-live unerwartet fehlschlägt. Was Sie tun und nicht tun dürfen Wenn Sie unter realitätsnahen Bedingungen testen, beeinträchtigen die Sicherheitsschichten Ihre Entwicklung nicht. Entwicklungswerkzeuge, die nicht dem Marktstandard entsprechen, lösen Sicherheitsprüfungen aus, und die Transaktion kann blockiert werden. SzenarioStatusVollständiger Integrationsablauf — Erfassung, Übermittlung, API-Antwort und Rückgabe✅ ErlaubtFunktionale Szenarien: UI/UX, Performance, Geschäftsfehler✅ ErlaubtGerät in der Standardkonfiguration eines Endnutzers✅ ErlaubtIntegration mit Backend, APIs und Datenverarbeitung✅ ErlaubtGerät mit Root/Jailbreak❌ Nicht erlaubtAktiver Debug-Modus / USB-Debugging❌ Nicht erlaubtEmulatoren oder Virtualisierung❌ Nicht erlaubtVirtuelle Kameras oder Werkzeuge zur Automatisierung der Erfassung❌ Nicht erlaubtTools, die die Verbindung verändern❌ Nicht erlaubtUnternehmens-MDM oder aktives Monitoring auf dem Gerät❌ Nicht erlaubtSandbox in einem Container oder einer virtuellen Maschine❌ Nicht erlaubt Jede dieser Bedingungen kann zur Ablehnung des Lebendigkeitsnachweises führen. Hängt Ihr QA-Zyklus von einer dieser Bedingungen ab?Wenden Sie sich an das [Support-Team](https://business.unico.io/hc/), um Hinweise zur Konfiguration Ihrer Umgebung zu erhalten. Es gibt keine Ausnahme, keine punktuelle Freigabe und keine temporäre Lockerung — Unico hält das Staging so lange mit der Produktion gleichgestellt, wie es dies für erforderlich hält. ### Plattformspezifische Richtlinien​ Flutter: Verwenden Sie das Flutter-Plugin von Unico Versuchen Sie nicht, die nativen Android- oder iOS-SDKs in einer Flutter-Anwendung zu bridgen. Native Bridges erzeugen häufig nicht zugeordnete Fehler. Verwenden Sie immer das dedizierte Flutter-Plugin von Unico. Web: Löschen Sie alte Ressourcendateien beim Aktualisieren der Versionen Löschen Sie beim Upgrade des Web SDK die alten Ressourcendateien aus Ihrem `public`-Ordner, bevor Sie die neuen einfügen. Dateien mit identischen Namen werden nicht automatisch überschrieben und können zu Versionskonflikten führen. Mobile: Leeren Sie den Cache vor dem Erstellen neuer Versionen Build-Artefakte aus früheren SDK-Versionen können nach einem Update zu Abhängigkeitsfehlern führen. Vor dem Erstellen einer neuen Version: **Flutter:** löschen Sie `pubspec.lock` und führen Sie `flutter pub get` aus **iOS:** führen Sie `pod cache clean --all` und `pod install` aus **Android:** führen Sie `./gradlew clean` aus Obfuskierungseinstellungen Schließen Sie den Unico SDK-Code von Ihrer Obfuskierungskonfiguration aus. Das Obfuskieren des SDK führt häufig zu Fehlern in Release-Builds, die in Debug-Builds nicht auftreten. Lesen Sie die plattformspezifische Dokumentation für die erforderlichen Keep-Regeln. ### UX und Performance​ Trennen Sie den Vorbereitungs- und Kameraöffnungsfluss in zwei Schritte Strukturieren Sie den SDK-Fluss in zwei unterschiedliche Phasen: **Vorbereiten** — initialisieren Sie das SDK, während die Seite lädt (vor der Benutzerinteraktion). **Öffnen** — starten Sie die Kamera nur, wenn der Benutzer die Aktion explizit auslöst. Die vorherige Vorbereitung des SDK reduziert die wahrgenommene Latenz und verbessert die Benutzererfahrung erheblich. ### Produktionsrollout​ Erstellen Sie eine sichere Checkliste für den Produktionsrollout Überprüfen Sie vor dem Deployment in die Produktion: Produktions-API-Keys und Umgebungskonfigurationen sind korrekt Rollback-Plan ist definiert und getestet Log-Erfassungsprotokoll ist vorhanden Support-Ticket-Verfahren sind für den Umgang mit Fehlern dokumentiert Alle Validierungen in der Staging-Umgebung wurden bestanden Zuletzt aktualisiert am 23. Okt. 2026**