Iniciar

Copiar un prompt de configuración con los pasos de instalación y la guía de markdown completa para este 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.

Instale el paquete
Ventana de terminal
```
bun add @capgo/capacitor-passkey
```
Sincronice proyectos nativos
Ventana de terminal
```
bunx cap sync
```

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;

Instalar el shim durante el arranque

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

await CapacitorPasskey.autoShimWebAuthn();

Mantenga su flujo WebAuthn normal

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

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

¿Qué hace la configuración del plugin?

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

origin: origen de confianza HTTPS primario utilizado por el shim y directo API
domains: hostnames de confianza adicionales para parchear en la configuración nativa durante la sincronización
autoShim: se ajusta por defecto true y controla la configuración nativa cap sync hook de autoconfiguración

¿Qué parches de sincronización te aplican?

Cuando ejecutas bunx cap sync, el plugin actualiza el proyecto de host nativo generado:

iOS: permisos de dominios asociados y configuración de Xcode cuando sea necesario
Android: asset_statements metadatos y el recurso generado utilizado por el manifiesto

El hook no publica los archivos de confianza de tu sitio web por ti. Todavía necesitas 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

Dominios asociados y apple-app-site-association.

Configuración de Android

Enlaces de activos digitales y assetlinks.json.

Notas de backend

Validación de origen y advertencias de Android.