Getting Started

Installazione

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:

1. Installa il pacchetto

   bun add @capgo/capacitor-passkey

2. Sincronizza i 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. Installare 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: l'origine HTTPS primaria del partner di fiducia utilizzata dal shim e diretto API
• domains: hostnames aggiuntivi del provider per patchare nella configurazione nativa durante la sincronizzazione
• autoShim: si attiva per impostazione predefinita true e controlla l'hook di configurazione auto per la configurazione nativa cap sync Cosa sincronizza per te

Sezione intitolata “Cosa sincronizza per te”

, il plugin aggiorna il progetto host nativo generato: bunx cap synciOS: autorizzazioni dei domini associati e configurazione delle autorizzazioni di Xcode quando necessario

• Android:
• metadati e il risorsa generata utilizzata dal manifesto asset_statements L'hook non pubblica i file di trust del tuo sito web per te. Devi ancora ospitare:

L'hook non pubblica i file di trust del tuo sito web per te. Devi ancora ospitarli:

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

Guida alla piattaforma

Configurazione iOS

Domini associati e apple-app-site-association.

Configurazione Android

Digital Asset Links e assetlinks.json.

Note sul backend

Validazione dell'origine e limitazioni Android.

Continua da Guida introduttiva

Se stai utilizzando Guida introduttiva per pianificare l'autenticazione e le flussi di account, connettilo con Usando @capgo/capacitor-passkey per la capacità nativa in Usando @capgo/capacitor-passkey, @capgo/capacitor-social-login per il dettaglio di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric per il dettaglio di implementazione in @capgo/capacitor-native-biometric, e L'autenticazione a due fattori per il dettaglio di implementazione in L'autenticazione a due fattori.