Mulai

1. Pasang paket

   bun add @capgo/capacitor-passkey

2. Sinkronkan proyek native

   bunx cap sync

3. Tambahkan konfigurasi 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. Pasang shim selama proses bootstrapping

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

5. Tetapkan alur WebAuthn normal Anda

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

Apa yang dilakukan konfigurasi plugin

Konfigurasi dibaca dari plugins.CapacitorPasskey di capacitor.config.*.

• origin: asal HTTPS utama RP yang digunakan oleh shim dan langsung API
• domains: hostname RP tambahan untuk memperbaiki ke konfigurasi native selama sinkronisasi
• autoShimmenggunakan nilai default true dan mengontrol pengaturan asli cap sync hook konfigurasi otomatis

Apa saja patch sinkronisasi untuk Anda

Saat Anda menjalankan bunx cap sync, plugin ini memperbarui proyek host native yang dihasilkan:

• iOS: pengaturan domain terkait dan pengaturan Xcode yang diperlukan
• Android: asset_statements metadata dan sumber daya yang dihasilkan yang digunakan oleh manifest

Hook ini tidak memublikasikan file kepercayaan situs web Anda. Anda masih perlu menampung:

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

Petunjuk platform

Pengaturan iOS

Domain terkait dan apple-app-site-association.

Pengaturan Android

Tautan Aset Digital dan assetlinks.json.

Catatan backend

Validasi asal dan kelemahan Android.