__CAPGO_KEEP_0__
@capgo/capacitor-native-biometric 인증 및 보안 오픈 소스

네이티브 바이오메트릭스 Capacitor 플러그인

얼굴 인식, Touch ID 및 Android 생체 인식 API를 사용하는 보안 인증

설치

bun add @capgo/capacitor-native-biometric bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-native-biometric
  • pnpm add @capgo/capacitor-native-biometric
  • yarn add @capgo/capacitor-native-biometric

Guide

Capacitor에서 Native Biometric 사용 방법

__CAPGO_KEEP_0__에서 Native Biometric 사용하는 방법

다운로드하여 Capgo 앱을 설치한 후 QR code 코드를 스캔하세요.

네이티브 바이오메트릭스 플러그인 미리보기 QR code

@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 구현 세부 사항에 대해, 그리고 두 단계 인증 두 단계 인증 구현 세부 사항에 대해

FAQ

Native Biometric 플러그인 FAQ

Native Biometric 플러그인을 Capacitor 앱에 설치하는 방법은?

Run "bun add @capgo/capacitor-native-biometric" (또는 "npm install @capgo/capacitor-native-biometric"), 그리고 "bunx cap sync"를 실행하여 iOS와 Android 프로젝트가 네이티브 code를 인식하도록 하세요. 그리고 앱 code에서 "@capgo/capacitor-native-biometric"을 임포트하세요.

React, Vue 및 Angular과 함께 @capgo/capacitor-native-biometric가 작동하는지 여부는?

네. Native Biometric은 Capacitor 패키지이므로, Ionic, React, Vue, Angular, Svelte 및 일반 JavaScript와 같은 웹 프레임워크가 Capacitor 내에서 실행되는 경우에 작동합니다.

어떤 Capacitor 버전이 @capgo/capacitor-native-biometric을 지원하는가?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-native-biometric은 무료이며 오픈 소스인가?

네. code의 소스는 GitHub에 공개되어 있습니다: https://github.com/Cap-go/capacitor-native-biometric/ 에서 확인하실 수 있습니다. npm에서 무료로 설치하실 수 있습니다. 버그 리포트와 풀 리퀘스트는 환영합니다.

code이 Native Biometric을 사용하는 경우 App Store 리뷰 없이 업데이트가 가능한가?

code 플러그인을 설치하거나 업그레이드하면 Native code이 변경되므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 Capgo Live Update를 통해 JavaScript, HTML, CSS 변경 사항이 바로 배포될 수 있습니다.

네이티브 바이오메트릭스 변경 사항을 앱 리뷰 기다리지 않고 배포합니다.

플러그인이 스토어 빌드에 포함된 후, Capgo 라이브 업데이트 사용자에게 JavaScript, HTML 및 CSS 변경 사항을 분당 몇 분 안에 푸시합니다.

Capgo로 시작하세요.