• 创建项目访问令牌
• 撤销项目访问令牌
• 项目访问令牌的范围
• 启用或禁用项目访问令牌创建
• 项目机器人用户

项目访问令牌

项目访问令牌类似于密码，但您可以限制对资源的访问、选择受限角色并提供到期日期。

使用项目访问令牌进行身份验证：

• 使用 GitLab API。
• 使用 Git，当使用 HTTP 基本身份验证时，使用：
  • 任何非空白值作为用户名。
  • 项目访问令牌作为密码。

配置项目访问令牌后，进行身份验证时不需要密码。相反，您可以输入任何非空白值。

项目访问令牌类似于个人访问令牌。

在私有化部署实例中，如果设置了限制，项目访问令牌的最大生命周期限制与个人访问令牌相同。

您可以使用项目访问令牌：

• 在 SaaS 版上，如果您拥有专业版或更高级别许可证。项目访问令牌不适用于试用许可证。

• 在具有任何许可证级别的自助管理实例上。如果您有标准版：

  • 查看围绕用户自行注册的安全和合规性政策。
  • 考虑禁用项目访问令牌以减少潜在的滥用。

您不能使用项目访问令牌来创建其它群组、项目或个人访问令牌。

项目访问令牌继承为个人访问令牌配置的默认前缀设置。

创建项目访问令牌

• 于 15.1 版本中引入，所有者可以为项目访问令牌选择所有者角色。
• 于 15.3 版本中引入，默认到期时间为 30 天，并且在 UI 中填充默认的访客角色。

要创建项目访问令牌：

1. 在顶部栏上，选择 主菜单 > 项目 并找到您的项目。
2. 在左侧边栏上，选择 设置 > 访问令牌。
3. 输入名称。任何有权查看项目的用户都可以看到令牌名称。
4. 可选。输入令牌的到期日期。 令牌将在该日期的 UTC 午夜到期。
5. 为令牌选择一个角色。
6. 选择所需范围。
7. 选择 创建项目访问令牌。

显示项目访问令牌。 将项目访问令牌保存在安全的地方。 离开或刷新页面后，将无法再次查看。

撤销项目访问令牌

要撤销项目访问令牌：

1. 在顶部栏上，选择 主菜单 > 项目 并找到您的项目。
2. 在左侧边栏上，选择 设置 > 访问令牌。
3. 在要撤销的项目访问令牌旁边，选择 撤销。

项目访问令牌的范围

范围决定了您在使用项目访问令牌进行身份验证时可以执行的操作。

启用或禁用项目访问令牌创建

引入于 13.11 版本。

要为顶级组中的所有项目启用或禁用项目访问令牌创建：

1. 在顶部栏上，选择 主菜单 > 群组 并找到您的群组。
2. 在左侧边栏上，选择 设置 > 通用。
3. 展开 权限和群组功能。
4. 在 权限 下，开启或关闭 允许创建项目和群组访问令牌。

即使创建被禁用，您仍然可以使用和撤销现有的项目访问令牌。

项目机器人用户

项目机器人用户是系统创建的服务帐户。 每次创建项目访问令牌时，都会创建一个机器人用户并将其添加到项目中。 这些机器人用户不算作许可席位。

机器人用户具有与项目访问令牌所选角色和范围对应的权限。

• 名称设置为令牌的名称。
• 第一个访问令牌的用户名设置为 project_{project_id}_bot。例如，project_123_bot。
• 电子邮件设置为 project{project_id}_bot@noreply.{Gitlab.config.gitlab.host}。例如，project123_bot@noreply.example.com。
• 对于同一项目中的其他访问令牌，用户名设置为 project_{project_id}_bot{bot_count}。例如，project_123_bot1。
• 对于同一项目中的其他访问令牌，电子邮件设置为 project{project_id}_bot{bot_count}@noreply.{Gitlab.config.gitlab.host}。例如，project123_bot1@noreply.example.com。

使用项目访问令牌进行的 API 调用与相应的机器人用户相关联。

机器人用户：

• 包含在项目的成员列表中但不能修改。
• 不能添加到任何其他项目。
• 可以具有的最大项目角色为所有者。

当项目访问令牌被撤销时：

• 机器人用户被删除。
• 所有记录都移动到用户名为 Ghost User 的系统范围内的用户。有关详细信息，请参阅关联记录。