For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/mobile/security.md (or send Accept: text/markdown).
앱 잠금과 기기 보안
생체 인식 잠금 해제, 세션 관리, 연결된 계정.
앱 잠금 활성화
설정 → 보안은 expo-local-authentication을 통한 생체 인식 앱 잠금을 제공합니다 — Face ID, Touch ID 또는 지문이며 기기 PIN도 허용되는 대체 수단입니다. 활성화에는 한 번의 성공적인 인증이 필요하고 비활성화는 자유롭습니다. Face ID 사용 문구는 app.json에 포함되어 있습니다.
잠금이 걸리는 시점
게이트는 콜드 스타트와 60초 넘게 백그라운드에 있은 후 잠깁니다. 로그아웃 사용자는 절대 잠기지 않고, 생체 인식 프롬프트 뒤의 짧은 iOS active 상태가 실수로 앱을 다시 잠글 수 없습니다.
잠금 화면
마운트당 한 번 자동으로 프롬프트를 표시하고, 수동 Unlock 재시도를 제공하며, Sign out 탈출구를 유지합니다. 로그아웃은 세션을 파기하기 전에 푸시 토큰을 등록 해제합니다 — 등록 해제 호출에는 살아 있는 쿠키가 필요합니다 — 로그아웃이 실패하면 앱을 여는 대신 오류와 함께 게이트가 닫힌 상태로 유지됩니다.
세션, 연결된 계정, 내보내기
같은 화면은 인증 클라이언트를 통해 세션을 나열합니다 — 최신순이며 현재 세션에 표시됩니다 — 하나의 세션 또는 다른 모든 세션을 폐기할 수 있습니다. 연결된 계정은 설정 → 연결 아래에 나열되고, 마지막 로그인 방법은 연결 해제할 수 없으며, 커머스나 Stripe Connect 관리는 웹에 남습니다. GET /api/account/export는 멤버의 전체 데이터 내보내기를 다운로드합니다.
검증 및 문제 해결
잠그고 잠금 해제하고, 유예 기간을 넘겨 앱을 백그라운드로 보내고, 두 번째 세션을 폐기하고, 잠금 화면에서 로그아웃하세요. 등록된 생체 인식이 없는 기기는 잠금을 활성화할 수 없습니다 — 토글이 조용히 실패하는 대신 그 이유를 설명해야 합니다.