---
title: 框架 SDK
description: 为服务端 Web 登录与会话选择 Sudomimus 框架 SDK。
editUrl: true
head: []
template: doc
sidebar:
  order: 1
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

import { CardGrid, LinkCard } from "@astrojs/starlight/components";

框架 SDK 把 Sudomimus Connect callback 与 Session 生命周期适配到框架的服务端 route、cookie、redirect 和 request 对象。它们构建在 API SDK 之上，直接使用 Connect。其他运行时或直接调用 API 的应用可以[按语言选择 API SDK](/zh-cn/sdk/overview/#按语言选择-api-sdk)。

<CardGrid>
<LinkCard title="Next.js App Router" description="Route handler 与 Server Component session 读取。" href="/zh-cn/frameworks/nextjs/" />
<LinkCard title="React Router Framework Mode" description="Action、loader 与服务端 session 读取。" href="/zh-cn/frameworks/react-router/" />
<LinkCard title="Nuxt Node/Nitro" description="Nitro server route 与服务端 session 读取。" href="/zh-cn/frameworks/nuxt/" />
<LinkCard title="Django" description="Django view、session、callback 处理与 token 轮换。" href="/zh-cn/frameworks/django/" />
</CardGrid>

所有 adapter 都要求 CALLBACK ReturnRule 允许所配置的 callback URL。生产环境还需要共享、持久的 credential store；内存 store 只适用于本地开发。

:::caution[凭据只留在服务端]
client-auth 私钥、refresh token 和返回的 access token 必须保存在服务端 module 与存储中。不要把它们传入浏览器组件或序列化到客户端可见状态。
:::

如果框架已经具备成熟的 OpenID Connect 集成，也可以选择 [OIDC 路径](/zh-cn/oidc/flow/)。需要直接使用 Sudomimus Connect 与应用规则时，再使用这些 adapter。