Démarrage

Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-passkey`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/passkey/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installez le package
Fenêtre de terminal
```
bun add @capgo/capacitor-passkey
```
Synchronisez les projets natifs
Fenêtre de terminal
```
bunx cap sync
```

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;

Installez le shim lors du démarrage

import { CapacitorPasskey } from '@capgo/capacitor-passkey';

await CapacitorPasskey.autoShimWebAuthn();

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 dans capacitor.config.*.

origin: origine HTTPS primaire utilisée par le shim et directement par 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 mise en œuvre auto-configuration cap sync Ce que synchronise les correctifs pour vous

Section intitulée « Ce que synchronise les correctifs pour vous »

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

iOS : les droits d'entitlements associés et la mise en relation des droits Xcode lorsqu'il le nécessite
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 web 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 de biens numériques et assetlinks.json.

Notes de backend

Validation d'origine et avertissements Android.