认证设置

通过用户认证来控制文档的隐私

Pro 计划 包含密码认证。

Enterprise 计划 支持所有认证方式。

启用认证后，用户需先登录才能访问你的文档。

​

认证模式

根据你的访问控制需求，在完整认证和部分认证模式之间进行选择。

完整认证：所有页面均受保护。用户必须先登录才能访问任何内容。

部分认证：部分页面可公开查看，其他页面需要认证。用户可以自由浏览公开内容，访问受保护页面时再进行认证。

在配置下方任一握手机制时，你需要在控制台设置中选择 完整认证 或 部分认证。

​

配置认证

选择要配置的握手机制。

密码

密码认证仅用于访问控制，且不支持内容个性化。

​

前提条件

• 你的安全策略允许在用户之间共享密码。

​

实施

1. 创建密码。

   1. 在你的控制台中，前往 Authentication。
   2. 选择 Full Authentication 或 Partial Authentication。
   3. 选择 Password。
   4. 输入一个安全的密码。
   5. 选择 Save changes。
2. 分发访问权限。

   将密码和文档 URL 安全地共享给获授权的用户。

​

示例

你的文档托管在 docs.foo.com，你需要基本的访问控制，但不跟踪单个用户。你希望阻止公众访问，同时保持设置简单。

在控制台中创建强密码，并与获授权用户共享凭据。就是这样！

​

公开页面

在使用部分认证时，所有页面默认受保护。你可以在页面或分组级别通过 public 属性将特定页面设置为无需认证即可访问。

​

页面级

要将页面设为公开，请在该页面的 frontmatter 中添加 public: true。

Public page example

---
title: "公开页面"
public: true
---

​

组级别

要将某个组内的所有页面设为公开，请在你的 docs.json 中的 navigation 对象里，在该组名称下添加 "public": true。

Public group example

{
  "navigation": {
    "groups": [
      {
        "group": "公共组",
        "public": true,
        "icon": "play",
        "pages": [
          "quickstart",
          "installation",
          "settings"
        ]
      },
      {
        "group": "私有组",
        "icon": "pause",
        "pages": [
          "private-information",
          "secret-settings"
        ]
      }
    ]
  }
}