Migration von Ionic Identity Vault

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

Native Biometric ist ein vollständiger Ersatz für den sicheren Credential-Vault-Teil von Ionic Identity Vault. Es macht mehr als nur nach Biometrik zu fragen: Es speichert, prüft, ruft und löscht Credentials mit nativer Keychain- oder Keystore-Schutz. Wenn der biometrische Zugriffsschutz aktiviert ist, erfordern geschützte Lesevorgänge Face ID, Touch ID oder Android-Biometrik, bevor Ihre App das Credential erhält.

Verwenden Sie Native Biometric direkt für Tokens und Credential-Vault-Flows. Ihre App entscheidet, wann ein geschützter Lesevorgang angefordert wird, um ihre Timeout- und Lifecycle-Richtlinie anzuwenden. Wenn Sie zusätzlich eine breite verschlüsselte Datenbank für Daten jenseits von Credentials benötigen, fügen Sie hinzu Schnelles SQL oder SQLite-Datenspeicherung; das ist für eine Credential-Vault-Migration optional.

Automatische Timeout-Sperren und Hintergrund-Privacy-Screens sind eine Policy auf Anwendungsebene, daher müssen Sie sie in Ihrer App beibehalten oder neu erstellen. Vault-Modi mit benutzerdefiniertem Passwort und nur im Speicher werden von Native Biometric nicht unterstützt; verwenden Sie ein separates Anwendungsspeicher- und Verschlüsselungsdesign, wenn Sie diese benötigen.

Capgo Ersetzungen im Überblick

Ionic Enterprise-Plugin	Capgo-Ersatz	Migrationsguide
Sichere Speicherung	@capgo/capacitor-fast-sql oder @capgo/capacitor-data-storage-sqlite	Migration von Secure Storage
Auth-Verbindung herstellen	@capgo/capacitor-social-login	Migration von Auth Connect
Identity Vault: Credential-Vault-Abläufe	@capgo/capacitor-native-biometric — direkter Ersatz	Du bist hier

Was Native Biometric abdeckt

Sicherer Credential-Vault: Credentials für einen Server oder Account speichern, abrufen, prüfen und löschen.
Biometrische Entsperrung: getSecureCredentials Zeigt den nativen Biometric-Prompt an, bevor geschützte Credentials gelesen werden können.
App-gesteuerte Lock-Policy: Rufe den geschützten Lesezugriff auf, wenn die App wieder in den Vordergrund kommt, nach einem Timeout oder vor einer sensiblen Aktion.
Separater Identity-Prompt: verifyIdentity unterstützt den Fallback auf das Geräte-Passwort unter iOS; der Zugriff auf geschützte Credentials bleibt biometrisch.
Optionen für die Zugriffskontrolle: bestimmen, ob Änderungen an der biometrischen Registrierung geschützte Credentials ungültig machen.

Migrationsschritte

Native Biometric installieren und native code synchronisieren.

npm install @capgo/capacitor-native-biometric
npx cap sync

Speichern Sie Access- und Refresh-Tokens oder andere Credentials mit aktivierter biometrischer Zugriffskontrolle.
Nutzt getSecureCredentials um geschützte Zugangsdaten zu entsperren wenn die App wieder aufgenommen wird, nach einem Inaktivitäts-Timeout oder vor einer sensiblen Aktion.
Behalte das Timeout- und Privacy-Screen-Verhalten in deiner App-Schicht. Custom-Passcode- und Memory-only-Modi werden von Native Biometric nicht unterstützt; nutze bei Bedarf ein separates Design für App-Storage und Verschlüsselung.
Nutzt isCredentialsSaved und deleteCredentials für Onboarding-, Locked-State- und Logout-Flows.
Gespeicherte Secrets beim ersten Start migrieren indem du sie aus Identity Vault liest und mit Native Biometric speicherst.
Ionic Identity Vault entfernen aus deinen Dependencies und der nativen Konfiguration.

Nächste Schritte

Weiterlesen: Migration von Ionic Identity Vault

Wenn du es nutzt Migration von Ionic Identity Vault um Sicherheit und Compliance zu planen, verbinden Sie es mit Verschlüsselung für die Implementierungsdetails in Encryption, Konformität für das Implementierungsdetail in Compliance, Capgo Security-Scanner für den Produkt-Workflow im Capgo Security Scanner, Capgo Sicherheit für den Produkt-Workflow in Capgo Security und Capgo Trust Center für den Produkt-Workflow im Capgo Trust Center.