Démarrage

1. Installez le package

   bun add @capgo/capacitor-passkey

2. Synchroniser les projets natifs

   bunx cap sync

3. Ajoutez 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 sur capacitor.config.*.

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

Quels correctifs de synchronisation vous sont appliqués

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 forme des autorisations Xcode lorsqu'il le faut
• Android :  asset_statements les métadonnées et les ressources générées utilisées par le manifeste

L'hook ne publie pas les fichiers de confiance de votre site pour vous. Vous devez toujours 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 d'actifs numériques et assetlinks.json.

Notes de backend

Validation d'origine et avertissements Android.