# 设置 Auth0

{% hint style="info" %}
前往我们的指南，找到一个 [完整演示](https://gitbook.com/docs/guides/product-guides/how-to-personalize-your-gitbook-site-using-auth0-and-adaptive-content) 关于使用 Auth0 配置经过身份验证的访问和自适应内容。
{% endhint %}

{% hint style="warning" %}
本指南将引导你为文档设置一个受保护的登录界面。在阅读本指南之前，请确保你已经先完成了 [启用经过身份验证的访问](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/zhan-dian-fang-wen/authenticated-access/enabling-authenticated-access).
{% endhint %}

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

{% stepper %}
{% step %}
[**在 Auth0 中创建一个新应用**](#id-1.-create-a-new-application-in-auth0)

在你的 Auth0 仪表板中创建一个 Auth0 应用。
{% endstep %}

{% step %}
[**安装并配置 Auth0 集成**](#id-2.-install-and-configure-the-auth0-integration)

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

{% step %}
[**为自适应内容配置 Auth0（可选）**](#id-3.-configure-auth0-for-adaptive-content-optional)

配置 Auth0 以在 GitBook 中配合自适应内容使用。
{% endstep %}
{% endstepper %}

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

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

1. 登录到你的 Auth0 [仪表板](https://manage.auth0.com/dashboard/).
2. 进入 **应用程序 > 应用程序** 部分，从左侧边栏中。
3. 点击 **+ 创建应用程序** 按钮，并为你的应用命名。
4. 在 **选择一种应用类型，** 选择 **常规 Web 应用程序**.
5. 在 **快速入门** 在新创建的应用界面中，选择 **Node.js（Express）** 然后将 **我想集成我的应用**.
6. 然后你应该会看到如下所示的配置界面。\
   点击 **保存设置并继续**.<br>

   <figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FHoIpHTIRmkCvhw1kBVZZ%2Fauth0_app_configure_screen.png?alt=media&#x26;token=ef189183-2547-4e5e-b22f-2d3169f2b600" alt=""><figcaption></figcaption></figure>
7. 点击 **设置** 标签页来查找并重新打开已归档的变更请求。
8. 复制并记下 **域名**, **客户端 ID** 并 **客户端机密**.

{% hint style="warning" %}
请确保你已经 **至少启用了一个连接** 用于你的 Auth0 应用，在 **连接** 标签页来查找并重新打开已归档的变更请求。
{% endhint %}

### 2. 安装并配置 Auth0 集成

创建 Auth0 应用后，下一步是在 GitBook 中安装 Auth0 集成，并使用你之前生成的凭据将其与你的 Auth0 应用关联：

1. 导航到你已启用经过身份验证的访问，并希望使用 Auth0 作为身份提供方的站点。
2. 点击 **集成** 按钮，位于站点设置右上角。<br>

   <figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FgBMsbydNsuqx7eqcz0JN%2Fva_site_integration_overview_screen.png?alt=media&#x26;token=ead70cf3-93cf-4aef-b77a-321afad38900" alt=""><figcaption></figcaption></figure>
3. 点击 **已认证访问** 从侧边栏中的类别中。
4. 选择 **Auth0** 集成。
5. 点击 **安装到此站点**.<br>

   <figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F98d9Svq3PBdpaiRuyV14%2Fauth0_install_integration.png?alt=media&#x26;token=155beba6-bc85-42c6-acb8-18f782f207a4" alt=""><figcaption></figcaption></figure>
6. 在你的站点上安装集成后，你应该会看到该集成的配置界面：<br>

   <figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FGpdmoJqOQvrwFBaQ17Gv%2Fauth0_configure_integration.png?alt=media&#x26;token=61bc203c-2553-453f-b701-176264af044b" alt=""><figcaption></figcaption></figure>
7. 输入 **域名**, **客户端 ID** 并 **客户端机密** 你之前创建 Auth0 应用后复制的值。对于 Auth0 域名，请输入从 Auth0 复制的 Domain（确保在前面加上 `https://`).
8. **（可选）** 启用 **在 JWT 令牌中包含声明** 选项，如果你已为你的站点启用 [自适应内容](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/zhan-dian-fang-wen/adaptive-content/enabling-adaptive-content).
9. 复制并记下 **回调** **URL** 显示的 **位于对话框底部**.
10. 点击 **保存**.
11. 返回到你之前在 Auth0 仪表板中创建的 Auth0 应用。
12. 浏览到 **应用程序 > 应用程序** 在侧边栏中并选择 **设置** 标签页来查找并重新打开已归档的变更请求。
13. 向下滚动到 **应用程序 URI** 设置中的部分
14. 粘贴 **回调 URL** 你之前从 GitBook 集成对话框中复制的内容，填入 **允许的回调 URL** 输入字段。
15. 点击 **保存。**
16. 回到 **Auth0 集成** 安装界面 **在 GitBook 中**.
17. 关闭集成对话框并点击站点界面中的 **设置** 选项卡。
18. 浏览到 **受众** 并选择 **身份验证访问** （如果尚未选择）。
19. 选择 **Auth0** 从下拉菜单中 **身份验证后端** 部分。
20. 点击 **更新受众**.
21. 进入站点的概览界面并点击 **发布** 如果站点尚未发布。

你的站点现在已通过使用 Auth0 作为身份提供方的经过身份验证的访问方式发布。

要进行测试，请点击 **中定义的视觉样式。**。系统将要求你使用 Auth0 登录，这确认你的站点已通过 Auth0 的经过身份验证的访问方式发布。

### 3. 为自适应内容配置 Auth0（可选）

{% embed url="<https://www.youtube.com/embed/uhWeQkgyg8Y?si=7_kD3RF-Is_MnYhZ>" %}

要在你的经过身份验证访问站点中利用自适应内容功能， [配置 Auth0 应用](https://auth0.com/docs/secure/tokens/json-web-tokens/create-custom-claims) 将额外的用户信息作为声明包含在身份验证令牌中。

这些声明以键值对的形式表示，会传递给 GitBook，并可用于 [自适应内容](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/zhan-dian-fang-wen/adaptive-content/adapting-your-content) ，为你的站点访客动态调整内容。