Saltar al contenido

Empezar

  1. Instale el paquete

    Ventana de terminal
    bun add @capgo/capacitor-passkey
  2. Sincronizar proyectos nativos

    Ventana de terminal
    bunx cap sync
  3. Agregar la configuración 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. Instale el shim durante el arranque

    import { CapacitorPasskey } from '@capgo/capacitor-passkey';
    await CapacitorPasskey.autoShimWebAuthn();
  5. Mantenga su flujo WebAuthn normal

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

La configuración se lee de plugins.CapacitorPasskey en capacitor.config.*.

  • origin: origen de HTTPS principal de la parte de confianza utilizada por el shim y directo API
  • domains: nombres de host de la parte de confianza adicionales para parchear en la configuración nativa durante la sincronización
  • autoShim: predeterminado a true y controla la pestaña de configuración nativa cap sync hook de configuración automática

Cuando ejecutas bunx cap syncactualiza el proyecto de anfitrión nativo generado:

  • iOS: configuración de derechos de dominio asociados y configuración de derechos de Xcode cuando sea necesario
  • Android: asset_statements metadata y el recurso generado utilizado por el manifiesto

No publica los archivos de confianza de su sitio web. Todavía necesita alojar:

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

Guías de plataforma

Configuración de iOS