← 시나리오 목록

/app-clip

iOS App Clip (앱 설치 전)

iOS Camera 로 QR 을 찍으면 정식 logi 앱을 다운로드하지 않아도 화면 하단에 App Clip 카드가 떠서 그 자리에서 1pass 로그인 흐름이 진행됩니다. 가입 부담을 30초 안으로 줄이는 모드입니다.

적합 케이스: 오프라인 매장 / 이벤트 부스 / 길거리 광고 / 일회성 가입. iOS 14+ 디바이스에서 동작.

iPhone 카메라로 스캔

이 QR 의 invocation URL:
https://api.1pass.dev/demo/clip

App Clip 이 안 뜨면 iOS 14 이상인지 + 카메라가 App Clip 권한을 허용하는지 확인해주세요. Android / 데스크톱 카메라가 같은 QR 을 찍으면 자동으로 demo.1pass.dev 로 redirect 됩니다.

기술 흐름

  1. iOS Camera 가 api.1pass.dev/demo/clip URL 을 인식.
  2. /.well-known/apple-app-site-association 의 appclips.apps 패스 매칭 → iOS 가 App Clip 카드 표시.
  3. 사용자가 App Clip 을 열면 com.dcodelabs.logi.Clip 앱이 실행되어 1pass 로그인 흐름 진행.
  4. 로그인 완료 후 RP 의 redirect_uri 로 authorization code 전달 (기존 OAuth 흐름과 동일).
  5. App Clip → 정식 앱 업그레이드는 키체인 공유로 자동 (Apple App Clip 표준).

AASA 클레임 + Clip Card 설정은 App Clip Guide 참고.