设置 Auth0

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

circle-info

前往我们的指南以查找一个 完整的操作指南arrow-up-right 关于使用 Auth0 设置已验证访问和自适应内容。

circle-exclamation

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

1

在 Auth0 中创建一个新应用

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

2

安装并配置 Auth0 集成

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

3

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

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

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

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

  1. 登录到您的 Auth0 仪表板arrow-up-right.

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

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

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

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

  6. 您应该会看到如下配置界面。 点击 保存设置并继续.

  7. 点击 设置 选项卡来查看这些评分的结果。

  8. 复制并记下 域名, 客户端 ID 并且 客户端密钥.

circle-exclamation

2. 安装并配置 Auth0 集成

创建 Auth0 应用后,下一步是在 GitBook 中安装 Auth0 集成并使用之前生成的凭证将其与您的 Auth0 应用关联:

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

  2. 点击 集成 按钮(位于站点设置的右上角)。

  3. 点击 已验证访问 从侧栏的类别中。

  4. 选择 Auth0 集成。

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

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

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

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

  9. 复制并记下 回调(Callback) URL 在对话框底部显示的 在对话框底部显示的 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 应用arrow-up-right 以在身份验证令牌中作为声明包含额外的用户信息。

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

最后更新于

这有帮助吗?