안드로이드 설정

플러그인이 처리하는 것

플러그인 구성이 추가되고 실행되기

설치 단계, Sync, 그리고 소스 마크다운 가이드가 포함됩니다. bunx cap sync, 플러그인은 생성된 안드로이드 호스트 프로젝트를 패치합니다:

• injects the asset_statements manifest metadata
• writes the generated string resource referenced by that metadata

호스팅을 위해 여전히 필요한 항목

호스팅을 위해 여전히 필요한 항목 assetlinks.json on the relying-party domain:

https://signin.example.com/.well-known/assetlinks.json

Example:

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls",
      "delegate_permission/common.get_login_creds"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "app.capgo.passkey.example",
      "sha256_cert_fingerprints": [
        "AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33:44:55:66:77:88:99"
      ]
    }
  }
]

Checklist

1. 설정 origin and domains 내 plugins.CapacitorPasskey 내 capacitor.config.*.
2. 실행 bunx cap sync.
3. 실제 Android 패키지 이름을 사용하세요 assetlinks.json.
4. 모든 서명 인증서 지문을 추가하세요. 디버그 또는 내부 서명 키도 포함하세요. 테스트 빌드에 대해 키를 사용합니다.
5. 파일을 동일한 도메인에서 호스팅하세요. Relying-party ID와 동일한 도메인을 사용합니다.

웹 브라우저와 중요한 동작 차이점

Important behavior difference from a browser clientDataJSON.

• A normal Android app does not behave like a privileged browser.
• Assertion origin can be tied to the Android app signature instead of your website origin.
• If your backend strictly validates clientDataJSON.origin, accept the Android app origin alongside the website origin.

Android Setup에서 계속

If you are using Android Setup to plan authentication and account flows, connect it with Using @capgo/capacitor-passkey for the native capability in Using @capgo/capacitor-passkey, @capgo/capacitor-social-login Capacitor-capgo-capacitor-social-login Capacitor-capgo-capacitor-passkey Capacitor-capgo-capacitor-passkey Capacitor-capgo-capacitor-native-biometric Capacitor-capgo-capacitor-native-biometric, and 두 단계 인증 Capacitor-__CAPGO_KEEP_0__-__CAPGO_KEEP_1__-native-biometric의 implementation detail