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 bootstrap

   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 oleh konfigurasi plugin

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

• origin: asal HTTPS pihak ketiga utama yang digunakan oleh shim dan API
• domains: nama host pihak ketiga tambahan untuk memperbaiki ke dalam konfigurasi asli selama sinkronisasi
• autoShim: default ke true dan mengontrol hook konfigurasi asli cap sync Auto-configuration hook

Apa yang diperbaiki oleh sinkronisasi untuk Anda

Ketika Anda menjalankan bunx cap syncplugin 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

Hook ini tidak 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

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.