iOS 설정

iOS에서 passkey는 앱이 웹사이트와 동일한 relying-party 도메인에 연결되어 있을 때만 작동합니다.

플러그인이 처리하는 작업

플러그인 설정을 추가하고 실행하면 bunx cap sync, 플러그인이 생성된 iOS host 프로젝트를 자동으로 패치하므로 수동으로 계속 수정할 필요가 없습니다:

• 다음 항목을 추가합니다: webcredentials: 설정된 도메인에 대한 associated domains 항목
• 배선 CODE_SIGN_ENTITLEMENTS 생성된 앱 타겟이 이미 entitlements 파일을 가리키고 있지 않을 때

여전히 직접 호스팅해야 하는 항목

다음 사항을 게시해야 합니다 apple-app-site-association relying-party 도메인에:

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. Apple Team ID와 앱 bundle ID를 확인한 후, 다음을 빌드하세요: TEAMID.bundleId association 파일의 값.
4. 호스팅하세요 apple-app-site-association HTTP로 200 그리고 .json 확장자 없이.
5. 백엔드에서 사용하는 relying-party ID가 연결된 도메인과 일치하는지 확인하세요.

참고 사항

• 웹사이트 파일은 relying-party ID로 사용하는 passkey 도메인과 정확히 동일한 도메인에서 제공되어야 합니다.
• iOS 17.4 이상에서 플러그인은 브라우저 방식의 client-data API를 사용하므로 설정된 HTTPS origin이 반영됩니다. clientDataJSON.
• 플러그인은 sync 중에 네이티브 프로젝트 파일을 패치할 수 있지만, 도메인에 웹사이트 연동 파일을 생성하거나 호스팅할 수는 없습니다.

iOS 설정에서 계속하기

사용 중이라면 iOS 설정 인증 및 계정 흐름을 설계할 때, 이를 다음 항목과 연결하세요: @capgo/capacitor-passkey 사용하기 ‘@capgo/capacitor-passkey 사용하기’의 네이티브 기능에 대해서는, @capgo/capacitor-social-login @capgo/capacitor-social-login의 구현 세부 사항은, @capgo/capacitor-passkey @capgo/capacitor-passkey의 구현 세부 사항은 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric의 구현 세부 사항은, 2단계 인증 2단계 인증의 구현 세부 사항에 대해서는