L'authentification biométrique permet aux utilisateurs d'accéder aux applications de manière sécurisée en utilisant leur empreinte digitale, leur visage ou d'autres caractéristiques biologiques au lieu de mots de passe. Pour les développeurs travaillant avec Capacitor, la mise en œuvre de cette fonctionnalité est simple et fonctionne sur les deux iOS et Android. Voici un aperçu rapide :
-
Pourquoi utiliser l'authentification biométrique ?
- C'est plus sécurisé que les mots de passe.
- Cela améliore l'expérience utilisateur en faisant l'authentification plus rapide.
- Cela répond aux normes de sécurité pour les données sensibles.
-
Méthodes supportées :
- Empreinte digitale : rapide et courante.
- Reconnaissance faciale : option sans contact.
- Scanning Iris : cas d'utilisation de haute sécurité (dispositifs limités).
- Reconnaissance vocale : axée sur l'accessibilité (support limité).
-
Outils clés requis :
- Capacitor 3.0+.
-
Les points clés de la configuration :
- Ajoutez les permissions à AndroidManifest et Info.plist.
- Utilisez Keychain (iOS) ou Keystore (Android) pour un stockage sécurisé.
- Testez soigneusement pour la compatibilité et les options de fallback.
Comparaison rapide des plugins :
| Nom du plugin | Capacitor Version | Fonctionnalités | Meilleur adapté à |
|---|---|---|---|
@aparajita/capacitor-biometric-auth | Capacitor 8 | Authentification biométrique native, informations de dispositif | Nouveaux projets utilisant Capacitor 8 |
capacitor-native-biometric | Capacitor 3, 4 | Stockage sécurisé des informations d'identification, Keychain/Keystore | Gestion des informations d'identification |
| Toutes les versions | Support d'authentification biométrique et de dispositif | Options d'authentification flexibles |
Authentification biométrique dans les applications Capacitor est une manière sécurisée et conviviale de protéger les données sensibles. L'article complet détaille les étapes de configuration, les exemples code, les stratégies de test et les normes de sécurité.
Authentification biométrique Ionic (FaceID / Imprimante à doigts)
Exigences de configuration
Pour activer l'authentification biométrique dans votre Capacitor, vous devrez configurer certaines outils, des dépendances et des paramètres spécifiques aux plateformes. En dessous, vous trouverez les exigences de configuration étape par étape pour les deux plateformes Android et iOS.
Outils et dépendances requis
Avant de plonger dans la mise en œuvre, assurez-vous que les outils et les dépendances suivants sont prêts :
| Composant | Version minimale | But |
|---|---|---|
| Capacitor | 3.0 ou supérieur | Framwork de base |
| Node.js | Dernière LTS | Gestion de package |
| Xcode | Dernière version | Développement iOS |
| Android Studio | Dernière version | Développement Android |
| Appareils physiques | iOS 13+ / Android API 23+ | Testez les fonctionnalités biométriques |
Choisissez un plugin biométrique basé sur votre version de Capacitor :
- @aparajita/capacitor-authentification-biométrique pour Capacitor 8
- capacitor-authentification-biométrique-native pour Capacitor 3 et 4
Étapes de configuration Android
Pour configurer l'authentification biométrique sur Android, vous devrez apporter quelques ajustements à vos fichiers de projet :
-
Configuration du manifeste
Ajoutez les autorisations suivantes à votre
AndroidManifest.xml__CAPGO_KEEP_0__ :<uses-permission android:name="android.permission.USE_BIOMETRIC" /> <!-- For Android 9 (API 28) or lower --> <uses-permission android:name="android.permission.USE_FINGERPRINT" /> -
Configuration Gradle
Mettez à jour le fichier de votre application pour qu'il inclue les dépendances nécessaires aux authentifications biométriques :
build.gradleÉtapes de configuration pour iOSdependencies { implementation "androidx.biometric:biometric:1.1.0" }
Pour iOS, vous devez suivre ces étapes pour configurer l'authentification biométrique :
Configuration de Info.plist
-
Ajoutez la description d'utilisation requise à votre
__CAPGO_KEEP_0__ :
Info.plistConfiguration de Keychain<key>NSFaceIDUsageDescription</key> <string>Authentication required for secure access</string> -
Activez les capacités de Keychain dans Xcode :
iOS Setup Steps
- Ouvrez les paramètres de votre projet.
- Allez dans la section « Signature et capacités .
- Ajoutez la capacité de « Partage de clés de clés ». Configurez les groupes d'accès si nécessaire. Politiques d'authentification
- Configurez les politiques d'authentification locales pour gérer :
-
Essais d'authentification échoués
Revenir aux codes de passe de l'appareil
- Revenir aux codes de passe de l'appareil
- Revenir aux codes de passe de l'appareil
- Disponibilité biométrique
Pour une meilleure sécurité, utilisez le coffre-fort iOS pour stocker les données sensibles. Cela garantit la compatibilité avec les deux Touch ID et Face ID tout en protégeant les informations d'identification de l'utilisateur.
Code Implementation
Une fois que les configurations de mise en place sont en place, l'étape suivante consiste à mettre en œuvre des code sécurisés. Cela implique de sélectionner le bon plugin et de créer des flux d'authentification fiables.
Guide de sélection de plugin
Lors du choix d'un plugin d'authentification biométrique pour votre application Capacitor, votre choix devrait s'aligner sur les besoins spécifiques du projet. Voici quelques options populaires :
| Nom du plugin | Capacitor Version | Caractéristiques clés | Meilleur pour |
|---|---|---|---|
| @aparajita/capacitor-biometric-auth | Capacitor 8 | Authentification biométrique, informations de dispositif, API complet | Nouveaux projets commençant avec Capacitor 8 |
| capacitor-native-biometric | Capacitor 3, 4 | Stockage de données d'authentification sécurisé, intégration Keychain/Keystore | Projets établis nécessitant une gestion d'authentification |
| Toutes les versions | Authentification biométrique et de dispositif, API propre | Projets nécessitant des options d'authentification flexibles |
Exemples d'authentification Code
Voici comment utiliser le @capgo/capacitor-native-biometric plugin pour l'authentification biométrique :
import { Biometrics } from '@capgo/capacitor-native-biometric';
async function setupBiometricAuth() {
try {
const { isAvailable } = await Biometrics.isBiometricsAvailable();
if (!isAvailable) {
return {
success: false,
message: "Biometric authentication not available"
};
}
const result = await Biometrics.authenticate({
reason: "Access your secure data",
title: "Verify Identity",
subtitle: "Use biometrics to authenticate",
cancelTitle: "Use Password Instead"
});
return {
success: true,
data: result
};
} catch (error) {
return {
success: false,
error: error.message
};
}
}
Pour gérer les informations de connexion sécurisées, le capacitor-native-biometric Le plugin propose une approche simple :
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
async function secureCredentialStorage(credentials) {
try {
await NativeBiometric.setCredentials({
username: credentials.username,
password: credentials.password,
server: "api.yourserver.com"
});
// Verify storage by retrieving the credentials
const stored = await NativeBiometric.getCredentials({
server: "api.yourserver.com"
});
return stored.username === credentials.username;
} catch (error) {
console.error("Credential storage failed:", error);
return false;
}
}
Une fois le code mis en place, il est essentiel de valider sa fonctionnalité par des tests appropriés.
Méthodes de test
Pour vous assurer que votre authentification biométrique est fiable et sécurisée, envisagez ces stratégies de test :
-
Compatibilité des appareils
Vérifiez si l'authentification fonctionne sur divers appareils et conditions :
async function runCompatibilityTests() { const tests = { biometricAvailable: await Biometrics.isBiometricsAvailable(), credentialStorage: await testCredentialStorage(), authenticationFlow: await testAuthFlow(), fallbackMechanism: await testFallbackAuth() }; return tests; } -
Gestion des erreurs et scénarios courants
Simulez des erreurs et testez les mécanismes de rechange :
async function validateErrorHandling() { try { await Promise.race([ Biometrics.authenticate(), new Promise((_, reject) => setTimeout(() => reject(new Error("Timeout")), 30000) ) ]); } catch (error) { return implementFallbackAuth(); } } -
Validation de la sécurité
Vérifiez que votre mise en œuvre respecte les normes de sécurité :
async function validateSecurityMeasures() { const validations = { keychain: await validateKeychainAccess(), biometricStrength: await checkBiometricStrength(), encryptionStatus: await verifyEncryption() }; return validations.keychain && validations.biometricStrength && validations.encryptionStatus; }
Testez également les scénarios suivants :
- Essais d'authentification multiples
- Comportement après redémarrage du dispositif
- Transitions entre les états d'application en avant-plan et en arrière-plan
- Changements dans la connectivité réseau
- Mises à jour des paramètres de sécurité biométriques du système
Un test approfondi garantit que le système d'authentification biométrique est robuste et prêt à une utilisation dans le monde réel.
Normes de Sécurité
Assurer une forte sécurité dans l'authentification biométrique signifie donner la priorité à la protection des données, se conformer aux réglementations de conformité et appliquer des techniques de sécurité à couches multiples.
Méthodes de Sécurité des Données
Sur iOS, les données biométriques sont chiffrées et stockées à l'aide de Clé de chiffrement, tandis que Android utilise le Clé de chiffrement. Si vous utilisez le capacitor-native-biometric plugin, vous pouvez stocker de manière sécurisée les informations d'identification de l'utilisateur comme ceci:
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
async function securelyStoreCredentials(username, password) {
const server = "api.yourapp.com";
// Use the highest available encryption
await NativeBiometric.setCredentials({
username,
password,
server,
authenticationType: "biometricAndDevice",
accessControl: "biometryAny"
});
}
Pour la transmission de données, implémentez toujours une chiffrement de bout en bout pour protéger les informations sensibles.
Guide de stockage
Les magasins d'applications imposent des règles strictes pour la sécurité biométrique. Voici un aperçu des principaux exigences des plateformes :
| Plateforme | Exigences Clés | Notes d'implémentation |
|---|---|---|
| iOS | Utilisez le framework LocalAuthentication, fournissez des options de remplacement et assurez-vous du consentement clair de l'utilisateur | Doit supporter à la fois Face ID et Touch ID |
| Android | Utilisez le BiometricPrompt API, obtenez une permission explicite de l'utilisateur et déclarez les niveaux de sécurité | Supporter la reconnaissance d'empreinte digitale et faciale, avec des distinctions pour les niveaux de sécurité variés |
Configuration à Facteur Multiple
Améliorer la sécurité nécessite souvent la combinaison de la vérification biométrique avec une couche supplémentaire d'authentification. Par exemple, après l'authentification biométrique initiale la vérification biométriquevous pouvez ajouter une étape secondaire pour confirmer l'identité de l'utilisateur :
async function setupMultiFactorAuth() {
// First factor: Biometric verification
const biometricResult = await Biometrics.authenticate({
reason: "Verify your identity",
title: "Authentication Required"
});
if (biometricResult.verified) {
// Second factor: Time-based OTP or similar mechanism
const totpResult = await verifyTOTP();
return totpResult.success;
}
return false;
}
Une approche multi-facteur comprend généralement :
- L'authentification biométrique primaire
- La vérification secondaire (par exemple, SMS code ou une application d'authentificateur)
- La confirmation spécifique à la transaction pour une sécurité renforcée
Si vous utilisez des outils comme Capgo pour les mises à jour en temps réel, assurez-vous de respecter les normes de sécurité en profitant de ses chiffrement de bout en bout . Cela garantit que vos méthodes d'authentification biométrique restent sécurisées pendant les mises à jour et sont conformes aux exigences du plateau. [1].
Guide de Maintenance
Maintenez votre système biométrique en cours de fonctionnement en équilibrant la vitesse, l'efficacité de la batterie et les mises à jour à temps.
Conseils de Vitesse et de Batterie
Voici un code snippet pour l'implémentation d'une authentification biométrique efficace :
// Efficient authentication implementation
async function optimizedBiometricCheck() {
const authResult = await NativeBiometric.isAvailable();
if (!authResult.isAvailable) {
return handleFallback();
}
// Cache authentication state to avoid unnecessary re-checks
if (this.cachedAuthState && !this.isAuthExpired()) {
return this.cachedAuthState;
}
return NativeBiometric.verifyIdentity({
reason: "Verify your identity",
title: "Authentication Required",
maxAttempts: 3
});
}
Pour tirer le meilleur parti de la performance de votre système biométrique :
- Authentification en Lot: Au lieu de multiples invitations, groupez les actions nécessitant une authentification dans une session pour réduire les interruptions.
- Cache Intelligente: Enregistrez les états d'authentification de manière sécurisée et définissez des durées d'expiration pour éviter les vérifications redondantes.
- Optimisation de l'Arrière-Plan: Mettez temporairement en pause les tâches non essentielles pendant l'authentification pour améliorer la vitesse et économiser la batterie.
- Approche Déclenchée par les Événements: Remplacez la mise à jour constante par des écouteurs d'événements pour surveiller l'état d'authentification de manière plus efficace.
Mises à jour avec Capgo

Capgo simplifie les mises à jour de l'application.
Voici pourquoi Capgo est un outil idéal pour gérer les mises à jour :
- Déploiement instantané: Déployez des correctifs de sécurité critiques et de nouvelles fonctionnalités sans délai.
- Déploiement étalé: Testez les mises à jour avec des groupes d'utilisateurs sélectionnés avant de les déployer à tous.
- Contrôle de version: Suivez différentes versions d'authentification pour une meilleure gestion.
- Rouge d'urgence: Revenez rapidement à une version précédente si des problèmes surgissent.
API Mises à jour
Le maintien à jour de vos API biométriques est vital pour la sécurité et la fonctionnalité. Restez proactif avec les mises à jour en suivant ces lignes directrices :
| Type de mise à jour | Méthode de suivi | Calendrier d'implémentation |
|---|---|---|
| Fichiers de correctifs de sécurité | Alertes du dépôt de plugins | 24 heures |
| Mises à jour de fonctionnalités | Documentation de la plateforme | 1 semaine |
| Changements majeurs | Notes de version | 2-4 semaines |
| Mises à jour de la politique de stockage | Portail du développeur | Avant la soumission |
Concentrez-vous sur ces domaines :
- Changements de plateforme Suivez les mises à jour des API de LocalAuthentication d'iOS et de BiometricPrompt d'Android.
- Normes de sécuritéRestez aligné sur les dernières exigences de sécurité biométrique.
- Directives de magasin: Assurez-vous de respecter les politiques d'Apple App Store et Google Play pour éviter les problèmes de soumission.
Conclusion
Principales retombées
La mise en place de l'authentification biométrique dans votre Capacitor implique un équilibre entre la sécurité, les performances et l'expérience utilisateur. Voici un aperçu rapide des éléments clés à prendre en compte :
| Composant | Focus sur l'implémentation | Considérations clés |
|---|---|---|
| Normes de sécurité | Stockage natif de la plateforme (Keychain/Keystore) | Chiffrement de bout en bout, protection des informations d'identification |
| Sélection du plugin | Compatibilité de la dernière version | Support de plusieurs types de biométrie |
| Gestion des mises à jour | Cycle de maintenance régulier | Déploiement rapide des correctifs de sécurité |
| Expérience utilisateur | Options d'authentification de secours | Prompts d'authentification clairs et utilisateurs |
Ces composants sont votre carte pour une intégration réussie.
Étapes pour mettre en œuvre l'authentification biométrique
Suivez ces étapes pour intégrer l'authentification biométrique dans votre application :
-
Intégration du plugin
Commencez par choisir un plugin biométrique qui correspond à votre Capacitor version. Assurez-vous que vos fichiers de configuration - comme __CAPGO_KEEP_1__ et __CAPGO_KEEP_2__ - soient correctement configurés. Pour un stockage de crédentiels sécurisé, faites confiance à des solutions natives comme Keychain ou Keystore.AndroidManifest.xmlConfiguration de SécuritéInfo.plistProtégez les données des utilisateurs en activant la cryptage de bout en bout pour toutes les transmissions de crédentiels. Lorsque nécessaire, incluez la __CAPGO_KEEP_3__ pour ajouter une couche supplémentaire de sécurité. Planifiez des traitements d'erreurs robustes et des options de redondance pour maintenir la fonctionnalité en cas de pannes. -
Gestion Continue
Maintenez votre application sécurisée en configurant un pipeline d'actualisation régulier pour les correctifs de sécurité. Restez à jour sur les mises à jour des plugins et suivez les avis de sécurité. Les outils comme __CAPGO_KEEP_0__ peuvent simplifier ce processus en permettant des mises à jour instantanées. __CAPGO_KEEP_1__ se distingue par un taux d'actualisation utilisateur impressionnant de 95% en 24 heures, ce qui en fait une valeur ajoutée précieuse à votre arsenal “__CAPGO_KEEP_0__ est un outil indispensable pour les développeurs qui souhaitent être plus productifs. Éviter les examens pour les correctifs de bogues est d'or.” - Bessie Cooper FAQs -
::: faq
Keep your app secure by setting up a regular update pipeline for security patches. Stay on top of plugin updates and monitor security advisories. Tools like Capgo can simplify this process by enabling instant updates. Capgo boasts an impressive 95% user update rate within 24 hours, making it a valuable addition to your toolkit [2].
“Capgo is a must-have tool for developers who want to be more productive. Avoiding review for bug fixes is golden.” - Bessie Cooper [2]
__CAPGO_KEEP_3__
__CAPGO_KEEP_0__
What sont les différences entre les plugins biométriques pour Capacitor, et comment puis-je sélectionner le meilleur pour mon application ?
Lors du choix d'un plugin biométrique pour votre application Capacitor, il est crucial d'aligner la sélection sur les besoins spécifiques de votre projet. Considérez des facteurs comme la compatibilité de la plateforme (si vous avez besoin de support pour iOS, Android ou les deux), la simplicité du processus d'intégration et si le plugin prend en charge des méthodes biométriques avancées telles que Face ID ou l'authentification par empreinte digitale.
Même si ce guide se concentre sur l'implémentation de l'authentification biométrique dans les applications __CAPGO_KEEP_0__, des outils comme __CAPGO_KEEP_0__ peuvent jouer un rôle précieux. Ils permettent de publier des mises à jour en temps réel dans votre application sans avoir besoin d'approbations des magasins d'applications. Cela signifie que votre application peut rester à jour avec les dernières fonctionnalités de sécurité, y compris les mises à jour biométriques, tout en restant conforme aux normes d'Apple et d'Android. Capacitor appsplatform compatibility Capgo fingerprint authentication
::: FAQ
Comment puis-je m'assurer que l'authentification biométrique de mon application Capacitor répond aux normes de sécurité et aux directives des magasins d'applications ?
Pour vous assurer que l'authentification biométrique de votre application Capacitor répond aux normes de sécurité actuelles et aux règles des magasins d'applications, suivez ces pratiques clés :
- Choisissez des plugins fiablesUtilisez un plugin d'authentification biométrique fiable comme Capacitor’s
@capacitor/biometricspour vous assurer que votre application est sécurisée et fonctionne sans heurts sur plusieurs appareils. - Suivez les règles de la plateformeCompliez avec les directives d'Apple et d'Android, y compris l'obtention du consentement de l'utilisateur, l'utilisation d'un stockage sécurisé et l'offre d'options de sauvegarde comme un code PIN ou un mot de passe.
- Mettez à jour les dépendancesMettez régulièrement à jour votre application et ses bibliothèques pour corriger les vulnérabilités et rester aligné sur les normes changeantes.
En utilisant un service d'actualisation en direct tel que Capgo Peut faire ce processus plus fluide. Il vous permet de pousser des mises à jour de sécurité ou des améliorations à votre application instantanément, en contournant les retards d'approbation des magasins d'applications. Cela garde votre application sécurisée, conforme et à jour avec les politiques d'Apple et d'Android. :::
::: faq
Quels défis les développeurs peuvent rencontrer lors de l'intégration de l'authentification biométrique dans les applications Capacitor et comment peuvent-ils les surmonter?
L'implémentation de l'authentification biométrique dans les applications Capacitor est accompagnée de ses propres défis. Ces derniers peuvent inclure l'assurance de la compatibilité sur les appareils, la gestion efficace des permissions des utilisateurs et le traitement sécurisé des données sensibles. Voici comment vous pouvez relever ces problèmes :
-
Compatibilité des appareils: Pour soutenir les fonctionnalités biométriques sur Android et iOS, envisagez l'utilisation de plugins comme
@capacitor-fingerprint-auth. Ces outils aident à combler l'écart entre les plateformes, en vous assurant que votre application fonctionne de manière fluide sur une variété d'appareils. -
Permissions des utilisateurs: Il est important d'expliquer clairement pourquoi votre application nécessite un accès biométrique. Fournissez aux utilisateurs des informations transparentes et conçuez votre application pour gérer les situations avec élégance lorsque les utilisateurs choisissent de ne pas accorder les permissions.
-
Sécurité des données: La protection des données d'authentification est critique. Suivez les meilleures pratiques d'encryption FAQ And respectez les lignes directrices de sécurité fournies par chaque plateforme pour vous assurer que les informations sensibles restent en sécurité.
Pour effectuer des mises à jour ou corriger les problèmes liés aux fonctionnalités biométriques sans passer par les approbations des magasins d'applications, vous pouvez utiliser des outils comme Capgo. Cela permet des mises à jour en temps réel, vous permettant de résoudre les bogues ou d'améliorer la fonctionnalité rapidement tout en restant conforme aux politiques d'Apple et d'Android.
Continuez de travailler à partir de l'authentification biométrique dans les applications Capacitor
Si vous utilisez l'authentification biométrique dans les applications Capacitor pour planifier la sécurité et la conformité, connectez-le à l'Encryption pour les détails d'implémentation dans Encryption, la Compliance pour les détails d'implémentation dans Compliance, le Capgo Security Scanner pour le flux de travail du produit dans Capgo Security Scanner Sécurité Capgo pour le flux de travail du produit dans Sécurité Capgo, et Centre de confiance Capgo pour le flux de travail du produit dans Centre de confiance Capgo.