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 iOS 앱에서 Capgo를 사용하려면, Apple Team ID와 앱 번들 ID를 확인하고 빌드하세요. capacitor.config.*.
2. Run bunx cap sync.
3. Confirm your Apple Team ID and app bundle ID, then build the TEAMID.bundleId value for the association file.
4. Host apple-app-site-association with HTTPS 200 and no .json extension.
5. Make sure the relying-party ID used by your backend matches the associated domain.

Notes

• The website file must be served from the exact passkey domain you use as the relying-party ID.
• iOS 17.4 이상부터는 플러그인은 브라우저 스타일의 클라이언트 데이터 API를 사용하여 구성된 HTTPS 원본이 반영됩니다. clientDataJSON.
• 플러그인은 동기화 중에 네이티브 프로젝트 파일을 패치할 수 있지만 도메인에서 웹사이트 연관 파일을 만들거나 호스팅할 수 없습니다.