PingKai Logo下载
搜索

身份访问管理

本文档介绍如何在平凯数据库云服务中管理对组织、项目、资源、角色和用户资料的访问。

在访问平凯数据库云服务之前，请先创建一个平凯数据库云服务账户。你可以使用邮箱和密码注册，并通过平凯数据库云服务管理你的密码。

组织、项目和资源

平凯数据库云服务使用基于组织、项目和资源的分层结构来帮助你管理用户和 TiDB 部署。

  • 组织是一个顶级实体（例如公司或客户），用于管理你的平凯数据库云服务账户（包括一个管理账户和任意数量的成员账户）、项目和资源。
  • 项目是平凯数据库云服务资源的可选逻辑容器。你可以将平凯云 DB 实例（例如 平凯云 Starter 或 平凯云 Essential ）分组到项目中，也可以将这些实例保留在组织级别。
  • 平凯云 DB 虚拟项目用于容纳未分组到任何平凯云 DB 项目中的平凯云 DB 实例，仅用于 API 兼容性，不提供管理能力。

以下是分层结构的一个示例：

- 你的组织
    - 未归入任何项目的平凯云 DB 实例
        - 平凯云 Starter  实例 1
        - 平凯云 Essential  实例 1
    - 平凯云 DB 项目 1
        - 平凯云 Starter  实例 2
        - 平凯云 Starter  实例 3
        - 平凯云 Essential  实例 2

在该结构下：

  • 要访问一个组织，用户必须是该组织的成员。
  • 要访问组织中的某个项目，用户至少需要拥有该组织下该项目的读访问权限。
  • 要访问特定的平凯云 DB 实例，用户可以通过项目角色或实例角色被授予访问权限。

关于用户角色和权限的更多信息，请参见 用户角色。

组织

一个组织可以包含多个项目和未分组到任何项目中的平凯云 DB 实例。

平凯数据库云服务在组织级别进行计费，并为每个项目和资源提供详细的账单信息。

如果你是组织所有者，你在组织中拥有最高权限。

例如，你可以执行以下操作：

  • 为不同目的（如开发、预发布、生产）创建不同的项目。
  • 为不同用户分配不同的组织角色、项目角色和实例角色。
  • 配置组织设置。例如，为你的组织配置时区。

项目

项目对平凯数据库云服务资源进行分组和管理。

在平凯数据库云服务中，有两种平凯云 DB 项目类型：

  • 平凯云 DB 项目：用于按项目管理平凯云 DB 实例的 RBAC。在集群列表页面上创建项目时，平凯云 DB 项目是默认的项目类型。
  • 平凯云 DB 虚拟项目：虚拟项目不提供任何管理功能，用于让未分组到任何项目的平凯云 DB 实例通过平凯数据库云服务 API 使用项目 ID 进行访问。

用户角色

平凯数据库云服务定义了不同的用户角色，用于管理组织、项目和实例级别的权限。

你可以在组织级别、项目级别或实例级别为用户授予角色。请确保为安全考虑，合理规划你的组织、项目和资源的层级结构。

组织角色

在组织级别，平凯数据库云服务定义了五种角色，其中 Organization Owner 可以邀请成员并为成员分配组织角色。

权限Organization OwnerOrganization Billing ManagerOrganization Billing ViewerOrganization Console Audit ManagerOrganization Viewer
管理组织设置，如项目、API 密钥和时区。✅❌❌❌❌
邀请用户加入或移除用户出组织，并编辑用户的组织角色。✅❌❌❌❌
拥有该组织下所有项目的 Project Owner 权限，以及该组织下所有平凯云 DB 实例的平凯云 DB 实例角色的所有权限。✅❌❌❌❌
编辑组织的支付信息。✅✅❌❌❌
查看账单并使用 成本分析器。✅✅✅❌❌
管理组织的平凯数据库云服务 控制台审计日志。✅❌❌✅❌
查看组织内的用户及成员所属的项目。✅✅✅✅✅

注意

  • Organization Console Audit Manager 角色（由 Organization Console Audit Admin 重命名）用于管理平凯数据库云服务控制台的审计日志，而非数据库审计日志。要管理数据库审计，请在项目级别使用 Project Owner 角色。
  • Organization Billing Manager 角色由 Organization Billing Admin 重命名，Organization Viewer 角色由 Organization Member 重命名。

项目角色

在项目级别，平凯数据库云服务定义了四种角色，其中 Project Owner 可以邀请成员并为成员分配项目角色。

注意

  • Organization Owner 拥有所有项目的 Project Owner 权限，因此 Organization Owner 也可以邀请项目成员并分配项目角色。
  • 每个项目角色默认拥有 Organization Viewer 的所有权限。
  • 如果你组织中的某个用户不属于任何项目，则该用户没有任何项目权限。
  • 对于平凯云 DB 项目，项目角色控制对项目中资源的访问。
  • 项目角色不适用于平凯云 DB 虚拟项目，因为平凯云 DB 虚拟项目不提供任何管理功能。要管理未分组到任何平凯云 DB 项目中的特定平凯云 DB 实例的 RBAC，请使用实例角色。
权限Project OwnerProject Data Access Read-WriteProject Data Access Read-OnlyProject Viewer
管理项目设置✅❌❌❌
邀请用户加入或移除用户出项目，并编辑用户的项目角色。✅❌❌❌
管理项目的 数据库审计日志。✅❌❌❌
管理项目下所有 平凯云 Starter 实例的 消费限额。✅❌❌❌
管理项目中的资源操作，例如创建、修改、移动和删除项目类型支持的实例。✅❌❌❌
管理项目下 平凯云 Starter 和 平凯云 Essential 实例的分支，如分支创建、连接和删除。✅❌❌❌
管理资源数据，如数据导入、数据备份与恢复、数据迁移。✅✅❌❌
使用 SQL Editor 查看资源数据（如果资源类型支持）。✅✅✅❌
使用 SQL Editor 修改和删除资源数据（如果资源类型支持）。✅✅❌❌
管理 changefeeds。✅✅✅❌
审核和重置资源密码（如果资源类型支持）。✅❌❌❌
查看项目中的资源概览、备份记录、指标、事件和 changefeeds。✅✅✅✅

实例角色

平凯云 DB 实例支持实例级角色，因此你可以授予对单个平凯云 DB 实例的访问权限，而无需授予对项目中所有资源的相同访问权限。

注意

  • Organization Owner 自动拥有组织中所有平凯云 DB 实例的所有权限。
  • 每个实例角色默认继承 Organization Viewer 角色的所有权限。
  • 项目角色和实例角色是叠加的。用户可以从项目角色继承访问权限，也可以在单个实例上拥有更具体的角色。
权限Instance Manager平凯云 DB 实例数据访问读写平凯云 DB 实例数据访问只读平凯云 DB 实例查看者
管理实例操作，例如实例创建、修改和删除。✅❌❌❌
使用 SQL Editor 查看和修改实例数据。✅✅❌❌
使用 SQL Editor 查看实例数据。✅✅✅❌
管理实例作用域的角色。✅❌❌❌
查看平凯云 DB 实例的备份记录。✅❌❌✅
从备份恢复平凯云 DB 实例。✅❌❌❌
查看实例概览。✅❌❌✅
查看网络设置。✅❌❌✅
查看监控和指标。✅❌❌✅
查看告警。✅❌❌✅

当你想要管理项目中的所有资源时，请使用项目角色；当你只想授予对特定平凯云 DB 实例的访问权限时，请使用实例角色。

管理组织访问

查看并切换组织

要查看并切换组织，请执行以下步骤：

  1. 在 平凯数据库云服务控制台中，点击左上角的下拉框。会显示你所属的组织列表。

    提示：

    • 如果你当前在某个平凯数据库云服务资源页面，点击左上角下拉框后，还需点击下拉框中的 Back to My TiDB 返回到组织列表。
    • 如果你属于多个组织，可以在下拉框中点击目标组织名称，在不同组织间切换账户。

  2. 若要查看组织的详细信息（如组织 ID 和时区），点击组织名称，然后在左侧导航栏点击 Organization Settings > General。

设置组织时区

如果你拥有 Organization Owner 角色，可以根据你的时区修改系统显示时间。

要更改本地时区设置，请执行以下步骤：

  1. 在 平凯数据库云服务控制台中，使用左上角下拉框切换到目标组织。

  2. 在左侧导航栏点击 Organization Settings > General。

  3. 在 Time Zone 区域，从下拉列表中选择你的时区。

  4. 点击 Update。

邀请用户加入你的组织

如果你拥有 Organization Owner 角色，可以邀请用户加入你的组织。

注意

你也可以根据需要直接邀请用户加入你的项目或授予用户访问平凯云 DB 实例的权限，这同样会使该用户成为你的组织成员。

要邀请用户加入你的组织，请执行以下步骤：

  1. 在 平凯数据库云服务控制台中，使用左上角下拉框切换到目标组织。

  2. 在左侧导航栏点击 Organization Settings > Users。

  3. 在 Users 页面，点击右上角的 Invite User。

  4. 输入要邀请用户的邮箱地址。

    提示：

    如果你想一次邀请多个成员，可以输入多个邮箱地址。

  5. （可选）被邀请用户默认没有任何项目或实例权限。要为该用户授予项目或实例角色，请执行以下操作：

    • 要授予用户项目级别的访问权限，点击 Add Roles and Select Project，然后为用户授予角色并选择目标项目。
    • 要授予用户访问特定平凯云 DB 实例的权限，点击 Add Roles and Select Instance，然后为用户授予角色并选择目标平凯云 DB 实例。

  6. 点击 Invite。新用户会被成功添加到用户列表，同时会向被邀请邮箱发送一封带有验证链接的邮件。

  7. 用户收到邮件后，需要点击邮件中的链接进行身份验证，随后会显示一个新页面。

  8. 如果被邀请邮箱尚未注册平凯数据库云服务账户，用户会被引导至注册页面创建账户；如果邮箱已注册平凯数据库云服务账户，用户会被引导至登录页面，登录后账户会自动加入该组织。

注意

邮件中的验证链接 24 小时后过期。如果你要邀请的用户未收到邮件，可点击 Resend 重新发送。

移除组织成员

如果你拥有 Organization Owner 角色，可以将组织成员从你的组织中移除。

要将成员从组织中移除，请执行以下步骤：

注意

如果成员被移除出组织，该成员也会被从所有项目中移除，并失去在该组织中的所有实例访问权限。

  1. 在 平凯数据库云服务控制台中，使用左上角下拉框切换到目标组织。

  2. 在左侧导航栏点击 Organization Settings > Users。

  3. 在 Users 页面，找到目标成员所在行，点击该行中的 ...，然后点击 Delete。

  4. 在确认对话框中，点击 Delete。

管理项目访问

本节介绍如何重命名项目以及如何邀请和移除项目成员。要了解如何创建或管理项目，请参见管理项目。

重命名项目

如果你拥有 Organization Owner 角色，可以重命名你组织中的任何项目。如果你拥有 Project Owner 角色，可以重命名你的项目。

要重命名项目，请执行以下步骤：

  1. 在平凯数据库云服务控制台中，导航到你组织的 集群列表页面，然后点击 Project view 标签页。

    提示：

    如果你属于多个组织，请先使用左上角下拉框切换到目标组织。

  2. 在项目视图中，找到目标项目的表格，点击表格右上角的 ...，然后点击 Rename。

  3. 输入新的项目名称。

  4. 点击 Confirm。

邀请项目成员

如果你拥有 Organization Owner 或 Project Owner 角色，可以邀请成员加入你的项目。

注意

当不属于你组织的用户加入你的项目时，该用户也会自动加入你的组织。

要邀请成员加入项目，请执行以下步骤：

  1. 在平凯数据库云服务控制台中，左侧导航选择组织，然后左侧导航菜单中选择组织设置 / 用户选项。

  2. 在用户视图中，右上角点击邀请用户。

  3. 在弹出的对话框中，输入要邀请用户的邮箱地址，然后为该用户选择一个项目角色。

    提示：

    如果你想一次邀请多个成员，可以输入多个邮箱地址。

  4. 点击 Confirm。新用户会被成功添加到用户列表，同时会向被邀请邮箱发送一封带有验证链接的邮件。

  5. 用户收到邮件后，需要点击邮件中的链接进行身份验证，随后会显示一个新页面。

  6. 如果被邀请邮箱尚未注册平凯数据库云服务账户，用户会被引导至注册页面创建账户；如果邮箱已注册平凯数据库云服务账户，用户会被引导至登录页面，登录后账户会自动加入该项目。

注意

邮件中的验证链接将在 24 小时后过期。如果被邀请用户未收到邮件，可点击 Resend 重新发送。

移除用户的项目访问权限

如果你拥有 Organization Owner 或 Project Owner 角色，可以移除项目成员。

要将成员从项目中移除，请执行以下步骤：

  1. 在 平凯数据库云服务控制台中，使用左上角下拉框切换到目标组织。

  2. 在左侧导航栏点击 Organization Settings > Users。

  3. 在 Users 页面，找到目标成员所在行，点击该行中的 ...，然后点击 Edit Role。

  4. 在 Edit Role 对话框中，找到目标项目，然后点击删除图标。

  5. 点击 Save。

管理实例访问

授予平凯云 DB 实例访问权限

如果你拥有 Organization Owner 或 Project Owner 角色，可以为用户授予特定平凯云 DB 实例的实例角色。

注意

实例访问仅适用于平凯云 DB 实例。

要授予平凯云 DB 实例的访问权限，请执行以下步骤：

  1. 在 平凯数据库云服务控制台中，使用左上角下拉框切换到目标组织。

  2. 在左侧导航栏点击 Organization Settings > Users。

  3. 在 Users 页面，找到目标成员所在行，点击该行中的 ...，然后点击 Edit Role。

    提示：

    如果该用户尚未加入你的组织，请点击右上角的 Invite User，并按照邀请用户加入你的组织中的步骤为用户授予实例角色。

  4. 在 Edit Role 页面，点击 Instance access 部分的 Add Role and Select Instance，然后为用户授予角色并选择目标平凯云 DB 实例。

  5. 点击 Save。

移除用户的实例访问权限

如果你拥有 Organization Owner 或 Project Owner 角色，可以移除用户的实例访问权限。

要移除用户的实例访问权限，请执行以下步骤：

  1. 在 平凯数据库云服务控制台中，使用左上角下拉框切换到目标组织。

  2. 在左侧导航栏点击 Organization Settings > Users。

  3. 在 Users 页面，找到目标成员所在行，点击该行中的 ...，然后点击 Edit Role。

  4. 在 Edit Role 对话框中，找到目标实例，然后点击删除图标。

  5. 点击 Save。

修改用户角色

要修改平凯数据库云服务中用户的角色，请执行以下步骤：

  1. 在 平凯数据库云服务控制台中，使用左上角下拉框切换到目标组织。

  2. 在左侧导航栏点击 Organization Settings > Users。

  3. 在 Users 页面，找到目标用户所在行，点击该行中的 ...，然后点击 Edit Role。

    • 如果你拥有 Organization Owner 角色，可以修改目标用户的组织角色、项目角色和实例角色。
    • 如果你拥有 Project Owner 角色，可以修改目标用户的项目角色和实例角色。

  4. 点击 Save。

管理用户资料

在平凯数据库云服务中，你可以轻松管理你的资料，包括名字、姓氏和手机号。

  1. 在 平凯数据库云服务控制台中，点击左下角的账户图标。

  2. 点击 Account Settings。

  3. 在弹出的对话框中，更新资料信息，然后点击 Update。