안드로이드 설정

Android에서, 앱과 의존성 제공자 도메인이 디지털 자산 링크를 통해 연결되어 있으면 패스키가 웹사이트와 작동합니다.

플러그인이 처리하는 것

플러그인 구성 추가 후 실행 bunx cap sync, 플러그인은 생성된 안드로이드 호스트 프로젝트를 패치합니다:

• injects the asset_statements 매ニ페스트 메타데이터
• 생성된 문자열 리소스를 참조하는 메타데이터에 의해 생성된 리소스를 기록합니다.

호스팅하려면 여전히 필요한 항목

호스팅하려면 여전히 필요한 항목 assetlinks.json 의존성 파티 도메인에 게시해야 합니다:

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. 테스트하는 debug 또는 내부 signing 키를 포함하여 필요한 모든 signing 인증서 지문 추가
5. 동일한 도메인에서 파일을 호스팅하십시오. 이는 Relying-Party ID와 동일한 도메인입니다.

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

디지털 자산 링크를 구성했을 때 Android는 웹사이트와 동일한 Relying Party 및 Passkey를 사용할 수 있습니다. 나머지 차이점은 네이티브에서 보고하는 Literal Origin입니다. clientDataJSON.

• 일반 안드로이드 앱은 특권 브라우저와 같은 행동을 하지 않습니다.
• 보장된 출처는 안드로이드 앱 서명과 대신 웹사이트 출처와 연결될 수 있습니다.
• 만약 백엔드가 엄격하게 clientDataJSON.origin을 검증한다면, 웹사이트 출처와 함께 안드로이드 앱 출처를 받아들이세요.