设置 JWT

与您的登录系统集成的自管理身份验证

以 Markdown 格式查看
企业功能

此功能仅适用于企业计划。如需开始使用,请联系 support@buildwithfern.com

使用 JWT,您可以管理整个身份验证流程。这涉及构建和签署一个 fern_token cookie,将您的文档与现有登录系统集成。与 OAuth 类似,JWT 支持:

工作原理

  1. 用户在您的文档站点上点击 登录,然后被重定向到您的身份验证页面。
  2. 身份验证后,您的系统使用来自 Fern 的密钥签署一个 JWT,并将其设置为 fern_token cookie。
  3. Fern 读取令牌以确定用户的访问权限和凭据。

配置

1

获取您的密钥

联系 Fern 获取您的密钥,并向他们发送您的身份验证页面 URL。这是用户点击 登录 后被重定向的地方。

2

构建 fern 声明

JWT 负载必须包含一个 fern 声明。您在令牌的 fern 声明中包含的内容控制启用的功能:仅登录、RBAC 或 API 密钥注入。

1{
2 "fern": {}
3}
4

启用 RBAC 或 API 密钥注入(可选)

一旦您的 fern_token 工作正常,配置您需要的功能:

  • 基于角色的访问控制 — 在 docs.yml 中定义角色,并按角色限制导航项或页面内容。
  • API 密钥注入 — 配置 playground 负载,包括自定义标头、多个 API 密钥和按环境凭据。