Skip to content

@capgo/capacitor-native-biometric

안드로이드 및 iOS의 네이티브 생체 인식 API에 접근할 수 있는 플러그인입니다.

안드로이드와 iOS의 네이티브 바이오메트릭스 API에 대한 접근을 제공하는 플러그인입니다.

  • isAvailable - 안드로이드와 iOS의 바이오메트릭스 인증 장치가 있는지 확인합니다.
  • verifyIdentity - 사용자에게 바이오메트릭스 인증을 요청합니다.
  • getCredentials - 특정 서버에 저장된 자격 증명을 가져옵니다.
  • setCredentials - 특정 서버에 저장된 자격 증명을 저장합니다.

공개 API

API 제목
메소드설명
isAvailable비омет릭 인증 장치가 사용 가능한지 확인합니다.
addListener앱이 백그라운드에서 재개될 때 호출되는 리스너를 추가합니다. 이 기능은 앱이 백그라운드에서 실행 중일 때 사용자가 비омет릭 인증을 등록/해제하는 경우 비омет릭 인증 사용 가능 여부가 변경되었는지 감지할 수 있습니다.
verifyIdentity사용자에게 비омет릭 인증을 요청합니다.
getCredentials지정된 서버에 저장된 자격 증명을 가져옵니다.
setCredentials지정된 서버에 저장된 자격 증명을 저장합니다.
deleteCredentials지정된 서버에 저장된 자격 증명을 삭제합니다.
getSecureCredentialsBIOMETRY_CURRENT_SET 또는 BIOMETRY_ANY로 저장된 자격 증명이 있는지 확인하고, 해당 서버에 저장된 자격 증명을 가져옵니다. 비омет릭 인증이 필요합니다.
isCredentialsSaved지정된 서버에 저장된 자격 증명이 있는지 확인합니다.
getPluginVersion자체 Capacitor 플러그인 버전을 가져옵니다.

참고 값

참조 값

이 값을 biometricError 결과에서 authenticate.

생체 인증 오류

생체 인증 오류
Code플랫폼의미
UNKNOWN_ERROR0안드로이드, iOS알 수 없는 오류가 발생했습니다.
BIOMETRICS_UNAVAILABLE1안드로이드, iOS__CAPGO_KEEP_0__은/는/또는 없습니다.
USER_LOCKOUT2Android, iOS__CAPGO_KEEP_0__은/는/또는 잠금 해제되었습니다.
BIOMETRICS_NOT_ENROLLED3Android, iOS__CAPGO_KEEP_0__이/가/ 또는 없습니다.
USER_TEMPORARY_LOCKOUT4Android__CAPGO_KEEP_0__은/는/또는 잠금 해제되었습니다. 일반적으로 30초입니다.
AUTHENTICATION_FAILED10Android, iOS__CAPGO_KEEP_0__이/가/ 또는 실패했습니다.
APP_CANCEL11iOS__CAPGO_KEEP_0__이/가/ 또는 인증 흐름을 취소했습니다.
INVALID_CONTEXT12iOS__CAPGO_KEEP_0__
NOT_INTERACTIVE13iOS__CAPGO_KEEP_0__
PASSCODE_NOT_SET14안드로이드, iOS__CAPGO_KEEP_0__
SYSTEM_CANCEL15안드로이드, iOS__CAPGO_KEEP_0__
USER_CANCEL16안드로이드, iOS__CAPGO_KEEP_0__
USER_FALLBACK17안드로이드, iOS__CAPGO_KEEP_0__

이 참조는 src/definitions.ts 에서同步 capacitor-native-biometric.

@capgo/capacitor-native-biometric에서 계속

Section titled “@capgo/capacitor-native-biometric에서 계속”

Capgo를 사용하는 경우 @capgo/capacitor-native-biometric 인증 및 계정 흐름을 계획하고 연결하려면 @capgo/capacitor-native-biometric을 사용하여 @capgo/capacitor-native-biometric을 사용하여 Capgo에서 제공하는 @capgo/capacitor-social-login 구현 세부 정보는 @capgo/capacitor-social-login 에서 찾을 수 있습니다. @capgo/capacitor-passkey 구현 세부 정보는 @capgo/capacitor-passkey 에서 찾을 수 있습니다. 두 단계 인증 두 단계 인증 및 SSO (기업) 구현 세부 정보는 SSO (기업) 에서 찾을 수 있습니다.