Iniziare

Installazione

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

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

Usa poi 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 l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

1. Installa il pacchetto

   bun add @capgo/capacitor-passkey

2. Sincronizza progetti nativi

   bunx cap sync

3. 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;

4. Installa il shim durante l'avvio

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

5. 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: hostnames di origine di dipendenza aggiuntivi da patchare nella configurazione nativa durante la sincronizzazione
• autoShim: predefinito a true e controlla la configurazione nativa cap sync hook di configurazione automatica

Cosa sincronizza per te

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

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

Il hook non pubblica i file di trust del tuo sito per te. Hai ancora bisogno di ospitare:

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

Guida per piattaforma

Configurazione iOS

Domini associati e apple-app-site-association.

Configurazione Android

Digital Asset Links e assetlinks.json.

Nota sulla back-end

Validazione dell'origine e i limiti di Android.

Continua da Getting Started

Getting Started per pianificare l'autenticazione e le flussi di account, connettilo con Utilizza @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-passkey per la capacità nativa in Utilizza @capgo/capacitor-passkey, for the native capability in Using @capgo/capacitor-passkey, Social Login @capgo/capacitor Per i dettagli di implementazione in Social Login @capgo/capacitor Passkey @capgo/capacitor Per i dettagli di implementazione in Passkey @capgo/capacitor Autenticazione biometrica nativa @capgo/capacitor Per i dettagli di implementazione in Autenticazione biometrica nativa @capgo/capacitor, e Autenticazione a due fattori Per i dettagli di implementazione in Autenticazione a due fattori.