📱 모바일 앱 통합 트랙

iOS · Android · Flutter · React Native 네이티브 앱에서 logi 를 통합하는 가장 빠른 길.

이 트랙이 맞나요?

✅ 맞음: 사용자가 앱 스토어에서 깔아 쓰는 네이티브 앱
❌ 웹이라면 → 🌐 웹 통합 트랙
❌ 서버 간 통신 / CLI 라면 → 🔧 API · CLI 트랙

핵심 약속 4줄

Public client + PKCE 필수. client_secret 모바일에 못 박지 마세요.
redirect_uri 는 custom scheme 1개 — 예: com.example.app://oauth/1pass/callback
app-to-app first, 인앱 브라우저 fallback — 사용자가 카톡/네이버 인앱에서 들어와도 동작.
앱 RP 와 웹 RP 는 분리 — 같은 client_id 에 모바일+웹 redirect 섞지 마세요. 자세히: 공통/Public Clients · Surface 별 RP 분리

Step 1 · 앱 등록

client_type: public 으로 RP 한 개 등록. 콘솔 또는 API 둘 다 가능.

앱 등록 가이드 — 콘솔 UI 워크스루
Public Clients (PKCE-only) — API 등록 + redirect_uri 정책
Public vs Confidential 결정 — 뭘 골라야 하나

Step 2 · 플랫폼별 Quickstart

iOS — LogiAuth Swift Package (권장)

iOS 는 공식 Swift SDK LogiAuth 0.1.2 가 PKCE · ASWebAuthenticationSession · 인앱 escape · keychain 보관까지 처리합니다. roll-your-own 보다 먼저 SDK 를 시도하세요.

swift

// Package.swift
.package(url: "https://github.com/1pass-dev/logi.git", exact: "0.1.2"),

// App.swift
import LogiAuth

@main
struct MyApp: App {
  init() {
    LogiAuth.configure(LogiAuthConfig(
      clientId: "logi_xxx",
      redirectURI: URL(string: "myapp://oauth/1pass/callback")!
    ))
  }

  var body: some Scene {
    WindowGroup {
      ContentView()
        .onOpenURL { url in _ = LogiAuth.handle(url) }
    }
  }
}

// 어디서든
let result = try await LogiAuth.signIn()

.onOpenURL { url in _ = LogiAuth.handle(url) } 도 잊지 마세요 — 로그인 콜백을 SDK 가 받아 토큰 교환을 마무리합니다.

자세한 통합 + 에러 분류 → Swift quickstart

그 외 플랫폼

본인 스택의 페이지 한 개만 따라가세요. 나머지는 같은 패턴의 미러입니다.

스택	가이드	SDK / 라이브러리
iOS (Swift)	integrations/swift	LogiAuth 0.1.2 (권장) · 또는 roll-your-own `ASWebAuthenticationSession` + `CryptoKit`
Android (Kotlin)	integrations/android	LogiAuth Kotlin SDK (권장) · 또는 hand-rolled Custom Tabs + DataStore + Keystore
Flutter	integrations/flutter	`flutter_web_auth_2` + `flutter_secure_storage`
React Native	integrations/react-native	`react-native-app-auth` + `react-native-keychain`

Android 자격증명 분리 보관

Android (Kotlin) — Canonical/Merge 페이지는 canonical_sub / linked_subs 처리 + 자격증명 분리 보관 패턴을 따로 다룹니다. 신규 통합이면 Step 2 가이드 끝낸 뒤 읽으세요.

Step 3 · 모바일 특화 함정 피하기

Universal Links 통합 가이드 — iOS Universal Link / Android App Link 등록
인앱 브라우저 escape — 카톡/네이버/페북 인앱에서 OAuth 가 막힐 때
Refresh Token 회전 정책 — Apple Sign In / Google 회전 주기 차이
첫 로그인 완료 폼 — RP 자체 추가 정보(역할/조직) 1회 수집 패턴

Step 4 · 빌드 전 체크

RP 통합 테스트 — 시뮬레이터 + 실기기 양쪽 검증 절차
Demo 페이지 둘러보기 — Reference 구현 코드 비교
demo.1pass.dev/oauth — 모바일 PKCE end-to-end walking sample (시나리오 deep-link)
demo.1pass.dev/ios — iOS 네이티브 (앱 설치 후) — Universal Link first-try + Swift SDK
demo.1pass.dev/app-clip — iOS App Clip (앱 설치 전) — QR 스캔으로 카드 로그인
demo.1pass.dev/android — Android 네이티브 — Intent setPackage first-try + Custom Tabs fallback
셀프 진단 — /diagnose — 등록·redirect_uri·스코프 점검

공통 레퍼런스 (트랙 무관)

AI 에게 통째로 던지기

@/llms-full.txt 를 Claude Code · Cursor · Codex 에 붙이고 다음 한 줄:

"logi 1pass 를 [iOS Swift / Flutter / Android Kotlin / RN] 앱에 RP 로 통합해줘. public client + PKCE 기준."

→ Quickstart, env, redirect_uri 등록, 콜백 핸들러까지 자동 생성됩니다.

📱 모바일 앱 통합 트랙 ​

핵심 약속 4줄 ​

Step 1 · 앱 등록 ​

Step 2 · 플랫폼별 Quickstart ​

iOS — LogiAuth Swift Package (권장) ​

그 외 플랫폼 ​

Step 3 · 모바일 특화 함정 피하기 ​

Step 4 · 빌드 전 체크 ​

공통 레퍼런스 (트랙 무관) ​

AI 에게 통째로 던지기 ​