시작하기

__CAPGO_KEEP_0__ 복사

        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.

패키지를 설치하세요
터미널 창
```
bun add @capgo/capacitor-passkey
```
자연스러운 프로젝트 동기화
터미널 창
```
bunx cap sync
```

플러그인 구성 추가

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;

부트스트랩 시에 시뮬레이터 설치

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

await CapacitorPasskey.autoShimWebAuthn();

웹 인증 흐름을 유지하세요

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

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

플러그인 설정이 무엇을 하는지

설정은 plugins.CapacitorPasskey 에서 capacitor.config.*.

origin: shim과 직접 API에 사용되는 기본 HTTPS 의존성 원본
domains: 네이티브 설정에 동기화하는 동안 패치하는 추가 의존성 호스트 이름
autoShim: 기본값 true 네이티브 cap sync 자동 구성 Hook

자동 구성 Hook이 패치하는 것

당신이 실행할 때 bunx cap sync, 플러그인은 생성된 네이티브 호스트 프로젝트를 업데이트합니다:

iOS: 필요할 때 Xcode 권한과 관련된 도메인 연관성 권한
Android: asset_statements 메타데이터 및 생성된 리소스(마니페스트에 사용됨)

후크는 당신의 웹사이트 신뢰 파일을 공개하지 않습니다. 당신은 여전히 다음을 호스팅해야 합니다:

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

플랫폼 가이드

iOS 설정

연관된 도메인 및 apple-app-site-association.

디지털 자산 링크 및

Android 설정 assetlinks.json.

백엔드 참고 사항

원본 유효성 검사 및 안드로이드 주의 사항.