본문으로 건너뛰기

@capgo/capacitor-passkey

브라우저 스타일의 WebAuthn code을 앱에 Capacitor로 유지하고 플러그인에서는 네이티브 패스키 호출과 네이티브 호스트 패칭을 처리합니다.

브라우저 스타일의 API

보존 navigator.credentials.create() 그리고 navigator.credentials.get() 앱에 API 대신에 패스키 흐름을 다시 작성하지 않고 API를 사용하세요.

최소한의 앱 변경

플러그인 설정을 한 번만 추가하고 CapacitorPasskey.autoShimWebAuthn() 부트스트랩 중에 호출하고, 나머지 WebAuthn code 브라우저 구현과 가깝게 유지하세요.

빌드 시 네이티브 연결

플러그인은 iOS 및 Android 호스트 프로젝트를 싱크 시에 생성된 파일을 패치하여, 그 파일을 수동으로 편집할 필요가 없습니다.

Core API

Core API
  • shimWebAuthn(options?) 브라우저 스타일의 shim을 즉시 설치하고 HTTPS 원본을 선택적으로 override합니다.
  • getConfiguration() 해당 config에서 런타임 config를 읽습니다. plugins.CapacitorPasskey.
  • autoShimWebAuthn(options?) 그 config를 읽고 앱 부트스트랩 중에 shim을 한 번에 설치합니다.
  • createCredential(options) 그리고 getCredential(options) JSON-safe WebAuthn 패킷을 사용하여 네이티브 패스키 API를 직접 호출합니다.
  • isSupported() 런타임 사용 가능 여부를 보고합니다. getPluginVersion() 네이티브 implementation 버전 마커를 반환합니다.