Guide
Capacitor에서 Native Biometric 사용 방법
@capgo/capacitor-native-biometric을 사용합니다.
이 플러그인은 안드로이드 및 iOS의 네이티브 바이오메트릭스 API에 접근할 수 있도록 해줍니다.
설치
bun add @capgo/capacitor-native-biometric
bunx cap sync
bunx cap sync 플러그인의 네이티브 code을 프로젝트에 복사합니다. 플러그인 업그레이드 후 다시 실행하세요.
import
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
API의 개요
| 메소드 | 설명 |
|---|---|
isAvailable |
생체 인증 장치가 있는지 확인합니다. |
verifyIdentity |
사용자에게 생체 인증을 통해 인증하도록 유도합니다. |
getCredentials |
해당 서버에 저장된 자격 증명을 가져옵니다. |
setCredentials |
해당 서버에 저장된 자격 증명을 저장합니다. |
deleteCredentials |
해당 서버에 저장된 자격 증명을 삭제합니다. |
getSecureCredentials |
해당 서버에 저장된 자격 증명을 가져오고 생체 인증이 필요합니다. 자격 증명은 BIOMETRY_CURRENT_SET 또는 BIOMETRY_ANY로 설정된 경우에만 반환됩니다. |
isCredentialsSaved |
해당 서버에 저장된 자격 증명이 있는지 확인합니다. |
setData |
해당 키에 임의의 문자열 값을 저장합니다. 값은 Android Keystore + SharedPreferences, iOS Keychain과 같은 플랫폼 보안 저장소 백엔드에서 암호화되어 저장됩니다. |
getData |
해당 키에 이전에 저장된 값을 가져옵니다. 생체 인증이 없는 경우에만 반환됩니다. accessControl. |
getSecureData |
해당 키에 생체 인증 보호된 값을 가져옵니다. 값은 BIOMETRY_CURRENT_SET 또는 BIOMETRY_ANY로 설정된 경우에만 반환됩니다. accessControl __CAPGO_KEEP_0__ |
deleteData |
해당 키에 저장된 값을 삭제합니다 (보호되고 보호되지 않은). |
isDataSaved |
해당 키에 저장된 값이 있는지 확인합니다. |
예시
isAvailable()
비омет릭 인증 장치가 사용 가능한지 확인합니다.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
const result = await NativeBiometric.isAvailable();
console.log(result);
verifyIdentity()
비омет릭 인증 장치가 사용 가능한지 확인합니다.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
await NativeBiometric.verifyIdentity();
getCredentials()
사용자에게 비омет릭 인증을 요청합니다.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
const result = await NativeBiometric.getCredentials({ server: 'example.com' });
// The result holds sensitive values: use it without logging it.
setCredentials()
해당 서버에 저장된 자격증명을 가져옵니다.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
await NativeBiometric.setCredentials({
username: 'username',
password: 'password',
server: 'example.com',
});
deleteCredentials()
해당 서버에 저장된 자격증명을 저장합니다.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
await NativeBiometric.deleteCredentials({ server: 'example.com' });
getSecureCredentials()
해당 서버에 저장된 자격증명을 삭제합니다.
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
const result = await NativeBiometric.getSecureCredentials({ server: 'example.com' });
// The result holds sensitive values: use it without logging it.
해당 서버에 저장된 자격증명을 가져오며, 비омет릭 인증이 필요합니다. 자격증명은 BIOMETRY_CURRENT_SET 또는 BIOMETRY_ANY로 설정된 경우에만 사용할 수 있습니다. 위 표에는 12 개의 핵심 메서드가 나열되어 있습니다. 리스너 및 버전 헬퍼, 각 메서드의 전체 계약은 `GitHub` 저장소에서 문서화되어 있습니다..
__CAPGO_KEEP_0__ 저장소
addListener handle을 반환합니다. 호출 handle.remove() 화면이 해제될 때
전체 참조
@capgo/capacitor-native-biometric
__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-biometric을 사용 중이라면 capgo/capacitor-native-biometric을 연결하세요 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-biometric의 구현 세부 정보를 참조하세요 capgo/capacitor-native-biometric을 사용 중이라면 capgo/capacitor-native-biometric을 연결하세요 시작하기 시작하기 구현 세부 사항에 대해 @capgo/capacitor-social-login @capgo/capacitor-social-login 구현 세부 사항에 대해 @capgo/capacitor-passkey @capgo/capacitor-passkey 구현 세부 사항에 대해, 그리고 두 단계 인증 두 단계 인증 구현 세부 사항에 대해