For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
预约演示登录免费开始
  • 入门
    • 概览
    • 工作原理
    • 快速开始
    • 项目结构
    • Customer showcase
    • 变更日志
  • 配置
    • 概览
    • 站点级设置
    • 页面级设置
  • 编写内容
    • Markdown 基础
    • Markdown 中的富媒体
    • Fern 编辑器
    • 可复用代码片段
  • AI 功能
    • 概览
    • Fern Writer
    • AI 生成的示例
    • Markdown 访问
      • 概览
      • Agent 指令
      • 智能体指令
      • 分析与集成
    • MCP 服务器
    • API 目录发现
      • 概览
        • 密码保护
        • 单点登录
        • 设置 JWT
        • 设置 OAuth
  • Public API
    • GETJWT from Fern API key
    • GETAlgolia search credentials
    • GETCurrent user information
  • Fern Writer API
    • GETGet Fern Writer Install Link
Checking status...
SOC2Soc 2 Type II
© 2026 Fern • Birch Solutions, Inc., a Postman company

Documentation

SDKsDocsAsk FernCLI Reference

API Definitions

OpenAPIAsyncAPIOpenRPCgRPC

Resources

BlogSupportPricing

Company

Brand KitPrivacy PolicyTerms of Service
LogoLogo
预约演示登录免费开始
在本页
  • 工作原理
  • 配置
本地化Setup

设置 OAuth

与您的登录系统集成的 Fern 托管身份验证

||以 Markdown 格式查看|
此页面是否有帮助？
在仪表板中编辑
上一个

设置 JWT

下一个

基于角色的访问控制

企业功能

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

使用 OAuth，Fern 为您管理身份验证流程。您为 Fern 提供访问您的 OAuth 提供商的权限，Fern 处理 fern_token cookie，将您的文档与现有登录系统集成。与 JWT 一样，OAuth 支持：

  • RBAC — 按用户角色限制内容
  • API 密钥注入 — 在 API 探索器中预填充 API 密钥

工作原理

  1. 用户在您的文档站点上点击登录，Fern 启动与您提供商的 OAuth 流程。
  2. 用户在您的 OAuth 提供商登录页面进行身份验证。
  3. 您的提供商使用授权码重定向回 Fern，Fern 将其交换为访问令牌。
  4. Fern 设置包含用户访问权限和凭据的 fern_token cookie。
  5. 当用户点击登出时，Fern 清除会话 cookie。如果配置了登出 URL，用户将被重定向到您的 OAuth 提供商的登出端点以结束那里的会话。
架构图

配置

1

创建 OAuth 客户端

转到您的 OAuth 提供商的控制面板，创建一个新的Web 应用程序客户端。

2

将 Fern 回调添加到允许列表

在您的 OAuth 提供商中将以下回调添加到允许列表： https://<your-domain>/api/fern-docs/oauth2/callback。

将 <your-domain> 替换为您的 Fern 文档域名。如果您同时使用 .docs.buildwithfern.com 和自定义域名，请将两者都添加到允许列表。

3

将 OAuth 客户端详细信息发送给 Fern

将以下信息发送到 support@buildwithfern.com 或您专用的 Slack 频道：

  • 文档域名
  • 客户端 ID
  • 客户端密钥
  • 授权 URL（例如 https://<your-oauth-tenant>/oauth2/authorize）
  • 令牌 URL（例如 https://<your-oauth-tenant>/oauth2/token）
  • 作用域（例如 openid、profile、email）
  • 发行者 URL（例如 https://<your-domain>）
  • 登出 URL（可选，例如 https://<your-oauth-tenant>/oauth2/logout）
指定受众

如果您的客户端连接到 API，您可能需要在身份验证请求中指定受众。

更新后的授权 URL 可能如下所示：https://<your-oauth-tenant>/oauth2/authorize?audience=<your-api-identifier>

4

等待 Fern 配置 OAuth

Fern 将在您的站点上配置 OAuth。身份验证准备就绪时，您将收到通知。

5

启用 RBAC 或 API 密钥注入（可选）

OAuth 工作后，配置您需要的功能：

RBAC
1

添加自定义声明

将自定义声明添加到您的 OAuth 提供商的令牌响应中，以便 Fern 可以确定每个用户的角色。生成的令牌响应应该如下所示：

1{
2  "iss": "https://your-tenant.us.auth0.com/",
3  "sub": "auth0|507f1f77bcf86cd799439011",
4  "aud": "your_client_id_here",
5  "iat": 1728388800,
6  "exp": 1728475200,
7  "email": "user@example.com",
8  "email_verified": true,
9  "name": "John Doe",
10  "nickname": "johndoe",
11  "picture": "https://s.gravatar.com/avatar/...",
12  "roles": [
13    "custom-role",
14    "user-specific-role"
15  ]
16}

使用 roles 以外的声明

一些 OAuth 提供商对自定义声明有严格要求。如果您需要使用 roles 以外的声明，请联系 Fern 并指定应该解析哪个声明来获取用户角色。

使用 Auth0

要向 Auth0 添加自定义声明，您需要创建一个自定义操作。此操作将用于向令牌响应添加自定义声明。

  1. 转到 Auth0 控制面板中的操作标签。
  2. 创建一个自定义操作。
  3. 选择登录/登录后。
  4. 添加设置角色的逻辑。
    Example Action
    1exports.onExecutePostLogin = async (event, api) => {
    2  const roles = event.user.app_metadata?.roles; // or however you store user roles
    3
    4  if (roles) {
    5    const namespace: "https://<your-domain>.com"; // important: custom claims must be namespaced
    6    api.accessToken.setCustomClaim(`${namespace}/roles`, roles);
    7  }
    8};
  5. 点击创建。
  6. 将操作添加到您的登录后流程。
2

配置 RBAC

一旦您的令牌响应包含角色，在 docs.yml 中定义这些角色并将其分配给导航项和页面内容。完整设置请参阅基于角色的访问控制。

API 密钥注入

为 Fern 设置一个经过身份验证的账户，以便 Fern 可以代表您对用户进行授权，并配置您的 OAuth 应用程序在 Fern 请求令牌时返回用户 API 密钥。联系 support@buildwithfern.com 协调此设置。