设置 Auth0
为文档访客设置 Auth0 登录界面
前往我们的指南，了解一个 完整的操作流程 关于使用 Auth0 设置已认证访问和自适应内容。
本指南将引导您为文档设置一个受保护的登录界面。在阅读本指南之前，请确保您已经先完成 启用已认证访问.
要使用 Auth0 为您的 GitBook 站点设置已认证访问，流程如下：
在您的 Auth0 仪表板中创建一个 Auth0 应用程序。
安装 Auth0 集成，并将所需配置添加到您的 GitBook 站点。
配置 Auth0 以便与 GitBook 中的自适应内容配合使用。
1. 在 Auth0 中创建一个新应用程序
首先在您的 Auth0 平台仪表板中创建一个新应用程序。此应用程序将允许 GitBook Auth0 集成在授予用户访问您的站点之前请求令牌以验证用户身份。
登录到您的 Auth0 控制台.
前往 应用程序 > 应用程序 部分，从左侧边栏中。
点击你站点设置右上角的 + 创建应用程序 按钮，并为您的应用命名。
在 选择一种应用程序类型， 选择 常规 Web 应用程序.
在 快速入门 在新创建的应用的屏幕中，选择 Node.js（Express） 并且随后将 我想集成我的应用.
然后您应该会看到如下配置界面。 点击 保存设置并继续.
点击你站点设置右上角的 设置 选项卡。
复制并记下 域名, 客户端 ID 并在 客户端密钥.
请确保您已在 至少启用了一个连接 下的 Auth0 应用程序， 连接 选项卡。
2. 安装并配置 Auth0 集成
创建 Auth0 应用程序后，下一步是在 GitBook 中安装 Auth0 集成，并使用您之前生成的凭据将其与您的 Auth0 应用程序关联：
导航到您已启用已认证访问并希望将 Auth0 用作身份提供方的站点。
点击你站点设置右上角的 集成 按钮。
点击 已认证访问 在侧边栏的分类中。
选择 Auth0 集成。
点击 安装到此站点.
在你的站点上安装集成后，你应该会看到该集成的配置界面：
输入你之前在 域名, 客户端 ID 并在 客户端密钥 您之前创建 Auth0 应用程序后复制的值。对于 Auth0 域名，请输入从 Auth0 复制的 Domain（请确保在其前面加上
https://).（可选） 启用 在 JWT 令牌中包含声明 如果您已将站点启用为 自适应内容.
复制并记下 回调 URL 显示的 在对话框底部.
点击 保存.
返回到您之前在 Auth0 仪表板中创建的 Auth0 应用程序。
浏览到 应用程序 > 应用程序 在侧边栏中并选择 设置 选项卡。
向下滚动到 应用程序 URI 设置部分
粘贴 回调 URL 您之前从 GitBook 集成对话框中复制的内容到 允许的回调 URL 输入字段。
点击 保存。
返回到 Auth0 集成 安装页面 在 GitBook 中.
关闭集成对话框，然后点击站点页面中的 设置 选项卡。
浏览到 受众 并选择 已认证访问 （如果尚未选中）。
选择 Auth0 从下拉菜单中 身份验证后端 部分。
点击 更新受众.
前往站点概览页面并点击 发布 如果站点尚未发布。
您的站点现在已通过 Auth0 作为身份提供方，以已认证访问方式发布。
要进行测试，请点击 中定义的视觉样式。系统会要求您使用 Auth0 登录，这将确认您的站点已通过 Auth0 以已认证访问方式发布。
3. 为自适应内容配置 Auth0（可选）
要在您的已认证访问站点中利用自适应内容功能， 配置 Auth0 应用程序 以在认证令牌中将额外的用户信息作为声明包含进去。
这些声明以键值对形式表示，会传递给 GitBook，并可用于 自适应内容 ，以动态方式服务于你站点的访客。
最后更新于
这有帮助吗？