← 시나리오 목록

/ios

iOS 네이티브 앱 (설치된 앱)

사용자가 이미 App Store 에서 logi 앱을 받아둔 상태를 가정한 시나리오입니다. 여러분의 iOS 앱 안에서 "logi 로 계속하기" 버튼을 누르면 Universal Link 한 줄로 logi 앱이 호출되고, 키체인 기반 PKCE 로 인증이 끝납니다. Safari 가 떴다가 닫히는 어색한 플리커 없이 OS 가 두 앱 사이를 깔끔하게 넘겨줘요.

적합 케이스: App Store 정식 게시된 일반 iOS 앱. 연동 앱 개발자는 Swift SDK 만 붙이면 끝 — QR 코드도, 카메라 스캔도 필요하지 않습니다.

앱을 아직 안 깐 사용자라면? → iOS App Clip 시나리오 (/app-clip)

logi 앱 아이콘

App Store

logi — 간편 로그인

이 시나리오를 직접 체험하려면 먼저 logi 앱을 받아두세요.

기술 흐름

  1. 연동 iOS 앱이 PKCE state / code_verifier 를 생성해 키체인에 저장.
  2. UIApplication.open(URL: "https://api.1pass.dev/oauth/authorize?...", options: [.universalLinksOnly: true]) 호출 — first-try 패턴.
  3. 설치된 logi 앱이 Universal Link 를 intercept → 사용자 동의 화면 표시.
  4. 승인 후 logi 앱이 연동 앱의 redirect_uri (Universal Link) 로 점프 → 연동 앱이 callback 받아 /oauth/token 에 code + verifier 로 token 교환.
  5. 설치 안 됐을 경우 .universalLinksOnly 가 false 반환 → App Clip / Safari fallback 으로 자동 분기.

iOS Swift SDK 통합은 Swift 통합 가이드 · Universal Link first-try 패턴은 Universal Links Guide 참고.