iOS 설정

iOS에서 패스키드는 웹사이트와 동일한 의존성 제공자 도메인과 연관된 앱과 함께만 작동합니다.

플러그인이 처리하는 내용

플러그인 설정을 추가하고 실행한 후 bunx cap sync플러그인은 iOS 호스트 프로젝트를 생성하여 편집을 수동으로 유지하지 않도록 패치합니다.

• 구성된 도메인에 대한 webcredentials: 연관된 도메인 항목을 추가합니다.
• 생성된 앱 대상이 이미 특권 파일에 대한 참조를 가지고 있지 않으면 CODE_SIGN_ENTITLEMENTS 연결합니다.

호스팅해야 하는 내용

호스팅하려면 반드시 등록해야 합니다. apple-app-site-association 의존하는 파티 도메인에:

https://signin.example.com/.well-known/apple-app-site-association

예시:

{
  "webcredentials": {
    "apps": ["ABCDE12345.app.capgo.passkey.example"]
  }
}

체크리스트

1. 설정 origin 및 domains 내 plugins.CapacitorPasskey 내 capacitor.config.*.
2. 실행 bunx cap sync.
3. __CAPGO_KEEP_0__의 Apple 팀 ID와 앱 번들 ID를 확인한 후 빌드합니다. TEAMID.bundleId __CAPGO_KEEP_0__의 값입니다.
4. 호스트 apple-app-site-association HTTP 200 확장 .json 백엔드에서 사용하는 의존성 제공자 ID가 연관된 도메인과 일치하는지 확인하세요.
5. Notes

Notes 섹션

• iOS 17.4 이상 버전에서 플러그인은 브라우저 스타일의 client-data __CAPGO_KEEP_0__를 사용하여 구성된 HTTPS 원본이 반영됩니다.
• On iOS 17.4 and newer, the plugin uses the browser-style client-data API so the configured HTTPS origin is reflected in clientDataJSON.
• __CAPGO_KEEP_0__