Ionic Identity Vault에서 마이그레이션

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

Native Biometric은 Ionic Identity Vault의 보안 자격 증명 저장소 부분을 완전히 대체합니다. 생체 인증 프롬프트를 표시하는 것 이상으로, 네이티브 Keychain 또는 Keystore 보호를 통해 자격 증명을 저장, 확인, 검색 및 삭제합니다. 생체 인증 접근 제어가 활성화되면, 앱이 자격 증명을 수신하기 전에 Face ID, Touch ID 또는 Android 생체 인증을 통한 보호된 읽기 작업이 필요합니다.

토큰 및 자격 증명 저장소 플로우에 Native Biometric을 직접 사용하세요. 앱은 타임아웃 및 라이프사이클 정책을 적용하기 위해 보호된 읽기를 요청할 시점을 결정합니다. 자격 증명 외에도 더 넓은 범위의 암호화 데이터베이스가 필요하면 추가하세요 빠른 SQL 또는 SQLite 데이터 스토리지; 자격 증명 저장소 마이그레이션에 있어 이는 선택 사항입니다.

자동 타임아웃 잠금 및 백그라운드 프라이버시 스크린은 애플리케이션 레이어 정책이므로, 앱에서 이를 유지하거나 재구성해야 합니다. Native Biometric은 사용자 지정 비밀번호 및 메모리 전용 볼트 모드를 지원하지 않으므로, 이러한 기능이 필요하면 별도의 애플리케이션 저장소 및 암호화 설계를 사용하세요.

Capgo 교체 항목 한눈에 보기

Ionic Enterprise 플러그인	Capgo 대체	마이그레이션 가이드
보안 스토리지	@capgo/capacitor-fast-sql 또는 @capgo/capacitor-data-storage-sqlite	Secure Storage 마이그레이션
인증 연결	@capgo/capacitor-social-login	Auth Connect 마이그레이션
Identity Vault 자격 증명 볼트 플로우	@capgo/capacitor-native-biometric — 직접 대체	현재 위치

Native Biometric 지원 범위

보안 자격 증명 볼트: 서버 또는 계정의 자격 증명을 저장, 검색, 확인 및 삭제합니다.
생체 인증 잠금 해제: getSecureCredentials 보호된 자격 증명을 읽기 전에 네이티브 생체 인증 프롬프트를 표시합니다.
앱 제어 잠금 정책: 앱이 재개될 때, 타임아웃 후, 또는 민감한 작업 전에 보호된 read를 호출하세요.
별도 identity prompt: verifyIdentity iOS에서 device-passcode 폴백을 지원합니다. 보호된 credential read는 생체 인증만 가능합니다.
액세스 제어 옵션: 생체 인증 등록 변경 시 보호된 credential을 무효화할지 선택하세요.

마이그레이션 단계

Native Biometric 설치 그리고 네이티브 code를 동기화하세요.

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

access 및 refresh token 또는 기타 credential 저장 생체 인증 접근 제어가 활성화된 상태로.
사용 getSecureCredentials 보호된 인증 정보를 잠금 해제하려면 앱이 재개될 때, 비활성 타임아웃 후, 또는 민감한 작업 전에 실행합니다.
타임아웃 및 privacy-screen 동작은 앱 레이어에서 관리하세요. Native Biometric은 커스텀 패스코드 및 메모리 전용 모드를 지원하지 않습니다. 필요한 경우 별도의 애플리케이션 스토리지 및 암호화 설계를 사용하세요.
사용 isCredentialsSaved 및 deleteCredentials onboarding, 잠금 상태 및 로그아웃 흐름에 적용합니다.
첫 실행 시 저장된 secret 마이그레이션 Identity Vault에서 읽어 Native Biometric으로 기록합니다.
Ionic Identity Vault 제거 의존성 및 네이티브 설정에서 제거하세요.

다음 단계

Ionic Identity Vault 마이그레이션 계속하기

사용 중이라면 Ionic Identity Vault에서 마이그레이션 보안 및 컴플라이언스 계획을 세우려면, 다음 항목과 연결하세요: 암호화 암호화 구현 상세 정보: 컴플라이언스 컴플라이언스 구현 상세 정보: Capgo 보안 스캐너 Capgo Security Scanner 제품 워크플로우: Capgo 보안 Capgo Security 제품 워크플로우 및 Capgo 신뢰 센터 Capgo Trust Center 제품 워크플로우: