Accueil

Installation

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de la commande suivante :

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Utilisez ensuite la prompt suivante :

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-passkey` plugin in my project.

Si vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à la plateforme ci-dessous :

1. Installer le package

   bun add @capgo/capacitor-passkey

2. Synchroniser les projets natifs

   bunx cap sync

3. Ajouter la configuration du plugin

   import type { CapacitorConfig } from '@capacitor/cli';
   
   const config: CapacitorConfig = {
     appId: 'app.capgo.passkey.example',
     appName: 'My App',
     webDir: 'dist',
     plugins: {
       CapacitorPasskey: {
         origin: 'https://signin.example.com',
         autoShim: true,
         domains: ['signin.example.com'],
       },
     },
   };
   
   export default config;

4. Installez le shim lors du démarrage

   import { CapacitorPasskey } from '@capgo/capacitor-passkey';
   
   await CapacitorPasskey.autoShimWebAuthn();

5. Conservez votre flux WebAuthn normal

   const registration = await navigator.credentials.create({
     publicKey: registrationOptions,
   });
   
   const authentication = await navigator.credentials.get({
     publicKey: requestOptions,
   });

Ce que fait la configuration du plugin

La configuration est lue à partir de plugins.CapacitorPasskey en capacitor.config.*.

• origin: origine HTTPS primaire utilisée par le shim et directement API
• domains: hôtes de dépendance supplémentaires à intégrer dans la configuration native lors de la synchronisation
• autoShim: par défaut true et contrôle la configuration native cap sync l'hook de configuration automatique

Quels correctifs de synchronisation vous synchronisent

Lorsque vous exécutez bunx cap sync, le plugin met à jour le projet de hôte natif généré :

• iOS : les autorisations de domaine associées et la mise en relation des autorisations Xcode lorsque nécessaire
• Android : asset_statements les métadonnées et le ressource généré utilisé par le manifeste

L'hook ne publie pas les fichiers de confiance de votre site pour vous. Vous devez encore les héberger :

• https://your-domain/.well-known/apple-app-site-association
• https://your-domain/.well-known/assetlinks.json

Guides de plateforme

Configuration iOS

Domaines associés et apple-app-site-association.

Configuration Android

Liens de ressources numériques et assetlinks.json.

Notes sur l'arrière-plan

Validation d'origine et les avertissements Android.

Continuez de l'onglet « Commencer »

Commencer pour planifier l'authentification et les flux de compte, connectez-l’avec Utilisation de @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-passkey pour la capacité native dans Utilisation de @capgo/capacitor-passkey, Utilisation de @capgo/capacitor-passkey @capgo/capacitor-connexion sociale pour les détails d'implémentation dans @capgo/capacitor-connexion sociale @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey @capgo/capacitor-authentification biométrique native pour les détails d'implémentation dans @capgo/capacitor-authentification biométrique native, et L'authentification à deux facteurs pour les détails d'implémentation dans L'authentification à deux facteurs