设置 Auth0

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

前往我们的指南，找到一个完整演示关于使用 Auth0 配置经过身份验证的访问和自适应内容。

本指南将引导你为文档设置一个受保护的登录界面。在阅读本指南之前，请确保你已经先完成了启用经过身份验证的访问.

要使用 Auth0 为你的 GitBook 站点配置经过身份验证的访问，流程如下：

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

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

配置 Auth0 以在 GitBook 中配合自适应内容使用。

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

请确保你已经 至少启用了一个连接 用于你的 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 的经过身份验证的访问方式发布。

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

这些声明以键值对的形式表示，会传递给 GitBook，并可用于自适应内容，为你的站点访客动态调整内容。

最后更新于4个月前

这有帮助吗？