---
title: "SDK"
description: "서버, 웹, 모바일, 데스크톱용 TypeScript 패키지와 로컬 검증 네이티브 SDK."
locale: "ko"
---

> Documentation Index
> Fetch the locale documentation index at: https://xid.dev/ko/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK

## 상태 범례

아래의 모든 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](/ko/sdks/core) — 브라우저 세션, token, 관리 API 헬퍼.
- [@xid-kit/backend](/ko/sdks/backend) — 네트워크 호출 없는 JWT 검증, 요청 인증, webhook.
- [@xid-kit/react](/ko/sdks/react) — provider, hook, 제어 컴포넌트 및 UI 컴포넌트.
- [@xid-kit/nextjs](/ko/sdks/nextjs) — middleware 및 App/Pages Router 서버 헬퍼.
- [@xid-kit/react-native](/ko/sdks/react-native) — Hosted Auth 리디렉션, PKCE S256, 네이티브 앱용 안전한 토큰 저장소.

Source: https://xid.dev/ko/sdks/index.mdx