Ionic Identity Vault에서 Native Biometric으로 이주

Native Biometric은 Ionic Identity Vault의 안전한 자격 증명 저장소 부분을 완전하게 대체합니다. Native Biometric은 단순히 생체 인식 정보를 요청하는 것 이상입니다. Native Biometric은 Keychain 또는 Keystore 보호를 사용하여 자격 증명을 저장, 확인, 검색 및 삭제합니다. 생체 인식 접근 제어를 활성화하면 Face ID, Touch ID 또는 Android 생체 인식이 앱이 자격 증명을 받기 전에 보호된 읽기 요청을 적용하는 데 사용됩니다.

Native Biometric을 직접 토큰 및 자격 증명 저장소 흐름에 사용하세요. 앱은 보호된 읽기 요청을 적용하는 데 사용하는 타임아웃 및 라이프 사이클 정책을 결정합니다. 자격 증명 저장소 마이그레이션을 위해 자격 증명 저장소만 필요한 경우, 자격 증명 저장소에 대한 보편적인 암호화 데이터베이스를 추가하는 경우도 있습니다. Fast SQL Data Storage SQLite oror

자동 시간 초과 잠금과 배경 개인 정보 보호 화면은 애플리케이션 계층 정책이므로 앱에서 보존하거나 재생성하세요. Custom-passcode 및 메모리 전용 보관함 모드는 Native Biometric에 의해 지원되지 않습니다. 별도의 애플리케이션 저장소 및 암호화 설계를 사용하여 필요 시 사용하세요.

Capgo 대체 항목을 한 눈에 보기

Ionic 기업 플러그인	Capgo 대체	업그레이드 가이드
Secure Storage	@capgo/capacitor-fast-sql 또는 @capgo/capacitor-data-storage-sqlite	Secure Storage 업그레이드
인증 연결	@capgo/capacitor-social-login	인증 연결 마이그레이션
식별 보관소 인증-보관소 흐름	@capgo/capacitor-native-biometric — 직접 대체	현재 위치

Native Biometric이 무엇을 포함하는가

• 안전한 자격 증명 보관소: 서버 또는 계정에 대한 자격 증명을 저장, 검색, 확인 및 삭제합니다.
• 생체 인식 인증을 위한 잠금: getSecureCredentials 보호된 자격 증명을 읽기 전에 native 생체 인식 프롬프트를 표시합니다.
• 앱 제어 잠금 정책: 앱이 재개되거나 시간 초과되거나 sensitive 액션 전에 보호된 읽기 호출
• 분리된 신원提示: verifyIdentity iOS에서 장치-패스코드 fallback을 지원; 보호된 자격 증명 읽기는 바이오 메트릭스 전용
• 권한 제어 선택: 바이오 메트릭스 등록 변경이 보호된 자격 증명을 무효화하는지 선택

이동 단계

1. 네이티브 바이오 메트릭스 설치 네이티브 code 동기화

npm install @capgo/capacitor-native-biometric
npx cap sync

2. __CAPGO_KEEP_0__를 저장하거나 refresh token 및 기타 자격 증명을 보안합니다.
3. with biometric access control enabled. getSecureCredentials __CAPGO_KEEP_1__를 사용하여 보호된 자격 증명을 잠금 해제합니다. when the app resumes, after an inactivity timeout, or before a sensitive action.
4. __CAPGO_KEEP_2__와 __CAPGO_KEEP_3__를 앱 레이어에 유지합니다. Custom-passcode and memory-only modes are unsupported by Native Biometric; use a separate application storage and encryption design if required.
5. __CAPGO_KEEP_4__와 __CAPGO_KEEP_5__를 사용하여 onboard, locked-state, 및 logout 흐름을 처리합니다. isCredentialsSaved Migrate stored secrets on first launch deleteCredentials by reading from Identity Vault and writing them with Native Biometric.
6. __CAPGO_KEEP_6__를 읽고 Native Biometric와 함께 __CAPGO_KEEP_7__를 쓰세요. __CAPGO_KEEP_8__
7. Ionic Identity Vault을 의존성과 네이티브 설정에서 제거하세요. 다음 단계

Next steps

• 네이티브 바이오메트릭스 시작
• Ionic Identity Vault에서 Secure Storage로의 마이그레이션
• Ionic Identity Vault에서 Auth Connect로의 마이그레이션

Migrate from Ionic Identity Vault에서 계속하세요.

Ionic Identity Vault을 사용 중이라면 Ionic Identity Vault에서 보안 및 규정 준수 계획을 위해 Ionic Identity Vault을 연결하세요. __CAPGO_KEEP_0__ 암호화 __CAPGO_KEEP_0__ 암호화 구현 세부 정보에 대한 __CAPGO_KEEP_0__ 준수 __CAPGO_KEEP_0__ 준수 구현 세부 정보에 대한 Capgo 보안 스캐너 Capgo 보안 스캐너 제품 워크플로에 대한 Capgo 보안 Capgo 보안 제품 워크플로에 대한 Capgo 신뢰 센터 Capgo 신뢰 센터 제품 워크플로에 대한