Mulai

1. Jendela terminal

   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 bootstrapping

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

5. Tetapkan aliran 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 dalam capacitor.config.*.

• origin: asal HTTPS berdasarkan pihak ketiga yang digunakan oleh shim dan API
• domains: nama host pihak ketiga tambahan untuk memperbaiki konfigurasi native selama sinkronisasi
• autoShim: default ke true dan mengontrol hook konfigurasi native otomatis cap sync Hook konfigurasi native otomatis

Apa yang disinkronkan untuk Anda

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

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

Tidak ada hook yang memublikasikan file kepercayaan situs web Anda. Anda masih perlu menyiapkan:

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

Panduan platform

Pengaturan iOS

Domain yang terkait dan apple-app-site-association.

Pengaturan Android

Tautan Aset Digital dan assetlinks.json.

Catatan backend

Validasi asal dan kelemahan Android.