상태 범례
아래의 모든 SDK는 XID 플랫폼 지원 매트릭스에 따라 두 가지 상태 레이블 중 하나를 가집니다. 두 레이블 모두 프로덕션 준비 완료를 의미하지 않습니다.
| 상태 | 의미 |
|---|---|
| 현재 패키지 | 소스, 테스트, workspace 연결이 포함된 XID 저장소에서 관리되는 TypeScript 패키지. |
| 구현됨 · 로컬 검증 완료 | 로컬 툴체인에서 컴파일되고 단위 테스트를 통과하는 네이티브 SDK. 실제 프로덕션 IdP에 대한 왕복 테스트는 아직 수동 검증이 필요합니다. |
서버 사이드 SDK
웹 표준 런타임(Cloudflare Workers, Node.js, Bun, Deno)은 Web Crypto를 통해 @xid-kit/backend를 공유합니다. 다른 언어는 네이티브 SDK를 사용합니다. 모두 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증을 지원합니다.
| 런타임 또는 언어 | 패키지 또는 디렉터리 | 상태 | 책임 |
|---|---|---|---|
| Cloudflare Workers | @xid-kit/backend |
현재 패키지 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| Node.js | @xid-kit/backend |
현재 패키지 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| Bun | @xid-kit/backend |
현재 패키지 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| Deno | @xid-kit/backend |
현재 패키지 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| Go | sdk/go |
구현됨 · 로컬 검증 완료 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| Java | sdk/java |
구현됨 · 로컬 검증 완료 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| Rust | sdk/rust |
구현됨 · 로컬 검증 완료 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| PHP | sdk/php |
구현됨 · 로컬 검증 완료 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| Ruby | sdk/ruby |
구현됨 · 로컬 검증 완료 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| Python | sdk/python |
구현됨 · 로컬 검증 완료 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
| .NET | sdk/dotnet |
구현됨 · 로컬 검증 완료 | 네트워크 호출 없는 JWT 검증, 요청 인증, webhook 검증입니다. |
클라이언트 SDK: 웹 프레임워크
| 프레임워크 | 패키지 또는 디렉터리 | 상태 | 책임 |
|---|---|---|---|
| Vanilla JS / Web | @xid-kit/core |
현재 패키지 | 브라우저 클라이언트, 세션 저장소, token 캐시, 관리 API 헬퍼입니다. |
| React | @xid-kit/react |
현재 패키지 | Provider, hook, 제어 컴포넌트, 사용자 UI, 조직 UI입니다. |
| Next.js | @xid-kit/nextjs |
현재 패키지 | Middleware, App Router 헬퍼, Pages Router 헬퍼, React 재내보내기입니다. |
| Vue | @xid-kit/vue |
현재 패키지 | Provider, hook 또는 composable, 사용자 및 조직 사전 빌드 컴포넌트입니다. |
| Nuxt | @xid-kit/nuxt |
현재 패키지 | Provider, hook 또는 composable, 사용자 및 조직 사전 빌드 컴포넌트입니다. |
| Svelte / SvelteKit | @xid-kit/svelte |
현재 패키지 | Provider, hook 또는 composable, 사용자 및 조직 사전 빌드 컴포넌트입니다. |
| Angular | @xid-kit/angular |
현재 패키지 | Provider, hook 또는 composable, 사용자 및 조직 사전 빌드 컴포넌트입니다. |
| Remix | @xid-kit/remix |
현재 패키지 | Provider, hook 또는 composable, 사용자 및 조직 사전 빌드 컴포넌트입니다. |
| Astro | @xid-kit/astro |
현재 패키지 | Provider, hook 또는 composable, 사용자 및 조직 사전 빌드 컴포넌트입니다. |
| SolidJS | @xid-kit/solid |
현재 패키지 | Provider, hook 또는 composable, 사용자 및 조직 사전 빌드 컴포넌트입니다. |
클라이언트 SDK: 모바일
| 플랫폼 | 패키지 또는 디렉터리 | 상태 | 책임 |
|---|---|---|---|
| React Native | @xid-kit/react-native |
현재 패키지 | Hosted Auth 리디렉션, deep link callback, PKCE S256, 보안 스토리지 어댑터 계약입니다. |
| Expo | @xid-kit/expo |
현재 패키지 | Expo Router 통합, AuthSession, SecureStore 어댑터. |
| Flutter | sdk/flutter |
구현됨 · 로컬 검증 완료 | Hosted 리디렉션, 앱 링크 콜백, 안전한 저장소 어댑터. |
| iOS | sdk/ios |
구현됨 · 로컬 검증 완료 | ASWebAuthenticationSession, Keychain 저장소, PKCE S256. |
| Android | sdk/android |
구현됨 · 로컬 검증 완료 | Custom Tabs, App Links, Keystore 기반 저장소, PKCE S256. |
클라이언트 SDK: 데스크톱
| 플랫폼 | 패키지 또는 디렉터리 | 상태 | 책임 |
|---|---|---|---|
| macOS | sdk/macos |
구현됨 · 로컬 검증 완료 | ASWebAuthenticationSession, Keychain 저장소, PKCE S256. |
| Windows | sdk/windows |
구현됨 · 로컬 검증 완료 | WebView2 리디렉션, DPAPI 안전 저장소, PKCE S256. |
| Linux | sdk/linux |
구현됨 · 로컬 검증 완료 | 시스템 브라우저 리디렉션, Secret Service 저장소, PKCE S256. |
| Electron | @xid-kit/electron |
현재 패키지 | 메인 프로세스와 렌더러 브리지, safeStorage, loopback 또는 사용자 정의 스킴 콜백. |
| Tauri | @xid-kit/tauri |
현재 패키지 | Rust 백엔드 브리지, OS keychain, PKCE S256. |
공유 네이티브 계약
- 네이티브 공개 클라이언트는 PKCE S256을 사용하는 authorization code를 사용합니다. Implicit flow와 password grant는 지원되지 않습니다.
- 리디렉션 callback은 declared 앱 링크, 범용 링크, 커스텀 스킴 또는 플랫폼 동등 callback URL입니다.
- 스토리지 어댑터는 refresh token 또는 세션 캐시 값을 플랫폼 보안 스토리지에 보관하며 클라이언트 비밀값은 절대 저장하지 않습니다.
- JS 및 TS 네이티브 SDK(React Native, Expo)는 React provider와 hook 모델을 사용합니다: XidProvider, useSignIn, useSignOut.
- 다른 네이티브 SDK(iOS, Android, Flutter, 데스크톱)는 함수형 configure, signIn, handleRedirect API를 사용합니다.
패키지 가이드
각 SDK에는 설치 단계, API 표, 복사-붙여넣기 예제가 포함된 전용 참조 페이지가 있습니다. 사이드바의 SDK 패키지 그룹에 모든 참조 페이지가 나열되어 있으며, 가장 많이 사용되는 웹 패키지는 다음과 같습니다:
- @xid-kit/core — 브라우저 세션, token, 관리 API 헬퍼.
- @xid-kit/backend — 네트워크 호출 없는 JWT 검증, 요청 인증, webhook.
- @xid-kit/react — provider, hook, 제어 컴포넌트 및 UI 컴포넌트.
- @xid-kit/nextjs — middleware 및 App/Pages Router 서버 헬퍼.
- @xid-kit/react-native — Hosted Auth 리디렉션, PKCE S256, 네이티브 앱용 안전한 토큰 저장소.