메뉴로 이동

안드로이드 설정

GitHub

안드로이드에서 패스키는 앱과 의존성 파티 도메인이 디지털 자산 링크를 통해 연결되어 있을 때 웹사이트와 작동합니다.

플러그인이 처리하는 내용

제목 "플러그인이 처리하는 내용"

플러그인 구성이 추가되고 실행되면 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"
]
}
}
]

체크리스트

체크리스트 섹션
  1. 설정 origindomains 에서 plugins.CapacitorPasskey 에서 capacitor.config.*.
  2. 실행 bunx cap sync.
  3. 실제 안드로이드 패키지 이름을 사용하세요. assetlinks.json.
  4. 디버그 또는 내부 빌드에 대한 디버그 또는 내부 서명 키를 포함하여 필요한 모든 서명 인증서 지문을 추가하세요.
  5. 호스트 파일은 동일한 도메인에서 사용하는 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의 두 단계 인증 기능의 구현 세부 사항을 참조하세요.