Getting Started

Copia una riga di impostazione con i passaggi di installazione e la guida markdown completa per questo 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.

Istallazione

Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo competenze al tuo strumento AI utilizzando il seguente comando:

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

Poi utilizza la seguente richiesta:

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

Se preferisci la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo platform sotto:

Installa il pacchetto
Finestra del terminale
```
bun add @capgo/capacitor-passkey
```
Sincronizza progetti nativi
Finestra del terminale
```
bunx cap sync
```

Aggiungi la configurazione del 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;

Installa il shim durante l'avvio

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

await CapacitorPasskey.autoShimWebAuthn();

Mantieni il tuo flusso WebAuthn normale

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

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

Cosa fa la configurazione del plugin

La configurazione viene letta da plugins.CapacitorPasskey in capacitor.config.*.

origin: origine HTTPS primaria utilizzata dal shim e diretto API
domains: extra relying-party hostnames to patch into native config during sync
autoShim: predefinito a true e controlla la funzione di configurazione nativa cap sync hook di configurazione auto

Cosa sincronizza per te

Quando esegui bunx cap sync, il plugin aggiorna il progetto host nativo generato:

iOS: autorizzazioni ai domini associati e configurazione di Xcode quando necessario
Android: asset_statements metadati e il risorsa generata utilizzata dal manifesto

La funzione non pubblica i file di trust del tuo sito web per te. Devi ancora ospitare:

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

Guida per le piattaforme

iOS setup

Domini associati e apple-app-site-association.

Configurazione Android

Link di asset digitali e assetlinks.json.

Nota sul backend

Validazione dell'origine e limitazioni Android.

Continua da qui da Inizia

Se stai utilizzando Getting Started per pianificare l'autenticazione e i flussi di account, connettilo con Usando @capgo/capacitor-passkey per la capacità nativa in Usando @capgo/capacitor-passkey, @capgo/capacitor-login con social media per il dettaglio di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-autenticazione-biometrica-nativa per il dettaglio di implementazione in @capgo/capacitor-native-biometric, e Autenticazione a due fattori per il dettaglio di implementazione in Autenticazione a due fattori.