Einstieg

Eine Anleitung zur Voreinstellung mit Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.

        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.

Installieren Sie das Paket
Terminal-Fenster
```
bun add @capgo/capacitor-passkey
```
Synchronisieren Sie native Projekte
Terminal-Fenster
```
bunx cap sync
```

Fügen Sie die Plugin-Konfiguration hinzu

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;

Installieren Sie den Shim während des Bootstraps

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

await CapacitorPasskey.autoShimWebAuthn();

Halten Sie Ihren normalen WebAuthn-Flow aufrecht

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

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

Was die Plugin-Konfiguration tut

Die Konfiguration wird aus plugins.CapacitorPasskey in capacitor.config.*.

origin: primäre HTTPS-Vertrauenspartner-URL, die vom Shim und direkt verwendet wird API
domains: zusätzliche Vertrauenspartner-Hostnamen, die in die native Konfiguration während des Synchronisierens eingepatcht werden
autoShim: defaults to true und kontrolliert die native cap sync Auto-Konfigurations-Hook

Was synchronisiert Patches für Sie

Wenn Sie das Kommando ausführen bunx cap sync, aktualisiert der Plugin die generierte native Host-Projekt:

iOS: Domänenzugehörigkeiten und Xcode-Zugriffsrechte verbinden, wenn erforderlich
Android: asset_statements Metadaten und die generierte Ressource, die vom Manifest verwendet wird

Der Hook veröffentlicht Ihre Website-Trust-Dateien nicht für Sie. Sie müssen sie noch selbst hosten:

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

Plattform-Anleitungen

iOS-Einrichtung

Zugehörige Domains und apple-app-site-association.

Android-Einrichtung

Digitale Asset-Links und assetlinks.json.

Hintergrundhinweise

Origin-Validierung und Android-Hinweise.