안드로이드 설정
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.
안드로이드에서 패스키는 앱과 의존성 파티 도메인이 디지털 자산 링크를 통해 연결되어 있을 때 웹사이트와 작동합니다.
플러그인이 처리하는 내용
제목 "플러그인이 처리하는 내용"플러그인 구성이 추가되고 실행되면 bunx cap sync생성된 안드로이드 호스트 프로젝트를 패치합니다:
- 인젝션을
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" ] } }]체크리스트
체크리스트 섹션- 설정
origin및domains에서plugins.CapacitorPasskey에서capacitor.config.*. - 실행
bunx cap sync. - 실제 안드로이드 패키지 이름을 사용하세요.
assetlinks.json. - 디버그 또는 내부 빌드에 대한 디버그 또는 내부 서명 키를 포함하여 필요한 모든 서명 인증서 지문을 추가하세요.
- 호스트 파일은 동일한 도메인에서 사용하는 Relying-Party ID와 함께합니다.
브라우저와 중요한 동작 차이점
브라우저와 중요한 동작 차이점디지털 자산 링크를 구성했을 때 Android는 동일한 Relying Party와 Passkey를 사용할 수 있으며, 나머지 차이점은 네이티브에서 보고되는 실제 출처입니다. clientDataJSON.
- 일반적인 Android 앱은 특권 브라우저와 같은 동작을 하지 않습니다.
- Android 앱 서명 대신 웹사이트 출처와 연결된 Assertion Origin을 사용할 수 있습니다.
- 백엔드가 엄격하게 유효성을 검사한다면, Android 앱 출처와 함께 웹사이트 출처를 수락할 수 있습니다.
clientDataJSON.originAndroid 설정에서 계속
Android 설정 Android 설정 __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__을 연결하여 인증 및 계정 흐름을 계획하세요. @capgo/capacitor-passkey를 사용하여 Capacitor의 native 기능인 @capgo/capacitor-passkey를 사용하여 @capgo/capacitor-social-login을 사용하여 Capacitor의 social-login 기능인 @capgo/capacitor-social-login의 구현 세부 사항을 참조하세요. @capgo/capacitor-passkey를 사용하여 Capacitor의 passkey 기능인 @capgo/capacitor-passkey의 구현 세부 사항을 참조하세요. @capgo/capacitor-native-biometric를 사용하여 Capacitor의 native-biometric 기능인 @capgo/capacitor-native-biometric의 구현 세부 사항을 참조하세요. 그리고 두 단계 인증 Capacitor의 두 단계 인증 기능의 구현 세부 사항을 참조하세요.