Getting Started
Marketplace 로그인 & 첫 화면
호스트 앱 자체는 로컬-퍼스트로 작동하지만, 플러그인 카탈로그 / 다운로드 / 서명 검증을 위해 Marketplace 계정 + Agent Hub 서버 인증이 필요합니다. 인증은 plugin 측 hostApi.openAuthWindow / hostApi.openAuthPartitionViewer 로 처리됩니다.
왜 로그인이 필요할까요?
- Marketplace — 플러그인 catalog read + 패키지 다운로드 (deeplink
lvis://install/<slug>이 호스트로 routing). - Agent Hub — Work Board / Inbox 동기화 (HTTPBearer 토큰,
agent-hub.lvisai.xyz). - ms-graph, lge-api — 각 플러그인 자체 OAuth (MSAL · EP SSO). 토큰은 plugin namespace 에 격리.
로그인 흐름
- 01
메인 호스트 → Marketplace SSO
웹 브라우저에서 Marketplace LoginPage 진입. Marketplace 서버 (
marketplace.lvisai.xyz) 의/api/v1/auth/*가 응답. - 02
API key 발급
1회로그인 성공 시 ApiKey (publisher/admin role) 가 발급되고, 클라이언트는 키의 sha256 hash 가 서버 DB 의
api_keys.key_hash와 매칭되는지 검증. - 03
Agent Hub 토큰
Work Board 사용을 위해 별도 Agent Hub
/auth/exchange/issue+/auth/exchange/redeem흐름 (lvis-agent-hub/src/.../api/auth_exchange.py). PKCE-like. - 04
Plugin OAuth — 필요 시
ms-graph (MSAL) / lge-api (EP SSO) 는 plugin install 후 첫 사용 시
hostApi.openAuthWindow로 별도 처리.
첫 화면 — 어떤 구성으로 보이나요?
로그인 없이도 쓸 수 있는 범위
호스트 채팅과 로컬 plugin (예: Local Indexer 의 사전 인덱싱된 폴더) 은 로그인 없이 동작합니다. 다만 플러그인 신규 설치 · Marketplace 카탈로그 · Agent Hub 보드 sync 는 비활성화됩니다.