设置 Auth0

为访问您文档的访客设置 Auth0 登录界面。

前往我们的指南以查找 完整的逐步教程 关于使用 Auth0 设置已验证访问和自适应内容。

要使用 Auth0 为您的 GitBook 站点设置经过身份验证的访问,流程如下:

1

在您的 Auth0 仪表板中创建一个 Auth0 应用。

2

安装 Auth0 集成并将所需配置添加到您的 GitBook 站点。

3

配置 Auth0 以在 GitBook 中与自适应内容协同工作。

1. 在 Auth0 中创建一个新应用

首先在您的 Auth0 平台仪表板中创建一个新应用。此应用将允许 GitBook 的 Auth0 集成在授予用户访问您站点之前请求用于验证用户身份的令牌。

  1. 登录到您的 Auth0 仪表板.

  2. 前往 Applications > Applications 从左侧边栏的部分。

  3. 点击 + Create Application 按钮,并为您的应用命名。

  4. 选择一个应用类型, 选择 常规 Web 应用(Regular Web Applications).

  5. 快速入门 在新创建的应用的屏幕上,选择 Node.js(Express) ,然后将 我想将我的应用集成.

  6. 然后您应该会看到如下的配置界面。 点击 保存设置并继续(Save Settings And Continue).

  7. 点击 设置 菜单并选择

  8. 复制并记录下 域(Domain), 客户端 ID 并且 客户端密钥.

2. 安装并配置 Auth0 集成

创建 Auth0 应用后,下一步是在 GitBook 中安装 Auth0 集成,并使用您先前生成的凭据将其与 Auth0 应用链接:

  1. 导航到您已启用经过身份验证访问并希望使用 Auth0 作为身份提供者的站点。

  2. 点击 集成 从站点设置的右上角按钮。

  3. 点击 经过身份验证的访问 来自侧边栏的类别。

  4. 选择 Auth0 集成。

  5. 点击 在此站点上安装.

  6. 在站点上安装该集成后,您应看到该集成的配置界面:

  7. 输入 域(Domain), 客户端 ID 并且 客户端密钥 您在之前创建 Auth0 应用时复制的值。对于 Auth0 域,请输入从 Auth0 复制的域(确保以 https://).

  8. (可选) 启用 在 JWT 令牌中包含声明(Include claims in JWT token) 如果您已为站点启用 自适应内容.

  9. 复制并记录下 回调(Callback) 显示的 URL 在对话框底部.

  10. 点击 保存.

  11. 返回到您之前在 Auth0 仪表板中创建的 Auth0 应用。

  12. 浏览到 Applications > Applications 在侧边栏中并选择 设置 菜单并选择

  13. 向下滚动到 应用程序 URI(Application URIs) 设置部分的

  14. 粘贴 回调 URL(Callback URL) 您之前从 GitBook 集成对话框复制的内容到 允许的回调 URL(Allowed Callback URL) 输入字段中。

  15. 点击 保存。

  16. 返回到 Auth0 集成 安装屏幕 在 GitBook 中.

  17. 关闭集成对话框并在站点屏幕中点击 设置 选项卡。

  18. 浏览到 受众 并选择 经过身份验证的访问 (如果尚未选择)。

  19. 选择 Auth0 从下拉菜单中的 身份验证后端 部分选择。

  20. 点击 更新受众.

  21. 前往站点的概览屏幕并点击 发布 如果站点尚未发布。

您的站点现在使用 Auth0 作为身份提供者发布在验证访问之后。

要进行测试,请点击 中定义的视觉样式。。您将被要求使用 Auth0 登录,这将确认您的站点已通过 Auth0 发布在经过身份验证的访问之后。

3. 为自适应内容配置 Auth0(可选)

要在已启用经过身份验证访问的站点中利用自适应内容功能, 配置 Auth0 应用 以在认证令牌中作为声明包含额外的用户信息。

这些以键值对表示的声明会传递给 GitBook,并可用于 动态调整内容 以面向您的站点访客。

最后更新于

这有帮助吗?