Android 설정

Android에서는 Digital Asset Links를 통해 앱과 relying-party 도메인이 연결되어 있으면 웹사이트와 함께 passkey를 사용할 수 있습니다.

플러그인이 처리하는 작업

플러그인 설정을 추가하고 실행한 후 bunx cap sync, 플러그인이 생성된 Android host 프로젝트를 패치합니다:

• 다음 항목을 주입합니다: asset_statements manifest 메타데이터
• 해당 메타데이터가 참조하는 생성된 string 리소스를 작성합니다

여전히 직접 호스팅해야 하는 항목

다음 사항을 게시해야 합니다 assetlinks.json relying-party 도메인에:

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

예시:

[
  {
    "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"
      ]
    }
  }
]

체크리스트

1. 설정 origin 및 domains 에서 plugins.CapacitorPasskey 에서 capacitor.config.*.
2. 실행 bunx cap sync.
3. 다음 항목에 실제 Android 패키지 이름을 사용하세요: assetlinks.json.
4. 디버그 또는 내부 서명 키를 사용하여 빌드를 테스트하는 경우, 해당 서명 인증서 지문(fingerprint)을 모두 추가해야 합니다.
5. relying-party ID로 사용하는 것과 동일한 도메인에 파일을 호스팅하세요.

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

Digital Asset Links를 구성하면 Android에서 웹사이트와 동일한 relying party 및 passkey를 사용할 수 있습니다. 남은 차이점은 native에서 보고되는 실제 origin입니다. clientDataJSON.

• 일반적인 Android 앱은 권한이 부여된 브라우저처럼 동작하지 않습니다.
• assertion origin을 웹사이트 origin 대신 Android 앱 서명에 연결할 수 있습니다.
• 백엔드에서 엄격한 검증을 수행한다면 clientDataJSON.origin, 웹사이트 origin과 함께 Android 앱 origin도 허용하세요.

Android 설정부터 계속하기

사용 중이라면 Android 설정 인증 및 계정 흐름을 설계할 때, 이를 다음 항목과 연결하세요: @capgo/capacitor-passkey 사용하기 ‘@capgo/capacitor-passkey 사용하기’의 네이티브 기능에 대해서는, @capgo/capacitor-social-login @capgo/capacitor-social-login의 구현 세부 사항은, @capgo/capacitor-passkey @capgo/capacitor-passkey의 구현 세부 사항은 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric의 구현 세부 사항은, 2단계 인증 2단계 인증의 구현 세부 사항에 대해서는